SpyBara
Go Premium

Documentation 2026-07-09 23:58 UTC to 2026-07-10 17:00 UTC

110 files changed +1,708 −938. View all changes and history on the product overview
2026
Tue 14 01:57 Mon 13 23:57 Sat 11 19:03 Fri 10 17:00 Thu 9 23:58 Wed 8 16:02 Tue 7 16:02 Mon 6 23:57 Sat 4 03:01 Fri 3 23:00 Thu 2 23:59 Wed 1 21:01

admin-setup.md +6 −6

Details

15</Note>15</Note>

16 16 

17| Décision | Ce que vous choisissez | Référence |17| Décision | Ce que vous choisissez | Référence |

18| :-------------------------------------------------------------------------------------------- | :--------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------- |18| :-------------------------------------------------------------------------------------------- | :--------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

19| [Choisir votre fournisseur d'API](#choose-your-api-provider) | Où Claude Code s'authentifie et comment il est facturé | [Authentification](/fr/authentication), [Bedrock](/fr/amazon-bedrock), [Vertex AI](/fr/google-vertex-ai), [Foundry](/fr/microsoft-foundry) |19| [Choisir votre fournisseur d'API](#choose-your-api-provider) | Où Claude Code s'authentifie et comment il est facturé | [Authentification](/fr/authentication), [Amazon Bedrock](/fr/amazon-bedrock), [Google Cloud's Agent Platform](/fr/google-vertex-ai), [Microsoft Foundry](/fr/microsoft-foundry) |

20| [Décider comment les paramètres atteignent les appareils](#decide-how-settings-reach-devices) | Comment la politique gérée atteint les machines des développeurs | [Paramètres gérés par le serveur](/fr/server-managed-settings), [Fichiers de paramètres](/fr/settings#settings-files) |20| [Décider comment les paramètres atteignent les appareils](#decide-how-settings-reach-devices) | Comment la politique gérée atteint les machines des développeurs | [Paramètres gérés par le serveur](/fr/server-managed-settings), [Fichiers de paramètres](/fr/settings#settings-files) |

21| [Décider ce qu'il faut appliquer](#decide-what-to-enforce) | Quels outils, commandes et intégrations sont autorisés | [Permissions](/fr/permissions), [Sandboxing](/fr/sandboxing) |21| [Décider ce qu'il faut appliquer](#decide-what-to-enforce) | Quels outils, commandes et intégrations sont autorisés | [Permissions](/fr/permissions), [Sandboxing](/fr/sandboxing) |

22| [Configurer la visibilité de l'utilisation](#set-up-usage-visibility) | Comment vous suivez les dépenses et l'adoption | [Analytique](/fr/analytics), [Surveillance](/fr/monitoring-usage), [Coûts](/fr/costs) |22| [Configurer la visibilité de l'utilisation](#set-up-usage-visibility) | Comment vous suivez les dépenses et l'adoption | [Analytique](/fr/analytics), [Surveillance](/fr/monitoring-usage), [Coûts](/fr/costs) |


33| Claude for Teams / Enterprise | Vous voulez Claude Code et claude.ai sous un seul abonnement par siège sans infrastructure à exécuter. C'est la recommandation par défaut. |33| Claude for Teams / Enterprise | Vous voulez Claude Code et claude.ai sous un seul abonnement par siège sans infrastructure à exécuter. C'est la recommandation par défaut. |

34| Claude Console | Vous êtes orienté API ou vous voulez une facturation à l'usage |34| Claude Console | Vous êtes orienté API ou vous voulez une facturation à l'usage |

35| Amazon Bedrock | Vous voulez hériter des contrôles de conformité et de la facturation AWS existants |35| Amazon Bedrock | Vous voulez hériter des contrôles de conformité et de la facturation AWS existants |

36| Google Vertex AI | Vous voulez hériter des contrôles de conformité et de la facturation GCP existants |36| Google Cloud's Agent Platform | Vous voulez hériter des contrôles de conformité et de la facturation GCP existants |

37| Microsoft Foundry | Vous voulez hériter des contrôles de conformité et de la facturation Azure existants |37| Microsoft Foundry | Vous voulez hériter des contrôles de conformité et de la facturation Azure existants |

38 38 

39Certaines fonctionnalités de Claude Code nécessitent un compte claude.ai. [Claude Code sur le web](/fr/claude-code-on-the-web), [Routines](/fr/routines), [Révision de code](/fr/code-review), [Contrôle à distance](/fr/remote-control) et l'[extension Chrome](/fr/chrome) ne sont pas disponibles via les clés API Console ou les identifiants des fournisseurs cloud seuls. Si vous déployez via Bedrock, Vertex ou Foundry, planifiez si les développeurs ont également besoin de sièges Claude for Teams ou Enterprise. Chaque page de fonctionnalité répertorie ses exigences de plan.39Certaines fonctionnalités de Claude Code nécessitent un compte claude.ai. [Claude Code sur le web](/fr/claude-code-on-the-web), [Routines](/fr/routines), [Révision de code](/fr/code-review), [Contrôle à distance](/fr/remote-control) et l'[extension Chrome](/fr/chrome) ne sont pas disponibles via les clés API Console ou les identifiants des fournisseurs cloud seuls. Si vous déployez via Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry, planifiez si les développeurs ont également besoin de sièges Claude for Teams ou Enterprise. Chaque page de fonctionnalité répertorie ses exigences de plan.

40 40 

41Pour la comparaison complète des fournisseurs couvrant l'authentification, les régions et la parité des fonctionnalités, consultez l'[aperçu du déploiement en entreprise](/fr/third-party-integrations). La configuration d'authentification de chaque fournisseur se trouve dans [Authentification](/fr/authentication).41Pour la comparaison complète des fournisseurs couvrant l'authentification, les régions et la parité des fonctionnalités, consultez l'[aperçu du déploiement en entreprise](/fr/third-party-integrations). La configuration d'authentification de chaque fournisseur se trouve dans [Authentification](/fr/authentication).

42 42 


57 57 

58Un [`policyHelper`](/fr/settings#compute-managed-settings-with-a-policy-helper) configuré préempte les quatre sources : sa sortie devient la seule configuration gérée pour l'exécution. Voir [Précédence des paramètres](/fr/settings#settings-precedence).58Un [`policyHelper`](/fr/settings#compute-managed-settings-with-a-policy-helper) configuré préempte les quatre sources : sa sortie devient la seule configuration gérée pour l'exécution. Voir [Précédence des paramètres](/fr/settings#settings-precedence).

59 59 

60Les paramètres gérés par le serveur atteignent les appareils au moment de l'authentification et s'actualisent toutes les heures pendant les sessions actives, sans infrastructure de point de terminaison. La livraison via la console d'administration claude.ai nécessite un plan Claude for Teams ou Enterprise. Les déploiements sur Bedrock, Vertex AI ou Foundry peuvent obtenir la même livraison à distance en exécutant une [passerelle d'applications Claude](/fr/claude-apps-gateway), ou utiliser l'un des mécanismes basés sur fichier ou au niveau du système d'exploitation à la place.60Les paramètres gérés par le serveur atteignent les appareils au moment de l'authentification et s'actualisent toutes les heures pendant les sessions actives, sans infrastructure de point de terminaison. La livraison via la console d'administration claude.ai nécessite un plan Claude for Teams ou Enterprise. Les déploiements sur Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry peuvent obtenir la même livraison à distance en exécutant une [passerelle d'applications Claude](/fr/claude-apps-gateway), ou utiliser l'un des mécanismes basés sur fichier ou au niveau du système d'exploitation à la place.

61 61 

62Si votre organisation mélange les fournisseurs, configurez les [paramètres gérés par le serveur](/fr/server-managed-settings) pour les utilisateurs de claude.ai plus un [secours basé sur fichier ou plist/registre](/fr/settings#settings-files) afin que les autres utilisateurs reçoivent toujours la politique gérée.62Si votre organisation mélange les fournisseurs, configurez les [paramètres gérés par le serveur](/fr/server-managed-settings) pour les utilisateurs de claude.ai plus un [secours basé sur fichier ou plist/registre](/fr/settings#settings-files) afin que les autres utilisateurs reçoivent toujours la politique gérée.

63 63 


153* [Paramètres gérés par le serveur](/fr/server-managed-settings) : livrer la politique gérée à partir de la console d'administration Claude153* [Paramètres gérés par le serveur](/fr/server-managed-settings) : livrer la politique gérée à partir de la console d'administration Claude

154* [Référence des paramètres](/fr/settings) : chaque clé de paramètre, emplacement de fichier et règle de précédence154* [Référence des paramètres](/fr/settings) : chaque clé de paramètre, emplacement de fichier et règle de précédence

155* [Monorepos et grands référentiels](/fr/large-codebases) : modèles de configuration par répertoire pour les organisations déployant dans un monorepo155* [Monorepos et grands référentiels](/fr/large-codebases) : modèles de configuration par répertoire pour les organisations déployant dans un monorepo

156* [Amazon Bedrock](/fr/amazon-bedrock), [Google Vertex AI](/fr/google-vertex-ai), [Microsoft Foundry](/fr/microsoft-foundry) : déploiement spécifique au fournisseur156* [Amazon Bedrock](/fr/amazon-bedrock), [Google Cloud's Agent Platform](/fr/google-vertex-ai), [Microsoft Foundry](/fr/microsoft-foundry) : déploiement spécifique au fournisseur

157* [Guide de l'administrateur Claude Enterprise](https://claude.com/resources/tutorials/claude-enterprise-administrator-guide) : SSO, SCIM, gestion des sièges et playbook de déploiement157* [Guide de l'administrateur Claude Enterprise](https://claude.com/resources/tutorials/claude-enterprise-administrator-guide) : SSO, SCIM, gestion des sièges et playbook de déploiement

advisor.md +2 −2

Details

9{/* plan-availability: feature=advisor providers=anthropic */}9{/* plan-availability: feature=advisor providers=anthropic */}

10 10 

11<Note>11<Note>

12 L'outil advisor est expérimental et nécessite Claude Code v2.1.98 ou ultérieur avec l'API Anthropic. Il n'est pas disponible sur Amazon Bedrock, Google Vertex AI ou Microsoft Foundry. Le comportement, la tarification et la disponibilité peuvent changer.12 L'outil advisor est expérimental et nécessite Claude Code v2.1.98 ou ultérieur avec l'API Anthropic. 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.

13</Note>13</Note>

14 14 

15L'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.15L'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.


162L'outil advisor nécessite tous les éléments suivants :162L'outil advisor nécessite tous les éléments suivants :

163 163 

164* **Claude Code v2.1.98 ou ultérieur** : exécutez `claude update` pour mettre à niveau.164* **Claude Code v2.1.98 ou ultérieur** : exécutez `claude update` pour mettre à niveau.

165* **API Anthropic uniquement** : l'advisor est un outil exécuté par le serveur. Il n'est pas disponible sur Amazon Bedrock, Google Vertex AI ou Microsoft Foundry. Via une [passerelle LLM](/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.165* **API Anthropic uniquement** : l'advisor est un outil exécuté par le serveur. Il n'est pas disponible sur Amazon Bedrock, Google Cloud's Agent Platform, ou Microsoft Foundry. Via une [passerelle LLM](/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.

166* **Modèle principal supporté** : Opus 4.6 ou ultérieur, Sonnet 4.6 ou ultérieur, ou Haiku 4.5. {/* min-version: 2.1.170 */}Fable 5 se qualifie également sur Claude Code v2.1.170 ou ultérieur.166* **Modèle principal supporté** : Opus 4.6 ou ultérieur, Sonnet 4.6 ou ultérieur, ou Haiku 4.5. {/* min-version: 2.1.170 */}Fable 5 se qualifie également sur Claude Code v2.1.170 ou ultérieur.

167 167 

168<h2 id="turn-the-advisor-off">168<h2 id="turn-the-advisor-off">

Details

202 202 

203Lorsque l'une de ces limites est atteinte, le SDK retourne un `ResultMessage` avec un sous-type d'erreur correspondant (`error_max_turns` ou `error_max_budget_usd`). Voir [Gérer le résultat](#handle-the-result) pour savoir comment vérifier ces sous-types et [`ClaudeAgentOptions`](/fr/agent-sdk/python#claudeagentoptions) / [`Options`](/fr/agent-sdk/typescript#options) pour la syntaxe.203Lorsque l'une de ces limites est atteinte, le SDK retourne un `ResultMessage` avec un sous-type d'erreur correspondant (`error_max_turns` ou `error_max_budget_usd`). Voir [Gérer le résultat](#handle-the-result) pour savoir comment vérifier ces sous-types et [`ClaudeAgentOptions`](/fr/agent-sdk/python#claudeagentoptions) / [`Options`](/fr/agent-sdk/typescript#options) pour la syntaxe.

204 204 

205Avec [l'entrée en streaming](/fr/agent-sdk/streaming-vs-single-mode), un message que vous envoyez pendant qu'un tour est encore en cours reste en attente lorsque ce tour se termine à la limite de tours max, et il démarre son propre tour avec sa propre limite de tours max. Avant la v2.1.205, un message qui arrivait à l'itération finale du tour pouvait être consommé dans le tour qui se termine et perdu sans jamais atteindre le modèle.

206 

205<h3 id="effort-level">207<h3 id="effort-level">

206 Niveau d'effort208 Niveau d'effort

207</h3>209</h3>


231L'option de mode de permission (`permission_mode` en Python, `permissionMode` en TypeScript) contrôle si l'agent demande une approbation avant d'utiliser les outils :233L'option de mode de permission (`permission_mode` en Python, `permissionMode` en TypeScript) contrôle si l'agent demande une approbation avant d'utiliser les outils :

232 234 

233| Mode | Comportement |235| Mode | Comportement |

234| :------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |236| :-------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

235| `"default"` | Les outils non couverts par les règles d'autorisation déclenchent votre rappel d'approbation ; pas de rappel signifie refuser |237| `"default"` | Les outils non couverts par les règles d'autorisation déclenchent votre rappel d'approbation ; pas de rappel signifie refuser |

236| `"acceptEdits"` | Approuve automatiquement les éditions de fichiers et les commandes communes du système de fichiers (`mkdir`, `touch`, `mv`, `cp`, etc.) ; les autres commandes Bash suivent les règles par défaut |238| `"acceptEdits"` | Approuve automatiquement les éditions de fichiers et les commandes communes du système de fichiers (`mkdir`, `touch`, `mv`, `cp`, etc.) ; les autres commandes Bash suivent les règles par défaut |

237| `"plan"` | Claude explore et planifie sans éditer vos fichiers source ; les éditions de fichiers ne sont jamais approuvées automatiquement et demandent via votre rappel `canUseTool` |239| `"plan"` | Claude explore et planifie sans éditer vos fichiers source ; les éditions de fichiers ne sont jamais approuvées automatiquement et demandent via votre rappel `canUseTool` |

238| `"dontAsk"` | Ne demande jamais. Les outils pré-approuvés par les [règles de permission](/fr/settings#permission-settings) s'exécutent, tout le reste est refusé |240| `"dontAsk"` | Ne demande jamais. Les outils pré-approuvés par les [règles de permission](/fr/settings#permission-settings) s'exécutent, tout le reste est refusé |

239| `"auto"` (TypeScript uniquement) | Utilise un classificateur de modèle pour approuver ou refuser chaque appel d'outil. Voir [Mode auto](/fr/permission-modes#eliminate-prompts-with-auto-mode) pour la disponibilité et le comportement |241| `"auto"` | Utilise un classificateur de modèle pour approuver ou refuser chaque appel d'outil. Voir [Mode auto](/fr/permission-modes#eliminate-prompts-with-auto-mode) pour la disponibilité et le comportement |

240| `"bypassPermissions"` | Exécute tous les outils autorisés sans demander, sauf si une [règle `ask`](/fr/settings#permission-settings) explicite correspond ; voir [Comment les permissions sont évaluées](/fr/agent-sdk/permissions#how-permissions-are-evaluated) pour savoir où les règles ask se situent dans l'ordre de précédence. Ne peut pas être utilisé lors de l'exécution en tant que root sur Unix. À utiliser uniquement dans des environnements isolés où les actions de l'agent ne peuvent pas affecter les systèmes qui vous intéressent |242| `"bypassPermissions"` | Exécute tous les outils autorisés sans demander, sauf si une [règle `ask`](/fr/settings#permission-settings) explicite correspond ; voir [Comment les permissions sont évaluées](/fr/agent-sdk/permissions#how-permissions-are-evaluated) pour savoir où les règles ask se situent dans l'ordre de précédence. Ne peut pas être utilisé lors de l'exécution en tant que root sur Unix. À utiliser uniquement dans des environnements isolés où les actions de l'agent ne peuvent pas affecter les systèmes qui vous intéressent |

241 243 

242Pour les applications interactives, utilisez `"default"` avec un rappel d'approbation d'outil pour afficher les invites d'approbation. Pour les agents autonomes sur une machine de développement, `"acceptEdits"` approuve automatiquement les éditions de fichiers et les commandes communes du système de fichiers (`mkdir`, `touch`, `mv`, `cp`, etc.) tout en gardant les autres commandes `Bash` derrière les règles d'autorisation. Réservez `"bypassPermissions"` pour CI, les conteneurs ou d'autres environnements isolés. Voir [Permissions](/fr/agent-sdk/permissions) pour les détails complets.244Pour les applications interactives, utilisez `"default"` avec un rappel d'approbation d'outil pour afficher les invites d'approbation. Pour les agents autonomes sur une machine de développement, `"acceptEdits"` approuve automatiquement les éditions de fichiers et les commandes communes du système de fichiers (`mkdir`, `touch`, `mv`, `cp`, etc.) tout en gardant les autres commandes `Bash` derrière les règles d'autorisation. Réservez `"bypassPermissions"` pour CI, les conteneurs ou d'autres environnements isolés. Voir [Permissions](/fr/agent-sdk/permissions) pour les détails complets.


260Voici comment chaque composant affecte le contexte dans le SDK :262Voici comment chaque composant affecte le contexte dans le SDK :

261 263 

262| Source | Quand elle se charge | Impact |264| Source | Quand elle se charge | Impact |

263| :------------------------------ | :------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |265| :------------------------------ | :------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

264| **Prompt système** | Chaque requête | Petit coût fixe, toujours présent |266| **Prompt système** | Chaque requête | Petit coût fixe, toujours présent |

265| **Fichiers CLAUDE.md** | Démarrage de session, via [`settingSources`](/fr/agent-sdk/claude-code-features) | Contenu complet dans chaque requête (mais mis en cache par prompt, donc seule la première requête paie le coût complet) |267| **Fichiers CLAUDE.md** | Démarrage de session, via [`settingSources`](/fr/agent-sdk/claude-code-features) | Contenu complet dans chaque requête (mais mis en cache par prompt, donc seule la première requête paie le coût complet) |

266| **Définitions d'outils** | Chaque requête ; schémas MCP différés par défaut | Les schémas d'outils intégrés se chargent à chaque requête. La [recherche d'outils](/fr/agent-sdk/mcp#mcp-tool-search) diffère les schémas d'outils MCP par défaut, en revenant au chargement initial sur Vertex AI ou une `ANTHROPIC_BASE_URL` non-propriétaire. Voir [Configurer la recherche d'outils](/fr/agent-sdk/tool-search#configure-tool-search) pour la matrice complète |268| **Définitions d'outils** | Chaque requête ; schémas MCP différés par défaut | Les schémas d'outils intégrés se chargent à chaque requête. La [recherche d'outils](/fr/agent-sdk/mcp#mcp-tool-search) diffère les schémas d'outils MCP par défaut, en revenant au chargement initial sur Google Cloud's Agent Platform ou une `ANTHROPIC_BASE_URL` non-propriétaire. Voir [Configurer la recherche d'outils](/fr/agent-sdk/tool-search#configure-tool-search) pour la matrice complète |

267| **Historique de conversation** | S'accumule au fil des tours | Croît avec chaque tour : prompts, réponses, entrées d'outils, sorties d'outils |269| **Historique de conversation** | S'accumule au fil des tours | Croît avec chaque tour : prompts, réponses, entrées d'outils, sorties d'outils |

268| **Descriptions de compétences** | Démarrage de session, via sources de paramètres | Résumés courts ; le contenu complet se charge uniquement lors de l'invocation |270| **Descriptions de compétences** | Démarrage de session, via sources de paramètres | Résumés courts ; le contenu complet se charge uniquement lors de l'invocation |

269 271 


305 307 

306* **Utilisez des sous-agents pour les sous-tâches.** Chaque sous-agent commence avec une conversation fraîche (pas d'historique de messages antérieurs, bien qu'il charge son propre prompt système et le contexte au niveau du projet comme CLAUDE.md). Il ne voit pas les tours du parent, et seule sa réponse finale retourne au parent comme résultat d'outil. Le contexte de l'agent principal croît par ce résumé, pas par la transcription complète de la sous-tâche. Voir [Ce que les sous-agents héritent](/fr/agent-sdk/subagents#what-subagents-inherit) pour les détails.308* **Utilisez des sous-agents pour les sous-tâches.** Chaque sous-agent commence avec une conversation fraîche (pas d'historique de messages antérieurs, bien qu'il charge son propre prompt système et le contexte au niveau du projet comme CLAUDE.md). Il ne voit pas les tours du parent, et seule sa réponse finale retourne au parent comme résultat d'outil. Le contexte de l'agent principal croît par ce résumé, pas par la transcription complète de la sous-tâche. Voir [Ce que les sous-agents héritent](/fr/agent-sdk/subagents#what-subagents-inherit) pour les détails.

307* **Soyez sélectif avec les outils.** Chaque définition d'outil prend de l'espace de contexte. Utilisez le champ `tools` sur [`AgentDefinition`](/fr/agent-sdk/subagents#agentdefinition-configuration) pour délimiter les sous-agents à l'ensemble minimum dont ils ont besoin.309* **Soyez sélectif avec les outils.** Chaque définition d'outil prend de l'espace de contexte. Utilisez le champ `tools` sur [`AgentDefinition`](/fr/agent-sdk/subagents#agentdefinition-configuration) pour délimiter les sous-agents à l'ensemble minimum dont ils ont besoin.

308* **Surveillez les coûts des serveurs MCP.** La [recherche d'outils MCP](/fr/agent-sdk/mcp#mcp-tool-search) diffère les schémas d'outils MCP par défaut et les charge à la demande. Lorsque la recherche d'outils est désactivée, sur Vertex AI, ou derrière une `ANTHROPIC_BASE_URL` non-propriétaire, chaque serveur MCP ajoute tous ses schémas d'outils à chaque requête, donc quelques serveurs avec de nombreux outils peuvent consommer un contexte significatif avant que l'agent ne fasse aucun travail.310* **Surveillez les coûts des serveurs MCP.** La [recherche d'outils MCP](/fr/agent-sdk/mcp#mcp-tool-search) diffère les schémas d'outils MCP par défaut et les charge à la demande. Lorsque la recherche d'outils est désactivée, sur Google Cloud's Agent Platform, ou derrière une `ANTHROPIC_BASE_URL` non-propriétaire, chaque serveur MCP ajoute tous ses schémas d'outils à chaque requête, donc quelques serveurs avec de nombreux outils peuvent consommer un contexte significatif avant que l'agent ne fasse aucun travail.

309* **Utilisez un effort inférieur pour les tâches de routine.** Définissez [effort](#effort-level) à `"low"` pour les agents qui n'ont besoin que de lire des fichiers ou de lister des répertoires. Cela réduit l'utilisation des tokens et le coût.311* **Utilisez un effort inférieur pour les tâches de routine.** Définissez [effort](#effort-level) à `"low"` pour les agents qui n'ont besoin que de lire des fichiers ou de lister des répertoires. Cela réduit l'utilisation des tokens et le coût.

310 312 

311Pour une ventilation détaillée des coûts de contexte par fonctionnalité, voir [Comprendre les coûts de contexte](/fr/features-overview#understand-context-costs).313Pour une ventilation détaillée des coûts de contexte par fonctionnalité, voir [Comprendre les coûts de contexte](/fr/features-overview#understand-context-costs).

Details

292 Prolonger le TTL du cache d'invite à une heure292 Prolonger le TTL du cache d'invite à une heure

293</h3>293</h3>

294 294 

295Les entrées de cache écrites par le SDK utilisent un TTL de 5 minutes par défaut lorsque vous vous authentifiez avec une clé API ou que vous exécutez sur Amazon Bedrock, Google Cloud Vertex AI ou Microsoft Foundry. Si votre charge de travail exécute de nombreuses sessions courtes contre le même système d'invite et le même contexte avec des écarts plus longs que 5 minutes entre elles, le cache expire entre les sessions et chaque nouvelle session paie le prix d'entrée complet.295Les entrées de cache écrites par le SDK utilisent un TTL de 5 minutes par défaut lorsque vous vous authentifiez avec une clé API ou que vous exécutez sur Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry. Si votre charge de travail exécute de nombreuses sessions courtes contre le même système d'invite et le même contexte avec des écarts plus longs que 5 minutes entre elles, le cache expire entre les sessions et chaque nouvelle session paie le prix d'entrée complet.

296 296 

297Pour demander un TTL d'une heure sur les écritures de cache, définissez la variable d'environnement [`ENABLE_PROMPT_CACHING_1H`](/fr/env-vars). Vous pouvez l'exporter dans votre environnement shell ou conteneur, ou la transmettre via `options.env`.297Pour demander un TTL d'une heure sur les écritures de cache, définissez la variable d'environnement [`ENABLE_PROMPT_CACHING_1H`](/fr/env-vars). Vous pouvez l'exporter dans votre environnement shell ou conteneur, ou la transmettre via `options.env`.

298 298 

299L'exemple suivant active le TTL d'une heure pour un agent s'exécutant sur Bedrock :299L'exemple suivant active le TTL d'une heure pour un agent s'exécutant sur Amazon Bedrock :

300 300 

301<CodeGroup>301<CodeGroup>

302 ```python Python theme={null}302 ```python Python theme={null}

Details

21| Pré-approuver un outil | Ajoutez à vos outils autorisés. Voir [Configurer les outils autorisés](#configure-allowed-tools). |21| Pré-approuver un outil | Ajoutez à vos outils autorisés. Voir [Configurer les outils autorisés](#configure-allowed-tools). |

22| Supprimer un outil intégré du contexte de Claude | Transmettez un tableau `tools` listant uniquement les outils intégrés que vous souhaitez. Voir [Configurer les outils autorisés](#configure-allowed-tools). |22| Supprimer un outil intégré du contexte de Claude | Transmettez un tableau `tools` listant uniquement les outils intégrés que vous souhaitez. Voir [Configurer les outils autorisés](#configure-allowed-tools). |

23| Laisser Claude appeler les outils en parallèle | Définissez `readOnlyHint: true` sur les outils sans effets secondaires. Voir [Ajouter des annotations d'outils](#add-tool-annotations). |23| Laisser Claude appeler les outils en parallèle | Définissez `readOnlyHint: true` sur les outils sans effets secondaires. Voir [Ajouter des annotations d'outils](#add-tool-annotations). |

24| Gérer les erreurs sans arrêter la boucle | Retournez `isError: true` au lieu de lever une exception. Voir [Gérer les erreurs](#handle-errors). |24| Contrôler le message d'erreur que Claude lit | Retournez `isError: true` pour composer le message au lieu de faire remonter l'exception brute. Voir [Gérer les erreurs](#handle-errors). |

25| Retourner des images ou des fichiers | Utilisez des blocs `image` ou `resource` dans le tableau de contenu. Voir [Retourner des images et des ressources](#return-images-and-resources). |25| Retourner des images ou des fichiers | Utilisez des blocs `image` ou `resource` dans le tableau de contenu. Voir [Retourner des images et des ressources](#return-images-and-resources). |

26| Retourner un résultat JSON lisible par machine | Définissez `structuredContent` sur le résultat. Voir [Retourner des données structurées](#return-structured-data). |26| Retourner un résultat JSON lisible par machine | Définissez `structuredContent` sur le résultat. Voir [Retourner des données structurées](#return-structured-data). |

27| Adapter à de nombreux outils | Utilisez [la recherche d'outils](/fr/agent-sdk/tool-search) pour charger les outils à la demande. |27| Adapter à de nombreux outils | Utilisez [la recherche d'outils](/fr/agent-sdk/tool-search) pour charger les outils à la demande. |


356 Gérer les erreurs356 Gérer les erreurs

357</h2>357</h2>

358 358 

359La façon dont votre gestionnaire signale les erreurs détermine si la boucle d'agent continue ou s'arrête :359Une erreur de gestionnaire n'arrête pas la boucle d'agent. Le serveur MCP en processus du SDK capture les exceptions non capturées et les retourne comme des résultats d'erreur, donc la façon dont vous signalez une erreur détermine ce que Claude lit, non pas si la requête échoue :

360 360 

361| Ce qui se passe | Résultat |361| Ce qui se passe | Résultat |

362| :---------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------- |362| :---------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

363| Le gestionnaire lève une exception non capturée | La boucle d'agent s'arrête. Claude ne voit jamais l'erreur, et l'appel `query` échoue. |363| Le gestionnaire lève une exception non capturée | Le serveur MCP la convertit en résultat d'erreur contenant le message d'exception brut. Claude voit ce message, et la boucle d'agent continue. |

364| Le gestionnaire capture l'erreur et retourne `isError: true` (TS) / `"is_error": True` (Python) | La boucle d'agent continue. Claude voit l'erreur comme des données et peut réessayer, essayer un outil différent ou expliquer l'échec. |364| Le gestionnaire capture l'erreur et retourne `isError: true` (TS) / `"is_error": True` (Python) | Claude voit le message que vous composez. Vous pouvez ajouter du contexte que l'exception brute n'a pas, comme quelle requête a échoué ou ce qu'il faut essayer à la place. |

365 365 

366L'exemple ci-dessous capture deux types d'échecs à l'intérieur du gestionnaire au lieu de les laisser lever. Un statut HTTP non-200 est capturé de la réponse et retourné comme un résultat d'erreur. Une erreur réseau ou un JSON invalide est capturé par le `try/except` (Python) ou `try/catch` (TypeScript) environnant et est également retourné comme un résultat d'erreur. Dans les deux cas, le gestionnaire retourne normalement et la boucle d'agent continue.366Dans les deux cas, Claude peut réessayer, essayer un outil différent ou expliquer l'échec. Capturez les erreurs vous-même quand le message d'exception brut n'est pas suffisant pour que Claude agisse.

367 

368L'exemple ci-dessous capture deux types d'échecs à l'intérieur du gestionnaire et compose le message d'erreur que Claude lit. Un statut HTTP non-200 est capturé de la réponse et retourné comme un résultat d'erreur. Une erreur réseau ou un JSON invalide est capturé par le `try/except` (Python) ou `try/catch` (TypeScript) environnant et est également retourné comme un résultat d'erreur. Dans les deux cas, Claude reçoit un message qui décrit l'échec au lieu d'une chaîne d'exception brute.

367 369 

368<CodeGroup>370<CodeGroup>

369 ```python Python theme={null}371 ```python Python theme={null}


397 data = response.json()399 data = response.json()

398 return {"content": [{"type": "text", "text": json.dumps(data, indent=2)}]}400 return {"content": [{"type": "text", "text": json.dumps(data, indent=2)}]}

399 except Exception as e:401 except Exception as e:

400 # Catching here keeps the agent loop alive. An uncaught exception402 # Composes the message Claude reads. An uncaught exception would

401 # would end the whole query() call.403 # reach Claude as the raw str(e) with no context.

402 return {404 return {

403 "content": [{"type": "text", "text": f"Failed to fetch data: {str(e)}"}],405 "content": [{"type": "text", "text": f"Failed to fetch data: {str(e)}"}],

404 "is_error": True,406 "is_error": True,


440 ]442 ]

441 };443 };

442 } catch (error) {444 } catch (error) {

443 // Catching here keeps the agent loop alive. An uncaught throw445 // Composes the message Claude reads. An uncaught throw would

444 // would end the whole query() call.446 // reach Claude as the raw error message with no context.

445 return {447 return {

446 content: [448 content: [

447 {449 {


461 Retourner des images et des ressources463 Retourner des images et des ressources

462</h2>464</h2>

463 465 

464Le tableau `content` dans un résultat d'outil accepte les blocs `text`, `image`, `audio`, `resource` et `resource_link`. Vous pouvez les mélanger dans la même réponse. Les blocs audio sont enregistrés sur le disque et Claude reçoit un bloc texte avec le chemin du fichier enregistré. Les blocs de lien de ressource sont convertis en un bloc texte contenant le nom du lien, l'URI et la description.466Le tableau `content` dans un résultat d'outil accepte les blocs `text`, `image`, `audio`, `resource` et `resource_link`. Vous pouvez les mélanger dans la même réponse. En TypeScript, les blocs audio sont enregistrés sur le disque et Claude reçoit un bloc texte avec le chemin du fichier enregistré ; en Python, le SDK supprime les blocs audio du résultat de l'outil et enregistre un avertissement. Les blocs de lien de ressource sont convertis en un bloc texte contenant le nom du lien, l'URI et la description.

465 467 

466<h3 id="images">468<h3 id="images">

467 Images469 Images


535Un bloc ressource intègre un morceau de contenu identifié par un URI. L'URI est un libellé pour que Claude le référence ; le contenu réel se trouve dans le champ `text` ou `blob` du bloc. Utilisez ceci quand votre outil produit quelque chose qui a du sens à adresser par nom plus tard, comme un fichier généré ou un enregistrement d'un système externe.537Un bloc ressource intègre un morceau de contenu identifié par un URI. L'URI est un libellé pour que Claude le référence ; le contenu réel se trouve dans le champ `text` ou `blob` du bloc. Utilisez ceci quand votre outil produit quelque chose qui a du sens à adresser par nom plus tard, comme un fichier généré ou un enregistrement d'un système externe.

536 538 

537| Champ | Type | Notes |539| Champ | Type | Notes |

538| :------------------ | :----------- | :-------------------------------------------------------------------- |540| :------------------ | :----------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

539| `type` | `"resource"` | |541| `type` | `"resource"` | |

540| `resource.uri` | `string` | Identifiant du contenu. N'importe quel schéma URI |542| `resource.uri` | `string` | Identifiant du contenu. N'importe quel schéma URI |

541| `resource.text` | `string` | Le contenu, s'il est textuel. Fournissez ceci ou `blob`, pas les deux |543| `resource.text` | `string` | Le contenu, s'il est textuel. Fournissez ceci ou `blob`, pas les deux |

542| `resource.blob` | `string` | Le contenu codé en base64, s'il est binaire |544| `resource.blob` | `string` | Le contenu codé en base64, s'il est binaire. TypeScript uniquement : le SDK Python supprime les ressources binaires du résultat de l'outil et enregistre un avertissement |

543| `resource.mimeType` | `string` | Optionnel |545| `resource.mimeType` | `string` | Optionnel |

544 546 

545Cet exemple montre un bloc ressource retourné de l'intérieur d'un gestionnaire d'outil. L'URI `file:///tmp/report.md` est un libellé que Claude peut référencer plus tard ; le SDK ne lit pas à partir de ce chemin.547Cet exemple montre un bloc ressource retourné de l'intérieur d'un gestionnaire d'outil. L'URI `file:///tmp/report.md` est un libellé que Claude peut référencer plus tard ; le SDK ne lit pas à partir de ce chemin.

Details

250 250 

251* **Données d'entrée :** un objet typé contenant les détails de l'événement. Chaque type de hook a sa propre forme d'entrée. Par exemple, `PreToolUseHookInput` inclut `tool_name` et `tool_input`, tandis que `NotificationHookInput` inclut `message`. Consultez les définitions de type complètes dans les références du SDK [TypeScript](/fr/agent-sdk/typescript#hookinput) et [Python](/fr/agent-sdk/python#hookinput).251* **Données d'entrée :** un objet typé contenant les détails de l'événement. Chaque type de hook a sa propre forme d'entrée. Par exemple, `PreToolUseHookInput` inclut `tool_name` et `tool_input`, tandis que `NotificationHookInput` inclut `message`. Consultez les définitions de type complètes dans les références du SDK [TypeScript](/fr/agent-sdk/typescript#hookinput) et [Python](/fr/agent-sdk/python#hookinput).

252 * Toutes les entrées de hook partagent `session_id`, `cwd` et `hook_event_name`.252 * Toutes les entrées de hook partagent `session_id`, `cwd` et `hook_event_name`.

253 * `agent_id` et `agent_type` sont remplis lorsque le hook se déclenche à l'intérieur d'un sous-agent. En TypeScript, ceux-ci se trouvent sur l'entrée de hook de base et sont disponibles pour tous les types de hook. En Python, ils se trouvent uniquement sur `PreToolUse`, `PostToolUse` et `PostToolUseFailure`.253 * `agent_id` et `agent_type` sont remplis lorsque le hook se déclenche à l'intérieur d'un sous-agent. En TypeScript, ceux-ci se trouvent sur l'entrée de hook de base et sont disponibles pour tous les types de hook. En Python, ils sont des champs optionnels sur `PreToolUse`, `PostToolUse`, `PostToolUseFailure` et `PermissionRequest`, et des champs requis sur `SubagentStart` et `SubagentStop`.

254* **ID d'utilisation d'outil** (`str | None` / `string | undefined`) : met en corrélation les événements `PreToolUse` et `PostToolUse` pour le même appel d'outil.254* **ID d'utilisation d'outil** (`str | None` / `string | undefined`) : met en corrélation les événements `PreToolUse` et `PostToolUse` pour le même appel d'outil.

255* **Contexte :** en TypeScript, contient une propriété `signal` (`AbortSignal`) pour l'annulation. En Python, cet argument est réservé pour une utilisation future.255* **Contexte :** en TypeScript, contient une propriété `signal` (`AbortSignal`) pour l'annulation. En Python, cet argument est réservé pour une utilisation future.

256 256 

Details

189 Réseau189 Réseau

190</h3>190</h3>

191 191 

192Le SDK a besoin d'un accès HTTPS sortant à `api.anthropic.com`, ou au point de terminaison régional de votre fournisseur lors de l'exécution sur Bedrock ou Vertex. Si vos agents utilisent des [serveurs MCP](/fr/agent-sdk/mcp) ou des outils externes, ils ont besoin d'un accès sortant à ces points de terminaison également. Pour la production, acheminez le trafic sortant via un proxy de sortie qui applique les listes blanches de domaines, injecte les identifiants et enregistre les requêtes. Voir [Déploiement sécurisé](/fr/agent-sdk/secure-deployment) pour le modèle complet.192Le SDK a besoin d'un accès HTTPS sortant à `api.anthropic.com`, ou au point de terminaison régional de votre fournisseur lors de l'exécution sur Amazon Bedrock ou Google Cloud's Agent Platform. Si vos agents utilisent des [serveurs MCP](/fr/agent-sdk/mcp) ou des outils externes, ils ont besoin d'un accès sortant à ces points de terminaison également. Pour la production, acheminez le trafic sortant via un proxy de sortie qui applique les listes blanches de domaines, injecte les identifiants et enregistre les requêtes. Voir [Déploiement sécurisé](/fr/agent-sdk/secure-deployment) pour le modèle complet.

193 193 

194Pour le trafic entrant, exposez un port HTTP ou WebSocket sur le conteneur. Votre application gère les requêtes des clients sur ce port et appelle le SDK en interne ; le sous-processus lui-même n'écoute pas sur le réseau.194Pour le trafic entrant, exposez un port HTTP ou WebSocket sur le conteneur. Votre application gère les requêtes des clients sur ce port et appelle le SDK en interne ; le sous-processus lui-même n'écoute pas sur le réseau.

195 195 

Details

823 Délais d'expiration de la connexion823 Délais d'expiration de la connexion

824</h3>824</h3>

825 825 

826Le SDK MCP a un délai d'expiration par défaut de 60 secondes pour les connexions serveur. Si votre serveur prend plus de temps pour démarrer, la connexion échouera. Pour les serveurs qui ont besoin de plus de temps de démarrage, envisagez :826Les connexions serveur MCP expirent après 30 secondes par défaut. Si votre serveur prend plus de temps pour démarrer, la connexion échoue. Augmentez la limite avec la variable d'environnement [`MCP_TIMEOUT`](/fr/env-vars), en millisecondes. Pour les serveurs qui ont besoin de plus de temps de démarrage, envisagez également :

827 827 

828* Utiliser un serveur plus léger si disponible828* Utiliser un serveur plus léger si disponible

829* Préchauffer le serveur avant de démarrer votre agent829* Préchauffer le serveur avant de démarrer votre agent

Details

152 152 

153* **CLI** : exécutez `/config` et sélectionnez un style de sortie153* **CLI** : exécutez `/config` et sélectionnez un style de sortie

154* **Paramètres** : définissez `outputStyle` dans `.claude/settings.local.json`154* **Paramètres** : définissez `outputStyle` dans `.claude/settings.local.json`

155* **SDK TypeScript** : définissez `outputStyle` dans l'objet `settings` en ligne passé à `query()`, ou pointez `settings` vers un fichier de paramètres qui le définit. `outputStyle` n'est pas un champ `Options` de niveau supérieur155* **SDK TypeScript** : définissez `outputStyle` dans l'objet `settings` en ligne passé à `query()`, ou pointez `settings` vers un fichier de paramètres qui le définit. `outputStyle` n'est pas un champ `Options` de niveau supérieur :

156 

157 ```typescript theme={null}

158 const options = { settings: { outputStyle: "Explanatory" } };

159 ```

156 160 

157Le SDK Python n'a pas d'option pour sélectionner un style de sortie par programmation. Pour les déploiements basés sur le code où vous ne pouvez pas écrire dans `.claude/settings.local.json`, utilisez `append` ou une chaîne d'invite personnalisée à la place.161Le SDK Python n'a pas d'option pour sélectionner un style de sortie par programmation. Pour les déploiements basés sur le code où vous ne pouvez pas écrire dans `.claude/settings.local.json`, utilisez `append` ou une chaîne d'invite personnalisée à la place.

158 162 

Details

212 212 

213L'interface de ligne de commande joint les [attributs d'identité](/fr/monitoring-usage#standard-attributes) à chaque événement en fonction de la credential qu'elle utilise pour appeler Anthropic. Lorsque vous créez une application qui sert de nombreux utilisateurs finaux à partir d'un seul déploiement, ces attributs identifient la credential de votre service, pas l'utilisateur final au nom duquel l'agent a agi.213L'interface de ligne de commande joint les [attributs d'identité](/fr/monitoring-usage#standard-attributes) à chaque événement en fonction de la credential qu'elle utilise pour appeler Anthropic. Lorsque vous créez une application qui sert de nombreux utilisateurs finaux à partir d'un seul déploiement, ces attributs identifient la credential de votre service, pas l'utilisateur final au nom duquel l'agent a agi.

214 214 

215Pour rendre les appels d'outils et l'activité MCP attribuables aux utilisateurs finaux de votre application, injectez l'identité de l'utilisateur final en tant qu'attributs de ressource sur chaque appel `query()`. Encodez en pourcentage les valeurs avant de les interpoler, car `OTEL_RESOURCE_ATTRIBUTES` [réserve les virgules, les espaces et les signes égal](/fr/monitoring-usage#multi-team-organization-support). L'exemple suivant joint l'utilisateur demandeur et le locataire à chaque span et événement d'une requête :215Pour rendre les appels d'outils et l'activité MCP attribuables aux utilisateurs finaux de votre application, injectez l'identité de l'utilisateur final en tant qu'attributs de ressource sur chaque appel `query()`. Encodez en pourcentage les valeurs avant de les interpoler, car `OTEL_RESOURCE_ATTRIBUTES` [réserve les virgules, les espaces et les signes égal](/fr/monitoring-usage#multi-team-organization-support). L'exemple suivant joint l'utilisateur demandeur et le locataire à chaque span et événement d'une requête. Il suppose un objet `request` de votre framework web portant les identifiants d'utilisateur et de locataire :

216 216 

217<CodeGroup>217<CodeGroup>

218 ```python Python theme={null}218 ```python Python theme={null}


237 ```237 ```

238</CodeGroup>238</CodeGroup>

239 239 

240Avec l'identité de l'utilisateur final attachée, les événements `tool_decision`, `tool_result`, `mcp_server_connection` et `permission_mode_changed` deviennent une piste d'audit par utilisateur que vous pouvez transférer à une plateforme SIEM (Security Information and Event Management). Consultez [Audit des événements de sécurité](/fr/monitoring-usage#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.240Avec l'identité de l'utilisateur final attachée, les événements `tool_decision`, `tool_result`, `mcp_server_connection` et `permission_mode_changed`, qui s'exportent en tant qu'enregistrements de journal nommés avec un préfixe `claude_code.`, deviennent une piste d'audit par utilisateur que vous pouvez transférer à une plateforme SIEM (Security Information and Event Management). Consultez [Audit des événements de sécurité](/fr/monitoring-usage#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.

241 241 

242<h2 id="control-sensitive-data-in-exports">242<h2 id="control-sensitive-data-in-exports">

243 Contrôler les données sensibles dans les exports243 Contrôler les données sensibles dans les exports

Details

87 87 

88 * **Amazon Bedrock** : définissez la variable d'environnement `CLAUDE_CODE_USE_BEDROCK=1` et configurez les identifiants AWS88 * **Amazon Bedrock** : définissez la variable d'environnement `CLAUDE_CODE_USE_BEDROCK=1` et configurez les identifiants AWS

89 * **Claude Platform on AWS** : définissez `CLAUDE_CODE_USE_ANTHROPIC_AWS=1` et `ANTHROPIC_AWS_WORKSPACE_ID`, puis configurez les identifiants AWS89 * **Claude Platform on AWS** : définissez `CLAUDE_CODE_USE_ANTHROPIC_AWS=1` et `ANTHROPIC_AWS_WORKSPACE_ID`, puis configurez les identifiants AWS

90 * **Google Vertex AI** : définissez la variable d'environnement `CLAUDE_CODE_USE_VERTEX=1` et configurez les identifiants Google Cloud90 * **Google Cloud's Agent Platform** : définissez la variable d'environnement `CLAUDE_CODE_USE_VERTEX=1` et configurez les identifiants Google Cloud

91 * **Microsoft Azure** : définissez la variable d'environnement `CLAUDE_CODE_USE_FOUNDRY=1` et configurez les identifiants Azure91 * **Microsoft Azure** : définissez la variable d'environnement `CLAUDE_CODE_USE_FOUNDRY=1` et configurez les identifiants Azure

92 92 

93 Consultez les guides de configuration pour [Bedrock](/fr/amazon-bedrock), [Claude Platform on AWS](/fr/claude-platform-on-aws), [Vertex AI](/fr/google-vertex-ai), ou [Azure AI Foundry](/fr/microsoft-foundry) pour plus de détails.93 Consultez les guides de configuration pour [Amazon Bedrock](/fr/amazon-bedrock), [Claude Platform on AWS](/fr/claude-platform-on-aws), [Google Cloud's Agent Platform](/fr/google-vertex-ai), ou [Microsoft Foundry](/fr/microsoft-foundry) pour plus de détails.

94 94 

95 <Note>95 <Note>

96 Sauf approbation préalable, Anthropic n'autorise pas les développeurs tiers à proposer la connexion claude.ai ou les limites de débit pour leurs produits, y compris les agents construits sur le SDK Claude Agent. Veuillez utiliser les méthodes d'authentification par clé API décrites dans ce document à la place.96 Sauf approbation préalable, Anthropic n'autorise pas les développeurs tiers à proposer la connexion claude.ai ou les limites de débit pour leurs produits, y compris les agents construits sur le SDK Claude Agent. Veuillez utiliser les méthodes d'authentification par clé API décrites dans ce document à la place.

Details

109Le SDK supporte ces modes de permission :109Le SDK supporte ces modes de permission :

110 110 

111| Mode | Description | Comportement de l'outil |111| Mode | Description | Comportement de l'outil |

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

113| `default` | Comportement de permission standard | Pas d'auto-approbations ; les outils non appariés déclenchent votre callback `canUseTool` |113| `default` | Comportement de permission standard | Pas d'auto-approbations ; les outils non appariés déclenchent votre callback `canUseTool` |

114| `dontAsk` | Refuser au lieu de demander | Tout ce qui n'est pas pré-approuvé par `allowed_tools` ou les règles est refusé ; `canUseTool` n'est jamais appelé |114| `dontAsk` | Refuser au lieu de demander | Tout ce qui n'est pas pré-approuvé par `allowed_tools` ou les règles est refusé ; `canUseTool` n'est jamais appelé |

115| `acceptEdits` | Auto-accepter les modifications de fichiers | Les modifications de fichiers et les [opérations du système de fichiers](#accept-edits-mode-acceptedits) (`mkdir`, `rm`, `mv`, etc.) sont automatiquement approuvées |115| `acceptEdits` | Auto-accepter les modifications de fichiers | Les modifications de fichiers et les [opérations du système de fichiers](#accept-edits-mode-acceptedits) (`mkdir`, `rm`, `mv`, etc.) sont automatiquement approuvées |

116| `bypassPermissions` | Contourner les contrôles de permission | Les outils s'exécutent sans invites de permission, sauf si une [règle `ask`](#how-permissions-are-evaluated) explicite correspond (à utiliser avec prudence) |116| `bypassPermissions` | Contourner les contrôles de permission | Les outils s'exécutent sans invites de permission, sauf si une [règle `ask`](#how-permissions-are-evaluated) explicite correspond (à utiliser avec prudence) |

117| `plan` | Mode de planification | Claude explore et planifie sans modifier vos fichiers source ; les modifications de fichiers ne sont jamais auto-approuvées et demandent via votre callback `canUseTool` |117| `plan` | Mode de planification | Claude explore et planifie sans modifier vos fichiers source ; les modifications de fichiers ne sont jamais auto-approuvées et demandent via votre callback `canUseTool` |

118| `auto` (TypeScript uniquement) | Approbations classées par modèle | Un classificateur de modèle approuve ou refuse chaque appel d'outil. Consultez [Mode Auto](/fr/permission-modes#eliminate-prompts-with-auto-mode) pour la disponibilité |118| `auto` | Approbations classées par modèle | Un classificateur de modèle approuve ou refuse chaque appel d'outil. Consultez [Mode Auto](/fr/permission-modes#eliminate-prompts-with-auto-mode) pour la disponibilité |

119 119 

120<Warning>120<Warning>

121 **Héritage des sous-agents :** Lorsque le parent utilise `bypassPermissions`, `acceptEdits` ou `auto`, tous les sous-agents héritent de ce mode et il ne peut pas être remplacé par sous-agent. Les sous-agents peuvent avoir des invites système différentes et un comportement moins contraint que votre agent principal, donc hériter de `bypassPermissions` leur accorde un accès système complet et autonome. Une [règle `ask`](#how-permissions-are-evaluated) explicite force toujours une invite.121 **Héritage des sous-agents :** Lorsque le parent utilise `bypassPermissions`, `acceptEdits` ou `auto`, tous les sous-agents héritent de ce mode et il ne peut pas être remplacé par sous-agent. Les sous-agents peuvent avoir des invites système différentes et un comportement moins contraint que votre agent principal, donc hériter de `bypassPermissions` leur accorde un accès système complet et autonome. Une [règle `ask`](#how-permissions-are-evaluated) explicite force toujours une invite.

Details

854class ClaudeAgentOptions:854class ClaudeAgentOptions:

855 tools: list[str] | ToolsPreset | None = None855 tools: list[str] | ToolsPreset | None = None

856 allowed_tools: list[str] = field(default_factory=list)856 allowed_tools: list[str] = field(default_factory=list)

857 system_prompt: str | SystemPromptPreset | None = None857 system_prompt: str | SystemPromptPreset | SystemPromptFile | None = None

858 mcp_servers: dict[str, McpServerConfig] | str | Path = field(default_factory=dict)858 mcp_servers: dict[str, McpServerConfig] | str | Path = field(default_factory=dict)

859 strict_mcp_config: bool = False859 strict_mcp_config: bool = False

860 permission_mode: PermissionMode | None = None860 permission_mode: PermissionMode | None = None


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

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

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

903| `system_prompt` | `str \| SystemPromptPreset \| None` | `None` | Configuration du prompt système. Passez une chaîne pour un prompt personnalisé, ou utilisez `{"type": "preset", "preset": "claude_code"}` pour le prompt système de Claude Code. Ajoutez `"append"` pour étendre le preset |903| `system_prompt` | `str \| SystemPromptPreset \| SystemPromptFile \| None` | `None` | Configuration du prompt système. Passez une chaîne pour un prompt personnalisé, `{"type": "preset", "preset": "claude_code"}` pour le prompt système de Claude Code avec `"append"` optionnel, ou `{"type": "file", "path": "..."}` pour charger un grand prompt depuis le disque. Voir [`SystemPromptPreset`](#systempromptpreset) et [`SystemPromptFile`](#systempromptfile) |

904| `mcp_servers` | `dict[str, McpServerConfig] \| str \| Path` | `{}` | Configurations de serveur MCP ou chemin vers le fichier de configuration |904| `mcp_servers` | `dict[str, McpServerConfig] \| str \| Path` | `{}` | Configurations de serveur MCP ou chemin vers le fichier de configuration |

905| `strict_mcp_config` | `bool` | `False` | Quand `True`, utilisez uniquement les serveurs passés dans `mcp_servers` et ignorez le projet `.mcp.json`, les paramètres utilisateur, les serveurs MCP fournis par les plugins, et les [connecteurs claude.ai](/fr/mcp#use-mcp-servers-from-claude-ai). Correspond à l'indicateur CLI `--strict-mcp-config` |905| `strict_mcp_config` | `bool` | `False` | Quand `True`, utilisez uniquement les serveurs passés dans `mcp_servers` et ignorez le projet `.mcp.json`, les paramètres utilisateur, les serveurs MCP fournis par les plugins, et les [connecteurs claude.ai](/fr/mcp#use-mcp-servers-from-claude-ai). Correspond à l'indicateur CLI `--strict-mcp-config` |

906| `permission_mode` | `PermissionMode \| None` | `None` | Mode de permission pour l'utilisation des outils |906| `permission_mode` | `PermissionMode \| None` | `None` | Mode de permission pour l'utilisation des outils |


1002| `append` | Non | Instructions supplémentaires à ajouter au preset de prompt système |1002| `append` | Non | Instructions supplémentaires à ajouter au preset de prompt système |

1003| `exclude_dynamic_sections` | Non | Déplacez le contexte par session comme le répertoire de travail, le statut git et les chemins de mémoire du prompt système vers le premier message utilisateur. Améliore la réutilisation du cache de prompt entre les utilisateurs et les machines. Voir [Modifier les prompts système](/fr/agent-sdk/modifying-system-prompts#improve-prompt-caching-across-users-and-machines) |1003| `exclude_dynamic_sections` | Non | Déplacez le contexte par session comme le répertoire de travail, le statut git et les chemins de mémoire du prompt système vers le premier message utilisateur. Améliore la réutilisation du cache de prompt entre les utilisateurs et les machines. Voir [Modifier les prompts système](/fr/agent-sdk/modifying-system-prompts#improve-prompt-caching-across-users-and-machines) |

1004 1004 

1005<h3 id="systempromptfile">

1006 `SystemPromptFile`

1007</h3>

1008 

1009Configuration pour charger un prompt système personnalisé à partir d'un fichier au lieu de le passer en tant que chaîne. Le SDK mappe ceci à l'indicateur CLI [`--system-prompt-file`](/fr/cli-reference#system-prompt-flags). Utilisez la forme fichier quand le prompt est volumineux : le SDK passe un `system_prompt` chaîne sur l'argv du sous-processus CLI, qui est soumis aux limites de longueur de ligne de commande du système d'exploitation avant que le SDK n'envoie une requête API. Sur Linux, un seul argument plus long que environ 128 KB échoue au spawn du processus avec `Argument list too long`. Sur Windows, la ligne de commande entière est limitée à environ 32 KB, donc la forme chaîne échoue à un seuil inférieur.

1010 

1011```python theme={null}

1012class SystemPromptFile(TypedDict):

1013 type: Literal["file"]

1014 path: str

1015```

1016 

1017| Champ | Requis | Description |

1018| :----- | :----- | :--------------------------------------------------------- |

1019| `type` | Oui | Doit être `"file"` pour charger le prompt depuis le disque |

1020| `path` | Oui | Chemin vers un fichier contenant le prompt système |

1021 

1005<h3 id="settingsource">1022<h3 id="settingsource">

1006 `SettingSource`1023 `SettingSource`

1007</h3>1024</h3>


1192 "plan", # Planning mode - explore without editing1209 "plan", # Planning mode - explore without editing

1193 "dontAsk", # Deny anything not pre-approved instead of prompting1210 "dontAsk", # Deny anything not pre-approved instead of prompting

1194 "bypassPermissions", # Bypass permission checks; explicit ask rules still prompt (use with caution)1211 "bypassPermissions", # Bypass permission checks; explicit ask rules still prompt (use with caution)

1212 "auto", # A model classifier approves or denies each tool call

1195]1213]

1196```1214```

1197 1215 


1755```1773```

1756 1774 

1757| Champ | Type | Description |1775| Champ | Type | Description |

1758| :------------------- | :--------------- | :------------------------------------------------------------------------ |1776| :------------------- | :--------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

1759| `uuid` | `str` | Identifiant unique pour cet événement |1777| `uuid` | `str` | Identifiant unique pour cet événement |

1760| `session_id` | `str` | Identifiant de session |1778| `session_id` | `str` | Identifiant de session |

1761| `event` | `dict[str, Any]` | Les données d'événement de flux Claude API brutes |1779| `event` | `dict[str, Any]` | Les données d'événement de flux Claude API brutes |

1762| `parent_tool_use_id` | `str \| None` | ID d'utilisation d'outil parent si cet événement provient d'un sous-agent |1780| `parent_tool_use_id` | `str \| None` | Toujours `None`. Les événements de flux sont émis pour la session principale uniquement. Pour l'attribution de sous-agent, utilisez des messages complets tels que [`AssistantMessage`](#assistantmessage) |

1763 1781 

1764<h3 id="ratelimitevent">1782<h3 id="ratelimitevent">

1765 `RateLimitEvent`1783 `RateLimitEvent`


2393 tool_name: str2411 tool_name: str

2394 tool_input: dict[str, Any]2412 tool_input: dict[str, Any]

2395 permission_suggestions: NotRequired[list[Any]]2413 permission_suggestions: NotRequired[list[Any]]

2414 agent_id: NotRequired[str]

2415 agent_type: NotRequired[str]

2396```2416```

2397 2417 

2398| Champ | Type | Description |2418| Champ | Type | Description |

2399| :----------------------- | :----------------------------- | :------------------------------------------ |2419| :----------------------- | :----------------------------- | :------------------------------------------------------------------------------------------ |

2400| `hook_event_name` | `Literal["PermissionRequest"]` | Toujours « PermissionRequest » |2420| `hook_event_name` | `Literal["PermissionRequest"]` | Toujours « PermissionRequest » |

2401| `tool_name` | `str` | Nom de l'outil demandant la permission |2421| `tool_name` | `str` | Nom de l'outil demandant la permission |

2402| `tool_input` | `dict[str, Any]` | Paramètres d'entrée pour l'outil |2422| `tool_input` | `dict[str, Any]` | Paramètres d'entrée pour l'outil |

2403| `permission_suggestions` | `list[Any]` (optionnel) | Mises à jour de permission suggérées du CLI |2423| `permission_suggestions` | `list[Any]` (optionnel) | Mises à jour de permission suggérées du CLI |

2424| `agent_id` | `str` (optionnel) | Identifiant de sous-agent, présent quand le hook se déclenche à l'intérieur d'un sous-agent |

2425| `agent_type` | `str` (optionnel) | Type de sous-agent, présent quand le hook se déclenche à l'intérieur d'un sous-agent |

2404 2426 

2405<h3 id="hookjsonoutput">2427<h3 id="hookjsonoutput">

2406 `HookJSONOutput`2428 `HookJSONOutput`

Details

121 121 

122 * **Amazon Bedrock** : définissez la variable d'environnement `CLAUDE_CODE_USE_BEDROCK=1` et configurez les identifiants AWS122 * **Amazon Bedrock** : définissez la variable d'environnement `CLAUDE_CODE_USE_BEDROCK=1` et configurez les identifiants AWS

123 * **Claude Platform on AWS** : définissez `CLAUDE_CODE_USE_ANTHROPIC_AWS=1` et `ANTHROPIC_AWS_WORKSPACE_ID`, puis configurez les identifiants AWS123 * **Claude Platform on AWS** : définissez `CLAUDE_CODE_USE_ANTHROPIC_AWS=1` et `ANTHROPIC_AWS_WORKSPACE_ID`, puis configurez les identifiants AWS

124 * **Google Vertex AI** : définissez la variable d'environnement `CLAUDE_CODE_USE_VERTEX=1` et configurez les identifiants Google Cloud124 * **Google Cloud's Agent Platform** : définissez la variable d'environnement `CLAUDE_CODE_USE_VERTEX=1` et configurez les identifiants Google Cloud

125 * **Microsoft Azure** : définissez la variable d'environnement `CLAUDE_CODE_USE_FOUNDRY=1` et configurez les identifiants Azure125 * **Microsoft Azure** : définissez la variable d'environnement `CLAUDE_CODE_USE_FOUNDRY=1` et configurez les identifiants Azure

126 126 

127 Consultez les guides de configuration pour [Bedrock](/fr/amazon-bedrock), [Claude Platform on AWS](/fr/claude-platform-on-aws), [Vertex AI](/fr/google-vertex-ai) ou [Azure AI Foundry](/fr/microsoft-foundry) pour plus de détails.127 Consultez les guides de configuration pour [Amazon Bedrock](/fr/amazon-bedrock), [Claude Platform on AWS](/fr/claude-platform-on-aws), [Google Cloud's Agent Platform](/fr/google-vertex-ai), ou [Microsoft Foundry](/fr/microsoft-foundry) pour plus de détails.

128 128 

129 <Note>129 <Note>

130 Sauf approbation préalable, Anthropic n'autorise pas les développeurs tiers à proposer la connexion claude.ai ou les limites de débit pour leurs produits, y compris les agents construits sur le SDK Agent Claude. Veuillez utiliser les méthodes d'authentification par clé API décrites dans ce document à la place.130 Sauf approbation préalable, Anthropic n'autorise pas les développeurs tiers à proposer la connexion claude.ai ou les limites de débit pour leurs produits, y compris les agents construits sur le SDK Agent Claude. Veuillez utiliser les méthodes d'authentification par clé API décrites dans ce document à la place.


368**Les modes de permission** contrôlent le niveau de surveillance humaine que vous souhaitez :368**Les modes de permission** contrôlent le niveau de surveillance humaine que vous souhaitez :

369 369 

370| Mode | Comportement | Cas d'usage |370| Mode | Comportement | Cas d'usage |

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

372| `acceptEdits` | Approuve automatiquement les modifications de fichiers et les commandes courantes du système de fichiers, demande les autres actions | Flux de travail de développement de confiance |372| `acceptEdits` | Approuve automatiquement les modifications de fichiers et les commandes courantes du système de fichiers, demande les autres actions | Flux de travail de développement de confiance |

373| `plan` | Exécute les outils en lecture seule ; les modifications de fichiers ne sont jamais approuvées automatiquement et atteignent votre rappel `canUseTool` | Délimitation d'une tâche avant d'approuver l'exécution |373| `plan` | Exécute les outils en lecture seule ; les modifications de fichiers ne sont jamais approuvées automatiquement et atteignent votre rappel `canUseTool` | Délimitation d'une tâche avant d'approuver l'exécution |

374| `dontAsk` | Refuse tout ce qui n'est pas dans `allowedTools` | Agents sans tête verrouillés |374| `dontAsk` | Refuse tout ce qui n'est pas dans `allowedTools` | Agents sans tête verrouillés |

375| `auto` (TypeScript uniquement) | Un classificateur de modèle approuve ou refuse chaque appel d'outil | Agents autonomes avec garde-fous de sécurité |375| `auto` | Un classificateur de modèle approuve ou refuse chaque appel d'outil | Agents autonomes avec garde-fous de sécurité |

376| `bypassPermissions` | Exécute chaque outil sans invites, sauf si une règle [`ask`](/fr/agent-sdk/permissions#how-permissions-are-evaluated) explicite correspond | CI en bac à sable, environnements entièrement de confiance |376| `bypassPermissions` | Exécute chaque outil sans invites, sauf si une règle [`ask`](/fr/agent-sdk/permissions#how-permissions-are-evaluated) explicite correspond | CI en bac à sable, environnements entièrement de confiance |

377| `default` | Nécessite un rappel `canUseTool` pour gérer l'approbation | Flux d'approbation personnalisés |377| `default` | Nécessite un rappel `canUseTool` pour gérer l'approbation | Flux d'approbation personnalisés |

378 378 

Details

91 uuid: str # Unique identifier for this event91 uuid: str # Unique identifier for this event

92 session_id: str # Session identifier92 session_id: str # Session identifier

93 event: dict[str, Any] # The raw Claude API stream event93 event: dict[str, Any] # The raw Claude API stream event

94 parent_tool_use_id: str | None # Parent tool ID if from a subagent94 parent_tool_use_id: str | None # Always None

95 ```95 ```

96 96 

97 ```typescript TypeScript theme={null}97 ```typescript TypeScript theme={null}


106 ```106 ```

107</CodeGroup>107</CodeGroup>

108 108 

109Le champ `parent_tool_use_id` est toujours `None` en Python et `null` en TypeScript. Les événements de diffusion sont émis pour la session principale uniquement ; les deltas au niveau des tokens des sous-agents ne sont pas transmis. Pour attribuer la sortie à un sous-agent, utilisez les messages complets, qui portent `parent_tool_use_id`. Voir [Détecter l'invocation de sous-agent](/fr/agent-sdk/subagents#detect-subagent-invocation).

110 

109Le champ `event` contient l'événement de diffusion brut de l'[API Claude](https://platform.claude.com/docs/en/build-with-claude/streaming#event-types). Les types d'événements courants incluent :111Le champ `event` contient l'événement de diffusion brut de l'[API Claude](https://platform.claude.com/docs/en/build-with-claude/streaming#event-types). Les types d'événements courants incluent :

110 112 

111| Type d'événement | Description |113| Type d'événement | Description |

Details

247 247 

248Le SDK supporte les fonctionnalités JSON Schema standard incluant tous les types de base (object, array, string, number, boolean, null), `enum`, `const`, `required`, les objets imbriqués et les définitions `$ref`. Pour la liste complète des fonctionnalités supportées et des limitations, voir [Limitations JSON Schema](https://platform.claude.com/docs/fr/build-with-claude/structured-outputs#json-schema-limitations).248Le SDK supporte les fonctionnalités JSON Schema standard incluant tous les types de base (object, array, string, number, boolean, null), `enum`, `const`, `required`, les objets imbriqués et les définitions `$ref`. Pour la liste complète des fonctionnalités supportées et des limitations, voir [Limitations JSON Schema](https://platform.claude.com/docs/fr/build-with-claude/structured-outputs#json-schema-limitations).

249 249 

250Un schéma qui n'est pas un JSON Schema valide échoue l'exécution au démarrage avec une erreur nommant le problème. Avant la v2.1.205, un schéma invalide était silencieusement ignoré et l'agent retournait du texte non structuré.

251 

252Le mot-clé `format`, tel que `"format": "email"`, est accepté comme annotation et n'est pas appliqué par le validateur du SDK. Avant la v2.1.205, tout schéma contenant `format` était traité comme invalide.

253 

250<h2 id="example-todo-tracking-agent">254<h2 id="example-todo-tracking-agent">

251 Exemple : agent de suivi des TODO255 Exemple : agent de suivi des TODO

252</h2>256</h2>

Details

234 Le parent reçoit le message final du sous-agent tel quel comme résultat de l'outil Agent, mais peut le résumer dans sa propre réponse. Pour préserver la sortie du sous-agent tel quel dans la réponse visible par l'utilisateur, incluez une instruction pour le faire dans l'invite ou l'option `systemPrompt` que vous transmettez à l'appel `query()` principal.234 Le parent reçoit le message final du sous-agent tel quel comme résultat de l'outil Agent, mais peut le résumer dans sa propre réponse. Pour préserver la sortie du sous-agent tel quel dans la réponse visible par l'utilisateur, incluez une instruction pour le faire dans l'invite ou l'option `systemPrompt` que vous transmettez à l'appel `query()` principal.

235</Note>235</Note>

236 236 

237{/* min-version: 2.1.199 */}À partir de Claude Code v2.1.199, une erreur API qui termine le sous-agent prématurément, comme une limite de débit, n'est jamais livrée comme résultat. Si le sous-agent a déjà produit une sortie, l'outil Agent retourne cette sortie partielle avec une note indiquant que le sous-agent n'a pas terminé ; sinon, le résultat de l'outil est un message d'erreur, `Agent terminated early due to an API error`, suivi du détail de l'erreur. Consultez [API errors in subagents](/fr/sub-agents#api-errors-in-subagents) pour le comportement au premier plan et en arrière-plan.237{/* min-version: 2.1.199 */}Une erreur API qui termine le sous-agent prématurément, comme une limite de débit, n'est jamais livrée comme résultat. Si une limite de débit, une surcharge ou une erreur serveur interrompt un sous-agent au premier plan qui a déjà produit une sortie textuelle, l'outil Agent retourne cette sortie partielle avec une note indiquant que le sous-agent n'a pas terminé. {/* min-version: 2.1.200 */}Un sous-agent qui n'a rien produit, ou dont la seule sortie était des appels d'outils sans texte, échoue avec un message d'erreur, `Agent terminated early due to an API error`, suivi du détail de l'erreur. Consultez [API errors in subagents](/fr/sub-agents#api-errors-in-subagents) pour le comportement au premier plan et en arrière-plan.

238 

239Cette gestion des sorties partielles nécessite Claude Code v2.1.199 ou ultérieur. Dans v2.1.199, une limite de débit, une surcharge ou une erreur serveur laissait la forme contenant uniquement des appels d'outils avec un résultat partiel vide contenant seulement la note d'interruption.

238 240 

239<h2 id="invoke-subagents">241<h2 id="invoke-subagents">

240 Invoquer les sous-agents242 Invoquer les sous-agents

Details

296</h4>296</h4>

297 297 

298| Propriété | Type | Description |298| Propriété | Type | Description |

299| :------------------- | :---------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |299| :------------------- | :---------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

300| `type` | `"user" \| "assistant"` | Rôle du message |300| `type` | `"user" \| "assistant"` | Rôle du message |

301| `uuid` | `string` | Identifiant de message unique |301| `uuid` | `string` | Identifiant de message unique |

302| `session_id` | `string` | Session à laquelle ce message appartient |302| `session_id` | `string` | Session à laquelle ce message appartient |

303| `message` | `unknown` | Charge utile de message brute de la transcription |303| `message` | `unknown` | Charge utile de message brute de la transcription |

304| `parent_tool_use_id` | `string \| null` | Pour les messages de sous-agent, le `tool_use_id` de l'appel d'outil `Agent` qui l'a généré. `null` pour les messages de session principale et les sessions plus anciennes |304| `parent_tool_use_id` | `string \| null` | Pour les messages de sous-agent, le `tool_use_id` de l'appel d'outil `Agent` qui l'a généré. `null` pour les messages de session principale et les sessions plus anciennes |

305| `parent_agent_id` | `string \| null` | Pour les messages d'un [sous-agent imbriqué](/fr/sub-agents#spawn-nested-subagents), le `agentId` du sous-agent qui l'a généré. `null` pour les messages de session principale, les messages des sous-agents de niveau supérieur et les sessions plus anciennes. {/* min-version: 2.1.202 */}Nécessite Claude Code v2.1.202 ou ultérieur |

305 306 

306<h4 id="example-2">307<h4 id="example-2">

307 Exemple308 Exemple


563 564 

564```typescript theme={null}565```typescript theme={null}

565interface Query extends AsyncGenerator<SDKMessage, void> {566interface Query extends AsyncGenerator<SDKMessage, void> {

566 interrupt(): Promise<void>;567 interrupt(): Promise<SDKControlInterruptResponse | undefined>;

567 rewindFiles(568 rewindFiles(

568 userMessageId: string,569 userMessageId: string,

569 options?: { dryRun?: boolean }570 options?: { dryRun?: boolean }


594 595 

595| Méthode | Description |596| Méthode | Description |

596| :------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |597| :------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

597| `interrupt()` | Interrompt la requête (disponible uniquement en mode d'entrée en diffusion) |598| `interrupt()` | Interrompt la requête. Disponible uniquement en mode d'entrée en diffusion. {/* min-version: 2.1.205 */}Quand la CLI annonce la capacité `interrupt_receipt_v1` dans [`SDKSystemMessage.capabilities`](#sdksystemmessage), se résout avec une [`SDKControlInterruptResponse`](#sdkcontrolinterruptresponse) listant les messages en attente qui survivent à l'interruption. Se résout à `undefined` sur les CLI antérieures à v2.1.205 |

598| `rewindFiles(userMessageId, options?)` | Restaure les fichiers à leur état au message utilisateur spécifié. Passez `{ dryRun: true }` pour prévisualiser les modifications. Nécessite `enableFileCheckpointing: true`. Voir [Sauvegarde de fichiers](/fr/agent-sdk/file-checkpointing) |599| `rewindFiles(userMessageId, options?)` | Restaure les fichiers à leur état au message utilisateur spécifié. Passez `{ dryRun: true }` pour prévisualiser les modifications. Nécessite `enableFileCheckpointing: true`. Voir [Sauvegarde de fichiers](/fr/agent-sdk/file-checkpointing) |

599| `setPermissionMode()` | Change le mode de permission (disponible uniquement en mode d'entrée en diffusion) |600| `setPermissionMode()` | Change le mode de permission (disponible uniquement en mode d'entrée en diffusion) |

600| `setModel()` | Change le modèle (disponible uniquement en mode d'entrée en diffusion) |601| `setModel()` | Change le modèle (disponible uniquement en mode d'entrée en diffusion) |


625* **Appliquées au tour suivant** : `model`, `effortLevel`, `ultracode`, `permissions`, `hooks`, `skillOverrides`, `fastMode`, `awaySummaryEnabled`, `agent`. Basculer `agent` applique également le remplacement de modèle, les hooks et l'invite système de cet agent au tour suivant.626* **Appliquées au tour suivant** : `model`, `effortLevel`, `ultracode`, `permissions`, `hooks`, `skillOverrides`, `fastMode`, `awaySummaryEnabled`, `agent`. Basculer `agent` applique également le remplacement de modèle, les hooks et l'invite système de cet agent au tour suivant.

626* **Aucun effet en milieu de session** : les options d'invite système. Celles-ci sont résolues une fois au démarrage, donc la session en cours d'exécution conserve la valeur d'origine même si l'appel réussit. Pour les modifier, démarrez une nouvelle session.627* **Aucun effet en milieu de session** : les options d'invite système. Celles-ci sont résolues une fois au démarrage, donc la session en cours d'exécution conserve la valeur d'origine même si l'appel réussit. Pour les modifier, démarrez une nouvelle session.

627 628 

629`effortLevel` accepte un nom de [niveau d'effort](/fr/model-config#adjust-effort-level). Il accepte également `"ultracode"`, qui exécute la session au niveau d'effort `xhigh` et active [ultracode](/fr/workflows#let-claude-decide-with-ultracode). Le type `Settings` déclare `effortLevel` sans cette valeur, donc passez l'équivalent `{ ultracode: true }` en TypeScript. {/* min-version: 2.1.203 */}La valeur `ultracode` nécessite Claude Code v2.1.203 ou ultérieur et n'est acceptée que par `applyFlagSettings()`, pas par la clé `effortLevel` dans un fichier de paramètres.

630 

628Les valeurs sont écrites dans la couche de paramètres d'indicateur, la même couche que l'option `settings` en ligne de `query()` remplit au démarrage. Les paramètres d'indicateur se situent près du haut de l'[ordre de précédence des paramètres](/fr/settings#settings-precedence) : ils remplacent les paramètres utilisateur, projet et locaux, et seuls les paramètres de politique gérée peuvent les remplacer. C'est le même niveau que la [section de précédence sur la page](#settings-precedence) appelle les options programmatiques.631Les valeurs sont écrites dans la couche de paramètres d'indicateur, la même couche que l'option `settings` en ligne de `query()` remplit au démarrage. Les paramètres d'indicateur se situent près du haut de l'[ordre de précédence des paramètres](/fr/settings#settings-precedence) : ils remplacent les paramètres utilisateur, projet et locaux, et seuls les paramètres de politique gérée peuvent les remplacer. C'est le même niveau que la [section de précédence sur la page](#settings-precedence) appelle les options programmatiques.

629 632 

630Les appels successifs fusionnent superficiellement les clés de niveau supérieur. Un deuxième appel avec `{ permissions: {...} }` remplace l'objet `permissions` entier de l'appel précédent plutôt que de le fusionner profondément. Pour effacer une clé de la couche d'indicateur et revenir aux sources de précédence inférieure, passez `null` pour cette clé. Passer `undefined` n'a aucun effet car la sérialisation JSON le supprime.633Les appels successifs fusionnent superficiellement les clés de niveau supérieur. Un deuxième appel avec `{ permissions: {...} }` remplace l'objet `permissions` entier de l'appel précédent plutôt que de le fusionner profondément. Pour effacer une clé de la couche d'indicateur et revenir aux sources de précédence inférieure, passez `null` pour cette clé. Passer `undefined` n'a aucun effet car la sérialisation JSON le supprime.


693 696 

694Ce sont des demandes qui ont été émises avant que le client se connecte et attendent toujours une réponse. Le SDK lit le tableau pour vous et distribue chaque entrée à votre rappel [`canUseTool`](#canusetool), la même redistribution que [`reinitialize()`](#query-object) déclenche après une interruption de transport. Gérez les ID de requête répétés de manière idempotente, car une entrée peut répéter une requête que le rappel a déjà reçue avant que la connexion ne soit interrompue.697Ce sont des demandes qui ont été émises avant que le client se connecte et attendent toujours une réponse. Le SDK lit le tableau pour vous et distribue chaque entrée à votre rappel [`canUseTool`](#canusetool), la même redistribution que [`reinitialize()`](#query-object) déclenche après une interruption de transport. Gérez les ID de requête répétés de manière idempotente, car une entrée peut répéter une requête que le rappel a déjà reçue avant que la connexion ne soit interrompue.

695 698 

699<h3 id="sdkcontrolinterruptresponse">

700 `SDKControlInterruptResponse`

701</h3>

702 

703Le reçu d'interruption : la valeur que [`interrupt()`](#query-object) se résout avec sur une CLI qui annonce la capacité `interrupt_receipt_v1` dans [`SDKSystemMessage.capabilities`](#sdksystemmessage). Nécessite Claude Code v2.1.205 ou ultérieur. Les CLI antérieures répondent à l'interruption avec une charge utile de succès vide, donc `interrupt()` se résout à `undefined`.

704 

705```typescript theme={null}

706type SDKControlInterruptResponse = {

707 still_queued: string[];

708};

709```

710 

711`still_queued` liste les UUID des messages utilisateur qui survivent à l'interruption : messages toujours en attente, plus tout lot déjà retiré de la file d'attente pour le tour suivant mais pas encore accessible par l'abandon. Chacun s'exécute comme son propre tour après l'interruption sauf si vous l'annulez d'abord. Utilisez le reçu pour décider si vous devez renvoyer quelque chose ; renvoyer un message qui est déjà listé produit un tour en double.

712 

713Interprétez la liste avec ces avertissements :

714 

715* Seuls les messages qui ont été mis en attente avec un UUID apparaissent. Un tableau vide ne signifie pas que rien d'autre ne s'exécutera.

716* Seuls les messages du thread principal sont listés. Les messages adressés à un sous-agent sont hors de portée.

717* La liste peut inclure des UUID que votre client n'a jamais envoyés, comme les déclencheurs de [tâche programmée](/fr/scheduled-tasks). Ignorez les UUID que vous ne reconnaissez pas au lieu de les traiter comme une erreur.

718 

719Le reçu est un instantané pris au moment où l'interruption est traitée, et sur une interruption propre, il arrive avant le [`SDKResultMessage`](#sdkresultmessage) du tour interrompu. Lisez le reçu plutôt que d'inspecter la file d'attente après ce résultat : la boucle démarre immédiatement le tour en attente suivant, donc la file d'attente que vous inspectez après le résultat a déjà changé.

720 

696<h3 id="agentdefinition">721<h3 id="agentdefinition">

697 `AgentDefinition`722 `AgentDefinition`

698</h3>723</h3>


1097 | SDKTaskStartedMessage1122 | SDKTaskStartedMessage

1098 | SDKTaskProgressMessage1123 | SDKTaskProgressMessage

1099 | SDKTaskUpdatedMessage1124 | SDKTaskUpdatedMessage

1125 | SDKBackgroundTasksChangedMessage

1100 | SDKSessionStateChangedMessage1126 | SDKSessionStateChangedMessage

1101 | SDKWorkerShuttingDownMessage1127 | SDKWorkerShuttingDownMessage

1102 | SDKCommandsChangedMessage1128 | SDKCommandsChangedMessage


1110 | SDKPromptSuggestionMessage1136 | SDKPromptSuggestionMessage

1111 | SDKAPIRetryMessage1137 | SDKAPIRetryMessage

1112 | SDKMirrorErrorMessage1138 | SDKMirrorErrorMessage

1113 | SDKInformationalMessage;1139 | SDKInformationalMessage

1140 | SDKConversationResetMessage;

1114```1141```

1115 1142 

1116<h3 id="sdkassistantmessage">1143<h3 id="sdkassistantmessage">


1273 output_style: string;1300 output_style: string;

1274 skills: string[];1301 skills: string[];

1275 plugins: { name: string; path: string }[];1302 plugins: { name: string; path: string }[];

1303 capabilities?: string[];

1276};1304};

1277```1305```

1278 1306 

1307{/* min-version: 2.1.205 */}

1308 

1309Le tableau `capabilities` nomme les comportements de protocole que ce CLI implémente, afin que vous puissiez détecter les fonctionnalités au lieu de comparer les chaînes `claude_code_version`. C'est un ensemble ouvert : ignorez les valeurs que vous ne reconnaissez pas, et vérifiez la capacité spécifique dont vous dépendez. Le champ nécessite Claude Code v2.1.205 ou ultérieur et est absent sur les CLI antérieurs.

1310 

1311| Capacité | Signification |

1312| ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

1313| `interrupt_receipt_v1` | [`interrupt()`](#query-object) se résout avec une réception [`SDKControlInterruptResponse`](#sdkcontrolinterruptresponse) nommant les messages en attente qui survivent à l'interruption |

1314 

1279<h3 id="sdkpartialassistantmessage">1315<h3 id="sdkpartialassistantmessage">

1280 `SDKPartialAssistantMessage`1316 `SDKPartialAssistantMessage`

1281</h3>1317</h3>

1282 1318 

1283Message partiel en diffusion (uniquement quand `includePartialMessages` est true).1319Message partiel en diffusion (uniquement quand `includePartialMessages` est true). Le champ `parent_tool_use_id` est toujours `null` : les événements de flux sont émis pour la session principale uniquement. Pour l'attribution de sous-agent, utilisez les messages complets, qui portent `parent_tool_use_id`, ou activez [`forwardSubagentText`](#options) pour recevoir le texte et la réflexion du sous-agent en tant que messages complets.

1284 1320 

1285```typescript theme={null}1321```typescript theme={null}

1286type SDKPartialAssistantMessage = {1322type SDKPartialAssistantMessage = {


1421type SDKMessageOrigin =1457type SDKMessageOrigin =

1422 | { kind: "human" }1458 | { kind: "human" }

1423 | { kind: "channel"; server: string }1459 | { kind: "channel"; server: string }

1424 | { kind: "peer"; from: string; name?: string; senderTaskId?: string }1460 | {

1461 kind: "peer";

1462 from: string;

1463 name?: string;

1464 senderTaskId?: string;

1465 body?: string;

1466 }

1425 | { kind: "task-notification" }1467 | { kind: "task-notification" }

1426 | { kind: "coordinator" }1468 | { kind: "coordinator" }

1427 | { kind: "auto-continuation" };1469 | { kind: "auto-continuation" };

1428```1470```

1429 1471 

1430| `kind` | Signification |1472| `kind` | Signification |

1431| ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |1473| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

1432| `human` | Entrée directe de l'utilisateur final. Sur les messages utilisateur, une `origin` absente signifie également une entrée humaine. |1474| `human` | Entrée directe de l'utilisateur final. Sur les messages utilisateur, une `origin` absente signifie également une entrée humaine. |

1433| `channel` | Message arrivant sur un [canal](/fr/channels). `server` est le nom du serveur MCP source. |1475| `channel` | Message arrivant sur un [canal](/fr/channels). `server` est le nom du serveur MCP source. |

1434| `peer` | Message d'un autre agent. Pour un [coéquipier](/fr/agent-teams) en processus envoyant à `main` via `SendMessage`, `from` est le nom du coéquipier et `senderTaskId` est son ID de tâche. Pour un pair entre sessions comme un autre processus Claude Code local, `from` est l'adresse de l'expéditeur et `senderTaskId` est absent. Le champ `name` est réservé. |1476| `peer` | Message d'un autre agent. Pour un [coéquipier](/fr/agent-teams) en processus envoyant à `main` via `SendMessage`, `from` est le nom du coéquipier et `senderTaskId` est son ID de tâche. Pour un pair entre sessions comme un autre processus Claude Code local, `from` est l'adresse de l'expéditeur et `senderTaskId` est absent. {/* min-version: 2.1.205 */}}`name` et `body` nécessitent Claude Code v2.1.205 ou ultérieur. `name` est le nom d'affichage de l'expéditeur, normalisé par Claude Code : il supprime les points de code de contrôle, de format, de substitut Unicode, et de séparateur de ligne ou de paragraphe, puis tronque le résultat et le limite à 64 points de code avec des points de suspension. `body` est le corps du message décodé avec l'enveloppe de pair supprimée, octet-exact avec ce que le modèle voit. Pour un message de coéquipier, `body` est toujours présent ; pour un pair entre sessions, il est présent uniquement quand le tour est exactement une enveloppe de pair formée par Claude Code. Rendez `name` et `body` au lieu de réanalyser le texte du message. |

1435| `task-notification` | Tour synthétique injecté après la fin d'une tâche de fond. Voir [`SDKTaskNotificationMessage`](#sdktasknotificationmessage). |1477| `task-notification` | Tour synthétique injecté après la fin d'une tâche de fond. Voir [`SDKTaskNotificationMessage`](#sdktasknotificationmessage). |

1436| `coordinator` | Message d'un coordinateur d'équipe dans une [équipe d'agents](/fr/agent-teams). |1478| `coordinator` | Message d'un coordinateur d'équipe dans une [équipe d'agents](/fr/agent-teams). |

1437| `auto-continuation` | Tour synthétique injecté quand la session continue sans nouvelle entrée utilisateur, comme un résultat de commande qui déclenche une invite de suivi. |1479| `auto-continuation` | Tour synthétique injecté quand la session continue sans nouvelle entrée utilisateur, comme un résultat de commande qui déclenche une invite de suivi. |


2357 2399 

2358```typescript theme={null}2400```typescript theme={null}

2359type ExitPlanModeInput = {2401type ExitPlanModeInput = {

2402 /** Déprécié : n'est plus utilisé. */

2360 allowedPrompts?: Array<{2403 allowedPrompts?: Array<{

2361 tool: "Bash";2404 tool: "Bash";

2362 prompt: string;2405 prompt: string;


2364};2407};

2365```2408```

2366 2409 

2367Quitte le mode de planification. Spécifie éventuellement les permissions basées sur les invites nécessaires pour implémenter le plan.2410Quitte le mode de planification. Le champ `allowedPrompts` est déprécié et ignoré ; Claude Code l'accepte toujours pour que les appelants existants et les transcriptions se valident. Avant v2.1.205, il demandait des permissions Bash basées sur les invites pour implémenter le plan.

2368 2411 

2369<h3 id="listmcpresources">2412<h3 id="listmcpresources">

2370 ListMcpResources2413 ListMcpResources


2408};2451};

2409```2452```

2410 2453 

2411Crée et entre dans un worktree git temporaire pour un travail isolé. Passez `path` pour basculer dans un worktree existant du référentiel actuel au lieu d'en créer un nouveau. `name` et `path` s'excluent mutuellement.2454Crée et entre dans un worktree git temporaire pour un travail isolé. Passez `path` pour basculer dans un worktree existant au lieu d'en créer un nouveau. À la première entrée, la cible doit être un worktree enregistré du référentiel actuel ou, dans un espace de travail multi-référentiel, d'un référentiel imbriqué à l'intérieur ; depuis une session worktree, elle doit être sous `.claude/worktrees/` du référentiel de la session. `name` et `path` s'excluent mutuellement.

2412 2455 

2413<h2 id="tool-output-types">2456<h2 id="tool-output-types">

2414 Types de sortie d'outil2457 Types de sortie d'outil


3656};3699};

3657```3700```

3658 3701 

3702<h3 id="sdkbackgroundtaskschangedmessage">

3703 `SDKBackgroundTasksChangedMessage`

3704</h3>

3705 

3706Émis chaque fois que l'ensemble des tâches de fond en direct change : une tâche démarre, se termine, est tuée, ou un agent de premier plan est mis en arrière-plan. Le tableau `tasks` est l'ensemble complet en direct. Remplacez tout ensemble en cache par chaque charge utile au lieu d'associer les événements `task_started` et `task_notification`, de sorte que le prochain changement d'adhésion corrige tout événement que vous avez manqué.

3707 

3708L'ordre par rapport à ces événements par tâche n'est pas spécifié, donc ne mettez pas en corrélation les deux flux.

3709 

3710Rien n'est émis au démarrage. Réinitialisez à un ensemble vide chaque fois que le processus CLI de la session démarre ou redémarre et laissez le prochain changement d'adhésion le repeupler.

3711 

3712{/* min-version: 2.1.203 */}Nécessite Claude Code v2.1.203 ou ultérieur.

3713 

3714```typescript theme={null}

3715type SDKBackgroundTasksChangedMessage = {

3716 type: "system";

3717 subtype: "background_tasks_changed";

3718 tasks: {

3719 task_id: string;

3720 task_type: string;

3721 description: string;

3722 }[];

3723 uuid: UUID;

3724 session_id: string;

3725};

3726```

3727 

3659<h3 id="sdkfilespersistedevent">3728<h3 id="sdkfilespersistedevent">

3660 `SDKFilesPersistedEvent`3729 `SDKFilesPersistedEvent`

3661</h3>3730</h3>


3745};3814};

3746```3815```

3747 3816 

3817<h3 id="sdkconversationresetmessage">

3818 `SDKConversationResetMessage`

3819</h3>

3820 

3821Émis quand la conversation de la session est remplacée sans terminer la session, par exemple après `/clear`, à la sortie du mode plan, ou quand une nouvelle conversation démarre. Montez une transcription vide sous `new_conversation_id` et abandonnez tout titre de session en cache.

3822 

3823```typescript theme={null}

3824type SDKConversationResetMessage = {

3825 type: "conversation_reset";

3826 new_conversation_id: UUID;

3827 uuid: UUID;

3828 session_id: string;

3829};

3830```

3831 

3832{/* min-version: 2.1.203 */}Les typages publiés du SDK déclarent `SDKConversationResetMessage` dans Claude Code v2.1.203 et ultérieur. Avant v2.1.203, `SDKMessage` référençait le type sans le déclarer, donc le rétrécissement sur `type === "conversation_reset"` n'a pas pu être typé quand `skipLibCheck` était désactivé.

3833 

3748<h3 id="aborterror">3834<h3 id="aborterror">

3749 `AbortError`3835 `AbortError`

3750</h3>3836</h3>

Details

198</CodeGroup>198</CodeGroup>

199 199 

200<Note>200<Note>

201 En Python, `can_use_tool` nécessite le [mode streaming](/fr/agent-sdk/streaming-vs-single-mode) et un hook `PreToolUse` qui retourne `{"continue_": True}` pour garder le flux ouvert. Sans ce hook, le flux se ferme avant que le callback de permission puisse être invoqué.201 En Python, `can_use_tool` nécessite le [mode streaming](/fr/agent-sdk/streaming-vs-single-mode). Lorsque vous passez un flux de messages fini via `query(prompt=generator)` ou `ClaudeSDKClient.connect(prompt=async_iterable)`, le SDK ferme le flux d'entrée après le dernier message, avant que le callback de permission puisse être invoqué, sauf si un hook enregistré ou un serveur MCP en cours de processus le maintient ouvert. L'exemple ci-dessus le maintient ouvert avec un hook `PreToolUse` qui retourne `{"continue_": True}`. La connexion sans prompt et l'envoi de messages via `ClaudeSDKClient.query()` maintiennent le flux ouvert d'eux-mêmes et ne nécessitent aucun hook.

202</Note>202</Note>

203 203 

204Cet exemple utilise un flux y/n où toute entrée autre que `y` est traitée comme un refus. En pratique, vous pourriez construire une interface utilisateur plus riche qui permet aux utilisateurs de modifier la demande, de fournir des commentaires, ou de rediriger Claude entièrement. Voir [Répondre aux demandes d'outil](#respond-to-tool-requests) pour tous les moyens de répondre.204Cet exemple utilise un flux y/n où toute entrée autre que `y` est traitée comme un refus. En pratique, vous pourriez construire une interface utilisateur plus riche qui permet aux utilisateurs de modifier la demande, de fournir des commentaires, ou de rediriger Claude entièrement. Voir [Répondre aux demandes d'outil](#respond-to-tool-requests) pour tous les moyens de répondre.


6864. **Mapper les réponses** : Le code vérifie si l'entrée est numérique (utilise le label de l'option) ou du texte libre (utilise le texte directement)6864. **Mapper les réponses** : Le code vérifie si l'entrée est numérique (utilise le label de l'option) ou du texte libre (utilise le texte directement)

6875. **Retourner à Claude** : La réponse inclut à la fois le tableau `questions` original et le mapping `answers`6875. **Retourner à Claude** : La réponse inclut à la fois le tableau `questions` original et le mapping `answers`

688 688 

689Enregistrez la version TypeScript sous `ask.ts` et exécutez-la avec `npx tsx ask.ts`, ou enregistrez la version Python sous `ask.py` et exécutez-la avec `python ask.py`.

690 

689<CodeGroup>691<CodeGroup>

690 ```python Python theme={null}692 ```python Python theme={null}

691 import asyncio693 import asyncio

agent-view.md +69 −25

Details

90 90 

91```text theme={null}91```text theme={null}

92Épinglées92Épinglées

93 ✽ clawd walk cycle Write assets/sprites/clawd-walk.png 3m93 ✽ clawd walk cycle Drawing the walk-cycle sprite frames 3m

94 94 

95Prêtes pour examen95Prêtes pour examen

96 ∙ jump physics Opened PR with collision fix #2048 2h96 ∙ jump physics Opened PR with collision fix #2048 2h

97 97 

98Nécessite une intervention98Nécessite une intervention

99 ✻ power-up design needs input: double jump or wall climb? 1m99 ✻ power-up design double jump or wall climb? 1m

100 100 

101En cours101En cours

102 ✽ collision detection Edit src/physics/CollisionSystem.ts 2m102 ✽ collision detection Adding swept-AABB checks to CollisionSystem 2m

103 ✢ playtest level 3 run 12 · all checkpoints cleared in 4m103 ✢ playtest level 3 run 12 · all checkpoints cleared in 4m

104 104 

105Terminées105Terminées


131| `∙` | Le processus a quitté. Vous pouvez toujours apercevoir, répondre, ou vous attacher, et Claude redémarre à partir de là où il s'était arrêté |131| `∙` | Le processus a quitté. Vous pouvez toujours apercevoir, répondre, ou vous attacher, et Claude redémarre à partir de là où il s'était arrêté |

132| `✢` | Une session [`/loop`](/fr/scheduled-tasks) dormant entre les itérations. La ligne affiche son nombre d'exécutions et un compte à rebours |132| `✢` | Une session [`/loop`](/fr/scheduled-tasks) dormant entre les itérations. La ligne affiche son nombre d'exécutions et un compte à rebours |

133 133 

134L'étiquette `#N` qui peut apparaître au bord droit d'une ligne est la [pull request que la session a ouvert](#pull-request-status), pas une partie de l'icône d'état.134L'étiquette `#N` qui peut apparaître au bord droit d'une ligne est la [pull request que la session est liée à](#pull-request-status), pas une partie de l'icône d'état.

135 135 

136Le titre de l'onglet du terminal affiche le nombre d'entrées en attente pendant que la vue agent est ouverte : `2 awaiting input · claude agents` quand les sessions ont besoin d'une intervention, ou `claude agents` quand ce n'est pas le cas.136Le titre de l'onglet du terminal affiche le nombre d'entrées en attente pendant que la vue agent est ouverte : `2 awaiting input · claude agents` quand les sessions ont besoin d'une intervention, ou `claude agents` quand ce n'est pas le cas.

137 137 


141 141 

142L'état de la session persiste sur le disque via les mises à jour automatiques et les redémarrages du superviseur. Les sessions sont également préservées quand votre machine se met en veille. Leurs processus reprennent au réveil et le superviseur se reconnecte à eux au lieu de traiter l'écart de temps comme inactif. L'arrêt arrête toujours les sessions en cours ; consultez [Les sessions s'affichent comme échouées après l'arrêt](#sessions-show-as-failed-after-shutdown) pour savoir comment les récupérer.142L'état de la session persiste sur le disque via les mises à jour automatiques et les redémarrages du superviseur. Les sessions sont également préservées quand votre machine se met en veille. Leurs processus reprennent au réveil et le superviseur se reconnecte à eux au lieu de traiter l'écart de temps comme inactif. L'arrêt arrête toujours les sessions en cours ; consultez [Les sessions s'affichent comme échouées après l'arrêt](#sessions-show-as-failed-after-shutdown) pour savoir comment les récupérer.

143 143 

144Quand vous ouvrez une session qui a cessé de répondre, le superviseur redémarre son processus et la session continue la réponse interrompue à partir de là où elle s'était arrêtée. Une session peut se retrouver dans cet état quand la machine se met en veille pendant qu'elle est en train de répondre. Nécessite Claude Code v2.1.200 ou ultérieur.

145 

144<h3 id="row-summaries">146<h3 id="row-summaries">

145 Résumés des lignes147 Résumés des lignes

146</h3>148</h3>

147 149 

148Le résumé d'une ligne dans chaque ligne est généré par un [modèle de classe Haiku](/fr/model-config) afin que la ligne puisse vous dire ce que la session fait, ce qu'elle a besoin, ou ce qu'elle a produit sans ouvrir la transcription. Pendant qu'une session fonctionne activement, le résumé s'actualise au maximum une fois toutes les 15 secondes, plus une fois quand chaque tour se termine.150Le résumé d'une ligne dans chaque ligne est généré par un [modèle de classe Haiku](/fr/model-config) afin que la ligne puisse vous dire ce que la session fait, ce qu'elle a besoin, ou ce qu'elle a produit sans ouvrir la transcription. Pendant qu'une session fonctionne activement, le texte de la ligne se met à jour au maximum une fois toutes les 15 secondes à partir de la sortie récente de la session sans envoyer une demande de modèle, et le modèle écrit un résumé frais quand chaque tour se termine.

151 

152Une ligne de travail affiche ce que la session dit qu'elle fait, et une ligne bloquée affiche la question qu'elle pose. Pendant un long tour, le modèle réécrit également le résumé environ une fois par minute, attendant deux fois plus longtemps après chaque réécriture jusqu'à quatre minutes, donc une ligne occupée n'affiche pas continuellement un résumé obsolète. Le texte est tronqué à 64 colonnes ; ouvrez le [panneau d'aperçu](#peek-and-reply) pour lire la phrase entière. Avant la v2.1.205, une ligne de travail pouvait afficher une invocation d'outil brute au lieu d'un rapport, et une session exécutant des éléments de travail parallèles affichait un nombre `done/total` comme `2/5` avant le texte.

153 

154Quand 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 d'état par défaut, l'en-tête du groupe nomme déjà l'état, donc la ligne affiche uniquement le résumé. Avant la v2.1.205, les lignes groupées par répertoire ne portaient aucun mot d'état.

149 155 

150Quand la session exécute deux ou plusieurs éléments de travail parallèles, comme des sous-agents, des commandes shell en arrière-plan, ou des moniteurs, un nombre `done/total` comme `2/5` apparaît avant le texte du résumé.156Un tour dont la sortie entière ne contient aucune lettre ni chiffre, comme une session [`/loop`](/fr/scheduled-tasks) qui imprime un seul symbole sur une itération silencieuse, conserve le résumé et l'état précédents de la ligne. Avant la v2.1.205, ce tour a été reclassé et pouvait faire basculer une session qui attendait votre intervention vers `En cours`.

151 157 

152Chaque actualisation est une courte demande de classe Haiku via votre fournisseur normal, facturée et traitée selon les mêmes [conditions d'utilisation des données](/fr/data-usage) que la session elle-même. Sur les fournisseurs tiers tels que Bedrock, Vertex AI, Microsoft Foundry, et les passerelles personnalisées, la demande revient au modèle principal de la session quand aucun modèle Haiku n'est configuré. Définissez [`ANTHROPIC_DEFAULT_HAIKU_MODEL`](/fr/model-config#environment-variables) pour choisir le modèle pour ces résumés sur ces fournisseurs.158Le résumé de fin de tour et chaque réécriture à mi-tour sont une courte demande de classe Haiku via votre fournisseur normal, facturée et traitée selon les mêmes [conditions d'utilisation des données](/fr/data-usage) que la session elle-même. Sur les fournisseurs tiers tels que Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, et les passerelles personnalisées, la demande revient au modèle principal de la session quand aucun modèle Haiku n'est configuré. Définissez [`ANTHROPIC_DEFAULT_HAIKU_MODEL`](/fr/model-config#environment-variables) pour choisir le modèle pour ces résumés sur ces fournisseurs.

153 159 

154<h3 id="pull-request-status">160<h3 id="pull-request-status">

155 Statut de la pull request161 Statut de la pull request


157 163 

158Quand une session ouvre une pull request, une étiquette `#1234` apparaît au bord droit de la ligne, liée à la pull request dans les terminaux qui supportent les hyperliens. L'étiquette persiste quand vous envoyez un suivi à la session, donc la pull request reste visible pendant que la ligne revient à la progression en direct. Les sessions en arrière-plan qui ont isolé leurs modifications dans une worktree ouvrent elles-mêmes ces pull requests ; [Comment les modifications de fichiers sont isolées](#how-file-edits-are-isolated) couvre quand cela se produit et ce qu'une session ne fait jamais sans demander.164Quand une session ouvre une pull request, une étiquette `#1234` apparaît au bord droit de la ligne, liée à la pull request dans les terminaux qui supportent les hyperliens. L'étiquette persiste quand vous envoyez un suivi à la session, donc la pull request reste visible pendant que la ligne revient à la progression en direct. Les sessions en arrière-plan qui ont isolé leurs modifications dans une worktree ouvrent elles-mêmes ces pull requests ; [Comment les modifications de fichiers sont isolées](#how-file-edits-are-isolated) couvre quand cela se produit et ce qu'une session ne fait jamais sans demander.

159 165 

160Quand une session a ouvert plus d'une pull request, l'étiquette affiche un nombre à la place, comme `3 PRs`, colorée par la pull request ouverte qui a le plus besoin d'attention. Ouvrez le [panneau d'aperçu](#peek-and-reply) pour les voir toutes.166Une session qui travaille sur une pull request existante y est liée de la même manière. Éditer, commenter, fermer, ou marquer une pull request comme prête avec `gh` lie la pull request que la sortie de la commande elle-même nomme, donc une commande `gh` dont la sortie capturée ne nomme aucune pull request ne crée pas de lien ; `gh pr merge` est le cas courant, car il imprime son résultat uniquement sur un terminal interactif. Vérifier une pull request avec `gh pr checkout`, ou pousser vers une branche qui a une pull request ouverte, la lie en cherchant cette branche avec `gh pr view` à la place. Avant la v2.1.205, seules les pull requests que la session a créées ou vérifiées étaient liées, et une poussée en liait une uniquement quand le nom de la branche locale correspondait.

167 

168Claude Code lit la pull request à partir de la sortie complète de la commande, y compris la partie enregistrée dans un fichier quand la sortie d'une commande dépasse la limite en ligne. Avant la v2.1.205, une pull request créée dans un appel Bash dont la sortie dépassait environ 30 000 caractères n'était pas liée.

169 

170Quand une session est liée à plus d'une pull request, l'étiquette affiche un nombre à la place, comme `3 PRs`, colorée par la pull request ouverte qui a le plus besoin d'attention. Ouvrez le [panneau d'aperçu](#peek-and-reply) pour les voir toutes.

161 171 

162Le numéro de la pull request est coloré par son statut :172Le numéro de la pull request est coloré par son statut :

163 173 


174 Aperçu et réponse184 Aperçu et réponse

175</h3>185</h3>

176 186 

177Appuyez sur `Espace` sur une ligne sélectionnée pour ouvrir le panneau d'aperçu. Il affiche ce que la session a besoin de vous, sa sortie la plus récente, et toutes les pull requests qu'elle a ouvertes. La plupart du temps, c'est suffisant, et vous n'avez jamais besoin d'ouvrir la transcription complète.187Appuyez sur `Espace` sur une ligne sélectionnée pour ouvrir le panneau d'aperçu. Il s'ouvre avec la phrase d'état complète de la session, que la ligne tronque, et depuis combien de temps elle a changé, suivie de toutes les pull requests liées à la session. Pour une session qui attend votre intervention, la question exacte qu'elle pose apparaît également au-dessus de l'entrée de réponse. La plupart du temps, le panneau d'aperçu est suffisant et vous n'avez pas besoin d'ouvrir la transcription complète.

178 188 

179Quand la session exécute des éléments de travail parallèles, le panneau nomme également le plus long en cours d'exécution et depuis combien de temps il s'exécute, afin que vous puissiez voir ce que la session attend sans vous attacher.189Avant la v2.1.205, le panneau répétait la phrase d'état uniquement quand il n'avait rien d'autre à afficher et nommait l'élément de travail parallèle le plus long en cours d'exécution.

180 190 

181Tapez une réponse dans le panneau d'aperçu et appuyez sur `Entrée` pour l'envoyer à cette session. Quand la session pose une question à choix multiples, le panneau d'aperçu affiche les options et vous pouvez appuyer sur une touche numérique pour en choisir une. Pour les autres sessions bloquées, appuyez sur `Tab` pour remplir l'entrée avec une réponse suggérée que vous pouvez modifier avant d'envoyer. Préfixez une réponse avec `!` pour envoyer une commande Bash à la place.191Tapez une réponse dans le panneau d'aperçu et appuyez sur `Entrée` pour l'envoyer à cette session. Quand la session pose une question à choix multiples, le panneau d'aperçu affiche les options et vous pouvez appuyer sur une touche numérique pour en choisir une. Pour les autres sessions bloquées, appuyez sur `Tab` pour remplir l'entrée avec une réponse suggérée que vous pouvez modifier avant d'envoyer. Préfixez une réponse avec `!` pour envoyer une commande Bash à la place.

182 192 


206 216 

207Si un outil s'exécute quand vous appuyez sur `←`, Claude Code attend jusqu'à environ dix secondes pour qu'il se termine avant de mettre en arrière-plan, et la réponse continue dans la session en arrière-plan. Appuyez sur `←` à nouveau pour mettre en arrière-plan immédiatement au lieu d'attendre. Quand le travail en cours ne peut pas se transférer à la session en arrière-plan, la boîte de dialogue `Background this session?` apparaît d'abord, la même que avec [`/background`](#from-inside-a-session).217Si un outil s'exécute quand vous appuyez sur `←`, Claude Code attend jusqu'à environ dix secondes pour qu'il se termine avant de mettre en arrière-plan, et la réponse continue dans la session en arrière-plan. Appuyez sur `←` à nouveau pour mettre en arrière-plan immédiatement au lieu d'attendre. Quand le travail en cours ne peut pas se transférer à la session en arrière-plan, la boîte de dialogue `Background this session?` apparaît d'abord, la même que avec [`/background`](#from-inside-a-session).

208 218 

209La ligne est créée même à partir d'une session nouvelle sans historique de conversation, donc `` y revient. Quand cette ligne est la seule, la vue agent affiche un indice d'intégration en dessous.219La limite de dix secondes ne s'applique pas pendant que les [sous-agents](/fr/sub-agents) s'exécutent. Claude Code continue d'attendre pour que leur travail se transporte, et affiche un avis `Still backgrounding after the current tool` pendant qu'il attend ; appuyez sur `←` à nouveau pour mettre en arrière-plan sans attendre, ce qui redémarre les sous-agents depuis le début. Avant la v2.1.203, l'attente s'est terminée après dix secondes et les sous-agents en cours d'exécution ont été redémarrés depuis le début sans avertissement.

220 

221La ligne est créée même à partir d'une session nouvelle sans historique de conversation, donc `→` y revient. Avant la v2.1.203, la vue agent affichait un indice d'intégration en dessous de cette ligne quand elle était la seule.

210 222 

211Vous pouvez désactiver ce raccourci avec le paramètre `leftArrowOpensAgents` dans `/config`.223Vous pouvez désactiver ce raccourci avec le paramètre `leftArrowOpensAgents` dans `/config`.

212 224 


302* `/model` définit le [modèle de lancement](#set-the-model)314* `/model` définit le [modèle de lancement](#set-the-model)

303* {/* min-version: 2.1.198 */}À partir de la v2.1.198, `/login` ouvre la boîte de dialogue de connexion pour que vous puissiez vous connecter à nouveau sans vous attacher à une session315* {/* min-version: 2.1.198 */}À partir de la v2.1.198, `/login` ouvre la boîte de dialogue de connexion pour que vous puissiez vous connecter à nouveau sans vous attacher à une session

304 316 

305Les skills, vos propres commandes, et les built-ins qui développent les invites comme `/init` sont envoyés à une nouvelle session en arrière-plan comme leur première invite. Les autres commandes built-in affichent plutôt un indice `attach to a session to run it`.317Les skills, vos propres commandes, et les built-ins qui développent les invites comme `/init` sont envoyés à une nouvelle session en arrière-plan comme leur première invite. Les autres commandes built-in affichent plutôt un indice `attach to a session to run it`. {/* min-version: 2.1.203 */}Tout ce que vous avez tapé reste dans l'entrée à côté de l'indice pour que vous puissiez le modifier. Avant la v2.1.203, l'indice effaçait l'entrée et le texte tapé était perdu.

306 318 

307Empaqueter une tâche récurrente comme un [skill](/fr/skills) vous permet de démarrer le même workflow à partir de la vue agent à plusieurs reprises sans retaper l'invite.319Empaqueter une tâche récurrente comme un [skill](/fr/skills) vous permet de démarrer le même workflow à partir de la vue agent à plusieurs reprises sans retaper l'invite.

308 320 


315Une nouvelle session s'exécute dans le répertoire à partir duquel vous avez ouvert la vue agent. Pour cibler un répertoire différent, utilisez l'un de ceux-ci :327Une nouvelle session s'exécute dans le répertoire à partir duquel vous avez ouvert la vue agent. Pour cibler un répertoire différent, utilisez l'un de ceux-ci :

316 328 

317* Ouvrez `claude agents` dans ce répertoire.329* Ouvrez `claude agents` dans ce répertoire.

318* Ouvrez `claude agents` dans un répertoire parent et mentionnez un référentiel enfant avec `@<repo>` dans l'invite. Taper `@` liste les référentiels git un niveau en dessous du répertoire de lancement, plus tout répertoire qui a déjà une session dans la liste. Un répertoire dont le nom contient un espace n'est pas listé.330* Ouvrez `claude agents` dans un répertoire parent et mentionnez un référentiel enfant avec `@<repo>` dans l'invite. Taper `@` liste ces cibles :

331 

332 * Les référentiels Git un niveau en dessous du répertoire de lancement

333 * Les [git worktrees](/fr/worktrees) enregistrés du référentiel à partir duquel vous avez lancé qui vivent à l'intérieur de son arborescence de répertoires, comme ceux que Claude crée sous `.claude/worktrees/`, étiquetés avec leur branche extraite. Les worktrees ajoutés en dehors du référentiel, comme avec `git worktree add ../feature`, ne sont pas listés

334 * Tout répertoire qui a déjà une session dans la liste

335 

336 Un répertoire dont le nom contient un espace n'est pas listé. {/* min-version: 2.1.203 */}Avant la v2.1.203, les worktrees enregistrés n'étaient pas listés, donc lancer dans l'un d'eux signifiait exécuter `claude --bg` à partir du répertoire de ce worktree.

319* Depuis le shell, `cd` dans le répertoire et exécutez `claude --bg "<prompt>"`.337* Depuis le shell, `cd` dans le répertoire et exécutez `claude --bg "<prompt>"`.

320 338 

321Quand la vue agent est groupée par répertoire, le répertoire de la ligne en surbrillance devient la cible de lancement, vous pouvez donc faire défiler jusqu'à un groupe et lancer dedans sans retaper le chemin.339Quand la vue agent est groupée par répertoire, le répertoire de la ligne en surbrillance devient la cible de lancement, vous pouvez donc faire défiler jusqu'à un groupe et lancer dedans sans retaper le chemin.


371claude --bg --name "flaky-test-fix" "investigate the flaky SettingsChangeDetector test"389claude --bg --name "flaky-test-fix" "investigate the flaky SettingsChangeDetector test"

372```390```

373 391 

374Après avoir mis en arrière-plan, Claude affiche l'ID court de la session et les commandes pour la gérer. Quand vous passez `--name`, le nom apparaît après l'ID court :392Après avoir mis en arrière-plan, Claude affiche l'ID court de la session et les commandes pour la gérer. Quand le service qui héberge les sessions en arrière-plan n'est pas déjà en cours d'exécution, `--bg` peut d'abord afficher `Starting background service…` au-dessus de cette sortie. Quand vous passez `--name`, le nom apparaît après l'ID court :

375 393 

376```text theme={null}394```text theme={null}

377backgrounded · 7c5dcf5d · flaky-test-fix395backgrounded · 7c5dcf5d · flaky-test-fix


425 443 

426En dehors d'un référentiel git, les sessions écrivent dans le répertoire de travail directement et ne sont pas isolées les unes des autres, donc évitez de lancer des sessions parallèles qui modifient les mêmes fichiers. Si vous utilisez un système de contrôle de version différent, configurez un hook [`WorktreeCreate`](/fr/worktrees#non-git-version-control) et Claude isole les modifications de la même manière qu'il le fait pour git.444En dehors d'un référentiel git, les sessions écrivent dans le répertoire de travail directement et ne sont pas isolées les unes des autres, donc évitez de lancer des sessions parallèles qui modifient les mêmes fichiers. Si vous utilisez un système de contrôle de version différent, configurez un hook [`WorktreeCreate`](/fr/worktrees#non-git-version-control) et Claude isole les modifications de la même manière qu'il le fait pour git.

427 445 

446Quand le hook échoue dans un répertoire qui n'est pas un référentiel git, la session ignore l'isolation pour ce répertoire et modifie le répertoire de travail sur place. À l'intérieur d'un référentiel git, les écritures restent bloquées jusqu'à ce que la session s'isole. Avant la v2.1.203, une session en arrière-plan dans cet état ne pouvait modifier aucun fichier : chaque écriture était rejetée jusqu'à ce qu'elle s'isole, et le hook ne pouvait jamais isoler ce répertoire.

447 

428Supprimer une session dans la vue agent avec `Ctrl+X` deux fois supprime une worktree que Claude a créée pour elle, y compris les modifications non validées, donc fusionnez ou poussez les modifications que vous voulez conserver d'abord. Supprimer depuis le shell avec [`claude rm`](#manage-sessions-from-the-shell) conserve une worktree qui a des modifications non validées et affiche son chemin pour que vous puissiez la nettoyer vous-même. Une worktree que vous avez créée vous-même et dans laquelle vous avez démarré la session est laissée en place de toute façon.448Supprimer une session dans la vue agent avec `Ctrl+X` deux fois supprime une worktree que Claude a créée pour elle, y compris les modifications non validées, donc fusionnez ou poussez les modifications que vous voulez conserver d'abord. Supprimer depuis le shell avec [`claude rm`](#manage-sessions-from-the-shell) conserve une worktree qui a des modifications non validées et affiche son chemin pour que vous puissiez la nettoyer vous-même. Une worktree que vous avez créée vous-même et dans laquelle vous avez démarré la session est laissée en place de toute façon.

429 449 

430Pour trouver le chemin de la worktree d'une session, jetez un œil à la session ou attachez-vous et vérifiez son répertoire de travail.450Pour trouver le chemin de la worktree d'une session, jetez un œil à la session ou attachez-vous et vérifiez son répertoire de travail.


464 484 

465Une session en arrière-plan lit ses [paramètres](/fr/settings) à partir du répertoire dans lequel elle s'exécute, de la même manière que si vous aviez démarré `claude` là. Cela inclut les valeurs [`env`](/fr/settings#available-settings) dans les paramètres du projet, donc une variable `ANTHROPIC_MODEL` ou de fournisseur définie là s'applique aux sessions en arrière-plan dans ce répertoire.485Une session en arrière-plan lit ses [paramètres](/fr/settings) à partir du répertoire dans lequel elle s'exécute, de la même manière que si vous aviez démarré `claude` là. Cela inclut les valeurs [`env`](/fr/settings#available-settings) dans les paramètres du projet, donc une variable `ANTHROPIC_MODEL` ou de fournisseur définie là s'applique aux sessions en arrière-plan dans ce répertoire.

466 486 

467La sélection du fournisseur cloud, comme `CLAUDE_CODE_USE_BEDROCK` ou `CLAUDE_CODE_USE_VERTEX`, et les alias `ANTHROPIC_DEFAULT_*_MODEL` suivent le shell qui a lancé la session. Les variables de point de terminaison de passerelle comme `ANTHROPIC_BASE_URL` et son `ANTHROPIC_AUTH_TOKEN` associé ne le font pas. Voir [le processus superviseur](#the-supervisor-process) pour savoir comment les sessions en arrière-plan sourçent les paramètres du fournisseur et les identifiants.487La sélection du fournisseur cloud, comme `CLAUDE_CODE_USE_BEDROCK` ou `CLAUDE_CODE_USE_VERTEX`, et les alias `ANTHROPIC_DEFAULT_*_MODEL` suivent le shell qui a lancé la session. Une passerelle `ANTHROPIC_BASE_URL` exportée dans ce shell la suit aussi, avec `ANTHROPIC_CUSTOM_HEADERS`, quand le superviseur s'exécute avec le même environnement de passerelle et la session s'exécute dans le répertoire à partir duquel vous avez lancé ou est votre propre session mise en arrière-plan avec `` ou `/background`. C'est le cas normal quand le premier shell à ouvrir la vue agent ou lancer une session en arrière-plan est le shell de passerelle. Lancer dans un répertoire différent avec `@repo` ou `--cwd` ne porte pas la passerelle du shell ; les [paramètres](/fr/settings) de ce projet fournissent le point de terminaison. Voir [le processus superviseur](#the-supervisor-process) pour savoir comment les sessions en arrière-plan sourçent les paramètres du fournisseur et les identifiants.

468 488 

469Le [mode de permission](/fr/permissions) dépend de la façon dont vous avez démarré la session. Mettre en arrière-plan une session existante avec `/bg` ou `←` conserve le mode de permission actuel, donc une session que vous avez basculée vers `acceptEdits` ou `auto` reste dans ce mode après détachement. Lancer à partir de l'entrée de la vue agent ou exécuter `claude --bg` depuis votre shell utilise le `defaultMode` à partir des paramètres de ce répertoire, ou le `permissionMode` à partir du [frontmatter du sous-agent lancé](/fr/sub-agents#supported-frontmatter-fields).489Le [mode de permission](/fr/permissions) dépend de la façon dont vous avez démarré la session. Mettre en arrière-plan une session existante avec `/bg` ou `←` conserve le mode de permission actuel, donc une session que vous avez basculée vers `acceptEdits` ou `auto` reste dans ce mode après détachement. Lancer à partir de l'entrée de la vue agent ou exécuter `claude --bg` depuis votre shell utilise le `defaultMode` à partir des paramètres de ce répertoire, ou le `permissionMode` à partir du [frontmatter du sous-agent lancé](/fr/sub-agents#supported-frontmatter-fields).

470 490 

471Le mode de permission, le modèle et l'effort avec lesquels une session en arrière-plan a été démarrée, ainsi que les [drapeaux de configuration qu'elle porte](#from-inside-a-session), persistent tous quand le superviseur [arrête et redémarre](#the-supervisor-process) ultérieurement le processus de la session. Une session que vous avez lancée avec `claude --bg --dangerously-skip-permissions` ou `claude --bg --permission-mode bypassPermissions` reste dans `bypassPermissions` après ce redémarrage au lieu de revenir au `defaultMode` du répertoire, et un modèle ou un effort que vous avez changé en milieu de session avec `/model` ou `/effort` est conservé.491Le mode de permission, le modèle et l'effort avec lesquels une session en arrière-plan a été démarrée, ainsi que les [drapeaux de configuration qu'elle porte](#from-inside-a-session), persistent tous quand le superviseur [arrête et redémarre](#the-supervisor-process) ultérieurement le processus de la session. Une session que vous avez lancée avec `claude --bg --dangerously-skip-permissions` ou `claude --bg --permission-mode bypassPermissions` reste dans `bypassPermissions` après ce redémarrage au lieu de revenir au `defaultMode` du répertoire, et un modèle ou un effort que vous avez changé en milieu de session avec `/model` ou `/effort` est conservé.

472 492 

493Un effort que la session a pris à partir du paramètre [`effortLevel`](/fr/settings#available-settings) plutôt que de `--effort` ou `/effort` n'est pas fixé au lancement : chaque processus démarré pour la session relit le paramètre à nouveau, donc modifier `effortLevel` dans `settings.json` atteint les sessions que vous mettez en arrière-plan avec `←` ou `/bg` et leurs redémarrages ultérieurs. Avant la v2.1.203, mettre en arrière-plan une session enregistrait son effort dérivé des paramètres comme si vous aviez passé `--effort`, donc les modifications ultérieures de `effortLevel` ne l'atteignaient jamais.

494 

495Un nom que vous avez défini avec [`/rename`](/fr/commands) ou `Ctrl+R` persiste également lors de ce redémarrage, donc [`claude --resume <name>`](/fr/sessions#name-your-sessions) résout toujours la session. Avant la v2.1.202, le redémarrage revenait au nom avec lequel la session a été lancée et le nouveau nom cessait de résoudre.

496 

473Pour définir les valeurs par défaut pour chaque session que vous lancez à partir de la vue agent, passez l'un de `--permission-mode`, `--model`, `--effort`, ou `--agent` lors de son ouverture :497Pour définir les valeurs par défaut pour chaque session que vous lancez à partir de la vue agent, passez l'un de `--permission-mode`, `--model`, `--effort`, ou `--agent` lors de son ouverture :

474 498 

475```bash theme={null}499```bash theme={null}


544 568 

545Le superviseur et ses sessions s'authentifient avec les mêmes identifiants stockés que vos sessions interactives et ne font aucune connexion réseau supplémentaire au-delà de l'API du modèle. Les variables de sélection de fournisseur telles que `CLAUDE_CODE_USE_BEDROCK` et les alias `ANTHROPIC_DEFAULT_*_MODEL` sont lues depuis le shell qui a dispatché chaque session et sont appliquées à son worker.569Le superviseur et ses sessions s'authentifient avec les mêmes identifiants stockés que vos sessions interactives et ne font aucune connexion réseau supplémentaire au-delà de l'API du modèle. Les variables de sélection de fournisseur telles que `CLAUDE_CODE_USE_BEDROCK` et les alias `ANTHROPIC_DEFAULT_*_MODEL` sont lues depuis le shell qui a dispatché chaque session et sont appliquées à son worker.

546 570 

547Une session en arrière-plan n'hérite pas des variables de point de terminaison de passerelle telles que `ANTHROPIC_BASE_URL`, les variables d'URL de base Bedrock, Vertex et Foundry équivalentes, ou un `ANTHROPIC_AUTH_TOKEN` appairé depuis le shell qui a démarré le superviseur ou depuis le shell de dispatch. La session utilise vos identifiants stockés et toute valeur `env` dans le bloc [settings](/fr/settings) du répertoire du projet à la place. Pour pointer les sessions en arrière-plan dans un projet vers une [passerelle LLM](/fr/llm-gateway), définissez `ANTHROPIC_BASE_URL` dans le bloc `env` du fichier `.claude/settings.json` de ce projet plutôt que de l'exporter dans votre shell.571Le `PATH` du shell de dispatch est appliqué au worker de la même manière, donc les commandes shell que la session exécute trouvent les mêmes outils que votre terminal. Avant v2.1.203, une session en arrière-plan conservait le `PATH` du shell qui a d'abord démarré le superviseur, donc les outils ajoutés à votre `PATH` depuis pourraient manquer, le plus souvent sur Windows.

572 

573Une session en arrière-plan n'hérite pas des variables de point de terminaison de passerelle telles que `ANTHROPIC_BASE_URL` ou les variables d'URL de base équivalentes pour Amazon Bedrock, Google Cloud's Agent Platform, et Microsoft Foundry depuis le shell qui a démarré le superviseur. Sans une passerelle exportée dans le shell à partir duquel vous dispatchez, la session utilise vos identifiants stockés et toute valeur `env` dans le bloc [settings](/fr/settings) du répertoire du projet. Pour pointer chaque session dans un projet vers une [passerelle LLM](/fr/llm-gateway), définissez `ANTHROPIC_BASE_URL` dans le bloc `env` du fichier `.claude/settings.json` de ce projet.

574 

575{/* min-version: 2.1.203 */}Une passerelle `ANTHROPIC_BASE_URL` exportée dans le shell à partir duquel vous dispatchez atteint le worker de cette session, ainsi que `ANTHROPIC_CUSTOM_HEADERS` et l'identifiant exporté à côté, quand le superviseur a été démarré à partir d'un environnement avec la même passerelle. Le superviseur capture son environnement depuis le premier shell qui ouvre la vue agent ou dispatch une session en arrière-plan, donc démarrer à partir du shell de passerelle lui donne cet environnement. La transmission s'applique également uniquement aux sessions dispatched dans le répertoire à partir duquel vous dispatchez, ou mises en arrière-plan à partir de votre propre session avec `←` ou `/background` : dispatcher dans un répertoire différent avec `@repo` ou `--cwd` ne porte pas la passerelle du shell, et le bloc `env` du `settings.json` de ce projet fournit le point de terminaison à la place. Quand l'environnement du superviseur porte une passerelle différente ou aucune, le worker conserve vos identifiants stockés contre le point de terminaison par défaut au lieu de mélanger l'identifiant d'un environnement avec le point de terminaison d'un autre. Avant v2.1.203, le `ANTHROPIC_BASE_URL` du shell de dispatch était supprimé tandis que le `ANTHROPIC_API_KEY` exporté à côté était conservé, donc la clé de la passerelle était envoyée au point de terminaison par défaut et chaque requête échouait avec un 401.

576 

577Le point de terminaison transmis s'applique uniquement à ce processus actif et n'est jamais écrit sur le disque. Quand le superviseur arrête une session inactive et la redémarre plus tard, le processus redémarré lit son point de terminaison à partir de vos paramètres à nouveau : avec un `ANTHROPIC_AUTH_TOKEN` de passerelle, il revient à vos identifiants stockés, et avec un `ANTHROPIC_API_KEY` émis par la passerelle, il peut échouer à s'authentifier jusqu'à ce que la passerelle soit définie dans les paramètres.

548 578 

549Chaque session en arrière-plan est son propre processus Claude Code, géré par le superviseur plutôt que lié à votre terminal. Une session qui fonctionne activement, attend votre entrée, ou a un terminal attaché garde son processus en cours d'exécution. Une commande shell en arrière-plan en cours d'exécution, un sous-agent, un workflow dynamique, ou un monitor compte comme un travail actif, donc un processus de longue durée tel qu'un serveur de développement maintient la session active.579Chaque session en arrière-plan est son propre processus Claude Code, géré par le superviseur plutôt que lié à votre terminal. Une session qui fonctionne activement, attend votre entrée, ou a un terminal attaché garde son processus en cours d'exécution. Une commande shell en arrière-plan en cours d'exécution, un sous-agent, un workflow dynamique, ou un monitor compte comme un travail actif, donc un processus de longue durée tel qu'un serveur de développement maintient la session active.

550 580 


570 600 

571Le superviseur regarde le binaire Claude Code installé sur le disque et redémarre dans la nouvelle version après que l'[auto-updater](/fr/setup#auto-updates) régulier le remplace. C'est une montre de fichier local, pas une vérification réseau. Les sessions en arrière-plan sont des processus détachés, donc elles continuent de s'exécuter pendant le redémarrage et le nouveau superviseur se reconnecte à elles. Une session épinglée inactive est également redémarrée sur place dans la nouvelle version pour qu'elle récupère la mise à jour sans que vous vous réattachiez.601Le superviseur regarde le binaire Claude Code installé sur le disque et redémarre dans la nouvelle version après que l'[auto-updater](/fr/setup#auto-updates) régulier le remplace. C'est une montre de fichier local, pas une vérification réseau. Les sessions en arrière-plan sont des processus détachés, donc elles continuent de s'exécuter pendant le redémarrage et le nouveau superviseur se reconnecte à elles. Une session épinglée inactive est également redémarrée sur place dans la nouvelle version pour qu'elle récupère la mise à jour sans que vous vous réattachiez.

572 602 

603L'exécution de `claude attach` tandis que le superviseur redémarre une session, que ce soit pour une mise à jour, une stagnation, ou une migration, attend le processus de remplacement au lieu d'échouer. Une ligne d'état telle que `Agent is updating to the new Claude Code…` nomme ce qu'il attend et compte les secondes écoulées, et la commande se connecte dès que la session est prête. Après environ 60 secondes, elle arrête d'attendre et signale une erreur. Avant v2.1.205, `claude attach` arrêtait de réessayer après quelques secondes et imprimait une erreur tandis que la session était encore en cours de redémarrage.

604 

573<h3 id="where-state-is-stored">605<h3 id="where-state-is-stored">

574 Où l'état est stocké606 Où l'état est stocké

575</h3>607</h3>


585 617 

586Chaque session en arrière-plan a la variable d'environnement `CLAUDE_JOB_DIR` définie à son répertoire `~/.claude/jobs/<id>`, donc les commandes shell que la session exécute peuvent écrire des fichiers temporaires à `$CLAUDE_JOB_DIR/tmp` sans entrer en collision avec les sessions parallèles.618Chaque session en arrière-plan a la variable d'environnement `CLAUDE_JOB_DIR` définie à son répertoire `~/.claude/jobs/<id>`, donc les commandes shell que la session exécute peuvent écrire des fichiers temporaires à `$CLAUDE_JOB_DIR/tmp` sans entrer en collision avec les sessions parallèles.

587 619 

588Pour inspecter cet état sans lire les fichiers directement, exécutez `claude daemon status`. Il rapporte si le superviseur est accessible, son ID de processus et sa version, le répertoire socket, et combien de sessions en arrière-plan sont actives. `/doctor` inclut un résumé de la même vérification.620Pour inspecter cet état sans lire les fichiers directement, exécutez `claude daemon status`. Il rapporte si le superviseur est accessible, son ID de processus et sa version, le répertoire socket, et combien de sessions en arrière-plan sont actives.

589 621 

590La commande avertit également quand le superviseur en cours d'exécution est sur une version différente de celle du `claude` que vous avez invoqué, ce qui se produit après une mise à jour que le superviseur n'a pas encore redémarrée. L'avertissement affiche les deux versions et vous dit d'exécuter `claude daemon stop --any` pour récupérer la nouvelle version. Quand Claude Code est installé en tant que service du système d'exploitation, la commande suggérée est `claude daemon stop` sans le drapeau.622La commande avertit également quand le superviseur en cours d'exécution est sur une version différente de celle du `claude` que vous avez invoqué, ce qui se produit après une mise à jour que le superviseur n'a pas encore redémarrée. L'avertissement affiche les deux versions et vous dit d'exécuter `claude daemon stop --any` pour récupérer la nouvelle version. Quand Claude Code est installé en tant que service du système d'exploitation, la commande suggérée est `claude daemon stop` sans le drapeau.

591 623 

592Les sessions survivent à ce décalage de version intact : une version plus ancienne de Claude Code qui met à jour le `state.json` d'une session préserve les champs qu'elle ne reconnaît pas et garde la session listée.624Les sessions survivent à ce décalage de version intact : une version plus ancienne de Claude Code qui met à jour le `state.json` d'une session préserve les champs qu'elle ne reconnaît pas et garde la session listée. {/* min-version: 2.1.200 */}La liste des sessions dans `roster.json` suit la même règle : une version plus ancienne qui la réécrit préserve les champs qu'une version plus récente a écrit, donc les sessions démarrées par la version plus récente restent accessibles et continuent d'accepter l'entrée après le redémarrage du superviseur. Avant v2.1.200, les versions plus anciennes pouvaient supprimer ces champs lors de la réécriture.

593 625 

594Sur Windows, `claude daemon status` affiche l'erreur de fichier sous-jacente quand le fichier de clé pipe du daemon est verrouillé ou illisible au lieu de signaler un échec de connexion générique.626Sur Windows, `claude daemon status` affiche l'erreur de fichier sous-jacente quand le fichier de clé pipe du daemon est verrouillé ou illisible au lieu de signaler un échec de connexion générique.

595 627 


615 La vue agent s'ouvre sans sessions647 La vue agent s'ouvre sans sessions

616</h3>648</h3>

617 649 

618Avant de lancer votre première session, la vue agent affiche un court indice d'intégration avec des invites d'exemple à la place de la liste des sessions. Tapez une invite dans l'entrée en bas et appuyez sur `Entrée` pour lancer votre première session.650Avant de lancer votre première session, la vue agent affiche les en-têtes de section vides avec une description sous chacun, plus une explication d'une ligne au-dessus de l'entrée, à la place de la liste des sessions. Tapez une invite dans l'entrée en bas et appuyez sur `Entrée` pour lancer votre première session.

619 651 

620<h3 id="backgrounding-shows-a-background-this-session-dialog">652<h3 id="backgrounding-shows-a-background-this-session-dialog">

621 Impossible de mettre en arrière-plan la session car du travail s'exécute653 Mise en arrière-plan affiche une boîte de dialogue `Background this session?`

622</h3>654</h3>

623 655 

624Si appuyer sur `←` pour mettre la session actuelle en arrière-plan affiche une boîte de dialogue `Background this session?`, la session a du travail en cours qui ne peut pas se transférer à la session en arrière-plan, comme un [monitor](/fr/tools-reference#monitor-tool) en cours d'exécution, et Claude Code ne l'arrêtera pas silencieusement. La boîte de dialogue nomme le travail qui sera arrêté et, séparément, compte les tâches qui se transfèrent. Exécutez `/tasks` pour voir tout ce qui s'exécute, puis confirmez pour mettre en arrière-plan de toute façon ou choisissez `Stay` pour laisser le travail se terminer d'abord. Voir [À partir d'une session](#from-inside-a-session) pour savoir quels types de tâches se transfèrent et lesquels s'arrêtent.656Si appuyer sur `←` pour mettre la session actuelle en arrière-plan affiche une boîte de dialogue `Background this session?`, la session a du travail en cours qui ne peut pas se transférer à la session en arrière-plan, comme un [monitor](/fr/tools-reference#monitor-tool) en cours d'exécution, et Claude Code ne l'arrêtera pas silencieusement. La boîte de dialogue nomme le travail qui sera arrêté et, séparément, compte les tâches qui se transfèrent. Exécutez `/tasks` pour voir tout ce qui s'exécute, puis confirmez pour mettre en arrière-plan de toute façon ou choisissez `Stay` pour laisser le travail se terminer d'abord. Voir [À partir d'une session](#from-inside-a-session) pour savoir quels types de tâches se transfèrent et lesquels s'arrêtent.


637 669 

638La mise en veille seule ne cause pas cela. Les sessions sont préservées lors de la mise en veille et le superviseur se reconnecte à elles au réveil.670La mise en veille seule ne cause pas cela. Les sessions sont préservées lors de la mise en veille et le superviseur se reconnecte à elles au réveil.

639 671 

672<h3 id="opening-a-session-says-the-conversation-is-already-open">

673 Ouverture d'une session indique que la conversation est déjà ouverte

674</h3>

675 

676L'ouverture d'une ligne arrêtée dont la conversation est également maintenue ouverte par un autre processus Claude Code non interactif en cours d'exécution, par exemple un worker en arrière-plan pour la même conversation qui se termine toujours, affiche `This conversation is already open in another running Claude session` au lieu de démarrer le processus de la ligne, car deux processus ne peuvent pas écrire à la même transcription. Répondez dans la session qui a déjà la conversation ouverte, ou quittez-la et ouvrez la ligne à nouveau. Une réponse que vous avez tapée avec la tentative refusée n'est pas perdue ; elle est envoyée la prochaine fois que la session démarre.

677 

678Avant la v2.1.203, cet état démarrait un deuxième processus de toute façon. Ce processus s'est terminé avec une erreur `currently running as a background agent` et la ligne s'est affichée comme échouée.

679 

640<h3 id="a-session-fails-before-starting-with-a-possibly-low-memory-note">680<h3 id="a-session-fails-before-starting-with-a-possibly-low-memory-note">

641 Une session échoue avant de démarrer avec une note « possibly low memory »681 Une session échoue avant de démarrer avec une note « possibly low memory »

642</h3>682</h3>


730La vue agent a évolué rapidement pendant l'aperçu de recherche. Si vous êtes sur une version plus ancienne de Claude Code, certains comportements sur cette page peuvent différer ; en particulier, `claude agents` rejette les drapeaux qu'il ne supporte pas encore avec une erreur `unknown option`. Le tableau ci-dessous répertorie quand chaque drapeau et comportement a été ajouté.770La vue agent a évolué rapidement pendant l'aperçu de recherche. Si vous êtes sur une version plus ancienne de Claude Code, certains comportements sur cette page peuvent différer ; en particulier, `claude agents` rejette les drapeaux qu'il ne supporte pas encore avec une erreur `unknown option`. Le tableau ci-dessous répertorie quand chaque drapeau et comportement a été ajouté.

731 771 

732| Version | Changement |772| Version | Changement |

733| -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |773| -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

774| v2.1.205 | {/* min-version: 2.1.205 */}Les résumés des lignes affichent le rapport d'une ligne de la session elle-même, tronqué à 64 colonnes, au lieu d'une invocation d'outil brute ou d'un nombre `done/total` ; les lignes groupées par répertoire s'ouvrent avec un mot d'état coloré. Le panneau d'aperçu s'ouvre avec la phrase de statut complète et, pour une session vous attendant, sa question exacte au-dessus de l'entrée de réponse. Les sessions qui modifient, commentent, ferment ou marquent une demande de tirage comme prête avec `gh` y sont liées, pas seulement celles qui créent ou extraient une demande de tirage, une poussée lie une demande de tirage même quand le nom de la branche locale ne correspond pas, et une demande de tirage dont la sortie de la commande de création a dépassé la limite en ligne est également liée. Un tour sans texte lisible conserve l'état précédent de la session au lieu de le basculer vers `Working`. `claude attach` attend jusqu'à environ 60 secondes une session qui redémarre, avec une ligne de statut nommant pourquoi, au lieu d'échouer. |

775| v2.1.203 | {/* min-version: 2.1.203 */}Une passerelle `ANTHROPIC_BASE_URL` exportée dans le shell de dispatching atteint les sessions dispatchées à partir de celui-ci dans ce même répertoire quand le superviseur partage cet environnement de passerelle, au lieu d'être supprimée tandis que la clé API exportée à côté d'elle était conservée. Le `PATH` du shell de dispatching est appliqué à chaque worker de session. Appuyer sur `←` tandis que les sous-agents s'exécutent les attend au lieu de les redémarrer après dix secondes. La liste vide affiche toujours les en-têtes de section avec une description sous chacun. Taper `@` dans l'entrée de dispatch répertorie également les worktrees git enregistrés du référentiel de lancement qui vivent dans son arborescence de répertoires. Un effort hérité du paramètre `effortLevel` suit les modifications ultérieures de ce paramètre au lieu d'être fixé au dispatching. L'ouverture d'une session arrêtée dont la conversation est déjà ouverte dans une autre session en cours d'exécution est refusée avec un message au lieu d'échouer la ligne. Une commande qui n'est pas disponible dans la vue agent laisse le texte tapé dans l'entrée. Un hook `WorktreeCreate` qui échoue en dehors d'un référentiel git ne bloque plus la session de modifier les fichiers. |

776| v2.1.202 | {/* min-version: 2.1.202 */}Un nom défini avec `/rename` ou `Ctrl+R` sur une session en arrière-plan persiste quand le superviseur arrête et redémarre son processus, au lieu de revenir au nom avec lequel la session a été dispatchée. |

777| v2.1.200 | {/* min-version: 2.1.200 */}Une version plus ancienne de Claude Code qui réécrit la liste de sessions dans `roster.json` préserve les champs écrits par une version plus récente, correspondant à la garantie `state.json` existante, de sorte que les sessions démarrées par la version plus récente continuent d'accepter l'entrée après le redémarrage du superviseur. Quand vous ouvrez une session qui a cessé de répondre, le superviseur redémarre son processus et la session continue la réponse interrompue à partir de là où elle s'était arrêtée. |

734| v2.1.199 | {/* min-version: 2.1.199 */}Une session en arrière-plan dont le processus se termine avant de finir de démarrer sur un hôte à faible mémoire affiche `possibly low memory — free some up and retry` dans le statut de sa ligne au lieu de seulement la raison de sortie brute. Mettre en arrière-plan une session avec `←` ou `/background` transfère son `/color` vers la nouvelle ligne. |778| v2.1.199 | {/* min-version: 2.1.199 */}Une session en arrière-plan dont le processus se termine avant de finir de démarrer sur un hôte à faible mémoire affiche `possibly low memory — free some up and retry` dans le statut de sa ligne au lieu de seulement la raison de sortie brute. Mettre en arrière-plan une session avec `←` ou `/background` transfère son `/color` vers la nouvelle ligne. |

735| v2.1.198 | {/* min-version: 2.1.198 */}La vue agent envoie une notification via `preferredNotifChannel` quand une session en arrière-plan a besoin d'une entrée, se termine ou échoue, et déclenche le hook `Notification` avec le type `agent_needs_input` ou `agent_completed`. `←` et `/exit` à l'intérieur de `claude attach <id>` reviennent à la vue agent au lieu de quitter vers le shell ; `Ctrl+Z` revient au shell. Une session en arrière-plan qui a isolé son travail dans un worktree valide, pousse sa propre branche isolée, jamais `main` ou `master`, et ouvre une demande de tirage en brouillon quand elle se termine au lieu de demander d'abord. `/login` s'exécute dans la vue agent et ouvre la boîte de dialogue de connexion. La boîte de dialogue de sortie `Background work is running` propose `Move to background and exit`. Le transfert de sortie couvre également les sous-agents en arrière-plan, qui reprennent à partir de leur transcription à la prochaine activation au lieu d'être signalés comme échoués. `claude --bg` combiné avec `-p` ou `--print` est rejeté avec une erreur. |779| v2.1.198 | {/* min-version: 2.1.198 */}La vue agent envoie une notification via `preferredNotifChannel` quand une session en arrière-plan a besoin d'une entrée, se termine ou échoue, et déclenche le hook `Notification` avec le type `agent_needs_input` ou `agent_completed`. `←` et `/exit` à l'intérieur de `claude attach <id>` reviennent à la vue agent au lieu de quitter vers le shell ; `Ctrl+Z` revient au shell. Une session en arrière-plan qui a isolé son travail dans un worktree valide, pousse sa propre branche isolée, jamais `main` ou `master`, et ouvre une demande de tirage en brouillon quand elle se termine au lieu de demander d'abord. `/login` s'exécute dans la vue agent et ouvre la boîte de dialogue de connexion. La boîte de dialogue de sortie `Background work is running` propose `Move to background and exit`. Le transfert de sortie couvre également les sous-agents en arrière-plan, qui reprennent à partir de leur transcription à la prochaine activation au lieu d'être signalés comme échoués. `claude --bg` combiné avec `-p` ou `--print` est rejeté avec une erreur. |

736| v2.1.196 | {/* min-version: 2.1.196 */}Une seule pression sur `←` met en arrière-plan une session au premier plan ; les versions antérieures nécessitaient deux pressions, avec un indice de pied de page et une confirmation. `--dangerously-skip-permissions` passé à `claude agents` affiche la clause de non-responsabilité du contournement au lieu d'être silencieusement supprimé. Les sessions interactives que vous n'avez jamais nommées portent un nom par défaut comme `my-app-3f` dans les listes de sessions et `claude agents --json`. Les commandes shell en arrière-plan et les workflows dynamiques survivent à l'arrêt, au redémarrage ou à la mise à jour du processus de la session, y compris sur Windows ; définissez `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF=1` pour désactiver le transfert. Une transcription mal lue comme vide au redémarrage est renommée avec un suffixe `.orphaned-` au lieu d'être supprimée. |780| v2.1.196 | {/* min-version: 2.1.196 */}Une seule pression sur `←` met en arrière-plan une session au premier plan ; les versions antérieures nécessitaient deux pressions, avec un indice de pied de page et une confirmation. `--dangerously-skip-permissions` passé à `claude agents` affiche la clause de non-responsabilité du contournement au lieu d'être silencieusement supprimé. Les sessions interactives que vous n'avez jamais nommées portent un nom par défaut comme `my-app-3f` dans les listes de sessions et `claude agents --json`. Les commandes shell en arrière-plan et les workflows dynamiques survivent à l'arrêt, au redémarrage ou à la mise à jour du processus de la session, y compris sur Windows ; définissez `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF=1` pour désactiver le transfert. Une transcription mal lue comme vide au redémarrage est renommée avec un suffixe `.orphaned-` au lieu d'être supprimée. |

737| v2.1.195 | {/* min-version: 2.1.195 */}Le travail en cours se transfère aussi quand vous mettez en arrière-plan une session sur Windows ; définissez `CLAUDE_DISABLE_ADOPT=1` pour l'arrêter à la place. Le groupe `Completed` remplit l'espace vertical restant et l'en-tête se compacte sur les terminaux courts. Une version plus ancienne de Claude Code ne supprime plus les champs `state.json` plus récents des sessions ou ne cache plus ces sessions de `claude agents`. S'attacher à une session arrêtée bascule immédiatement au lieu d'afficher un écran vide pendant jusqu'à cinq secondes. Un superviseur qui ne peut pas accepter les connexions quitte et libère son verrou de lui-même. |781| v2.1.195 | {/* min-version: 2.1.195 */}Le travail en cours se transfère aussi quand vous mettez en arrière-plan une session sur Windows ; définissez `CLAUDE_DISABLE_ADOPT=1` pour l'arrêter à la place. Le groupe `Completed` remplit l'espace vertical restant et l'en-tête se compacte sur les terminaux courts. Une version plus ancienne de Claude Code ne supprime plus les champs `state.json` plus récents des sessions ou ne cache plus ces sessions de `claude agents`. S'attacher à une session arrêtée bascule immédiatement au lieu d'afficher un écran vide pendant jusqu'à cinq secondes. Un superviseur qui ne peut pas accepter les connexions quitte et libère son verrou de lui-même. |

738| v2.1.174 | {/* min-version: 2.1.174 */}Les sessions en arrière-plan n'héritent plus des variables de point de terminaison de passerelle comme `ANTHROPIC_BASE_URL` du shell de lancement du superviseur ; le superviseur fournit un nouvel instantané d'identifiants aux workers préchauffés, corrigeant les erreurs `Could not resolve authentication method` spurieuses. |782| v2.1.174 | {/* min-version: 2.1.174 */}Les sessions en arrière-plan n'héritent plus des variables de point de terminaison de passerelle comme `ANTHROPIC_BASE_URL` du shell de lancement du superviseur ; le superviseur fournit un nouvel instantané d'identifiants aux workers préchauffés, corrigeant les erreurs `Could not resolve authentication method` spurieuses. |

739| v2.1.172 | {/* min-version: 2.1.172 */}\`\`/model\` dans l'entrée de dispatch définit un remplacement du modèle de dispatch limité à la session. |783| v2.1.172 | {/* min-version: 2.1.172 */}`/model` dans l'entrée de dispatch définit un remplacement du modèle de dispatch limité à la session. |

740| v2.1.161 | {/* min-version: 2.1.161 */}Les résumés des lignes affichent un nombre `done/total` pour les éléments de travail parallèles ; le panneau d'aperçu nomme l'élément de travail parallèle le plus long en cours d'exécution. |784| v2.1.161 | {/* min-version: 2.1.161 */}Les résumés des lignes affichent un nombre `done/total` pour les éléments de travail parallèles ; le panneau d'aperçu nomme l'élément de travail parallèle le plus long en cours d'exécution. |

741| v2.1.157 | {/* min-version: 2.1.157 */}\`\`claude agents`accepte`--agent`; les sessions dispatchées honorent le paramètre`agent\`. |785| v2.1.157 | {/* min-version: 2.1.157 */}`claude agents` accepte `--agent` ; les sessions dispatchées honorent le paramètre `agent`. |

742| v2.1.145 | {/* min-version: 2.1.145 */}La dictée vocale supportée dans l'entrée de réponse du panneau d'aperçu et l'entrée de dispatch. |786| v2.1.145 | {/* min-version: 2.1.145 */}La dictée vocale supportée dans l'entrée de réponse du panneau d'aperçu et l'entrée de dispatch. |

743| v2.1.143 | {/* min-version: 2.1.143 */}Le paramètre `worktree.bgIsolation` ajouté ; `claude agents` accepte `--allow-dangerously-skip-permissions`. |787| v2.1.143 | {/* min-version: 2.1.143 */}Le paramètre `worktree.bgIsolation` ajouté ; `claude agents` accepte `--allow-dangerously-skip-permissions`. |

744| v2.1.142 | {/* min-version: 2.1.142 */}\`\`claude agents`accepte`--permission-mode`, `--model`, `--effort`, `--dangerously-skip-permissions`, `--settings`, `--add-dir`, `--plugin-dir`, `--mcp-config`, et `--strict-mcp-config\`. |788| v2.1.142 | {/* min-version: 2.1.142 */}`claude agents` accepte `--permission-mode`, `--model`, `--effort`, `--dangerously-skip-permissions`, `--settings`, `--add-dir`, `--plugin-dir`, `--mcp-config`, et `--strict-mcp-config`. |

745| v2.1.141 | {/* min-version: 2.1.141 */}\`\`claude agents`accepte`--cwd\` pour limiter la liste à un projet. |789| v2.1.141 | {/* min-version: 2.1.141 */}`claude agents` accepte `--cwd` pour limiter la liste à un projet. |

746| v2.1.139 | {/* min-version: 2.1.139 */}La vue agent introduite comme un aperçu de recherche. |790| v2.1.139 | {/* min-version: 2.1.139 */}La vue agent introduite comme un aperçu de recherche. |

amazon-bedrock.md +28 −28

Details

82 Prérequis82 Prérequis

83</h2>83</h2>

84 84 

85Avant de configurer Claude Code avec Bedrock, assurez-vous que vous disposez de :85Avant de configurer Claude Code avec Amazon Bedrock, assurez-vous que vous disposez de :

86 86 

87* Un compte AWS avec accès à Bedrock activé87* Un compte AWS avec accès à Amazon Bedrock activé

88* Accès aux modèles Claude souhaités (par exemple, Claude Sonnet 4.6) dans Bedrock88* Accès aux modèles Claude souhaités (par exemple, Claude Sonnet 4.6) dans Amazon Bedrock

89* AWS CLI installé et configuré (facultatif - nécessaire uniquement si vous n'avez pas d'autre mécanisme pour obtenir les identifiants)89* AWS CLI installé et configuré (facultatif - nécessaire uniquement si vous n'avez pas d'autre mécanisme pour obtenir les identifiants)

90* Autorisations IAM appropriées90* Autorisations IAM appropriées

91 91 

92Pour vous connecter avec vos propres identifiants Bedrock, suivez [Se connecter avec Bedrock](#sign-in-with-bedrock) ci-dessous. Pour déployer Claude Code dans une équipe, utilisez les étapes de [configuration manuelle](#set-up-manually) et [épinglez vos versions de modèle](#4-pin-model-versions) avant le déploiement.92Pour vous connecter avec vos propres identifiants Amazon Bedrock, suivez [Se connecter avec Amazon Bedrock](#sign-in-with-bedrock) ci-dessous. Pour déployer Claude Code dans une équipe, utilisez les étapes de [configuration manuelle](#set-up-manually) et [épinglez vos versions de modèle](#4-pin-model-versions) avant le déploiement.

93 93 

94<h2 id="sign-in-with-bedrock">94<h2 id="sign-in-with-bedrock">

95 Se connecter avec Bedrock95 Se connecter avec Bedrock

96</h2>96</h2>

97 97 

98Si vous disposez d'identifiants AWS et souhaitez commencer à utiliser Claude Code via Bedrock, l'assistant de connexion vous guide à travers le processus. Vous complétez les prérequis côté AWS une fois par compte ; l'assistant gère le côté Claude Code.98Si vous disposez d'identifiants AWS et souhaitez commencer à utiliser Claude Code via Amazon Bedrock, l'assistant de connexion vous guide à travers le processus. Vous complétez les prérequis côté AWS une fois par compte ; l'assistant gère le côté Claude Code.

99 99 

100<Steps>100<Steps>

101 <Step title="Activer les modèles Anthropic dans votre compte AWS">101 <Step title="Activer les modèles Anthropic dans votre compte AWS">

102 Dans la [console Amazon Bedrock](https://console.aws.amazon.com/bedrock/), ouvrez le catalogue de modèles, sélectionnez un modèle Anthropic et soumettez le formulaire de cas d'usage. L'accès est accordé immédiatement après la soumission. Voir [Soumettre les détails du cas d'usage](#1-submit-use-case-details) pour AWS Organizations et [Configuration IAM](#iam-configuration) pour les autorisations dont votre rôle a besoin.102 Dans la [console Amazon Bedrock](https://console.aws.amazon.com/bedrock/), ouvrez le catalogue de modèles, sélectionnez un modèle Anthropic et soumettez le formulaire de cas d'usage. L'accès est accordé immédiatement après la soumission. Voir [Soumettre les détails du cas d'usage](#1-submit-use-case-details) pour AWS Organizations et [Configuration IAM](#iam-configuration) pour les autorisations dont votre rôle a besoin.

103 </Step>103 </Step>

104 104 

105 <Step title="Démarrer Claude Code et choisir Bedrock">105 <Step title="Démarrer Claude Code et choisir Amazon Bedrock">

106 Exécutez `claude`. À l'invite de connexion, sélectionnez **3rd-party platform**, puis **Amazon Bedrock**.106 Exécutez `claude`. À l'invite de connexion, sélectionnez **3rd-party platform**, puis **Amazon Bedrock**.

107 </Step>107 </Step>

108 108 

109 <Step title="Suivre les invites de l'assistant">109 <Step title="Suivre les invites de l'assistant">

110 Choisissez comment vous vous authentifiez auprès d'AWS : un profil AWS détecté à partir de votre répertoire `~/.aws`, une clé API Bedrock, une clé d'accès et un secret, ou des identifiants déjà dans votre environnement. L'assistant récupère votre région, vérifie quels modèles Claude votre compte peut invoquer, et vous permet de les épingler. Il enregistre le résultat dans le bloc `env` de votre [fichier de paramètres utilisateur](/fr/settings), vous n'avez donc pas besoin d'exporter les variables d'environnement vous-même.110 Choisissez comment vous vous authentifiez auprès d'AWS : un profil AWS détecté à partir de votre répertoire `~/.aws`, une clé API Amazon Bedrock, une clé d'accès et un secret, ou des identifiants déjà dans votre environnement. L'assistant récupère votre région, vérifie quels modèles Claude votre compte peut invoquer, et vous permet de les épingler. Il enregistre le résultat dans le bloc `env` de votre [fichier de paramètres utilisateur](/fr/settings), vous n'avez donc pas besoin d'exporter les variables d'environnement vous-même.

111 </Step>111 </Step>

112</Steps>112</Steps>

113 113 


117 Configuration manuelle117 Configuration manuelle

118</h2>118</h2>

119 119 

120Pour configurer Bedrock via des variables d'environnement au lieu de l'assistant, par exemple dans CI ou un déploiement d'entreprise scriptés, suivez les étapes ci-dessous.120Pour configurer Amazon Bedrock via des variables d'environnement au lieu de l'assistant, par exemple dans CI ou un déploiement d'entreprise scriptés, suivez les étapes ci-dessous.

121 121 

122<h3 id="1-submit-use-case-details">122<h3 id="1-submit-use-case-details">

123 1. Soumettre les détails du cas d'usage123 1. Soumettre les détails du cas d'usage


168 168 

169[En savoir plus](https://docs.aws.amazon.com/signin/latest/userguide/command-line-sign-in.html) sur `aws login`.169[En savoir plus](https://docs.aws.amazon.com/signin/latest/userguide/command-line-sign-in.html) sur `aws login`.

170 170 

171**Option E : Clés API Bedrock**171**Option E : Clés API Amazon Bedrock**

172 172 

173```bash theme={null}173```bash theme={null}

174export AWS_BEARER_TOKEN_BEDROCK=your-bedrock-api-key174export AWS_BEARER_TOKEN_BEDROCK=your-bedrock-api-key

175```175```

176 176 

177Les clés API Bedrock offrent une méthode d'authentification plus simple sans avoir besoin d'identifiants AWS complets. [En savoir plus sur les clés API Bedrock](https://aws.amazon.com/blogs/machine-learning/accelerate-ai-development-with-amazon-bedrock-api-keys/).177Les clés API Amazon Bedrock offrent une méthode d'authentification plus simple sans avoir besoin d'identifiants AWS complets. [En savoir plus sur les clés API Amazon Bedrock](https://aws.amazon.com/blogs/machine-learning/accelerate-ai-development-with-amazon-bedrock-api-keys/).

178 178 

179<h4 id="advanced-credential-configuration">179<h4 id="advanced-credential-configuration">

180 Configuration avancée des identifiants180 Configuration avancée des identifiants


185Ces deux paramètres ont des conditions de déclenchement différentes :185Ces deux paramètres ont des conditions de déclenchement différentes :

186 186 

187* **`awsAuthRefresh`** : s'exécute uniquement lorsque Claude Code détecte que vos identifiants AWS ont expiré, soit localement en fonction de leur horodatage, soit lorsque l'API retourne une erreur d'identifiants, puis réessaye la demande avec des identifiants actualisés.187* **`awsAuthRefresh`** : s'exécute uniquement lorsque Claude Code détecte que vos identifiants AWS ont expiré, soit localement en fonction de leur horodatage, soit lorsque l'API retourne une erreur d'identifiants, puis réessaye la demande avec des identifiants actualisés.

188* **`awsCredentialExport`** : s'exécute au démarrage de la session et à chaque rechargement des identifiants, même lorsque les identifiants de votre chaîne de fournisseurs d'identifiants AWS par défaut sont toujours valides. Utilisez ceci lorsque votre compte Bedrock nécessite des identifiants inter-comptes qui diffèrent de ceux que la chaîne de fournisseurs par défaut résoudrait.188* **`awsCredentialExport`** : s'exécute au démarrage de la session et à chaque rechargement des identifiants, même lorsque les identifiants de votre chaîne de fournisseurs d'identifiants AWS par défaut sont toujours valides. Utilisez ceci lorsque votre compte Amazon Bedrock nécessite des identifiants inter-comptes qui diffèrent de ceux que la chaîne de fournisseurs par défaut résoudrait.

189 189 

190<h5 id="example-configuration">190<h5 id="example-configuration">

191 Exemple de configuration191 Exemple de configuration


227 3. Configurer Claude Code227 3. Configurer Claude Code

228</h3>228</h3>

229 229 

230Définissez les variables d'environnement suivantes pour activer Bedrock :230Définissez les variables d'environnement suivantes pour activer Amazon Bedrock :

231 231 

232```bash theme={null}232```bash theme={null}

233# Enable Bedrock integration233# Enable Bedrock integration


243# export ANTHROPIC_BEDROCK_BASE_URL=https://bedrock-runtime.us-east-1.amazonaws.com243# export ANTHROPIC_BEDROCK_BASE_URL=https://bedrock-runtime.us-east-1.amazonaws.com

244```244```

245 245 

246Lors de l'activation de Bedrock pour Claude Code, gardez à l'esprit les points suivants :246Lors de l'activation d'Amazon Bedrock pour Claude Code, gardez à l'esprit les points suivants :

247 247 

248* {/* min-version: 2.1.172 */}À partir de la v2.1.172, vous devez uniquement définir `AWS_REGION` pour remplacer la région de votre profil AWS ou lorsque votre profil n'a pas de région. Claude Code résout la région dans cet ordre :248* {/* min-version: 2.1.172 */}À partir de la v2.1.172, vous devez uniquement définir `AWS_REGION` pour remplacer la région de votre profil AWS ou lorsque votre profil n'a pas de région. Claude Code résout la région dans cet ordre :

249 249 


253 * `us-east-1`253 * `us-east-1`

254 254 

255 Le profil actif est `AWS_PROFILE` s'il est défini, sinon `default`. Définissez `AWS_SHARED_CREDENTIALS_FILE` ou `AWS_CONFIG_FILE` pour pointer vers des chemins de fichiers non par défaut. Exécutez `/status` pour voir la région résolue. Lorsque la région provient de vos fichiers de configuration AWS ou du repli par défaut, `/status` note également la source. Sur la v2.1.171 et antérieures, Claude Code ne lit pas les fichiers de configuration AWS, donc définissez `AWS_REGION` explicitement.255 Le profil actif est `AWS_PROFILE` s'il est défini, sinon `default`. Définissez `AWS_SHARED_CREDENTIALS_FILE` ou `AWS_CONFIG_FILE` pour pointer vers des chemins de fichiers non par défaut. Exécutez `/status` pour voir la région résolue. Lorsque la région provient de vos fichiers de configuration AWS ou du repli par défaut, `/status` note également la source. Sur la v2.1.171 et antérieures, Claude Code ne lit pas les fichiers de configuration AWS, donc définissez `AWS_REGION` explicitement.

256* Lors de l'utilisation de Bedrock, la commande `/logout` est indisponible car l'authentification est gérée via les identifiants AWS.256* Lors de l'utilisation d'Amazon Bedrock, la commande `/logout` est indisponible car l'authentification est gérée via les identifiants AWS.

257* L'outil WebSearch n'est pas disponible sur Bedrock. Voir [Comportement de l'outil WebSearch](/fr/tools-reference#websearch-tool-behavior).257* L'outil WebSearch n'est pas disponible sur Amazon Bedrock. Voir [Comportement de l'outil WebSearch](/fr/tools-reference#websearch-tool-behavior).

258* Vous pouvez utiliser des fichiers de paramètres pour les variables d'environnement comme `AWS_PROFILE` que vous ne voulez pas divulguer à d'autres processus. Voir [Paramètres](/fr/settings) pour plus d'informations.258* Vous pouvez utiliser des fichiers de paramètres pour les variables d'environnement comme `AWS_PROFILE` que vous ne voulez pas divulguer à d'autres processus. Voir [Paramètres](/fr/settings) pour plus d'informations.

259 259 

260<h3 id="4-pin-model-versions">260<h3 id="4-pin-model-versions">


262</h3>262</h3>

263 263 

264<Warning>264<Warning>

265 Épinglez les versions de modèle spécifiques lors du déploiement pour plusieurs utilisateurs. Sans épinglage, les alias de modèle tels que `sonnet` et `opus` se résolvent à la valeur par défaut intégrée de Claude Code pour Bedrock, qui peut être en retard par rapport à la version la plus récente et peut ne pas encore être disponible dans votre compte. Claude Code [revient](#startup-model-checks) à la version précédente au démarrage lorsque la valeur par défaut n'est pas disponible, mais l'épinglage vous permet de contrôler quand vos utilisateurs passent à un nouveau modèle.265 Épinglez les versions de modèle spécifiques lors du déploiement pour plusieurs utilisateurs. Sans épinglage, les alias de modèle tels que `sonnet` et `opus` se résolvent à la valeur par défaut intégrée de Claude Code pour Amazon Bedrock, qui peut être en retard par rapport à la version la plus récente et peut ne pas encore être disponible dans votre compte. Claude Code [revient](#startup-model-checks) à la version précédente au démarrage lorsque la valeur par défaut n'est pas disponible, mais l'épinglage vous permet de contrôler quand vos utilisateurs passent à un nouveau modèle.

266</Warning>266</Warning>

267 267 

268Définissez ces variables d'environnement sur des ID de modèle Bedrock spécifiques.268Définissez ces variables d'environnement sur des ID de modèle Amazon Bedrock spécifiques.

269 269 

270Sans `ANTHROPIC_DEFAULT_OPUS_MODEL`, l'alias `opus` sur Bedrock se résout à Opus 4.6. Définissez-le sur l'ID Opus 4.8 pour utiliser le dernier modèle :270Sans `ANTHROPIC_DEFAULT_OPUS_MODEL`, l'alias `opus` sur Amazon Bedrock se résout à Opus 4.6. Définissez-le sur l'ID Opus 4.8 pour utiliser le dernier modèle :

271 271 

272```bash theme={null}272```bash theme={null}

273export ANTHROPIC_DEFAULT_OPUS_MODEL='us.anthropic.claude-opus-4-8'273export ANTHROPIC_DEFAULT_OPUS_MODEL='us.anthropic.claude-opus-4-8'


284| Modèle principal | `us.anthropic.claude-sonnet-4-5-20250929-v1:0` |284| Modèle principal | `us.anthropic.claude-sonnet-4-5-20250929-v1:0` |

285| Modèle petit/rapide | Identique au modèle principal |285| Modèle petit/rapide | Identique au modèle principal |

286 286 

287Les tâches de fond telles que la génération de titre de session utilisent le modèle petit/rapide, normalement un modèle de classe Haiku. Sur Bedrock, Claude Code utilise par défaut le modèle principal car Haiku peut ne pas être activé dans tous les comptes ou régions. Pour utiliser Haiku pour les tâches de fond, définissez `ANTHROPIC_DEFAULT_HAIKU_MODEL` sur un ID de modèle disponible dans votre compte.287Les tâches de fond telles que la génération de titre de session utilisent le modèle petit/rapide, normalement un modèle de classe Haiku. Sur Amazon Bedrock, Claude Code utilise par défaut le modèle principal car Haiku peut ne pas être activé dans tous les comptes ou régions. Pour utiliser Haiku pour les tâches de fond, définissez `ANTHROPIC_DEFAULT_HAIKU_MODEL` sur un ID de modèle disponible dans votre compte.

288 288 

289Pour personnaliser davantage les modèles, utilisez l'une de ces méthodes :289Pour personnaliser davantage les modèles, utilisez l'une de ces méthodes :

290 290 


305 305 

306Le TTL du cache d'une heure est facturé à un taux plus élevé que la valeur par défaut de cinq minutes. Voir [durée de vie du cache](/fr/prompt-caching#cache-lifetime).306Le TTL du cache d'une heure est facturé à un taux plus élevé que la valeur par défaut de cinq minutes. Voir [durée de vie du cache](/fr/prompt-caching#cache-lifetime).

307 307 

308<Note>La mise en cache des invites peut ne pas être disponible dans toutes les régions Bedrock. Si les nombres de jetons de cache restent à zéro, vérifiez les [modèles, régions et limites pris en charge](https://docs.aws.amazon.com/bedrock/latest/userguide/prompt-caching.html#prompt-caching-models) dans la documentation Bedrock.</Note>308<Note>La mise en cache des invites peut ne pas être disponible dans toutes les régions Amazon Bedrock. Si les nombres de jetons de cache restent à zéro, vérifiez les [modèles, régions et limites pris en charge](https://docs.aws.amazon.com/bedrock/latest/userguide/prompt-caching.html#prompt-caching-models) dans la documentation Amazon Bedrock.</Note>

309 309 

310<h4 id="map-each-model-version-to-an-inference-profile">310<h4 id="map-each-model-version-to-an-inference-profile">

311 Mapper chaque version de modèle à un profil d'inférence311 Mapper chaque version de modèle à un profil d'inférence


326}326}

327```327```

328 328 

329Lorsqu'un utilisateur sélectionne l'une de ces versions dans `/model`, Claude Code appelle Bedrock avec l'ARN mappé. Les versions sans remplacement reviennent à l'ID de modèle Bedrock intégré ou à tout profil d'inférence correspondant découvert au démarrage. Voir [Remplacer les ID de modèle par version](/fr/model-config#override-model-ids-per-version) pour plus de détails sur la façon dont les remplacements interagissent avec `availableModels` et d'autres paramètres de modèle.329Lorsqu'un utilisateur sélectionne l'une de ces versions dans `/model`, Claude Code appelle Amazon Bedrock avec l'ARN mappé. {/* min-version: 2.1.200 */}Le même mappage s'applique lorsque vous transmettez directement l'ID de modèle Anthropic via `--model` ou `ANTHROPIC_MODEL`. Les versions sans remplacement reviennent à l'ID de modèle Amazon Bedrock intégré ou à tout profil d'inférence correspondant découvert au démarrage. Avant la v2.1.200, les valeurs `--model` et `ANTHROPIC_MODEL` atteignaient Amazon Bedrock telles quelles sans passer par la carte de remplacement. Voir [Remplacer les ID de modèle par version](/fr/model-config#override-model-ids-per-version) pour plus de détails sur la façon dont les remplacements interagissent avec `availableModels` et d'autres paramètres de modèle.

330 330 

331<h2 id="startup-model-checks">331<h2 id="startup-model-checks">

332 Vérifications du modèle au démarrage332 Vérifications du modèle au démarrage

333</h2>333</h2>

334 334 

335Lorsque Claude Code démarre avec Bedrock configuré, il vérifie que les modèles qu'il a l'intention d'utiliser sont accessibles dans votre compte. Cette vérification nécessite Claude Code v2.1.94 ou version ultérieure.335Lorsque Claude Code démarre avec Amazon Bedrock configuré, il vérifie que les modèles qu'il a l'intention d'utiliser sont accessibles dans votre compte. Cette vérification nécessite Claude Code v2.1.94 ou version ultérieure.

336 336 

337Si vous avez épinglé une version de modèle plus ancienne que la valeur par défaut actuelle de Claude Code, et que votre compte peut invoquer la version plus récente, Claude Code vous invite à mettre à jour l'épingle. L'acceptation écrit le nouvel ID de modèle dans votre [fichier de paramètres utilisateur](/fr/settings) et redémarre Claude Code. Le refus est mémorisé jusqu'au prochain changement de version par défaut. Les épingles qui pointent vers un [ARN de profil d'inférence d'application](#map-each-model-version-to-an-inference-profile) sont ignorées, car celles-ci sont gérées par votre administrateur.337Si vous avez épinglé une version de modèle plus ancienne que la valeur par défaut actuelle de Claude Code, et que votre compte peut invoquer la version plus récente, Claude Code vous invite à mettre à jour l'épingle. L'acceptation écrit le nouvel ID de modèle dans votre [fichier de paramètres utilisateur](/fr/settings) et redémarre Claude Code. Le refus est mémorisé jusqu'au prochain changement de version par défaut. Les épingles qui pointent vers un [ARN de profil d'inférence d'application](#map-each-model-version-to-an-inference-profile) sont ignorées, car celles-ci sont gérées par votre administrateur.

338 338 

339Si vous n'avez pas épinglé un modèle et que la valeur par défaut actuelle n'est pas disponible dans votre compte, Claude Code revient à la version précédente pour la session actuelle et affiche un avis. Le retour n'est pas persistant. Activez le modèle plus récent dans votre compte Bedrock ou [épinglez une version](#4-pin-model-versions) pour rendre le choix permanent.339Si vous n'avez pas épinglé un modèle et que la valeur par défaut actuelle n'est pas disponible dans votre compte, Claude Code revient à la version précédente pour la session actuelle et affiche un avis. Le retour n'est pas persistant. Activez le modèle plus récent dans votre compte Amazon Bedrock ou [épinglez une version](#4-pin-model-versions) pour rendre le choix permanent.

340 340 

341<h2 id="iam-configuration">341<h2 id="iam-configuration">

342 Configuration IAM342 Configuration IAM


564 Ressources supplémentaires564 Ressources supplémentaires

565</h2>565</h2>

566 566 

567* [Documentation Bedrock](https://docs.aws.amazon.com/bedrock/)567* [Documentation Amazon Bedrock](https://docs.aws.amazon.com/bedrock/)

568* [Tarification Bedrock](https://aws.amazon.com/bedrock/pricing/)568* [Tarification Amazon Bedrock](https://aws.amazon.com/bedrock/pricing/)

569* [Profils d'inférence Bedrock](https://docs.aws.amazon.com/bedrock/latest/userguide/inference-profiles-support.html)569* [Profils d'inférence Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/userguide/inference-profiles-support.html)

570* [Quota de jetons Bedrock et réduction des jetons](https://docs.aws.amazon.com/bedrock/latest/userguide/quotas-token-burndown.html)570* [Quota de jetons Amazon Bedrock et réduction des jetons](https://docs.aws.amazon.com/bedrock/latest/userguide/quotas-token-burndown.html)

571* [Claude Code sur Amazon Bedrock : Guide de configuration rapide](https://community.aws/content/2tXkZKrZzlrlu0KfH8gST5Dkppq/claude-code-on-amazon-bedrock-quick-setup-guide)571* [Claude Code sur Amazon Bedrock : Guide de configuration rapide](https://community.aws/content/2tXkZKrZzlrlu0KfH8gST5Dkppq/claude-code-on-amazon-bedrock-quick-setup-guide)

572* [Implémentation de la surveillance de Claude Code (Bedrock)](https://github.com/aws-solutions-library-samples/guidance-for-claude-code-with-amazon-bedrock/blob/main/assets/docs/MONITORING.md)572* [Implémentation de la surveillance de Claude Code (Amazon Bedrock)](https://github.com/aws-solutions-library-samples/guidance-for-claude-code-with-amazon-bedrock/blob/main/assets/docs/MONITORING.md)

artifacts.md +1 −1

Details

192| :-------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |192| :-------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

193| Plan | Pro, Max, Team ou Enterprise. Sur les plans Pro et Max, les artefacts sont privés pour vous, et aucune gestion d'administrateur ne s'applique. Sur les plans Team, les artefacts sont activés par défaut. Sur les plans Enterprise, un propriétaire [les active](#manage-artifacts-for-your-organization) dans les paramètres d'administration de claude.ai. |193| Plan | Pro, Max, Team ou Enterprise. Sur les plans Pro et Max, les artefacts sont privés pour vous, et aucune gestion d'administrateur ne s'applique. Sur les plans Team, les artefacts sont activés par défaut. Sur les plans Enterprise, un propriétaire [les active](#manage-artifacts-for-your-organization) dans les paramètres d'administration de claude.ai. |

194| Authentification | Connecté à claude.ai avec `/login`. Les sessions utilisant une clé API, un [jeton de passerelle](/fr/llm-gateway) ou une identifiant de fournisseur cloud ne peuvent pas publier. |194| Authentification | Connecté à claude.ai avec `/login`. Les sessions utilisant une clé API, un [jeton de passerelle](/fr/llm-gateway) ou une identifiant de fournisseur cloud ne peuvent pas publier. |

195| Fournisseur de modèle | API Anthropic. Non disponible sur [Amazon Bedrock](/fr/amazon-bedrock), [Google Cloud Vertex AI](/fr/google-vertex-ai) ou [Microsoft Foundry](/fr/microsoft-foundry). |195| Fournisseur de modèle | API Anthropic. Non disponible sur [Amazon Bedrock](/fr/amazon-bedrock), [Google Cloud's Agent Platform](/fr/google-vertex-ai) ou [Microsoft Foundry](/fr/microsoft-foundry). |

196| Politique organisationnelle | Les clés de chiffrement gérées par le client (CMEK), HIPAA et [Zéro rétention de données](/fr/zero-data-retention) ne sont pas activées pour l'organisation. |196| Politique organisationnelle | Les clés de chiffrement gérées par le client (CMEK), HIPAA et [Zéro rétention de données](/fr/zero-data-retention) ne sont pas activées pour l'organisation. |

197| Surface | CLI Claude Code, ou l'application de bureau Claude version 1.13576.0 ou ultérieure. Désactivé par défaut dans les contextes [Agent SDK](/fr/agent-sdk/overview), GitHub Action et MCP-server, et lorsque [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/fr/env-vars) est défini. |197| Surface | CLI Claude Code, ou l'application de bureau Claude version 1.13576.0 ou ultérieure. Désactivé par défaut dans les contextes [Agent SDK](/fr/agent-sdk/overview), GitHub Action et MCP-server, et lorsque [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/fr/env-vars) est défini. |

198 198 

Details

6 6 

7> Connectez-vous à Claude Code et configurez l'authentification pour les particuliers, les équipes et les organisations.7> Connectez-vous à Claude Code et configurez l'authentification pour les particuliers, les équipes et les organisations.

8 8 

9Claude Code prend en charge plusieurs méthodes d'authentification selon votre configuration. Les utilisateurs individuels peuvent se connecter avec un compte Claude.ai, tandis que les équipes peuvent utiliser Claude for Teams ou Enterprise, la Claude Console, ou un fournisseur cloud comme Amazon Bedrock, Google Vertex AI ou Microsoft Foundry.9Claude Code prend en charge plusieurs méthodes d'authentification selon votre configuration. Les utilisateurs individuels peuvent se connecter avec un compte Claude.ai, tandis que les équipes peuvent utiliser Claude for Teams ou Enterprise, la Claude Console, ou un fournisseur cloud comme Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry.

10 10 

11<h2 id="log-in-to-claude-code">11<h2 id="log-in-to-claude-code">

12 Se connecter à Claude Code12 Se connecter à Claude Code


23* **Abonnement Claude Pro ou Max** : connectez-vous avec votre compte Claude.ai. Abonnez-vous sur [claude.com/pricing](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=authentication_pro_max).23* **Abonnement Claude Pro ou Max** : connectez-vous avec votre compte Claude.ai. Abonnez-vous sur [claude.com/pricing](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=authentication_pro_max).

24* **Claude for Teams ou Enterprise** : connectez-vous avec le compte Claude.ai que votre administrateur d'équipe vous a invité à utiliser.24* **Claude for Teams ou Enterprise** : connectez-vous avec le compte Claude.ai que votre administrateur d'équipe vous a invité à utiliser.

25* **Claude Console** : connectez-vous avec vos identifiants Console. Votre administrateur doit vous avoir [invité](#claude-console-authentication) au préalable.25* **Claude Console** : connectez-vous avec vos identifiants Console. Votre administrateur doit vous avoir [invité](#claude-console-authentication) au préalable.

26* **Fournisseurs cloud** : si votre organisation utilise [Amazon Bedrock](/fr/amazon-bedrock), [Google Vertex AI](/fr/google-vertex-ai) ou [Microsoft Foundry](/fr/microsoft-foundry), définissez les variables d'environnement requises avant d'exécuter `claude`. Aucune connexion au navigateur n'est nécessaire.26* **Fournisseurs cloud** : si votre organisation utilise [Amazon Bedrock](/fr/amazon-bedrock), [Google Cloud's Agent Platform](/fr/google-vertex-ai) ou [Microsoft Foundry](/fr/microsoft-foundry), définissez les variables d'environnement requises avant d'exécuter `claude`. Aucune connexion au navigateur n'est nécessaire.

27* **Passerelle cloud** : si votre organisation exécute une [passerelle d'applications Claude](/fr/claude-apps-gateway) auto-hébergée, connectez-vous avec l'authentification unique d'entreprise via `/login`. Le jeton émis par la passerelle est la seule credential de la session.27* **Passerelle cloud** : si votre organisation exécute une [passerelle d'applications Claude](/fr/claude-apps-gateway) auto-hébergée, connectez-vous avec l'authentification unique d'entreprise via `/login`. Le jeton émis par la passerelle est la seule credential de la session.

28 28 

29Pour vous déconnecter et vous réauthentifier, tapez `/logout` à l'invite Claude Code.29Pour vous déconnecter et vous réauthentifier, tapez `/logout` à l'invite Claude Code.


40* [Claude Console](#claude-console-authentication)40* [Claude Console](#claude-console-authentication)

41* [Claude apps gateway](/fr/claude-apps-gateway), une passerelle auto-hébergée qui connecte les développeurs avec votre IdP et achemine l'inférence vers le fournisseur cloud que vous configurez41* [Claude apps gateway](/fr/claude-apps-gateway), une passerelle auto-hébergée qui connecte les développeurs avec votre IdP et achemine l'inférence vers le fournisseur cloud que vous configurez

42* [Amazon Bedrock](/fr/amazon-bedrock)42* [Amazon Bedrock](/fr/amazon-bedrock)

43* [Google Vertex AI](/fr/google-vertex-ai)43* [Google Cloud's Agent Platform](/fr/google-vertex-ai)

44* [Microsoft Foundry](/fr/microsoft-foundry)44* [Microsoft Foundry](/fr/microsoft-foundry)

45 45 

46<h3 id="claude-for-teams-or-enterprise">46<h3 id="claude-for-teams-or-enterprise">


105 Authentification du fournisseur cloud105 Authentification du fournisseur cloud

106</h3>106</h3>

107 107 

108Pour les équipes utilisant Amazon Bedrock, Google Vertex AI ou Microsoft Foundry :108Pour les équipes utilisant Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry :

109 109 

110<Steps>110<Steps>

111 <Step title="Suivre la configuration du fournisseur">111 <Step title="Suivre la configuration du fournisseur">

112 Suivez la [documentation Bedrock](/fr/amazon-bedrock), la [documentation Vertex](/fr/google-vertex-ai) ou la [documentation Microsoft Foundry](/fr/microsoft-foundry).112 Suivez la [documentation Amazon Bedrock](/fr/amazon-bedrock), la [documentation Google Cloud's Agent Platform](/fr/google-vertex-ai) ou la [documentation Microsoft Foundry](/fr/microsoft-foundry).

113 </Step>113 </Step>

114 114 

115 <Step title="Distribuer la configuration">115 <Step title="Distribuer la configuration">


140 140 

141`apiKeyHelper`, `ANTHROPIC_API_KEY` et `ANTHROPIC_AUTH_TOKEN` s'appliquent à la CLI et aux surfaces qui l'enveloppent, y compris l'extension VS Code, le SDK Agent et GitHub Actions. Claude Desktop et les sessions cloud n'appellent pas `apiKeyHelper` ni ne lisent ces variables d'environnement : elles utilisent OAuth, sauf les sessions de bureau exécutant une [configuration d'inférence tierce distribuée par l'organisation](/fr/llm-gateway-connect#desktop-app), qui s'authentifient avec les identifiants de cette configuration.141`apiKeyHelper`, `ANTHROPIC_API_KEY` et `ANTHROPIC_AUTH_TOKEN` s'appliquent à la CLI et aux surfaces qui l'enveloppent, y compris l'extension VS Code, le SDK Agent et GitHub Actions. Claude Desktop et les sessions cloud n'appellent pas `apiKeyHelper` ni ne lisent ces variables d'environnement : elles utilisent OAuth, sauf les sessions de bureau exécutant une [configuration d'inférence tierce distribuée par l'organisation](/fr/llm-gateway-connect#desktop-app), qui s'authentifient avec les identifiants de cette configuration.

142 142 

143<h3 id="renew-an-expiring-login">

144 Renouveler une connexion qui expire

145</h3>

146 

147Lorsque la connexion que vous avez créée avec `/login` est à moins de cinq jours de l'expiration, Claude Code affiche un avertissement au démarrage : `Your login expires in 3 days · run /login to renew`. Nécessite Claude Code v2.1.203 ou version ultérieure.

148 

149Exécutez `/login` pour renouveler. L'avertissement est informatif et ne bloque jamais une requête : l'authentification continue de fonctionner jusqu'à ce que la connexion expire réellement. La durée de vie de la connexion elle-même est inchangée ; l'avertissement préalable est ce que v2.1.203 ajoute.

150 

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

152 

153Le renouvellement anticipé est plus important pour les sessions qui s'exécutent sans surveillance. Une [session en arrière-plan en vue agent](/fr/agent-view) ou une session [Remote Control](/fr/remote-control) qui dépasse la durée de vie de la connexion cesse de progresser une fois que l'identifiant expire et ne peut pas récupérer jusqu'à ce que vous vous reconnectiez.

154 

143<h3 id="authentication-precedence">155<h3 id="authentication-precedence">

144 Ordre de priorité de l'authentification156 Ordre de priorité de l'authentification

145</h3>157</h3>


1535. Variable d'environnement `CLAUDE_CODE_OAUTH_TOKEN`. Un jeton OAuth de longue durée généré par [`claude setup-token`](#generate-a-long-lived-token). Utilisez ceci pour les pipelines CI et les scripts où la connexion au navigateur n'est pas disponible.1655. Variable d'environnement `CLAUDE_CODE_OAUTH_TOKEN`. Un jeton OAuth de longue durée généré par [`claude setup-token`](#generate-a-long-lived-token). Utilisez ceci pour les pipelines CI et les scripts où la connexion au navigateur n'est pas disponible.

1546. Identifiants OAuth d'abonnement de `/login`. C'est la valeur par défaut pour les utilisateurs Claude Pro, Max, Team et Enterprise.1666. Identifiants OAuth d'abonnement de `/login`. C'est la valeur par défaut pour les utilisateurs Claude Pro, Max, Team et Enterprise.

155 167 

156Une session [passerelle d'applications Claude](/fr/claude-apps-gateway) signée se situe en dehors de cette liste : c'est une sélection de fournisseur comme Bedrock ou Vertex, et elle les surclasse. Lorsqu'une session de passerelle existe, la CLI s'authentifie avec le jeton de passerelle même si `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_VERTEX` ou `CLAUDE_CODE_USE_FOUNDRY` est défini, et les entrées de jeton porteur, clé API et `apiKeyHelper` ci-dessus ne sont pas utilisées.168Une session [passerelle d'applications Claude](/fr/claude-apps-gateway) signée se situe en dehors de cette liste : c'est une sélection de fournisseur comme Amazon Bedrock ou Google Cloud's Agent Platform, et elle les surclasse. Lorsqu'une session de passerelle existe, la CLI s'authentifie avec le jeton de passerelle même si `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_VERTEX` ou `CLAUDE_CODE_USE_FOUNDRY` est défini, et les entrées de jeton porteur, clé API et `apiKeyHelper` ci-dessus ne sont pas utilisées.

157 169 

158Si vous avez un abonnement Claude actif mais que vous avez également `ANTHROPIC_API_KEY` défini dans votre environnement, la clé API prend priorité une fois approuvée. Cela peut causer des échecs d'authentification si la clé appartient à une organisation désactivée ou expirée. Exécutez `unset ANTHROPIC_API_KEY` pour revenir à votre abonnement, et vérifiez `/status` pour confirmer quelle méthode est active.170Si vous avez un abonnement Claude actif mais que vous avez également `ANTHROPIC_API_KEY` défini dans votre environnement, la clé API prend priorité une fois approuvée. Cela peut causer des échecs d'authentification si la clé appartient à une organisation désactivée ou expirée. Exécutez `unset ANTHROPIC_API_KEY` pour revenir à votre abonnement, et vérifiez `/status` pour confirmer quelle méthode est active.

159 171 

Details

60 * **Organisation**60 * **Organisation**

61 * **Utilisation principale de Claude Code** : par défaut développement logiciel61 * **Utilisation principale de Claude Code** : par défaut développement logiciel

62 * **Fournisseur(s) cloud**62 * **Fournisseur(s) cloud**

63 * **Visibilité du dépôt** : un dépôt est supposé privé sauf si son hôte distant et son nom l'indiquent autrement63 * **Visibilité du dépôt** : un dépôt est supposé privé sauf si son hôte distant et son nom l'indiquent autrement, {/* min-version: 2.1.200 */}ou une vérification de visibilité antérieure dans la conversation que le classificateur lit montre qu'il est public. Le classificateur lit vos messages et les commandes que Claude exécute, pas leur sortie, donc la preuve doit être quelque chose qu'il peut lire, comme votre propre message nommant le dépôt comme public ; la sortie d'un `gh repo view` seul ne l'atteint pas. La vérification des preuves de transcription nécessite Claude Code v2.1.200 ou ultérieur

64 * **Partage interne / hébergement d'extraits** : les services publics de paste et gist sont traités comme en dehors de la limite de confiance jusqu'à ce que vous en nomiez un64 * **Partage interne / hébergement d'extraits** : les services publics de paste et gist sont traités comme en dehors de la limite de confiance jusqu'à ce que vous en nomiez un

65 * **CLI spécifiques à l'organisation**65 * **CLI spécifiques à l'organisation**

66 * **Gestion des secrets**66 * **Gestion des secrets**


69 * **Posture réseau**69 * **Posture réseau**

70 * **Espaces de noms / environnements de déploiement protégés** : revient à l'heuristique des cibles distantes sensibles jusqu'à ce que vous les nomiez70 * **Espaces de noms / environnements de déploiement protégés** : revient à l'heuristique des cibles distantes sensibles jusqu'à ce que vous les nomiez

71 * **Rétention des données / déclassification**71 * **Rétention des données / déclassification**

72* **Emplacements de confiance** : nomment ce que le classificateur traite comme à l'intérieur de votre limite. Les emplacements sont Dépôt approuvé, Contrôle de source, Domaines internes approuvés, Buckets cloud approuvés, Services internes clés et Registre de packages interne. Les entrées de dépôt et de contrôle de source sont par défaut le dépôt de travail et ses remotes configurées. Tous les autres emplacements de confiance sont par défaut `Aucun configuré`, donc rien d'autre n'est approuvé jusqu'à ce que vous l'ajoutiez.72* **Emplacements de confiance** : nomment ce que le classificateur traite comme à l'intérieur de votre limite. Les emplacements sont Dépôt approuvé, Contrôle de source, Domaines internes approuvés, Buckets cloud approuvés, Services internes clés et Registre de packages interne. Les entrées de dépôt et de contrôle de source sont par défaut le dépôt de travail et ses remotes configurées. Tous les autres emplacements de confiance sont par défaut `Aucun configuré`, donc rien d'autre n'est approuvé jusqu'à ce que vous l'ajoutiez. {/* min-version: 2.1.203 */}La visibilité d'un dépôt ne s'applique qu'au matériel confidentiel : un dépôt privé est une destination acceptable pour le matériel confidentiel, mais rendre un dépôt privé ne supprime jamais les secrets ou les données personnelles ou confiées qu'il contient, et le classificateur traite le contenu porté, réorienté ou d'abord lu de l'extérieur du dépôt de travail comme n'étant pas le travail propre de ce dépôt. Cette portée nécessite Claude Code v2.1.203 ou ultérieur.

73* **Emplacements de sensibilité** : nomment ce que les règles de protection traitent comme à haut risque. Les emplacements sont Emplacements de données sensibles et audiences, Cibles distantes sensibles et Portées IaC protégées. Chacun est par défaut une heuristique large, comme traiter tout hôte ou espace de noms dont le nom porte `prod` ou `production` comme une cible distante sensible, donc les règles de protection sont actives avant que vous configuriez quoi que ce soit. Nommer des cibles concrètes dans un emplacement de sensibilité fait que ces règles s'appliquent aux cibles nommées au lieu de l'heuristique.73* **Emplacements de sensibilité** : nomment ce que les règles de protection traitent comme à haut risque. Les emplacements sont Emplacements de données sensibles et audiences, Cibles distantes sensibles et Portées IaC protégées. Chacun est par défaut une heuristique large, comme traiter tout hôte ou espace de noms dont le nom porte `prod` ou `production` comme une cible distante sensible, donc les règles de protection sont actives avant que vous configuriez quoi que ce soit. Nommer des cibles concrètes dans un emplacement de sensibilité fait que ces règles s'appliquent aux cibles nommées au lieu de l'heuristique.

74 74 

75Pour ajouter vos propres entrées aux côtés des valeurs par défaut, incluez la chaîne littérale `"$defaults"` dans le tableau. Les entrées par défaut sont insérées à cette position, donc vos entrées personnalisées peuvent aller avant ou après elles.75Pour ajouter vos propres entrées aux côtés des valeurs par défaut, incluez la chaîne littérale `"$defaults"` dans le tableau. Les entrées par défaut sont insérées à cette position, donc vos entrées personnalisées peuvent aller avant ou après elles.

channels.md +1 −1

Details

7> Utilisez les canaux pour envoyer des messages, des alertes et des webhooks dans votre session Claude Code à partir d'un serveur MCP. Transférez les résultats CI, les messages de chat et les événements de surveillance pour que Claude puisse réagir en votre absence.7> Utilisez les canaux pour envoyer des messages, des alertes et des webhooks dans votre session Claude Code à partir d'un serveur MCP. Transférez les résultats CI, les messages de chat et les événements de surveillance pour que Claude puisse réagir en votre absence.

8 8 

9<Note>9<Note>

10 Les canaux sont en [aperçu de recherche](#research-preview) et nécessitent Claude Code v2.1.80 ou version ultérieure. Ils nécessitent une authentification Anthropic via claude.ai ou une clé API Console, et ne sont pas disponibles sur Amazon Bedrock, Google Vertex AI ou Microsoft Foundry. Les organisations Team et Enterprise doivent [les activer explicitement](#enterprise-controls).10 Les canaux sont en [aperçu de recherche](#research-preview) et nécessitent Claude Code v2.1.80 ou version ultérieure. Ils nécessitent une authentification Anthropic via claude.ai ou une clé API Console, et ne sont pas disponibles sur Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry. Les organisations Team et Enterprise doivent [les activer explicitement](#enterprise-controls).

11</Note>11</Note>

12 12 

13Un canal est un serveur MCP qui envoie des événements dans votre session Claude Code active, afin que Claude puisse réagir aux choses qui se produisent lorsque vous n'êtes pas au terminal. Les canaux peuvent être bidirectionnels : Claude lit l'événement et répond via le même canal, comme un pont de chat. Les événements n'arrivent que lorsque la session est ouverte, donc pour une configuration toujours active, vous exécutez Claude dans un processus d'arrière-plan ou un terminal persistant.13Un canal est un serveur MCP qui envoie des événements dans votre session Claude Code active, afin que Claude puisse réagir aux choses qui se produisent lorsque vous n'êtes pas au terminal. Les canaux peuvent être bidirectionnels : Claude lit l'événement et répond via le même canal, comme un pont de chat. Les événements n'arrivent que lorsque la session est ouverte, donc pour une configuration toujours active, vous exécutez Claude dans un processus d'arrière-plan ou un terminal persistant.

Details

36* **Plateformes de chat** (Telegram, Discord) : votre plugin s'exécute localement et interroge l'API de la plateforme pour les nouveaux messages. Quand quelqu'un envoie un message direct à votre bot, le plugin reçoit le message et le transmet à Claude. Aucune URL à exposer.36* **Plateformes de chat** (Telegram, Discord) : votre plugin s'exécute localement et interroge l'API de la plateforme pour les nouveaux messages. Quand quelqu'un envoie un message direct à votre bot, le plugin reçoit le message et le transmet à Claude. Aucune URL à exposer.

37* **Webhooks** (CI, surveillance) : votre serveur écoute sur un port HTTP local. Les systèmes externes envoient des POST à ce port, et votre serveur envoie la charge utile à Claude.37* **Webhooks** (CI, surveillance) : votre serveur écoute sur un port HTTP local. Les systèmes externes envoient des POST à ce port, et votre serveur envoie la charge utile à Claude.

38 38 

39<img src="https://mintlify.s3.us-west-1.amazonaws.com/claude-code/fr/images/channel-architecture.svg" alt="Diagramme d'architecture montrant les systèmes externes se connectant à votre serveur de canal local, qui communique avec Claude Code via stdio" />39<img src="https://mintcdn.com/claude-code/9FG0ZKj9uKYiHmbi/images/channel-architecture.svg?fit=max&auto=format&n=9FG0ZKj9uKYiHmbi&q=85&s=9a037b7da80184ae49015c0256b21a1f" alt="Diagramme d'architecture montrant les systèmes externes se connectant à votre serveur de canal local, qui communique avec Claude Code via stdio" width="600" height="220" data-path="images/channel-architecture.svg" />

40 40 

41<h2 id="what-you-need">41<h2 id="what-you-need">

42 Ce dont vous avez besoin42 Ce dont vous avez besoin


474 474 

475La boîte de dialogue du terminal local reste ouverte pendant tout cela. Si quelqu'un au terminal répond avant l'arrivée du verdict distant, cette réponse est appliquée à la place et la demande distante en attente est supprimée.475La boîte de dialogue du terminal local reste ouverte pendant tout cela. Si quelqu'un au terminal répond avant l'arrivée du verdict distant, cette réponse est appliquée à la place et la demande distante en attente est supprimée.

476 476 

477<img src="https://mintlify.s3.us-west-1.amazonaws.com/claude-code/fr/images/channel-permission-relay.svg" alt="Diagramme de séquence : Claude Code envoie une notification permission_request au serveur de canal, le serveur formate et envoie l'invite à l'application de chat, l'humain répond avec un verdict, et le serveur analyse cette réponse en une notification de permission vers Claude Code" />477<img src="https://mintcdn.com/claude-code/9FG0ZKj9uKYiHmbi/images/channel-permission-relay.svg?fit=max&auto=format&n=9FG0ZKj9uKYiHmbi&q=85&s=97d57f128f0da55f105ab1e3a7e10240" alt="Diagramme de séquence : Claude Code envoie une notification permission_request au serveur de canal, le serveur formate et envoie l'invite à l'application de chat, l'humain répond avec un verdict, et le serveur analyse cette réponse en une notification de permission vers Claude Code" width="600" height="230" data-path="images/channel-permission-relay.svg" />

478 478 

479<h3 id="permission-request-fields">479<h3 id="permission-request-fields">

480 Champs de demande de permission480 Champs de demande de permission

chrome.md +1 −1

Details

40* Un plan Anthropic direct (Pro, Max, Team ou Enterprise)40* Un plan Anthropic direct (Pro, Max, Team ou Enterprise)

41 41 

42<Note>42<Note>

43 L'intégration Chrome n'est pas disponible via des fournisseurs tiers comme Amazon Bedrock, Google Cloud Vertex AI ou Microsoft Foundry. Si vous accédez à Claude exclusivement via un fournisseur tiers, vous avez besoin d'un compte claude.ai séparé pour utiliser cette fonctionnalité.43 L'intégration Chrome n'est pas disponible via des fournisseurs tiers comme Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry. Si vous accédez à Claude exclusivement via un fournisseur tiers, vous avez besoin d'un compte claude.ai séparé pour utiliser cette fonctionnalité.

44</Note>44</Note>

45 45 

46<h2 id="get-started-in-the-cli">46<h2 id="get-started-in-the-cli">

Details

4 4 

5# Configuration de la passerelle Claude apps5# Configuration de la passerelle Claude apps

6 6 

7> Référence pour chaque option gateway.yaml : écouteur et TLS, OIDC, session, magasin Postgres, amonts Bedrock/Claude Platform sur AWS/Agent Platform/Foundry, routage des modèles, politiques gérées et télémétrie.7> Référence pour chaque option gateway.yaml : écouteur et TLS, OIDC, session, magasin Postgres, amonts Amazon Bedrock, Claude Platform sur AWS, Agent Platform de Google Cloud et Microsoft Foundry, routage des modèles, politiques gérées et télémétrie.

8 8 

9Un déploiement de passerelle Claude apps est configuré par un fichier YAML, conventionnellement `gateway.yaml`. Le fichier définit tout ce que fait la passerelle : où elle écoute, comment les développeurs se connectent, où va l'inférence et quelles politiques et télémétrie s'appliquent. Cette page est la référence pour chaque option de ce fichier.9Un déploiement de passerelle Claude apps est configuré par un fichier YAML, conventionnellement `gateway.yaml`. Le fichier définit tout ce que fait la passerelle : où elle écoute, comment les développeurs se connectent, où va l'inférence et quelles politiques et télémétrie s'appliquent. Cette page est la référence pour chaque option de ce fichier.

10 10 


26* [`oidc`](#oidc) : votre fournisseur d'identité (IdP), y compris l'émetteur, le client, le mappage des réclamations et qui peut se connecter26* [`oidc`](#oidc) : votre fournisseur d'identité (IdP), y compris l'émetteur, le client, le mappage des réclamations et qui peut se connecter

27* [`session`](#session) : les jetons porteurs que la passerelle émet, avec secret et durée de vie27* [`session`](#session) : les jetons porteurs que la passerelle émet, avec secret et durée de vie

28* [`store`](#store) : PostgreSQL, pour les subventions d'appareils et les compteurs de limite de débit28* [`store`](#store) : PostgreSQL, pour les subventions d'appareils et les compteurs de limite de débit

29* [`upstreams`](#upstreams) : où l'inférence va, qu'il s'agisse d'Anthropic, Bedrock, Claude Platform sur AWS, Agent Platform ou Foundry29* [`upstreams`](#upstreams) : où l'inférence va, qu'il s'agisse d'Anthropic, Amazon Bedrock, Claude Platform sur AWS, Agent Platform de Google Cloud ou Microsoft Foundry

30 30 

31**Sections optionnelles :**31**Sections optionnelles :**

32 32 


131 131 

132Plusieurs upstreams du même fournisseur doivent définir un `name:` distinct.132Plusieurs upstreams du même fournisseur doivent définir un `name:` distinct.

133 133 

134Les clients Bedrock, Claude Platform on AWS, Agent Platform et Foundry sont construits une fois au démarrage, et leurs SDKs actualisent les identifiants en interne, donc la rotation des identifiants cloud ne nécessite pas un redémarrage. Les clés API Anthropic statiques et les porteurs sont lus au démarrage ; voir [Anthropic API](#anthropic-api).134Les clients Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform et Microsoft Foundry sont construits une fois au démarrage, et leurs SDKs actualisent les identifiants en interne, donc la rotation des identifiants cloud ne nécessite pas un redémarrage. Les clés API Anthropic statiques et les porteurs sont lus au démarrage ; voir [Anthropic API](#anthropic-api).

135 135 

136<h4 id="anthropic-api">136<h4 id="anthropic-api">

137 Anthropic API137 Anthropic API

Details

4 4 

5# Utiliser Claude Code sur le web5# Utiliser Claude Code sur le web

6 6 

7> Configurez les environnements cloud, les scripts de configuration, l'accès réseau et Docker dans le sandbox d'Anthropic. Déplacez les sessions entre le web et le terminal avec `--remote` et `--teleport`.7> Configurez les environnements cloud, les scripts de configuration, l'accès réseau et Docker dans le sandbox d'Anthropic. Déplacez les sessions entre le web et le terminal avec `--cloud` et `--teleport`.

8 8 

9<Note>9<Note>

10 Claude Code sur le web est en aperçu de recherche pour les utilisateurs Pro, Max et Team, ainsi que pour les utilisateurs Enterprise disposant de sièges premium ou de sièges Chat + Claude Code.10 Claude Code sur le web est en aperçu de recherche pour les utilisateurs Pro, Max et Team, ainsi que pour les utilisateurs Enterprise disposant de sièges premium ou de sièges Chat + Claude Code.


22* [L'environnement cloud](#the-cloud-environment) : quelle configuration est transférée, quels outils sont installés et comment configurer les environnements22* [L'environnement cloud](#the-cloud-environment) : quelle configuration est transférée, quels outils sont installés et comment configurer les environnements

23* [Scripts de configuration](#setup-scripts) et gestion des dépendances23* [Scripts de configuration](#setup-scripts) et gestion des dépendances

24* [Accès réseau](#network-access) : niveaux, proxies et liste d'autorisation par défaut24* [Accès réseau](#network-access) : niveaux, proxies et liste d'autorisation par défaut

25* [Déplacer les tâches entre le web et le terminal](#move-tasks-between-web-and-terminal) avec `--remote` et `--teleport`25* [Déplacer les tâches entre le web et le terminal](#move-tasks-between-web-and-terminal) avec `--cloud` et `--teleport`

26* [Travailler avec les sessions](#work-with-sessions) : examiner, partager, archiver, supprimer26* [Travailler avec les sessions](#work-with-sessions) : examiner, partager, archiver, supprimer

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

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


182Les environnements contrôlent [l'accès réseau](#network-access), les variables d'environnement et le [script de configuration](#setup-scripts) qui s'exécute avant le démarrage d'une session. Consultez [Outils installés](#installed-tools) pour ce qui est disponible sans aucune configuration. Vous pouvez gérer les environnements à partir de l'interface web ou du terminal :182Les environnements contrôlent [l'accès réseau](#network-access), les variables d'environnement et le [script de configuration](#setup-scripts) qui s'exécute avant le démarrage d'une session. Consultez [Outils installés](#installed-tools) pour ce qui est disponible sans aucune configuration. Vous pouvez gérer les environnements à partir de l'interface web ou du terminal :

183 183 

184| Action | Comment |184| Action | Comment |

185| :------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |185| :------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

186| Ajouter un environnement | Sélectionnez l'environnement actuel pour ouvrir le sélecteur, puis sélectionnez **Ajouter un environnement**. La boîte de dialogue inclut le nom, le niveau d'accès réseau, les variables d'environnement et le script de configuration. |186| Ajouter un environnement | Sélectionnez l'environnement actuel pour ouvrir le sélecteur, puis sélectionnez **Ajouter un environnement**. La boîte de dialogue inclut le nom, le niveau d'accès réseau, les variables d'environnement et le script de configuration. |

187| Modifier un environnement | Sélectionnez l'icône cloud affichant le nom de l'environnement actuel pour ouvrir le sélecteur, survolez un environnement et cliquez sur l'icône des paramètres qui apparaît à droite. |187| Modifier un environnement | Sélectionnez l'icône cloud affichant le nom de l'environnement actuel pour ouvrir le sélecteur, survolez un environnement et cliquez sur l'icône des paramètres qui apparaît à droite. |

188| Archiver un environnement | Ouvrez l'environnement pour le modifier et sélectionnez **Archiver**. Les environnements archivés sont masqués du sélecteur mais les sessions existantes continuent de s'exécuter. |188| Archiver un environnement | Ouvrez l'environnement pour le modifier et sélectionnez **Archiver**. Les environnements archivés sont masqués du sélecteur mais les sessions existantes continuent de s'exécuter. |

189| Définir la valeur par défaut pour `--remote` | Exécutez `/remote-env` dans votre terminal. Si vous avez un seul environnement, cette commande affiche votre configuration actuelle. `/remote-env` sélectionne uniquement la valeur par défaut ; ajoutez, modifiez et archivez les environnements à partir de l'interface web. |189| Définir l'environnement par défaut pour les sessions cloud CLI | Exécutez `/remote-env` dans votre terminal. Si vous avez un seul environnement, cette commande affiche votre configuration actuelle. `/remote-env` sélectionne uniquement la valeur par défaut ; ajoutez, modifiez et archivez les environnements à partir de l'interface web. |

190 190 

191Les variables d'environnement utilisent le format `.env` avec une paire `KEY=value` par ligne. N'enveloppez pas les valeurs entre guillemets, car les guillemets sont stockés comme faisant partie de la valeur. Cet exemple définit trois variables :191Les variables d'environnement utilisent le format `.env` avec une paire `KEY=value` par ligne. N'enveloppez pas les valeurs entre guillemets, car les guillemets sont stockés comme faisant partie de la valeur. Cet exemple définit trois variables :

192 192 


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

630 630 

631<Note>631<Note>

632 À partir du CLI, le transfert de session est unidirectionnel : vous pouvez extraire les sessions cloud dans votre terminal avec `--teleport`, mais vous ne pouvez pas pousser une session de terminal existante vers le web. L'indicateur `--remote` crée une nouvelle session cloud pour votre référentiel actuel. L'[application Desktop](/fr/desktop#continue-in-another-surface) fournit un menu Continue in qui peut envoyer une session locale vers le web.632 À partir du CLI, le transfert de session est unidirectionnel : vous pouvez extraire les sessions cloud dans votre terminal avec `--teleport`, mais vous ne pouvez pas pousser une session de terminal existante vers le web. L'indicateur `--cloud` crée une nouvelle session cloud pour votre référentiel actuel. L'[application Desktop](/fr/desktop#continue-in-another-surface) fournit un menu Continue in qui peut envoyer une session locale vers le web.

633</Note>633</Note>

634 634 

635<h3 id="from-terminal-to-web">635<h3 id="from-terminal-to-web">

636 Du terminal au web636 Du terminal au web

637</h3>637</h3>

638 638 

639Démarrez une session cloud à partir de la ligne de commande avec l'indicateur `--remote` :639Démarrez une session cloud à partir de la ligne de commande avec l'indicateur `--cloud` :

640 640 

641```bash theme={null}641```bash theme={null}

642claude --remote "Fix the authentication bug in src/auth/login.ts"642claude --cloud "Fix the authentication bug in src/auth/login.ts"

643```643```

644 644 

645Cela crée une nouvelle session cloud sur claude.ai. La session clone votre répertoire courant du serveur distant GitHub à votre branche actuelle, donc poussez d'abord si vous avez des commits locaux, puisque la VM clone depuis GitHub plutôt que depuis votre machine. `--remote` fonctionne avec un seul référentiel à la fois. La tâche s'exécute dans le cloud tandis que vous continuez à travailler localement.645Cela crée une nouvelle session cloud sur claude.ai. La session clone votre répertoire courant du serveur distant GitHub à votre branche actuelle, donc poussez d'abord si vous avez des commits locaux, puisque la VM clone depuis GitHub plutôt que depuis votre machine. `--cloud` fonctionne avec un seul référentiel à la fois. La tâche s'exécute dans le cloud tandis que vous continuez à travailler localement. L'ancienne orthographe `--remote` fonctionne toujours comme alias déprécié pour `--cloud`.

646 646 

647À partir de la v2.1.195, le CLI affiche une liste de contrôle en direct des étapes de configuration, telles que le clonage du référentiel et l'exécution de votre [script de configuration](#setup-scripts), tandis que le conteneur cloud démarre. Les messages que vous tapez pendant que le conteneur est en cours de provisionnement sont mis en file d'attente et envoyés une fois que la session est prête.647À partir de la v2.1.195, le CLI affiche une liste de contrôle en direct des étapes de configuration, telles que le clonage du référentiel et l'exécution de votre [script de configuration](#setup-scripts), tandis que le conteneur cloud démarre. Les messages que vous tapez pendant que le conteneur est en cours de provisionnement sont mis en file d'attente et envoyés une fois que la session est prête.

648 648 

649<Note>649<Note>

650 `--remote` crée des sessions cloud. `--remote-control` n'est pas lié : il expose une session CLI locale pour la surveillance depuis le web. Consultez [Contrôle à distance](/fr/remote-control).650 `--cloud` crée des sessions cloud. `--remote-control` n'est pas lié : il expose une session CLI locale pour la surveillance depuis le web. Consultez [Contrôle à distance](/fr/remote-control).

651</Note>651</Note>

652 652 

653Utilisez `/tasks` dans le CLI Claude Code pour vérifier la progression, ou ouvrez la session sur claude.ai ou l'application mobile Claude pour interagir directement. De là, vous pouvez diriger Claude, fournir des commentaires ou répondre à des questions comme dans n'importe quelle autre conversation.653Utilisez `/tasks` dans le CLI Claude Code pour vérifier la progression, ou ouvrez la session sur claude.ai ou l'application mobile Claude pour interagir directement. De là, vous pouvez diriger Claude, fournir des commentaires ou répondre à des questions comme dans n'importe quelle autre conversation.


665En mode plan, Claude lit les fichiers, exécute les commandes pour explorer et propose un plan sans modifier le code source. Une fois que vous êtes satisfait, enregistrez le plan dans le référentiel, validez et poussez afin que la VM cloud puisse le cloner. Ensuite, démarrez une session cloud pour l'exécution autonome :665En mode plan, Claude lit les fichiers, exécute les commandes pour explorer et propose un plan sans modifier le code source. Une fois que vous êtes satisfait, enregistrez le plan dans le référentiel, validez et poussez afin que la VM cloud puisse le cloner. Ensuite, démarrez une session cloud pour l'exécution autonome :

666 666 

667```bash theme={null}667```bash theme={null}

668claude --remote "Execute the migration plan in docs/migration-plan.md"668claude --cloud "Execute the migration plan in docs/migration-plan.md"

669```669```

670 670 

671Ce modèle vous donne le contrôle sur la stratégie tout en permettant à Claude d'exécuter de manière autonome dans le cloud.671Ce modèle vous donne le contrôle sur la stratégie tout en permettant à Claude d'exécuter de manière autonome dans le cloud.

672 672 

673**Planifiez dans le cloud avec ultraplan** : pour rédiger et examiner le plan lui-même dans une session web, utilisez [ultraplan](/fr/ultraplan). Claude génère le plan sur Claude Code sur le web tandis que vous continuez à travailler, puis vous commentez les sections dans votre navigateur et choisissez d'exécuter à distance ou d'envoyer le plan vers votre terminal.673**Planifiez dans le cloud avec ultraplan** : pour rédiger et examiner le plan lui-même dans une session web, utilisez [ultraplan](/fr/ultraplan). Claude génère le plan sur Claude Code sur le web tandis que vous continuez à travailler, puis vous commentez les sections dans votre navigateur et choisissez d'exécuter à distance ou d'envoyer le plan vers votre terminal.

674 674 

675**Exécutez les tâches en parallèle** : chaque commande `--remote` crée sa propre session cloud qui s'exécute indépendamment. Vous pouvez lancer plusieurs tâches et elles s'exécuteront toutes simultanément dans des sessions séparées :675**Exécutez les tâches en parallèle** : chaque commande `--cloud` crée sa propre session cloud qui s'exécute indépendamment. Vous pouvez lancer plusieurs tâches et elles s'exécuteront toutes simultanément dans des sessions séparées :

676 676 

677```bash theme={null}677```bash theme={null}

678claude --remote "Fix the flaky test in auth.spec.ts"678claude --cloud "Fix the flaky test in auth.spec.ts"

679claude --remote "Update the API documentation"679claude --cloud "Update the API documentation"

680claude --remote "Refactor the logger to use structured output"680claude --cloud "Refactor the logger to use structured output"

681```681```

682 682 

683Surveillez toutes les sessions avec `/tasks` dans le CLI Claude Code. Lorsqu'une session se termine, vous pouvez créer une PR à partir de l'interface web ou [téléporter](#from-web-to-terminal) la session vers votre terminal pour continuer à travailler.683Surveillez toutes les sessions avec `/tasks` dans le CLI Claude Code. Lorsqu'une session se termine, vous pouvez créer une PR à partir de l'interface web ou [téléporter](#from-web-to-terminal) la session vers votre terminal pour continuer à travailler.


686 Envoyer les référentiels locaux sans GitHub686 Envoyer les référentiels locaux sans GitHub

687</h4>687</h4>

688 688 

689Lorsque vous exécutez `claude --remote` à partir d'un référentiel qui n'est pas connecté à GitHub, Claude Code regroupe votre référentiel local et le télécharge directement vers la session cloud. Le paquet inclut votre historique de référentiel complet sur toutes les branches, plus toute modification non validée des fichiers suivis.689Lorsque vous exécutez `claude --cloud` à partir d'un référentiel qui n'est pas connecté à GitHub, Claude Code regroupe votre référentiel local et le télécharge directement vers la session cloud. Le paquet inclut votre historique de référentiel complet sur toutes les branches, plus toute modification non validée des fichiers suivis.

690 690 

691Ce repli s'active automatiquement lorsque l'accès à GitHub n'est pas disponible. Pour le forcer même lorsque GitHub est connecté, définissez `CCR_FORCE_BUNDLE=1` :691Ce repli s'active automatiquement lorsque l'accès à GitHub n'est pas disponible. Pour le forcer même lorsque GitHub est connecté, définissez `CCR_FORCE_BUNDLE=1` :

692 692 

693```bash theme={null}693```bash theme={null}

694CCR_FORCE_BUNDLE=1 claude --remote "Run the test suite and fix any failures"694CCR_FORCE_BUNDLE=1 claude --cloud "Run the test suite and fix any failures"

695```695```

696 696 

697Les référentiels regroupés doivent respecter ces limites :697Les référentiels regroupés doivent respecter ces limites :


733 `--teleport` n'est pas disponible733 `--teleport` n'est pas disponible

734</h4>734</h4>

735 735 

736La téléportation nécessite l'authentification par abonnement claude.ai. Si vous êtes authentifié via clé API, Bedrock, Vertex AI ou Microsoft Foundry, exécutez `/login` pour vous connecter avec votre compte claude.ai à la place. Si vous êtes déjà connecté via claude.ai et `--teleport` n'est toujours pas disponible, votre organisation a peut-être désactivé les sessions cloud.736La téléportation nécessite l'authentification par abonnement claude.ai. Si vous êtes authentifié via clé API, Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry, exécutez `/login` pour vous connecter avec votre compte claude.ai à la place. Si vous êtes déjà connecté via claude.ai et `--teleport` n'est toujours pas disponible, votre organisation a peut-être désactivé les sessions cloud.

737 737 

738<h2 id="work-with-sessions">738<h2 id="work-with-sessions">

739 Travailler avec les sessions739 Travailler avec les sessions


745 Gérer le contexte745 Gérer le contexte

746</h3>746</h3>

747 747 

748Les sessions cloud prennent en charge les [commandes intégrées](/fr/commands) qui produisent une sortie textuelle. Les commandes qui ouvrent un sélecteur de terminal interactif, comme `/model` ou `/config`, ne sont pas disponibles.748Les sessions cloud prennent en charge les [commandes intégrées](/fr/commands) qui produisent une sortie textuelle. Les commandes qui s'exécutent uniquement dans l'interface du terminal, telles que `/plugin` ou `/resume`, ne sont pas disponibles. {/* min-version: 2.1.205 */}`/model`, `/effort`, `/fast`, `/color` et `/rename` fonctionnent avec la valeur comme argument, par exemple `/model sonnet`, au lieu d'ouvrir le sélecteur de terminal ou le curseur ; les formes d'argument nécessitent Claude Code v2.1.205 ou ultérieur dans l'environnement de la session et suivent les [notes de disponibilité](/fr/commands#all-commands) de chaque commande, donc `/effort` signale `Not applied` tandis qu'un [lancement par défaut du niveau d'effort](/fr/model-config#adjust-effort-level) du modèle est en vigueur et `/fast` fonctionne uniquement dans une session qui a démarré avec le mode rapide activé. `/config` définit un paramètre lorsque vous passez `key=value`.

749 749 

750Pour la gestion du contexte spécifiquement :750Pour la gestion du contexte spécifiquement :

751 751 


777 Partage à partir d'un compte Enterprise ou Team777 Partage à partir d'un compte Enterprise ou Team

778</h4>778</h4>

779 779 

780Pour les comptes Enterprise et Team, les deux options de visibilité sont **Private** et **Team**. La visibilité Team rend la session visible aux autres membres de votre organisation claude.ai. [Claude dans Slack](/fr/slack) les sessions sont automatiquement partagées avec la visibilité Team.780Pour les comptes Enterprise et Team, les deux options de visibilité sont **Private** et **Team**. La visibilité Team rend la session visible aux autres membres de votre organisation claude.ai. Les sessions [Claude dans Slack](/fr/slack) sont automatiquement partagées avec la visibilité Team.

781 781 

782La vérification de l'accès au référentiel est activée par défaut, en fonction du compte GitHub connecté au compte du destinataire. Le nom d'affichage de votre compte est visible à tous les destinataires ayant accès.782La vérification de l'accès au référentiel est activée par défaut, en fonction du compte GitHub connecté au compte du destinataire. Le nom d'affichage de votre compte est visible à tous les destinataires ayant accès.

783 783 

Details

270 270 

271`ANTHROPIC_AWS_WORKSPACE_ID` est obligatoire et est envoyé à chaque requête en tant qu'en-tête `anthropic-workspace-id`. L'URL de base est calculée à partir de `AWS_REGION` comme `https://aws-external-anthropic.{region}.api.aws`. Pour remplacer l'URL directement, définissez `ANTHROPIC_AWS_BASE_URL`.271`ANTHROPIC_AWS_WORKSPACE_ID` est obligatoire et est envoyé à chaque requête en tant qu'en-tête `anthropic-workspace-id`. L'URL de base est calculée à partir de `AWS_REGION` comme `https://aws-external-anthropic.{region}.api.aws`. Pour remplacer l'URL directement, définissez `ANTHROPIC_AWS_BASE_URL`.

272 272 

273Claude Platform on AWS est optionnel même lorsque des identifiants AWS sont présents dans votre environnement. Bedrock et Foundry prennent la priorité dans l'acheminement des fournisseurs, donc désactivez `CLAUDE_CODE_USE_BEDROCK` et `CLAUDE_CODE_USE_FOUNDRY` s'ils sont définis.273Claude Platform on AWS est optionnel même lorsque des identifiants AWS sont présents dans votre environnement. Amazon Bedrock et Microsoft Foundry prennent la priorité dans l'acheminement des fournisseurs, donc désactivez `CLAUDE_CODE_USE_BEDROCK` et `CLAUDE_CODE_USE_FOUNDRY` s'ils sont définis.

274 274 

275<h3 id="3-pin-model-versions">275<h3 id="3-pin-model-versions">

276 3. Épinglez les versions de modèle276 3. Épinglez les versions de modèle

cli-reference.md +10 −7

Details

22| `claude -c -p "query"` | Continuer via SDK | `claude -c -p "Check for type errors"` |22| `claude -c -p "query"` | Continuer via SDK | `claude -c -p "Check for type errors"` |

23| `claude -r "<session>" "query"` | Reprendre une session par ID ou nom | `claude -r "auth-refactor" "Finish this PR"` |23| `claude -r "<session>" "query"` | Reprendre une session par ID ou nom | `claude -r "auth-refactor" "Finish this PR"` |

24| `claude update` | Mettre à jour vers la dernière version | `claude update` |24| `claude update` | Mettre à jour vers la dernière version | `claude update` |

25| `claude gateway` | Démarrer le serveur [passerelle d'applications Claude](/fr/claude-apps-gateway) auto-hébergé, pour les administrateurs déployant SSO et la politique devant Claude Code sur Bedrock, Vertex AI, ou Foundry. Nécessite `--config` pointant vers un [`gateway.yaml`](/fr/claude-apps-gateway-config). Disponible dans Claude Code v2.1.195 et ultérieur. | `claude gateway --config gateway.yaml` |25| `claude gateway` | Démarrer le serveur [passerelle d'applications Claude](/fr/claude-apps-gateway) auto-hébergé, pour les administrateurs déployant SSO et la politique devant Claude Code sur Amazon Bedrock, Google Cloud's Agent Platform, ou Microsoft Foundry. Nécessite `--config` pointant vers un [`gateway.yaml`](/fr/claude-apps-gateway-config). Disponible dans Claude Code v2.1.195 et ultérieur. | `claude gateway --config gateway.yaml` |

26| `claude install [version]` | Installer ou réinstaller le binaire natif. Accepte une version comme `2.1.118`, ou `stable` ou `latest`. Voir [Installer une version spécifique](/fr/setup#install-a-specific-version) | `claude install stable` |26| `claude install [version]` | Installer ou réinstaller le binaire natif. Accepte une version comme `2.1.118`, ou `stable` ou `latest`. Voir [Installer une version spécifique](/fr/setup#install-a-specific-version) | `claude install stable` |

27| `claude auth login` | Se connecter à votre compte Anthropic. Utilisez `--email` pour pré-remplir votre adresse e-mail, `--sso` pour forcer l'authentification SSO, et `--console` pour vous connecter avec Anthropic Console pour la facturation de l'utilisation de l'API au lieu d'un abonnement Claude | `claude auth login --console` |27| `claude auth login` | Se connecter à votre compte Anthropic. Utilisez `--email` pour pré-remplir votre adresse e-mail, `--sso` pour forcer l'authentification SSO, et `--console` pour vous connecter avec Anthropic Console pour la facturation de l'utilisation de l'API au lieu d'un abonnement Claude | `claude auth login --console` |

28| `claude auth logout` | Se déconnecter de votre compte Anthropic | `claude auth logout` |28| `claude auth logout` | Se déconnecter de votre compte Anthropic | `claude auth logout` |


32| `claude auto-mode defaults` | Imprimer les règles du classificateur [mode auto](/fr/permission-modes#eliminate-prompts-with-auto-mode) intégrées en JSON. Utilisez `claude auto-mode config` pour voir votre configuration effective avec les paramètres appliqués | `claude auto-mode defaults > rules.json` |32| `claude auto-mode defaults` | Imprimer les règles du classificateur [mode auto](/fr/permission-modes#eliminate-prompts-with-auto-mode) intégrées en JSON. Utilisez `claude auto-mode config` pour voir votre configuration effective avec les paramètres appliqués | `claude auto-mode defaults > rules.json` |

33| `claude daemon status` | Imprimer l'état du [superviseur](/fr/agent-view#the-supervisor-process) de session d'arrière-plan, la version, le répertoire socket, et le nombre de workers pour les diagnostics. Quitte avec 1 si le superviseur n'est pas en cours d'exécution | `claude daemon status` |33| `claude daemon status` | Imprimer l'état du [superviseur](/fr/agent-view#the-supervisor-process) de session d'arrière-plan, la version, le répertoire socket, et le nombre de workers pour les diagnostics. Quitte avec 1 si le superviseur n'est pas en cours d'exécution | `claude daemon status` |

34| `claude daemon stop --any` | Arrêter le [superviseur](/fr/agent-view#the-supervisor-process) de session d'arrière-plan et les sessions qu'il héberge. Passez `--keep-workers` pour laisser les sessions d'arrière-plan en cours d'exécution afin que le superviseur suivant se reconnecte à elles. `--any` confirme l'arrêt d'un superviseur à la demande, qui est la valeur par défaut. Utilisez ceci pour récupérer d'un [superviseur qui ne répond pas](/fr/agent-view#agent-view-says-the-background-service-did-not-respond) | `claude daemon stop --any --keep-workers` |34| `claude daemon stop --any` | Arrêter le [superviseur](/fr/agent-view#the-supervisor-process) de session d'arrière-plan et les sessions qu'il héberge. Passez `--keep-workers` pour laisser les sessions d'arrière-plan en cours d'exécution afin que le superviseur suivant se reconnecte à elles. `--any` confirme l'arrêt d'un superviseur à la demande, qui est la valeur par défaut. Utilisez ceci pour récupérer d'un [superviseur qui ne répond pas](/fr/agent-view#agent-view-says-the-background-service-did-not-respond) | `claude daemon stop --any --keep-workers` |

35| `claude doctor` | Imprimer les diagnostics d'installation et de paramètres en lecture seule depuis le terminal sans démarrer une session, y compris la vérification de la santé de l'installation, les erreurs de validation du fichier de paramètres, et l'éligibilité au contrôle à distance. Pour la vérification de configuration en session qui peut également appliquer des correctifs, exécutez [`/doctor`](/fr/commands#all-commands) | `claude doctor` |

35| `claude logs <id>` | Imprimer la sortie récente d'une [session d'arrière-plan](/fr/agent-view#manage-sessions-from-the-shell) | `claude logs 7c5dcf5d` |36| `claude logs <id>` | Imprimer la sortie récente d'une [session d'arrière-plan](/fr/agent-view#manage-sessions-from-the-shell) | `claude logs 7c5dcf5d` |

36| `claude mcp` | Configurer les serveurs Model Context Protocol (MCP) | Voir la [documentation Claude Code MCP](/fr/mcp). |37| `claude mcp` | Configurer les serveurs Model Context Protocol (MCP) | Voir la [documentation Claude Code MCP](/fr/mcp). |

37| `claude mcp login <name>` | {/* min-version: 2.1.186 */}Exécuter le flux OAuth d'un serveur MCP configuré sans ouvrir le panneau interactif `/mcp`. Fonctionne pour les serveurs HTTP, SSE et claude.ai connector. Ajoutez `--no-browser` sur SSH pour imprimer l'URL d'autorisation au lieu d'ouvrir un navigateur, puis collez l'URL de redirection à l'invite. Nécessite Claude Code v2.1.186 ou ultérieur. Voir [S'authentifier à partir de la ligne de commande](/fr/mcp#authenticate-from-the-command-line) | `claude mcp login sentry` |38| `claude mcp login <name>` | {/* min-version: 2.1.186 */}Exécuter le flux OAuth d'un serveur MCP configuré sans ouvrir le panneau interactif `/mcp`. Fonctionne pour les serveurs HTTP, SSE et claude.ai connector. Ajoutez `--no-browser` sur SSH pour imprimer l'URL d'autorisation au lieu d'ouvrir un navigateur, puis collez l'URL de redirection à l'invite. Nécessite Claude Code v2.1.186 ou ultérieur. Voir [S'authentifier à partir de la ligne de commande](/fr/mcp#authenticate-from-the-command-line) | `claude mcp login sentry` |


63| `--agents` | Définir des subagents personnalisés dynamiquement via JSON. Utilise les mêmes noms de champs que le [frontmatter](/fr/sub-agents#supported-frontmatter-fields) des subagents, plus un champ `prompt` pour les instructions de l'agent | `claude --agents '{"reviewer":{"description":"Reviews code","prompt":"You are a code reviewer"}}'` |64| `--agents` | Définir des subagents personnalisés dynamiquement via JSON. Utilise les mêmes noms de champs que le [frontmatter](/fr/sub-agents#supported-frontmatter-fields) des subagents, plus un champ `prompt` pour les instructions de l'agent | `claude --agents '{"reviewer":{"description":"Reviews code","prompt":"You are a code reviewer"}}'` |

64| `--allow-dangerously-skip-permissions` | Ajouter `bypassPermissions` au cycle du mode `Shift+Tab` sans commencer dedans. Permet de commencer dans un mode différent comme `plan` et de basculer vers `bypassPermissions` plus tard. Voir [modes de permission](/fr/permission-modes#skip-all-checks-with-bypasspermissions-mode) | `claude --permission-mode plan --allow-dangerously-skip-permissions` |65| `--allow-dangerously-skip-permissions` | Ajouter `bypassPermissions` au cycle du mode `Shift+Tab` sans commencer dedans. Permet de commencer dans un mode différent comme `plan` et de basculer vers `bypassPermissions` plus tard. Voir [modes de permission](/fr/permission-modes#skip-all-checks-with-bypasspermissions-mode) | `claude --permission-mode plan --allow-dangerously-skip-permissions` |

65| `--allowedTools`, `--allowed-tools` | Outils qui s'exécutent sans demander la permission. Voir [syntaxe des règles de permission](/fr/settings#permission-rule-syntax) pour la correspondance de motifs. Pour restreindre les outils disponibles, utilisez `--tools` à la place | `"Bash(git log *)" "Bash(git diff *)" "Read"` |66| `--allowedTools`, `--allowed-tools` | Outils qui s'exécutent sans demander la permission. Voir [syntaxe des règles de permission](/fr/settings#permission-rule-syntax) pour la correspondance de motifs. Pour restreindre les outils disponibles, utilisez `--tools` à la place | `"Bash(git log *)" "Bash(git diff *)" "Read"` |

67| `--append-subagent-system-prompt` | {/* min-version: 2.1.205 */}Ajouter du texte personnalisé à la fin de l'invite système de chaque [subagent](/fr/sub-agents), y compris les subagents imbriqués. S'applique uniquement en mode non interactif avec `-p`. Nécessite Claude Code v2.1.205 ou ultérieur | `claude -p --append-subagent-system-prompt "Cite file paths in every answer" "query"` |

66| `--append-system-prompt` | Ajouter du texte personnalisé à la fin de l'invite système par défaut | `claude --append-system-prompt "Always use TypeScript"` |68| `--append-system-prompt` | Ajouter du texte personnalisé à la fin de l'invite système par défaut | `claude --append-system-prompt "Always use TypeScript"` |

67| `--append-system-prompt-file` | Charger du texte d'invite système supplémentaire à partir d'un fichier et l'ajouter à l'invite par défaut | `claude --append-system-prompt-file ./extra-rules.txt` |69| `--append-system-prompt-file` | Charger du texte d'invite système supplémentaire à partir d'un fichier et l'ajouter à l'invite par défaut | `claude --append-system-prompt-file ./extra-rules.txt` |

68| `--ax-screen-reader` | {/* min-version: 2.1.181 */}Afficher une sortie accessible aux lecteurs d'écran : texte plat sans bordures décoratives ni animations. Force le rendu classique, donc le paramètre [`tui`](/fr/settings#available-settings) n'a aucun effet pour la session. Prend la priorité sur [`CLAUDE_AX_SCREEN_READER`](/fr/env-vars) et le paramètre [`axScreenReader`](/fr/settings#available-settings). Nécessite Claude Code v2.1.181 ou ultérieur | `claude --ax-screen-reader` |70| `--ax-screen-reader` | {/* min-version: 2.1.181 */}Afficher une sortie accessible aux lecteurs d'écran : texte plat sans bordures décoratives ni animations. Force le rendu classique, donc le paramètre [`tui`](/fr/settings#available-settings) n'a aucun effet pour la session. Prend la priorité sur [`CLAUDE_AX_SCREEN_READER`](/fr/env-vars) et le paramètre [`axScreenReader`](/fr/settings#available-settings). Nécessite Claude Code v2.1.181 ou ultérieur | `claude --ax-screen-reader` |


71| `--bg`, `--background` | Démarrer la session en tant qu'[agent en arrière-plan](/fr/agent-view) et revenir immédiatement. Affiche l'ID de session et les commandes de gestion. Combinez avec `--exec` pour exécuter une commande shell en tant que travail en arrière-plan au lieu d'une session Claude, ou avec `--agent` pour exécuter un subagent spécifique. {/* min-version: 2.1.198 */}Ne peut pas être combiné avec `-p`/`--print` ; voir la [référence d'erreur](/fr/errors#command-line-errors) | `claude --bg "investigate the flaky test"` |73| `--bg`, `--background` | Démarrer la session en tant qu'[agent en arrière-plan](/fr/agent-view) et revenir immédiatement. Affiche l'ID de session et les commandes de gestion. Combinez avec `--exec` pour exécuter une commande shell en tant que travail en arrière-plan au lieu d'une session Claude, ou avec `--agent` pour exécuter un subagent spécifique. {/* min-version: 2.1.198 */}Ne peut pas être combiné avec `-p`/`--print` ; voir la [référence d'erreur](/fr/errors#command-line-errors) | `claude --bg "investigate the flaky test"` |

72| `--channels` | (Aperçu de recherche) Serveurs MCP dont les notifications de [canal](/fr/channels) Claude doit écouter dans cette session. Liste séparée par des espaces d'entrées `plugin:<name>@<marketplace>`. Nécessite l'authentification Claude.ai | `claude --channels plugin:my-notifier@my-marketplace` |74| `--channels` | (Aperçu de recherche) Serveurs MCP dont les notifications de [canal](/fr/channels) Claude doit écouter dans cette session. Liste séparée par des espaces d'entrées `plugin:<name>@<marketplace>`. Nécessite l'authentification Claude.ai | `claude --channels plugin:my-notifier@my-marketplace` |

73| `--chrome` | Activer l'[intégration du navigateur Chrome](/fr/chrome) pour l'automatisation web et les tests | `claude --chrome` |75| `--chrome` | Activer l'[intégration du navigateur Chrome](/fr/chrome) pour l'automatisation web et les tests | `claude --chrome` |

76| `--cloud` | Créer une nouvelle [session web](/fr/claude-code-on-the-web) sur claude.ai avec la description de tâche fournie | `claude --cloud "Fix the login bug"` |

74| `--continue`, `-c` | Charger la conversation la plus récente dans le répertoire courant. Inclut les sessions qui ont ajouté ce répertoire avec `/add-dir` | `claude --continue` |77| `--continue`, `-c` | Charger la conversation la plus récente dans le répertoire courant. Inclut les sessions qui ont ajouté ce répertoire avec `/add-dir` | `claude --continue` |

75| `--dangerously-load-development-channels` | Activer les [canaux](/fr/channels-reference#test-during-the-research-preview) qui ne sont pas sur la liste d'approbation, pour le développement local. Accepte les entrées `plugin:<name>@<marketplace>` et `server:<name>`. Demande une confirmation | `claude --dangerously-load-development-channels server:webhook` |78| `--dangerously-load-development-channels` | Activer les [canaux](/fr/channels-reference#test-during-the-research-preview) qui ne sont pas sur la liste d'approbation, pour le développement local. Accepte les entrées `plugin:<name>@<marketplace>` et `server:<name>`. Demande une confirmation | `claude --dangerously-load-development-channels server:webhook` |

76| `--dangerously-skip-permissions` | Ignorer les invites de permission. Équivalent à `--permission-mode bypassPermissions`. Voir [modes de permission](/fr/permission-modes#skip-all-checks-with-bypasspermissions-mode) pour ce que cela ignore et n'ignore pas | `claude --dangerously-skip-permissions` |79| `--dangerously-skip-permissions` | Ignorer les invites de permission. Équivalent à `--permission-mode bypassPermissions`. Voir [modes de permission](/fr/permission-modes#skip-all-checks-with-bypasspermissions-mode) pour ce que cela ignore et n'ignore pas | `claude --dangerously-skip-permissions` |


78| `--debug-file <path>` | Écrire les journaux de débogage dans un chemin de fichier spécifique. Active implicitement le mode débogage. Prend la priorité sur `CLAUDE_CODE_DEBUG_LOGS_DIR` | `claude --debug-file /tmp/claude-debug.log` |81| `--debug-file <path>` | Écrire les journaux de débogage dans un chemin de fichier spécifique. Active implicitement le mode débogage. Prend la priorité sur `CLAUDE_CODE_DEBUG_LOGS_DIR` | `claude --debug-file /tmp/claude-debug.log` |

79| `--disable-slash-commands` | Désactiver tous les skills et commandes pour cette session | `claude --disable-slash-commands` |82| `--disable-slash-commands` | Désactiver tous les skills et commandes pour cette session | `claude --disable-slash-commands` |

80| `--disallowedTools`, `--disallowed-tools` | Règles de refus. Un nom d'outil nu supprime cet outil du contexte du modèle : `"Edit"` supprime Edit, `"*"` supprime tous les outils, et `"mcp__*"` supprime tous les outils MCP. Une règle délimitée telle que `Bash(rm *)` laisse l'outil disponible et refuse uniquement les appels correspondants | `"Bash(git log *)" "Bash(git diff *)" "Edit"` |83| `--disallowedTools`, `--disallowed-tools` | Règles de refus. Un nom d'outil nu supprime cet outil du contexte du modèle : `"Edit"` supprime Edit, `"*"` supprime tous les outils, et `"mcp__*"` supprime tous les outils MCP. Une règle délimitée telle que `Bash(rm *)` laisse l'outil disponible et refuse uniquement les appels correspondants | `"Bash(git log *)" "Bash(git diff *)" "Edit"` |

81| `--effort` | Définir le [niveau d'effort](/fr/model-config#adjust-effort-level) pour la session actuelle. Options : `low`, `medium`, `high`, `xhigh`, `max` ; les niveaux disponibles dépendent du modèle. Remplace le paramètre [`effortLevel`](/fr/settings#available-settings) pour cette session et ne persiste pas | `claude --effort high` |84| `--effort` | Définir le [niveau d'effort](/fr/model-config#adjust-effort-level) pour la session actuelle. Options : `low`, `medium`, `high`, `xhigh`, `max`, ou {/* min-version: 2.1.203 */}}`ultracode`. Les niveaux disponibles dépendent du modèle. `ultracode` démarre la session au niveau d'effort `xhigh` avec [ultracode](/fr/workflows#let-claude-decide-with-ultracode) activé, et nécessite Claude Code v2.1.203 ou ultérieur. Remplace le paramètre [`effortLevel`](/fr/settings#available-settings) pour cette session et ne persiste pas | `claude --effort high` |

82| `--enable-auto-mode` | {/* max-version: 2.1.110 */}Supprimé dans v2.1.111. Le mode auto est maintenant dans le cycle `Shift+Tab` par défaut ; utilisez `--permission-mode auto` pour commencer dedans | `claude --permission-mode auto` |85| `--enable-auto-mode` | {/* max-version: 2.1.110 */}Supprimé dans v2.1.111. Le mode auto est maintenant dans le cycle `Shift+Tab` par défaut ; utilisez `--permission-mode auto` pour commencer dedans | `claude --permission-mode auto` |

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

84| `--exec` | Exécuter une commande shell en tant que travail en arrière-plan soutenu par PTY au lieu de démarrer une session Claude. À utiliser avec `--bg` pour lancer depuis le shell | `claude --bg --exec 'pytest -x'` |87| `--exec` | Exécuter une commande shell en tant que travail en arrière-plan soutenu par PTY au lieu de démarrer une session Claude. À utiliser avec `--bg` pour lancer depuis le shell | `claude --bg --exec 'pytest -x'` |


91| `--include-hook-events` | Inclure tous les événements du cycle de vie des hooks dans le flux de sortie. Nécessite `--output-format stream-json` | `claude -p --output-format stream-json --verbose --include-hook-events "query"` |94| `--include-hook-events` | Inclure tous les événements du cycle de vie des hooks dans le flux de sortie. Nécessite `--output-format stream-json` | `claude -p --output-format stream-json --verbose --include-hook-events "query"` |

92| `--include-partial-messages` | Inclure les événements de streaming partiels dans la sortie. Nécessite `--print` et `--output-format stream-json` | `claude -p --output-format stream-json --verbose --include-partial-messages "query"` |95| `--include-partial-messages` | Inclure les événements de streaming partiels dans la sortie. Nécessite `--print` et `--output-format stream-json` | `claude -p --output-format stream-json --verbose --include-partial-messages "query"` |

93| `--input-format` | Spécifier le format d'entrée pour le mode impression (options : `text`, `stream-json`) | `claude -p --output-format json --input-format stream-json` |96| `--input-format` | Spécifier le format d'entrée pour le mode impression (options : `text`, `stream-json`) | `claude -p --output-format json --input-format stream-json` |

94| `--json-schema` | Obtenir une sortie JSON validée correspondant à un JSON Schema après que l'agent ait terminé son flux de travail (mode impression uniquement, voir [structured outputs](/fr/agent-sdk/structured-outputs)) | `claude -p --json-schema '{"type":"object","properties":{...}}' "query"` |97| `--json-schema` | Obtenir une sortie JSON validée correspondant à un JSON Schema après que l'agent ait terminé son flux de travail (mode impression uniquement). Voir [structured outputs](/fr/agent-sdk/structured-outputs). {/* min-version: 2.1.205 */}Claude Code quitte avec une erreur sur un schéma invalide et accepte le mot-clé `format` comme annotation sans validation côté client. Avant v2.1.205, un schéma invalide produisait une sortie non structurée sans erreur, et les schémas utilisant `format` étaient traités comme invalides | `claude -p --json-schema '{"type":"object","properties":{...}}' "query"` |

95| `--maintenance` | Exécuter les hooks d'[initialisation](/fr/hooks#setup) avec le matcher `maintenance` avant la session (mode impression uniquement) | `claude -p --maintenance "query"` |98| `--maintenance` | Exécuter les hooks d'[initialisation](/fr/hooks#setup) avec le matcher `maintenance` avant la session (mode impression uniquement) | `claude -p --maintenance "query"` |

96| `--max-budget-usd` | Montant en dollars maximum à dépenser pour les appels API avant d'arrêter (mode impression uniquement) | `claude -p --max-budget-usd 5.00 "query"` |99| `--max-budget-usd` | Montant en dollars maximum à dépenser pour les appels API avant d'arrêter (mode impression uniquement) | `claude -p --max-budget-usd 5.00 "query"` |

97| `--max-turns` | Limiter le nombre de tours d'agent (mode impression uniquement). Quitte avec une erreur lorsque la limite est atteinte. Pas de limite par défaut | `claude -p --max-turns 3 "query"` |100| `--max-turns` | Limiter le nombre de tours d'agent (mode impression uniquement). Quitte avec une erreur lorsque la limite est atteinte. Pas de limite par défaut. {/* min-version: 2.1.205 */}Avec `--input-format stream-json`, un message envoyé pendant que Claude travaille reste en attente et s'exécute comme son propre tour, avec sa propre limite, lorsque la limite termine le tour actuel. Avant v2.1.205, Claude Code rejetait ce message | `claude -p --max-turns 3 "query"` |

98| `--mcp-config` | Charger les serveurs MCP à partir de fichiers ou de chaînes JSON (séparés par des espaces) | `claude --mcp-config ./mcp.json` |101| `--mcp-config` | Charger les serveurs MCP à partir de fichiers ou de chaînes JSON (séparés par des espaces) | `claude --mcp-config ./mcp.json` |

99| `--model` | Définit le modèle pour la session actuelle avec un alias pour le dernier modèle (`sonnet`, `opus`, `haiku`, ou `fable`) ou le nom complet d'un modèle. Remplace le paramètre [`model`](/fr/settings#available-settings) et [`ANTHROPIC_MODEL`](/fr/model-config#environment-variables) | `claude --model claude-sonnet-5` |102| `--model` | Définit le modèle pour la session actuelle avec un alias pour le dernier modèle (`sonnet`, `opus`, `haiku`, ou `fable`) ou le nom complet d'un modèle. Remplace le paramètre [`model`](/fr/settings#available-settings) et [`ANTHROPIC_MODEL`](/fr/model-config#environment-variables) | `claude --model claude-sonnet-5` |

100| `--name`, `-n` | Définir un nom d'affichage pour la session, affiché dans `/resume` et le titre du terminal. Vous pouvez reprendre une session nommée avec `claude --resume <name>`. <br /><br />[`/rename`](/fr/commands) change le nom en cours de session et l'affiche également dans la barre d'invite | `claude -n "my-feature-work"` |103| `--name`, `-n` | Définir un nom d'affichage pour la session, affiché dans `/resume` et le titre du terminal. Vous pouvez reprendre une session nommée avec `claude --resume <name>`. <br /><br />[`/rename`](/fr/commands) change le nom en cours de session et l'affiche également dans la barre d'invite | `claude -n "my-feature-work"` |

101| `--no-chrome` | Désactiver l'[intégration du navigateur Chrome](/fr/chrome) pour cette session | `claude --no-chrome` |104| `--no-chrome` | Désactiver l'[intégration du navigateur Chrome](/fr/chrome) pour cette session | `claude --no-chrome` |

102| `--no-session-persistence` | Désactiver la persistance de session afin que les sessions ne soient pas enregistrées sur le disque et ne puissent pas être reprises. Mode impression uniquement. La variable d'environnement [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/fr/env-vars) fait la même chose dans n'importe quel mode | `claude -p --no-session-persistence "query"` |105| `--no-session-persistence` | Désactiver la persistance de session afin que les sessions ne soient pas enregistrées sur le disque et ne puissent pas être reprises. Mode impression uniquement. La variable d'environnement [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/fr/env-vars) fait la même chose dans n'importe quel mode | `claude -p --no-session-persistence "query"` |

103| `--output-format` | Spécifier le format de sortie pour le mode impression (options : `text`, `json`, `stream-json`) | `claude -p "query" --output-format json` |106| `--output-format` | Spécifier le format de sortie pour le mode impression (options : `text`, `json`, `stream-json`) | `claude -p "query" --output-format json` |

104| `--permission-mode` | Commencer dans un [mode de permission](/fr/permission-modes) spécifié. Accepte `default`, `acceptEdits`, `plan`, `auto`, `dontAsk`, ou `bypassPermissions`. Remplace `defaultMode` des fichiers de paramètres | `claude --permission-mode plan` |107| `--permission-mode` | Commencer dans un [mode de permission](/fr/permission-modes) spécifié. Accepte `default`, `acceptEdits`, `plan`, `auto`, `dontAsk`, `bypassPermissions`, ou {/* min-version: 2.1.200 */}}`manual` comme alias pour `default`. L'alias `manual` sélectionne le mode que l'interface utilisateur étiquette Manuel et nécessite Claude Code v2.1.200 ou ultérieur ; `claude --help` le répertorie à la place de `default`, et les deux valeurs fonctionnent. Remplace `defaultMode` des fichiers de paramètres | `claude --permission-mode plan` |

105| `--permission-prompt-tool` | Spécifier un outil MCP pour gérer les invites de permission en mode non interactif. {/* min-version: 2.1.199 */}À partir de v2.1.199, l'outil d'invite ne peut pas approuver un outil MCP marqué comme [nécessitant une interaction utilisateur](/fr/mcp#require-approval-for-a-specific-tool) : un résultat `allow` pour celui-ci est converti en refus | `claude -p --permission-prompt-tool mcp_auth_tool "query"` |108| `--permission-prompt-tool` | Spécifier un outil MCP pour gérer les invites de permission en mode non interactif. {/* min-version: 2.1.199 */}À partir de v2.1.199, l'outil d'invite ne peut pas approuver un outil MCP marqué comme [nécessitant une interaction utilisateur](/fr/mcp#require-approval-for-a-specific-tool) : un résultat `allow` pour celui-ci est converti en refus | `claude -p --permission-prompt-tool mcp_auth_tool "query"` |

106| `--plugin-dir` | Charger un plugin à partir d'un répertoire ou d'une archive `.zip` pour cette session uniquement. Chaque drapeau prend un chemin. Répétez le drapeau pour plusieurs plugins : `--plugin-dir A --plugin-dir B.zip` | `claude --plugin-dir ./my-plugin` |109| `--plugin-dir` | Charger un plugin à partir d'un répertoire ou d'une archive `.zip` pour cette session uniquement. Chaque drapeau prend un chemin. Répétez le drapeau pour plusieurs plugins : `--plugin-dir A --plugin-dir B.zip` | `claude --plugin-dir ./my-plugin` |

107| `--plugin-url` | Récupérer une archive `.zip` de plugin à partir d'une URL pour cette session uniquement. Répétez le drapeau pour plusieurs plugins, ou passez des URL séparées par des espaces dans une seule valeur entre guillemets | `claude --plugin-url https://example.com/plugin.zip` |110| `--plugin-url` | Récupérer une archive `.zip` de plugin à partir d'une URL pour cette session uniquement. Répétez le drapeau pour plusieurs plugins, ou passez des URL séparées par des espaces dans une seule valeur entre guillemets | `claude --plugin-url https://example.com/plugin.zip` |

108| `--print`, `-p` | Imprimer la réponse sans mode interactif (voir la [documentation du SDK Agent](/fr/agent-sdk/overview) pour les détails d'utilisation programmatique) | `claude -p "query"` |111| `--print`, `-p` | Imprimer la réponse sans mode interactif (voir la [documentation du SDK Agent](/fr/agent-sdk/overview) pour les détails d'utilisation programmatique) | `claude -p "query"` |

109| `--prompt-suggestions` | Émettre un message `prompt_suggestion` après chaque tour avec une prédiction du prochain message utilisateur. Nécessite `--print`, `--output-format stream-json`, et `--verbose`. Voir [Suggestions d'invite](/fr/interactive-mode#prompt-suggestions) | `claude -p --prompt-suggestions --output-format stream-json --verbose "query"` |112| `--prompt-suggestions` | Émettre un message `prompt_suggestion` après chaque tour avec une prédiction du prochain message utilisateur. Nécessite `--print`, `--output-format stream-json`, et `--verbose`. Voir [Suggestions d'invite](/fr/interactive-mode#prompt-suggestions) | `claude -p --prompt-suggestions --output-format stream-json --verbose "query"` |

110| `--remote` | Créer une nouvelle [session web](/fr/claude-code-on-the-web) sur claude.ai avec la description de tâche fournie | `claude --remote "Fix the login bug"` |113| `--remote` | Alias déprécié pour `--cloud` | `claude --remote "Fix the login bug"` |

111| `--remote-control`, `--rc` | Démarrer une session interactive avec [Remote Control](/fr/remote-control#start-a-remote-control-session) activé afin que vous puissiez également le contrôler depuis claude.ai ou l'application Claude. Optionnellement, passez un nom pour la session | `claude --remote-control "My Project"` |114| `--remote-control`, `--rc` | Démarrer une session interactive avec [Remote Control](/fr/remote-control#start-a-remote-control-session) activé afin que vous puissiez également le contrôler depuis claude.ai ou l'application Claude. Optionnellement, passez un nom pour la session | `claude --remote-control "My Project"` |

112| `--remote-control-session-name-prefix <prefix>` | Préfixe pour les noms de session [Remote Control](/fr/remote-control) générés automatiquement lorsqu'aucun nom explicite n'est défini. Par défaut, le nom d'hôte de votre machine, produisant des noms comme `myhost-graceful-unicorn`. Définissez `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` pour le même effet | `claude remote-control --remote-control-session-name-prefix dev-box` |115| `--remote-control-session-name-prefix <prefix>` | Préfixe pour les noms de session [Remote Control](/fr/remote-control) générés automatiquement lorsqu'aucun nom explicite n'est défini. Par défaut, le nom d'hôte de votre machine, produisant des noms comme `myhost-graceful-unicorn`. Définissez `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` pour le même effet | `claude remote-control --remote-control-session-name-prefix dev-box` |

113| `--replay-user-messages` | Ré-émettre les messages utilisateur de stdin sur stdout pour la reconnaissance. Nécessite `--input-format stream-json` et `--output-format stream-json` | `claude -p --input-format stream-json --output-format stream-json --verbose --replay-user-messages` |116| `--replay-user-messages` | Ré-émettre les messages utilisateur de stdin sur stdout pour la reconnaissance. Nécessite `--input-format stream-json` et `--output-format stream-json` | `claude -p --input-format stream-json --output-format stream-json --verbose --replay-user-messages` |


120| `--system-prompt` | Remplacer l'invite système entière par du texte personnalisé | `claude --system-prompt "You are a Python expert"` |123| `--system-prompt` | Remplacer l'invite système entière par du texte personnalisé | `claude --system-prompt "You are a Python expert"` |

121| `--system-prompt-file` | Charger l'invite système à partir d'un fichier, en remplaçant l'invite par défaut | `claude --system-prompt-file ./custom-prompt.txt` |124| `--system-prompt-file` | Charger l'invite système à partir d'un fichier, en remplaçant l'invite par défaut | `claude --system-prompt-file ./custom-prompt.txt` |

122| `--teleport` | Reprendre une [session web](/fr/claude-code-on-the-web) dans votre terminal local | `claude --teleport` |125| `--teleport` | Reprendre une [session web](/fr/claude-code-on-the-web) dans votre terminal local | `claude --teleport` |

123| `--teammate-mode` | Définir comment les coéquipiers de l'[équipe d'agents](/fr/agent-teams) s'affichent : `in-process` (par défaut), `auto`, `tmux`, ou {/* min-version: 2.1.186 */}`iterm2` (ajouté dans v2.1.186). La valeur par défaut a changé de `auto` dans v2.1.179. Remplace le paramètre [`teammateMode`](/fr/settings#available-settings) pour cette session. Voir [Choisir un mode d'affichage](/fr/agent-teams#choose-a-display-mode) | `claude --teammate-mode auto` |126| `--teammate-mode` | Définir comment les coéquipiers de l'[équipe d'agents](/fr/agent-teams) s'affichent : `in-process` (par défaut), `auto`, `tmux`, ou {/* min-version: 2.1.186 */}}`iterm2` (ajouté dans v2.1.186). La valeur par défaut a changé de `auto` dans v2.1.179. Remplace le paramètre [`teammateMode`](/fr/settings#available-settings) pour cette session. Voir [Choisir un mode d'affichage](/fr/agent-teams#choose-a-display-mode) | `claude --teammate-mode auto` |

124| `--tmux` | Créer une session tmux pour le worktree. Nécessite `--worktree`. Utilise les volets natifs iTerm2 lorsqu'ils sont disponibles ; passez `--tmux=classic` pour le tmux traditionnel | `claude -w feature-auth --tmux` |127| `--tmux` | Créer une session tmux pour le worktree. Nécessite `--worktree`. Utilise les volets natifs iTerm2 lorsqu'ils sont disponibles ; passez `--tmux=classic` pour le tmux traditionnel | `claude -w feature-auth --tmux` |

125| `--tools` | Restreindre les outils intégrés que Claude peut utiliser. Utilisez `""` pour désactiver tous, `"default"` pour tous, ou des noms d'outils comme `"Bash,Edit,Read"`. Les outils MCP ne sont pas affectés ; pour les refuser aussi, utilisez `--disallowedTools "mcp__*"`, ou passez `--strict-mcp-config` sans `--mcp-config` afin qu'aucun serveur MCP ne se charge | `claude --tools "Bash,Edit,Read"` |128| `--tools` | Restreindre les outils intégrés que Claude peut utiliser. Utilisez `""` pour désactiver tous, `"default"` pour tous, ou des noms d'outils comme `"Bash,Edit,Read"`. Les outils MCP ne sont pas affectés ; pour les refuser aussi, utilisez `--disallowedTools "mcp__*"`, ou passez `--strict-mcp-config` sans `--mcp-config` afin qu'aucun serveur MCP ne se charge | `claude --tools "Bash,Edit,Read"` |

126| `--verbose` | Activer la journalisation détaillée, affiche la sortie complète tour par tour. Remplace le paramètre [`viewMode`](/fr/settings#available-settings) pour cette session | `claude --verbose` |129| `--verbose` | Activer la journalisation détaillée, affiche la sortie complète tour par tour. Remplace le paramètre [`viewMode`](/fr/settings#available-settings) pour cette session | `claude --verbose` |

code-review.md +1 −1

Details

276 276 

277Dans n'importe quel mode, commenter `@claude review` [opte la PR dans les révisions déclenchées par push](#manually-trigger-reviews), de sorte que des coûts supplémentaires s'accumulent par push après ce commentaire. Pour exécuter une seule révision sans vous abonner à des pushes futurs, commentez `@claude review once` à la place.277Dans n'importe quel mode, commenter `@claude review` [opte la PR dans les révisions déclenchées par push](#manually-trigger-reviews), de sorte que des coûts supplémentaires s'accumulent par push après ce commentaire. Pour exécuter une seule révision sans vous abonner à des pushes futurs, commentez `@claude review once` à la place.

278 278 

279Les coûts apparaissent sur votre facture Anthropic quel que soit le fait que votre organisation utilise Amazon Bedrock ou Google Vertex AI pour d'autres fonctionnalités Claude Code. Pour définir un plafond de dépenses mensuelles pour Code Review, allez à [claude.ai/admin-settings/usage](https://claude.ai/admin-settings/usage) et configurez la limite pour le service Claude Code Review.279Les coûts apparaissent sur votre facture Anthropic quel que soit le fait que votre organisation utilise Amazon Bedrock ou Google Cloud's Agent Platform pour d'autres fonctionnalités Claude Code. Pour définir un plafond de dépenses mensuelles pour Code Review, allez à [claude.ai/admin-settings/usage](https://claude.ai/admin-settings/usage) et configurez la limite pour le service Claude Code Review.

280 280 

281Surveillez les dépenses via le graphique de coût hebdomadaire dans [analytics](#view-usage) ou la colonne de coût moyen par référentiel dans les paramètres d'administration.281Surveillez les dépenses via le graphique de coût hebdomadaire dans [analytics](#view-usage) ou la colonne de coût moyen par référentiel dans les paramètres d'administration.

282 282 

commands.md +14 −14

Details

24 24 

25**Exécution du travail en parallèle.** Claude délègue les tâches secondaires aux [sous-agents](/fr/sub-agents), et `/tasks` répertorie ce qui s'exécute en arrière-plan de la session actuelle. `/background` détache la session entière pour continuer à s'exécuter en tant qu'[agent en arrière-plan](/fr/agent-view) et libère votre terminal. Pour une modification importante qui s'étend sur la base de code, `/batch` la décompose en unités indépendantes et exécute chacune dans son propre [worktree](/fr/worktrees). Consultez [Exécuter des agents en parallèle](/fr/agents) pour comprendre comment ces approches se rapportent.25**Exécution du travail en parallèle.** Claude délègue les tâches secondaires aux [sous-agents](/fr/sub-agents), et `/tasks` répertorie ce qui s'exécute en arrière-plan de la session actuelle. `/background` détache la session entière pour continuer à s'exécuter en tant qu'[agent en arrière-plan](/fr/agent-view) et libère votre terminal. Pour une modification importante qui s'étend sur la base de code, `/batch` la décompose en unités indépendantes et exécute chacune dans son propre [worktree](/fr/worktrees). Consultez [Exécuter des agents en parallèle](/fr/agents) pour comprendre comment ces approches se rapportent.

26 26 

27**Avant de livrer.** `/diff` montre ce qui a changé, `/code-review` vérifie la diff pour les bugs de correction et les nettoyages et peut appliquer les résultats avec `--fix`, `/review` exécute le même examen en lecture seule sur une demande de tirage GitHub, et `/security-review` donne une lecture plus approfondie en lecture seule. `/code-review ultra` exécute un examen multi-agents dans le cloud.27**Avant de livrer.** `/diff` montre ce qui a changé, `/code-review` vérifie la diff pour les bugs de correction et les nettoyages et peut appliquer les résultats avec `--fix`, `/review` exécute un examen rapide en lecture seule d'une demande de tirage GitHub, `/code-review <level> <pr#>` exécute un examen multi-agents d'une demande de tirage, et `/security-review` vérifie la diff pour les vulnérabilités de sécurité. `/code-review ultra` exécute un examen multi-agents dans le cloud.

28 28 

29**Entre les sessions.** `/clear` démarre une nouvelle tâche tout en conservant la mémoire du projet. `/resume` et `/branch` vous permettent de revenir à ou de forker une conversation antérieure. `/teleport` extrait une session web dans ce terminal, et `/remote-control` vous permet de continuer cette session locale depuis un autre appareil.29**Entre les sessions.** `/clear` démarre une nouvelle tâche tout en conservant la mémoire du projet. `/resume` et `/branch` vous permettent de revenir à ou de forker une conversation antérieure. `/teleport` extrait une session web dans ce terminal, et `/remote-control` vous permet de continuer cette session locale depuis un autre appareil.

30 30 

31**Quand quelque chose ne va pas.** `/rewind` ramène le code et la conversation à un point de contrôle, ou résume une partie de la conversation. `/doctor` et `/debug` diagnostiquent les problèmes d'installation et d'exécution, et `/feedback` signale un bug avec le contexte de la session joint.31**Quand quelque chose ne va pas.** `/rewind` ramène le code et la conversation à un point de contrôle, ou résume une partie de la conversation. `/doctor` exécute une vérification de configuration qui diagnostique les problèmes d'installation et de configuration et peut les corriger, `/debug` diagnostique les problèmes d'exécution, et `/feedback` signale un bug avec le contexte de la session joint.

32 32 

33<h2 id="all-commands">33<h2 id="all-commands">

34 Toutes les commandes34 Toutes les commandes


48</Note>48</Note>

49 49 

50| Commande | Objectif |50| Commande | Objectif |

51| :--------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |51| :--------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

52| `/add-dir <path>` | Ajouter un répertoire de travail pour l'accès aux fichiers pendant la session actuelle. La plupart de la configuration `.claude/` [n'est pas découverte](/fr/permissions#additional-directories-grant-file-access-not-configuration) à partir du répertoire ajouté. Vous pouvez ensuite reprendre la session à partir du répertoire ajouté avec `--continue` ou `--resume` |52| `/add-dir <path>` | Ajouter un répertoire de travail pour l'accès aux fichiers pendant la session actuelle. La plupart de la configuration `.claude/` [n'est pas découverte](/fr/permissions#additional-directories-grant-file-access-not-configuration) à partir du répertoire ajouté. Vous pouvez ensuite reprendre la session à partir du répertoire ajouté avec `--continue` ou `--resume` |

53| `/advisor [model\|off]` | {/* min-version: 2.1.98 */}Activer ou désactiver l'[outil advisor](/fr/advisor), qui consulte un second modèle pour obtenir des conseils à des moments clés lors d'une tâche. Accepte `opus`, `sonnet`, `fable` ({/* min-version: 2.1.170 */}v2.1.170+), ou un ID de modèle complet. Sans argument, ouvre un sélecteur. Nécessite Claude Code v2.1.98 ou ultérieur |53| `/advisor [model\|off]` | {/* min-version: 2.1.98 */}Activer ou désactiver l'[outil advisor](/fr/advisor), qui consulte un second modèle pour obtenir des conseils à des moments clés lors d'une tâche. Accepte `opus`, `sonnet`, `fable` ({/* min-version: 2.1.170 */}v2.1.170+), ou un ID de modèle complet. Sans argument, ouvre un sélecteur. Nécessite Claude Code v2.1.98 ou ultérieur |

54| `/agents` | {/* min-version: 2.1.198 */}À partir de v2.1.198, exécuter `/agents` affiche un rappel pour demander à Claude de créer ou gérer des [sous-agents](/fr/sub-agents), ou pour modifier `.claude/agents/` ou `~/.claude/agents/` directement. {/* max-version: 2.1.197 */}Sur v2.1.197 et antérieur, ouvre une interface interactive pour créer et gérer les configurations des sous-agents |54| `/agents` | {/* min-version: 2.1.198 */}À partir de v2.1.198, exécuter `/agents` affiche un rappel pour demander à Claude de créer ou gérer des [sous-agents](/fr/sub-agents), ou pour modifier `.claude/agents/` ou `~/.claude/agents/` directement. {/* max-version: 2.1.197 */}Sur v2.1.197 et antérieur, ouvre une interface interactive pour créer et gérer les configurations des sous-agents |


62| `/claude-api [migrate\|managed-agents-onboard]` | **[Skill](/fr/skills#bundled-skills).** Charger le matériel de référence de l'API Claude pour le langage de votre projet (Python, TypeScript, Java, Go, Ruby, C#, PHP, ou cURL) et la référence des Agents gérés. Couvre l'utilisation d'outils, le streaming, les lots, les sorties structurées et les pièges courants. S'active également automatiquement lorsque votre code importe `anthropic` ou `@anthropic-ai/sdk`. Exécutez `/claude-api migrate` pour mettre à niveau le code existant de l'API Claude vers un modèle plus récent : Claude vous demande quels fichiers analyser et quel modèle cibler, puis met à jour les ID de modèle, la configuration de la réflexion et d'autres paramètres qui ont changé entre les versions. Exécutez `/claude-api managed-agents-onboard` pour une procédure pas à pas interactive qui crée un nouvel Agent géré à partir de zéro |62| `/claude-api [migrate\|managed-agents-onboard]` | **[Skill](/fr/skills#bundled-skills).** Charger le matériel de référence de l'API Claude pour le langage de votre projet (Python, TypeScript, Java, Go, Ruby, C#, PHP, ou cURL) et la référence des Agents gérés. Couvre l'utilisation d'outils, le streaming, les lots, les sorties structurées et les pièges courants. S'active également automatiquement lorsque votre code importe `anthropic` ou `@anthropic-ai/sdk`. Exécutez `/claude-api migrate` pour mettre à niveau le code existant de l'API Claude vers un modèle plus récent : Claude vous demande quels fichiers analyser et quel modèle cibler, puis met à jour les ID de modèle, la configuration de la réflexion et d'autres paramètres qui ont changé entre les versions. Exécutez `/claude-api managed-agents-onboard` pour une procédure pas à pas interactive qui crée un nouvel Agent géré à partir de zéro |

63| `/clear [name]` | Démarrer une nouvelle conversation avec un contexte vide. La conversation précédente reste disponible dans `/resume`. Passez un nom pour étiqueter la conversation précédente dans le sélecteur `/resume`. Pour libérer du contexte tout en continuant la même conversation, utilisez `/compact` à la place. Alias : `/reset`, `/new` |63| `/clear [name]` | Démarrer une nouvelle conversation avec un contexte vide. La conversation précédente reste disponible dans `/resume`. Passez un nom pour étiqueter la conversation précédente dans le sélecteur `/resume`. Pour libérer du contexte tout en continuant la même conversation, utilisez `/compact` à la place. Alias : `/reset`, `/new` |

64| `/code-review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [target]` | **[Skill](/fr/skills#bundled-skills).** Examiner le diff actuel pour les bugs de correction et pour les nettoyages de réutilisation, de simplification et d'efficacité. Passez `--fix` pour appliquer les conclusions à votre arborescence de travail, `--comment` pour les publier en tant que commentaires en ligne sur la PR GitHub, ou `ultra` pour exécuter un [examen cloud](/fr/ultrareview) approfondi. {/* min-version: 2.1.154 */}À partir de v2.1.154, `/simplify` exécute un examen séparé réservé au nettoyage qui applique les corrections sans rechercher les bugs. Consultez [Examiner un diff localement](/fr/code-review#review-a-diff-locally) pour les niveaux d'effort et le ciblage |64| `/code-review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [target]` | **[Skill](/fr/skills#bundled-skills).** Examiner le diff actuel pour les bugs de correction et pour les nettoyages de réutilisation, de simplification et d'efficacité. Passez `--fix` pour appliquer les conclusions à votre arborescence de travail, `--comment` pour les publier en tant que commentaires en ligne sur la PR GitHub, ou `ultra` pour exécuter un [examen cloud](/fr/ultrareview) approfondi. {/* min-version: 2.1.154 */}À partir de v2.1.154, `/simplify` exécute un examen séparé réservé au nettoyage qui applique les corrections sans rechercher les bugs. Consultez [Examiner un diff localement](/fr/code-review#review-a-diff-locally) pour les niveaux d'effort et le ciblage |

65| `/color [color\|default]` | Définir la couleur de la barre d'invite pour la session actuelle. Couleurs disponibles : `red`, `blue`, `green`, `yellow`, `purple`, `orange`, `pink`, `cyan`. Utilisez `default` pour réinitialiser, ou exécutez sans argument pour choisir une couleur aléatoire. Lorsque [Remote Control](/fr/remote-control) est connecté, la couleur se synchronise avec claude.ai/code |65| `/color [color\|default]` | Définir la couleur de la barre d'invite pour la session actuelle. Couleurs disponibles : `red`, `blue`, `green`, `yellow`, `purple`, `orange`, `pink`, `cyan`. Utilisez `default` pour réinitialiser, ou exécutez sans argument pour choisir une couleur aléatoire. Lorsque [Remote Control](/fr/remote-control) est connecté, la couleur se synchronise avec claude.ai/code. {/* min-version: 2.1.205 */}Également disponible en mode non interactif (`-p`) ; nécessite Claude Code v2.1.205 ou ultérieur |

66| `/compact [instructions]` | Libérer du contexte en résumant la conversation jusqu'à présent. Passez optionnellement des instructions de focus pour le résumé. Consultez [comment la compaction gère les règles, les skills et les fichiers de mémoire](/fr/context-window#what-survives-compaction) |66| `/compact [instructions]` | Libérer du contexte en résumant la conversation jusqu'à présent. Passez optionnellement des instructions de focus pour le résumé. Consultez [comment la compaction gère les règles, les skills et les fichiers de mémoire](/fr/context-window#what-survives-compaction) |

67| `/config [key=value ...]` | Ouvrir l'interface des [Paramètres](/fr/settings) pour ajuster le thème, le modèle, le [style de sortie](/fr/output-styles) et d'autres préférences. {/* min-version: 2.1.181 */}À partir de v2.1.181, passez une ou plusieurs paires `key=value` pour définir un paramètre directement sans ouvrir l'interface, par exemple `/config thinking=false`. {/* min-version: 2.1.182 */}À partir de v2.1.182, les clés de raccourci nommées sont également acceptées, telles que `/config theme=dark` ou `/config model=sonnet`. La forme `key=value` fonctionne également en mode non interactif (`-p`) et depuis [Remote Control](/fr/remote-control). Exécutez `/config --help` pour lister chaque clé définissable avec ses options. Alias : `/settings` |67| `/config [key=value ...]` | Ouvrir l'interface des [Paramètres](/fr/settings) pour ajuster le thème, le modèle, le [style de sortie](/fr/output-styles) et d'autres préférences. {/* min-version: 2.1.181 */}À partir de v2.1.181, passez une ou plusieurs paires `key=value` pour définir un paramètre directement sans ouvrir l'interface, par exemple `/config thinking=false`. {/* min-version: 2.1.182 */}À partir de v2.1.182, les clés de raccourci nommées sont également acceptées, telles que `/config theme=dark` ou `/config model=sonnet`. La forme `key=value` fonctionne également en mode non interactif (`-p`) et depuis [Remote Control](/fr/remote-control). Exécutez `/config --help` pour lister chaque clé définissable avec ses options. Alias : `/settings` |

68| `/context [all]` | Visualiser l'utilisation actuelle du contexte sous forme de grille colorée. Affiche les suggestions d'optimisation pour les outils gourmands en contexte, le surpoids de la mémoire et les avertissements de capacité. En [mode plein écran](/fr/fullscreen), la ventilation par élément est réduite pour garder la grille visible. Passez `all` pour l'étendre |68| `/context [all]` | Visualiser l'utilisation actuelle du contexte sous forme de grille colorée. Affiche les suggestions d'optimisation pour les outils gourmands en contexte, le surpoids de la mémoire et les avertissements de capacité. En [mode plein écran](/fr/fullscreen), la ventilation par élément est réduite pour garder la grille visible. Passez `all` pour l'étendre |


75| `/design-sync [hint]` | **[Skill](/fr/skills#bundled-skills).** Convertir le système de conception React de votre référentiel et le télécharger vers [Claude Design](https://claude.ai/design), afin que les conceptions qu'il produit utilisent vos vrais composants. Nommez optionnellement le système de conception, par exemple `/design-sync Acme DS`. Une première synchronisation vérifie chaque composant et peut prendre quelques heures sur un grand référentiel. Disponible sur l'API Anthropic ; sur Amazon Bedrock, la plateforme d'agents de Google Cloud, et Microsoft Foundry, l'outil sous-jacent ne peut pas atteindre claude.ai, donc la commande n'est pas disponible |75| `/design-sync [hint]` | **[Skill](/fr/skills#bundled-skills).** Convertir le système de conception React de votre référentiel et le télécharger vers [Claude Design](https://claude.ai/design), afin que les conceptions qu'il produit utilisent vos vrais composants. Nommez optionnellement le système de conception, par exemple `/design-sync Acme DS`. Une première synchronisation vérifie chaque composant et peut prendre quelques heures sur un grand référentiel. Disponible sur l'API Anthropic ; sur Amazon Bedrock, la plateforme d'agents de Google Cloud, et Microsoft Foundry, l'outil sous-jacent ne peut pas atteindre claude.ai, donc la commande n'est pas disponible |

76| `/desktop` | Continuer la session actuelle dans l'application Claude Code Desktop. Nécessite macOS ou Windows et un abonnement Claude. Alias : `/app` |76| `/desktop` | Continuer la session actuelle dans l'application Claude Code Desktop. Nécessite macOS ou Windows et un abonnement Claude. Alias : `/app` |

77| `/diff` | Ouvrir un visualiseur de diff interactif montrant les modifications non validées et les diffs par tour. Utilisez les flèches gauche/droite pour basculer entre le diff git actuel et les tours Claude individuels, et haut/bas pour parcourir les fichiers. {/* min-version: 2.1.198 */}À partir de v2.1.198, le visualiseur ouvert se rafraîchit également automatiquement lorsque l'état git du référentiel change en dehors de la session, comme un changement de branche ou un commit dans un autre terminal |77| `/diff` | Ouvrir un visualiseur de diff interactif montrant les modifications non validées et les diffs par tour. Utilisez les flèches gauche/droite pour basculer entre le diff git actuel et les tours Claude individuels, et haut/bas pour parcourir les fichiers. {/* min-version: 2.1.198 */}À partir de v2.1.198, le visualiseur ouvert se rafraîchit également automatiquement lorsque l'état git du référentiel change en dehors de la session, comme un changement de branche ou un commit dans un autre terminal |

78| `/doctor` | Diagnostiquer et vérifier votre installation et vos paramètres Claude Code. Les résultats s'affichent avec des icônes de statut. Appuyez sur `f` pour que Claude corrige les problèmes signalés |78| `/doctor` | **[Skill](/fr/skills#bundled-skills).** Exécuter une vérification de configuration qui diagnostique les problèmes et peut les corriger. Vérifie la santé de l'installation, y compris les installations dupliquées ou résiduelles, les problèmes de `PATH` et les fichiers de paramètres non analysables. Trouve les skills inutilisés, les serveurs MCP et les plugins par rapport à leur coût en contexte, déduplique les fichiers `CLAUDE.md` locaux par rapport aux fichiers archivés, migre les conseils toujours chargés dans les [skills](/fr/skills) et les fichiers `CLAUDE.md` imbriqués qui se chargent à la demande, signale les [hooks](/fr/hooks) lents et vérifie une version plus récente. Offre également de faire du [mode automatique](/fr/permissions#permission-modes) votre défaut et de [pré-approuver](/fr/permissions) les commandes en lecture seule fréquemment refusées. Signale les conclusions en premier et demande une confirmation avant de modifier quoi que ce soit. Depuis le terminal, `claude doctor` affiche les diagnostics d'installation en lecture seule sans démarrer une session. Alias : `/checkup`. {/* min-version: 2.1.205 */}Avant v2.1.205, `/doctor` ouvrait un écran de diagnostics en lecture seule et appuyer sur `f` envoyait le rapport à Claude |

79| `/effort [level\|auto]` | Définir le [niveau d'effort](/fr/model-config#adjust-effort-level) du modèle. Accepte `low`, `medium`, `high`, `xhigh`, `max`, ou `ultracode` ; les niveaux disponibles dépendent du modèle, et `max` et `ultracode` sont limités à la session. `ultracode` est un paramètre Claude Code qui combine le raisonnement `xhigh` avec l'orchestration automatique du [workflow](/fr/workflows#let-claude-decide-with-ultracode). `auto` réinitialise à la valeur par défaut du modèle. Sans argument, ouvre un curseur interactif ; utilisez les flèches gauche et droite pour choisir un niveau et `Entrée` pour appliquer. Prend effet immédiatement sans attendre la fin de la réponse actuelle |79| `/effort [level\|auto]` | Définir le [niveau d'effort](/fr/model-config#adjust-effort-level) du modèle. Accepte `low`, `medium`, `high`, `xhigh`, `max`, ou `ultracode` ; les niveaux disponibles dépendent du modèle, et `max` et `ultracode` sont limités à la session. `ultracode` est un paramètre Claude Code qui combine le raisonnement `xhigh` avec l'orchestration automatique du [workflow](/fr/workflows#let-claude-decide-with-ultracode). `auto` réinitialise à la valeur par défaut du modèle. Sans argument, ouvre un curseur interactif ; utilisez les flèches gauche et droite pour choisir un niveau et `Entrée` pour appliquer. Prend effet immédiatement sans attendre la fin de la réponse actuelle. {/* min-version: 2.1.205 */}Également disponible en mode non interactif (`-p`) avec un argument de niveau, où il s'applique uniquement à la session actuelle et n'est pas enregistré comme valeur par défaut ; nécessite Claude Code v2.1.205 ou ultérieur. Sur Fable 5, Opus 4.8 et Opus 4.7, un `/effort` non interactif signale `Not applied` pendant que la [retenue d'effort par défaut du modèle](/fr/model-config#adjust-effort-level) est en vigueur, donc passez `--effort` au lancement à la place |

80| `/exit` | Quitter le CLI. Dans une [session d'arrière-plan](/fr/agent-view#attach-to-a-session) attachée, cela détache et la session continue de s'exécuter. Alias : `/quit` |80| `/exit` | Quitter le CLI. Dans une [session d'arrière-plan](/fr/agent-view#attach-to-a-session) attachée, cela détache et la session continue de s'exécuter. Alias : `/quit` |

81| `/export [filename]` | Exporter la conversation actuelle en texte brut. Avec un nom de fichier, écrit directement dans ce fichier. Sans, ouvre une boîte de dialogue pour copier dans le presse-papiers ou enregistrer dans un fichier |81| `/export [filename]` | Exporter la conversation actuelle en texte brut. Avec un nom de fichier, écrit directement dans ce fichier. Sans, ouvre une boîte de dialogue pour copier dans le presse-papiers ou enregistrer dans un fichier |

82| `/fast [on\|off]` | Activer ou désactiver le [mode rapide](/fr/fast-mode) |82| `/fast [on\|off]` | Activer ou désactiver le [mode rapide](/fr/fast-mode). {/* min-version: 2.1.205 */}En mode non interactif (`-p`), `/fast` fonctionne uniquement dans une session lancée avec le mode rapide dans sa valeur [`--settings`](/fr/cli-reference#cli-flags), par exemple `claude -p --settings '{"fastMode": true}'` ; le basculement s'applique alors uniquement à la session actuelle et n'est pas enregistré comme valeur par défaut, et dans toute autre session non interactive, la commande signale que le mode rapide n'est pas disponible. Nécessite Claude Code v2.1.205 ou ultérieur |

83| `/feedback [report]` | Soumettre des commentaires, signaler un bogue ou partager votre conversation. Alias : `/bug`, `/share` |83| `/feedback [report]` | Soumettre des commentaires, signaler un bogue ou partager votre conversation. Alias : `/bug`, `/share` |

84| `/fewer-permission-prompts` | **[Skill](/fr/skills#bundled-skills).** Analyser vos transcriptions pour les appels d'outils Bash et MCP en lecture seule courants, puis ajouter une liste d'autorisation priorisée au fichier `.claude/settings.json` du projet pour réduire les invites de permission |84| `/fewer-permission-prompts` | **[Skill](/fr/skills#bundled-skills).** Analyser vos transcriptions pour les appels d'outils Bash et MCP en lecture seule courants, puis ajouter une liste d'autorisation priorisée au fichier `.claude/settings.json` du projet pour réduire les invites de permission |

85| `/focus` | Activer/désactiver la vue de focus, qui affiche uniquement votre dernière invite, un résumé d'appel d'outil d'une ligne avec les statistiques de diff d'édition, et la réponse finale. {/* min-version: 2.1.198 */}À partir de v2.1.198, le résumé d'appel d'outil compte également les sous-agents lancés dans le tour et réduit les notifications de tâche d'arrière-plan terminées en un seul décompte. La sélection persiste entre les sessions ; définissez [`viewMode`](/fr/settings#available-settings) dans les paramètres pour la remplacer. Disponible uniquement dans le [rendu en plein écran](/fr/fullscreen) |85| `/focus` | Activer/désactiver la vue de focus, qui affiche uniquement votre dernière invite, un résumé d'appel d'outil d'une ligne avec les statistiques de diff d'édition, et la réponse finale. {/* min-version: 2.1.198 */}À partir de v2.1.198, le résumé d'appel d'outil compte également les sous-agents lancés dans le tour et réduit les notifications de tâche d'arrière-plan terminées en un seul décompte. La sélection persiste entre les sessions ; définissez [`viewMode`](/fr/settings#available-settings) dans les paramètres pour la remplacer. Disponible uniquement dans le [rendu en plein écran](/fr/fullscreen) |


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

98| `/logout` | Se déconnecter de votre compte Anthropic |98| `/logout` | Se déconnecter de votre compte Anthropic |

99| `/loop [interval] [prompt]` | **[Skill](/fr/skills#bundled-skills).** Exécuter une invite à plusieurs reprises pendant que la session reste ouverte. Omettez l'intervalle et Claude s'auto-règle entre les itérations. Omettez l'invite et, [où disponible](/fr/scheduled-tasks#run-the-built-in-maintenance-prompt), Claude exécute une vérification de maintenance autonome ou l'invite dans `.claude/loop.md`. Exemple : `/loop 5m check if the deploy finished`. Consultez [Exécuter des invites selon un calendrier](/fr/scheduled-tasks). Alias : `/proactive` |99| `/loop [interval] [prompt]` | **[Skill](/fr/skills#bundled-skills).** Exécuter une invite à plusieurs reprises pendant que la session reste ouverte. Omettez l'intervalle et Claude s'auto-règle entre les itérations. Omettez l'invite et, [où disponible](/fr/scheduled-tasks#run-the-built-in-maintenance-prompt), Claude exécute une vérification de maintenance autonome ou l'invite dans `.claude/loop.md`. Exemple : `/loop 5m check if the deploy finished`. Consultez [Exécuter des invites selon un calendrier](/fr/scheduled-tasks). Alias : `/proactive` |

100| `/mcp [reconnect <server>\|enable\|disable [<server>\|all]]` | Gérer les connexions aux serveurs MCP et l'authentification OAuth. Exécutez sans argument pour ouvrir la liste interactive, passez `reconnect <server>` pour reconnecter un serveur déconnecté, ou passez `enable`/`disable` avec un nom de serveur ou `all` pour modifier l'état de la connexion sans ouvrir la boîte de dialogue |100| `/mcp [reconnect <server>\|enable\|disable [<server>\|all]]` | Gérer les connexions aux serveurs MCP et l'authentification OAuth. Exécutez sans argument pour ouvrir la liste interactive, passez `reconnect <server>` pour reconnecter un serveur déconnecté, ou passez `enable`/`disable` avec un nom de serveur ou `all` pour modifier l'état de la connexion sans ouvrir la boîte de dialogue. {/* min-version: 2.1.205 */}Également disponible en mode non interactif (`-p`), où l'exécuter sans argument affiche un résumé textuel de l'état du serveur au lieu d'ouvrir la liste ; nécessite Claude Code v2.1.205 ou ultérieur |

101| `/memory` | Modifier les fichiers de mémoire `CLAUDE.md`, activer ou désactiver la [mémoire automatique](/fr/memory#auto-memory) et afficher les entrées de mémoire automatique |101| `/memory` | Modifier les fichiers de mémoire `CLAUDE.md`, activer ou désactiver la [mémoire automatique](/fr/memory#auto-memory) et afficher les entrées de mémoire automatique |

102| `/mobile` | Afficher le code QR pour télécharger l'application mobile Claude. Alias : `/ios`, `/android` |102| `/mobile` | Afficher le code QR pour télécharger l'application mobile Claude. Alias : `/ios`, `/android` |

103| `/model [model]` | Basculer le modèle IA et l'enregistrer comme valeur par défaut pour les nouvelles sessions. Pour les modèles qui le supportent, utilisez les flèches gauche/droite pour [ajuster le niveau d'effort](/fr/model-config#adjust-effort-level). Sans argument, ouvre un sélecteur ; appuyez sur `s` sur une ligne pour basculer uniquement pour la session actuelle. Le sélecteur demande une confirmation lorsque la conversation a une sortie antérieure, car la réponse suivante relit l'historique complet sans contexte en cache. Une fois confirmé, le changement s'applique sans attendre la fin de la réponse actuelle |103| `/model [model]` | Basculer le modèle IA et l'enregistrer comme valeur par défaut pour les nouvelles sessions. Pour les modèles qui le supportent, utilisez les flèches gauche/droite pour [ajuster le niveau d'effort](/fr/model-config#adjust-effort-level). Sans argument, ouvre un sélecteur ; appuyez sur `s` sur une ligne pour basculer uniquement pour la session actuelle. Le sélecteur demande une confirmation lorsque la conversation a une sortie antérieure, car la réponse suivante relit l'historique complet sans contexte en cache. Une fois confirmé, le changement s'applique sans attendre la fin de la réponse actuelle. {/* min-version: 2.1.205 */}Également disponible en mode non interactif (`-p`) avec un argument de modèle au lieu du sélecteur, où il s'applique uniquement à la session actuelle et n'est pas enregistré comme valeur par défaut ; nécessite Claude Code v2.1.205 ou ultérieur |

104| `/passes` | Partager une semaine gratuite de Claude Code avec des amis. Visible uniquement si votre compte est éligible |104| `/passes` | Partager une semaine gratuite de Claude Code avec des amis. Visible uniquement si votre compte est éligible |

105| `/permissions` | Gérer les règles d'autorisation, de demande et de refus pour les permissions d'outils. Ouvre une boîte de dialogue interactive où vous pouvez afficher les règles par portée, ajouter ou supprimer des règles, gérer les répertoires de travail et examiner les [refus en mode automatique récents](/fr/auto-mode-config#review-denials). Alias : `/allowed-tools` |105| `/permissions` | Gérer les règles d'autorisation, de demande et de refus pour les permissions d'outils. Ouvre une boîte de dialogue interactive où vous pouvez afficher les règles par portée, ajouter ou supprimer des règles, gérer les répertoires de travail et examiner les [refus en mode automatique récents](/fr/auto-mode-config#review-denials). Alias : `/allowed-tools` |

106| `/plan [description]` | Entrer directement en mode plan à partir de l'invite. Passez une description optionnelle pour entrer en mode plan et commencer immédiatement avec cette tâche, par exemple `/plan fix the auth bug` |106| `/plan [description]` | Entrer directement en mode plan à partir de l'invite. Passez une description optionnelle pour entrer en mode plan et commencer immédiatement avec cette tâche, par exemple `/plan fix the auth bug` |


108| `/powerup` | Découvrir les fonctionnalités de Claude Code à travers des leçons interactives rapides avec des démos animées |108| `/powerup` | Découvrir les fonctionnalités de Claude Code à travers des leçons interactives rapides avec des démos animées |

109| `/pr-comments [PR]` | {/* max-version: 2.1.90 */}Supprimé dans v2.1.91. Demandez à Claude directement de consulter les commentaires de demande de tirage à la place. Sur les versions antérieures, récupère et affiche les commentaires d'une demande de tirage GitHub ; détecte automatiquement la PR pour la branche actuelle, ou passez une URL ou un numéro de PR. Nécessite le CLI `gh` |109| `/pr-comments [PR]` | {/* max-version: 2.1.90 */}Supprimé dans v2.1.91. Demandez à Claude directement de consulter les commentaires de demande de tirage à la place. Sur les versions antérieures, récupère et affiche les commentaires d'une demande de tirage GitHub ; détecte automatiquement la PR pour la branche actuelle, ou passez une URL ou un numéro de PR. Nécessite le CLI `gh` |

110| `/privacy-settings` | Afficher et mettre à jour vos paramètres de confidentialité. Disponible uniquement pour les abonnés aux plans Pro et Max |110| `/privacy-settings` | Afficher et mettre à jour vos paramètres de confidentialité. Disponible uniquement pour les abonnés aux plans Pro et Max |

111| `/radio` | Ouvrir Claude FM lo-fi radio dans votre navigateur. Affiche l'URL du flux lorsqu'aucun navigateur n'est disponible. Non disponible sur Bedrock, Vertex, ou Foundry |111| `/radio` | Ouvrir Claude FM lo-fi radio dans votre navigateur. Affiche l'URL du flux lorsqu'aucun navigateur n'est disponible. Non disponible sur Amazon Bedrock, la plateforme d'agents de Google Cloud, ou Microsoft Foundry |

112| `/recap` | Générer un résumé d'une ligne de la session actuelle à la demande. Consultez [Récapitulatif de session](/fr/interactive-mode#session-recap) pour le récapitulatif automatique qui apparaît après votre absence |112| `/recap` | Générer un résumé d'une ligne de la session actuelle à la demande. Consultez [Récapitulatif de session](/fr/interactive-mode#session-recap) pour le récapitulatif automatique qui apparaît après votre absence |

113| `/release-notes` | Afficher le journal des modifications dans un sélecteur de version interactif. Sélectionnez une version spécifique pour voir ses notes de version, ou choisissez d'afficher toutes les versions |113| `/release-notes` | Afficher le journal des modifications dans un sélecteur de version interactif. Sélectionnez une version spécifique pour voir ses notes de version, ou choisissez d'afficher toutes les versions |

114| `/reload-plugins [--force]` | Recharger tous les [plugins](/fr/plugins) actifs pour appliquer les modifications en attente sans redémarrer. Signale les comptages pour chaque composant rechargé et signale les erreurs de chargement. Lorsque le rechargement changerait les outils MCP chargés et invaliderait le cache d'invite, la commande avertit et ignore sauf si vous passez `--force` |114| `/reload-plugins [--force]` | Recharger tous les [plugins](/fr/plugins) actifs pour appliquer les modifications en attente sans redémarrer. Signale les comptages pour chaque composant rechargé et signale les erreurs de chargement. Lorsque le rechargement changerait les outils MCP chargés et invaliderait le cache d'invite, la commande avertit et ignore sauf si vous passez `--force` |

115| `/reload-skills` | {/* min-version: 2.1.152 */}Réanalyser les répertoires de [skills](/fr/skills) et de commandes afin que les skills ajoutés ou modifiés sur le disque pendant la session deviennent disponibles sans redémarrer. Signale le nombre de skills disponibles et le nombre de skills ajoutés ou supprimés. Ajouté dans v2.1.152 |115| `/reload-skills` | {/* min-version: 2.1.152 */}Réanalyser les répertoires de [skills](/fr/skills) et de commandes afin que les skills ajoutés ou modifiés sur le disque pendant la session deviennent disponibles sans redémarrer. Signale le nombre de skills disponibles et le nombre de skills ajoutés ou supprimés. Ajouté dans v2.1.152 |

116| `/remote-control` | Rendre cette session disponible pour le [contrôle à distance](/fr/remote-control) depuis claude.ai. Alias : `/rc` |116| `/remote-control` | Rendre cette session disponible pour le [contrôle à distance](/fr/remote-control) depuis claude.ai. Alias : `/rc` |

117| `/remote-env` | Choisir l'environnement par défaut pour les [agents cloud](/fr/claude-code-on-the-web#configure-your-environment) |117| `/remote-env` | Choisir l'environnement par défaut pour les [agents cloud](/fr/claude-code-on-the-web#configure-your-environment) |

118| `/rename [name]` | Renommer la session actuelle et afficher le nom sur la barre d'invite. Sans nom, génère automatiquement un à partir de l'historique de la conversation |118| `/rename [name]` | Renommer la session actuelle et afficher le nom sur la barre d'invite. Sans nom, génère automatiquement un à partir de l'historique de la conversation. {/* min-version: 2.1.205 */}Également disponible en mode non interactif (`-p`) ; nécessite Claude Code v2.1.205 ou ultérieur |

119| `/resume [session]` | Reprendre une conversation par ID ou nom, ou ouvrir le sélecteur de session. À partir de v2.1.144, les [sessions d'arrière-plan](/fr/agent-view) apparaissent dans le sélecteur marquées avec `bg`. Alias : `/continue` |119| `/resume [session]` | Reprendre une conversation par ID ou nom, ou ouvrir le sélecteur de session. À partir de v2.1.144, les [sessions d'arrière-plan](/fr/agent-view) apparaissent dans le sélecteur marquées avec `bg`. Alias : `/continue` |

120| `/review [PR]` | Examiner une demande de tirage GitHub par numéro, en utilisant le même moteur d'examen que `/code-review`. Sans arguments, répertorie les PR ouvertes à sélectionner. Pour un examen basé sur le cloud, consultez [`/code-review ultra`](/fr/ultrareview) |120| `/review [PR]` | {/* min-version: 2.1.202 */}Exécuter un examen rapide en une seule passe et en lecture seule d'une demande de tirage GitHub par numéro. Sans argument, répertorie les PR ouvertes à sélectionner ; le texte après le numéro de PR devient des instructions d'examen supplémentaires. De v2.1.186 à v2.1.201, `/review` exécutait plutôt le même moteur multi-agents que `/code-review medium`. Pour un examen multi-agents à un niveau d'effort choisi, utilisez [`/code-review <level> <pr#>`](/fr/code-review#review-a-diff-locally) ; pour un examen basé sur le cloud, consultez [`/code-review ultra`](/fr/ultrareview) |

121| `/rewind` | Rembobiner la conversation et/ou le code à un point antérieur, ou résumer à partir d'un message sélectionné. Consultez [checkpointing](/fr/checkpointing). Alias : `/checkpoint`, `/undo` |121| `/rewind` | Rembobiner la conversation et/ou le code à un point antérieur, ou résumer à partir d'un message sélectionné. Consultez [checkpointing](/fr/checkpointing). Alias : `/checkpoint`, `/undo` |

122| `/run` | **[Skill](/fr/skills#bundled-skills).** Lancer et piloter l'application de votre projet pour voir un changement fonctionner dans l'application en cours d'exécution, pas seulement dans les tests. Consultez [Exécuter et vérifier votre application](/fr/skills#run-and-verify-your-app). {/* min-version: 2.1.145 */}Nécessite Claude Code v2.1.145 ou ultérieur |122| `/run` | **[Skill](/fr/skills#bundled-skills).** Lancer et piloter l'application de votre projet pour voir un changement fonctionner dans l'application en cours d'exécution, pas seulement dans les tests. Consultez [Exécuter et vérifier votre application](/fr/skills#run-and-verify-your-app). {/* min-version: 2.1.145 */}Nécessite Claude Code v2.1.145 ou ultérieur |

123| `/run-skill-generator` | **[Skill](/fr/skills#bundled-skills).** Enseigner à `/run` et `/verify` comment construire, lancer et piloter l'application de votre projet à partir d'un environnement propre en écrivant un [skill](/fr/skills#run-and-verify-your-app) par projet. {/* min-version: 2.1.145 */}Nécessite Claude Code v2.1.145 ou ultérieur |123| `/run-skill-generator` | **[Skill](/fr/skills#bundled-skills).** Enseigner à `/run` et `/verify` comment construire, lancer et piloter l'application de votre projet à partir d'un environnement propre en écrivant un [skill](/fr/skills#run-and-verify-your-app) par projet. {/* min-version: 2.1.145 */}Nécessite Claude Code v2.1.145 ou ultérieur |


126| `/scroll-speed` | Ajuster la [vitesse de défilement](/fr/fullscreen#mouse-wheel-scrolling) de la molette de la souris de manière interactive, avec une règle que vous pouvez faire défiler pendant que la boîte de dialogue est ouverte pour prévisualiser le changement. Disponible uniquement dans le [rendu en plein écran](/fr/fullscreen) et non dans le terminal de l'IDE JetBrains |126| `/scroll-speed` | Ajuster la [vitesse de défilement](/fr/fullscreen#mouse-wheel-scrolling) de la molette de la souris de manière interactive, avec une règle que vous pouvez faire défiler pendant que la boîte de dialogue est ouverte pour prévisualiser le changement. Disponible uniquement dans le [rendu en plein écran](/fr/fullscreen) et non dans le terminal de l'IDE JetBrains |

127| `/security-review` | Analyser les modifications en attente sur la branche actuelle pour les vulnérabilités de sécurité. Examine le diff git et identifie les risques comme l'injection, les problèmes d'authentification et l'exposition de données |127| `/security-review` | Analyser les modifications en attente sur la branche actuelle pour les vulnérabilités de sécurité. Examine le diff git et identifie les risques comme l'injection, les problèmes d'authentification et l'exposition de données |

128| `/setup-bedrock` | Configurer l'authentification [Amazon Bedrock](/fr/amazon-bedrock), la région et les épingles de modèle via un assistant interactif. Visible uniquement lorsque `CLAUDE_CODE_USE_BEDROCK=1` est défini. Les utilisateurs de Bedrock pour la première fois peuvent également accéder à cet assistant à partir de l'écran de connexion |128| `/setup-bedrock` | Configurer l'authentification [Amazon Bedrock](/fr/amazon-bedrock), la région et les épingles de modèle via un assistant interactif. Visible uniquement lorsque `CLAUDE_CODE_USE_BEDROCK=1` est défini. Les utilisateurs de Bedrock pour la première fois peuvent également accéder à cet assistant à partir de l'écran de connexion |

129| `/setup-vertex` | Configurer l'authentification [Google Vertex AI](/fr/google-vertex-ai), le projet, la région et les épingles de modèle via un assistant interactif. Visible uniquement lorsque `CLAUDE_CODE_USE_VERTEX=1` est défini. Les utilisateurs de Vertex AI pour la première fois peuvent également accéder à cet assistant à partir de l'écran de connexion |129| `/setup-vertex` | Configurer l'authentification [Google Cloud's Agent Platform](/fr/google-vertex-ai), le projet, la région et les épingles de modèle via un assistant interactif. Visible uniquement lorsque `CLAUDE_CODE_USE_VERTEX=1` est défini. Les utilisateurs de Google Cloud's Agent Platform pour la première fois peuvent également accéder à cet assistant à partir de l'écran de connexion |

130| `/simplify [target]` | {/* min-version: 2.1.154 */}**[Skill](/fr/skills#bundled-skills).** Examiner le code modifié pour les opportunités de nettoyage et appliquer les corrections. Quatre [agents](/fr/sub-agents) d'examen s'exécutent en parallèle, couvrant la réutilisation des assistants existants, la simplification, l'efficacité et si le changement se situe au bon niveau d'abstraction. À partir de v2.1.154, l'examen ne recherche pas les bugs de correction. Utilisez `/code-review` pour trouver les bugs. Sur les versions antérieures, `/simplify` est équivalent à `/code-review --fix`. Passez un chemin ou une référence PR pour examiner une cible spécifique |130| `/simplify [target]` | {/* min-version: 2.1.154 */}**[Skill](/fr/skills#bundled-skills).** Examiner le code modifié pour les opportunités de nettoyage et appliquer les corrections. Quatre [agents](/fr/sub-agents) d'examen s'exécutent en parallèle, couvrant la réutilisation des assistants existants, la simplification, l'efficacité et si le changement se situe au bon niveau d'abstraction. À partir de v2.1.154, l'examen ne recherche pas les bugs de correction. Utilisez `/code-review` pour trouver les bugs. Sur les versions antérieures, `/simplify` est équivalent à `/code-review --fix`. Passez un chemin ou une référence PR pour examiner une cible spécifique |

131| `/skills` | Lister les [skills](/fr/skills) disponibles. {/* min-version: 2.1.121 */}À partir de v2.1.121, tapez pour filtrer la liste par nom. Appuyez sur `t` pour trier par nombre de tokens. Appuyez sur `Espace` pour [masquer un skill à Claude ou au menu `/`](/fr/skills#override-skill-visibility-from-settings), puis `Entrée` pour enregistrer |131| `/skills` | Lister les [skills](/fr/skills) disponibles. {/* min-version: 2.1.121 */}À partir de v2.1.121, tapez pour filtrer la liste par nom. Appuyez sur `t` pour trier par nombre de tokens. Appuyez sur `Espace` pour [masquer un skill à Claude ou au menu `/`](/fr/skills#override-skill-visibility-from-settings), puis `Entrée` pour enregistrer |

132| `/stats` | Alias pour `/usage`. Ouvre l'onglet Stats |132| `/stats` | Alias pour `/usage`. Ouvre l'onglet Stats |


144| `/ultrareview [PR]` | Exécuter un examen de code approfondi multi-agents dans un sandbox cloud avec [ultrareview](/fr/ultrareview). L'invocation préférée est maintenant `/code-review ultra`, et `/ultrareview` reste comme alias. Inclut 3 exécutions gratuites sur Pro et Max, puis nécessite les [crédits d'utilisation](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) |144| `/ultrareview [PR]` | Exécuter un examen de code approfondi multi-agents dans un sandbox cloud avec [ultrareview](/fr/ultrareview). L'invocation préférée est maintenant `/code-review ultra`, et `/ultrareview` reste comme alias. Inclut 3 exécutions gratuites sur Pro et Max, puis nécessite les [crédits d'utilisation](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) |

145| `/upgrade` | Ouvrir la page de mise à niveau pour passer à un niveau de plan supérieur |145| `/upgrade` | Ouvrir la page de mise à niveau pour passer à un niveau de plan supérieur |

146| `/usage` | Afficher le coût de la session, les limites d'utilisation du plan et les statistiques d'activité. Sur un plan Pro, Max, Team ou Enterprise, inclut une ventilation de l'utilisation par skill, sous-agent, plugin et serveur MCP. Consultez le [guide de suivi des coûts](/fr/costs#using-the-%2Fusage-command) pour les détails. `/cost` et `/stats` sont des alias |146| `/usage` | Afficher le coût de la session, les limites d'utilisation du plan et les statistiques d'activité. Sur un plan Pro, Max, Team ou Enterprise, inclut une ventilation de l'utilisation par skill, sous-agent, plugin et serveur MCP. Consultez le [guide de suivi des coûts](/fr/costs#using-the-%2Fusage-command) pour les détails. `/cost` et `/stats` sont des alias |

147| `/usage-credits` | Configurer les crédits d'utilisation pour continuer à travailler lorsque vous atteignez une limite. Anciennement `/extra-usage` |147| `/usage-credits` | Configurer les crédits d'utilisation pour continuer à travailler lorsque vous atteignez une limite. Ouvre la page de facturation des crédits d'utilisation dans votre navigateur. {/* min-version: 2.1.205 */}Lorsqu'aucun navigateur ne peut s'ouvrir, par exemple via SSH, la commande affiche l'URL à visiter à la place ; cela nécessite Claude Code v2.1.205 ou ultérieur, et les versions antérieures n'affichaient rien dans ce cas. Anciennement `/extra-usage` |

148| `/verify` | **[Skill](/fr/skills#bundled-skills).** Confirmer qu'un changement de code fait ce qu'il devrait en construisant l'application de votre projet, en l'exécutant et en observant le résultat, plutôt que de compter sur les tests ou les vérifications de type. Consultez [Exécuter et vérifier votre application](/fr/skills#run-and-verify-your-app). {/* min-version: 2.1.145 */}Nécessite Claude Code v2.1.145 ou ultérieur |148| `/verify` | **[Skill](/fr/skills#bundled-skills).** Confirmer qu'un changement de code fait ce qu'il devrait en construisant l'application de votre projet, en l'exécutant et en observant le résultat, plutôt que de compter sur les tests ou les vérifications de type. Consultez [Exécuter et vérifier votre application](/fr/skills#run-and-verify-your-app). {/* min-version: 2.1.145 */}Nécessite Claude Code v2.1.145 ou ultérieur |

149| `/vim` | {/* max-version: 2.1.91 */}Supprimé dans v2.1.92. Pour basculer entre les modes d'édition Vim et Normal, utilisez `/config` → Mode d'édition |149| `/vim` | {/* max-version: 2.1.91 */}Supprimé dans v2.1.92. Pour basculer entre les modes d'édition Vim et Normal, utilisez `/config` → Mode d'édition |

150| `/voice [hold\|tap\|off]` | Activer/désactiver la [dictée vocale](/fr/voice-dictation), ou l'activer dans un mode spécifique. Nécessite un compte Claude.ai |150| `/voice [hold\|tap\|off]` | Activer/désactiver la [dictée vocale](/fr/voice-dictation), ou l'activer dans un mode spécifique. Nécessite un compte Claude.ai |

Details

255 </Step>255 </Step>

256</Steps>256</Steps>

257 257 

258Lorsque vous créez une PR en utilisant `gh pr create`, la session est automatiquement liée à cette PR. Pour la reprendre plus tard, exécutez `claude --from-pr <number>` ou collez l'URL de la PR dans le sélecteur [`/resume`](/fr/sessions#use-the-session-picker).258Lorsque vous créez une PR en utilisant `gh pr create`, la session est automatiquement liée à cette PR. Pour la reprendre plus tard, exécutez `claude --from-pr 123`, en remplaçant 123 par le numéro de la PR, ou collez l'URL de la PR dans le sélecteur [`/resume`](/fr/sessions#use-the-session-picker).

259 259 

260<Tip>260<Tip>

261 Examinez la PR générée par Claude avant de la soumettre et demandez à Claude de mettre en évidence les risques ou considérations potentiels.261 Examinez la PR générée par Claude avant de la soumettre et demandez à Claude de mettre en évidence les risques ou considérations potentiels.

Details

319Parfois, vous voulez que Claude demande avant chaque modification. Parfois, vous voulez juste319Parfois, vous voulez que Claude demande avant chaque modification. Parfois, vous voulez juste

320qu'il expédie. Vous ne devriez pas avoir à choisir une fois pour toutes.320qu'il expédie. Vous ne devriez pas avoir à choisir une fois pour toutes.

321 321 

322*Maj+Tab* parcourt la longueur de la laisse que Claude obtient : *default* demande avant322*Maj+Tab* parcourt la longueur de la laisse que Claude obtient : *Manual* (la

323les choses risquées, *acceptEdits* laisse les modifications de fichiers et les commandes de système de fichiers courantes323valeur de paramètre `default`) demande avant chaque action, *acceptEdits* laisse les modifications de fichiers et les commandes de système de fichiers courantes

324passer tout en vérifiant avant les autres commandes shell, et *plan*324passer tout en vérifiant avant les autres commandes shell, et *plan*

325propose des modifications pour votre approbation avant que quoi que ce soit ne soit touché. Le mode plan est325propose des modifications pour votre approbation avant que quoi que ce soit ne soit touché. Le mode plan est

326le constructeur de confiance, alors commencez par là pour tout ce qui touche plusieurs fichiers.326le constructeur de confiance, alors commencez par là pour tout ce qui touche plusieurs fichiers.

computer-use.md +1 −1

Details

242* Vous êtes sur macOS. L'utilisation de l'ordinateur dans la CLI n'est pas disponible sur Linux ou Windows. Sur Windows, utilisez [utilisation de l'ordinateur dans Desktop](/fr/desktop#let-claude-use-your-computer) à la place.242* Vous êtes sur macOS. L'utilisation de l'ordinateur dans la CLI n'est pas disponible sur Linux ou Windows. Sur Windows, utilisez [utilisation de l'ordinateur dans Desktop](/fr/desktop#let-claude-use-your-computer) à la place.

243* Vous exécutez Claude Code v2.1.85 ou ultérieur. Exécutez `claude --version` pour vérifier.243* Vous exécutez Claude Code v2.1.85 ou ultérieur. Exécutez `claude --version` pour vérifier.

244* Vous êtes sur un plan Pro ou Max. Exécutez `/status` pour confirmer votre abonnement.244* Vous êtes sur un plan Pro ou Max. Exécutez `/status` pour confirmer votre abonnement.

245* Vous êtes authentifié via claude.ai. L'utilisation de l'ordinateur n'est pas disponible avec les fournisseurs tiers comme Amazon Bedrock, Google Cloud Vertex AI ou Microsoft Foundry. Si vous accédez à Claude exclusivement via un fournisseur tiers, vous avez besoin d'un compte claude.ai séparé pour utiliser cette fonctionnalité.245* Vous êtes authentifié via claude.ai. L'utilisation de l'ordinateur n'est pas disponible avec les fournisseurs tiers comme Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry. Si vous accédez à Claude exclusivement via un fournisseur tiers, vous avez besoin d'un compte claude.ai séparé pour utiliser cette fonctionnalité.

246* Vous êtes dans une session interactive. L'utilisation de l'ordinateur n'est pas disponible en mode non-interactif avec le drapeau `-p`.246* Vous êtes dans une session interactive. L'utilisation de l'ordinateur n'est pas disponible en mode non-interactif avec le drapeau `-p`.

247 247 

248<h2 id="see-also">248<h2 id="see-also">

costs.md +1 −1

Details

51 Pour les organisations avec des limites de débit personnalisées, le trafic Claude Code dans cet espace de travail compte vers les limites de débit API globales de votre organisation. Vous pouvez définir une [limite de débit d'espace de travail](https://platform.claude.com/docs/fr/api/rate-limits#setting-lower-limits-for-workspaces) sur la page Limites de cet espace de travail dans la Console Claude pour limiter la part de Claude Code et protéger les autres charges de travail de production.51 Pour les organisations avec des limites de débit personnalisées, le trafic Claude Code dans cet espace de travail compte vers les limites de débit API globales de votre organisation. Vous pouvez définir une [limite de débit d'espace de travail](https://platform.claude.com/docs/fr/api/rate-limits#setting-lower-limits-for-workspaces) sur la page Limites de cet espace de travail dans la Console Claude pour limiter la part de Claude Code et protéger les autres charges de travail de production.

52</Note>52</Note>

53 53 

54Sur Bedrock, Vertex et Foundry, Claude Code n'envoie pas de métriques depuis votre cloud. Une [passerelle d'applications Claude](/fr/claude-apps-gateway) auto-hébergée fournit l'attribution d'utilisation par utilisateur, les métriques OTLP avec les décomptes de tokens, et les [limites de dépenses par utilisateur](/fr/claude-apps-gateway-spend-limits) sur ces fournisseurs. Les organisations qui acheminent Claude Code via une [passerelle LLM](/fr/llm-gateway) différente peuvent suivre les dépenses à la passerelle à la place, puisqu'elle voit chaque requête.54Sur Amazon Bedrock, Google Cloud's Agent Platform et Microsoft Foundry, Claude Code n'envoie pas de métriques depuis votre cloud. Une [passerelle d'applications Claude](/fr/claude-apps-gateway) auto-hébergée fournit l'attribution d'utilisation par utilisateur, les métriques OTLP avec les décomptes de tokens, et les [limites de dépenses par utilisateur](/fr/claude-apps-gateway-spend-limits) sur ces fournisseurs. Les organisations qui acheminent Claude Code via une [passerelle LLM](/fr/llm-gateway) différente peuvent suivre les dépenses à la passerelle à la place, puisqu'elle voit chaque requête.

55 55 

56<h3 id="rate-limit-recommendations">56<h3 id="rate-limit-recommendations">

57 Recommandations de limite de débit57 Recommandations de limite de débit

data-usage.md +8 −8

Details

23 Programme de partenariat pour développeurs23 Programme de partenariat pour développeurs

24</h3>24</h3>

25 25 

26Si vous acceptez explicitement les méthodes pour nous fournir des matériaux à utiliser pour la formation, comme via le [Programme de partenariat pour développeurs](https://support.claude.com/en/articles/11174108-about-the-development-partner-program), nous pouvons utiliser ces matériaux fournis pour former nos modèles. Un administrateur d'organisation peut accepter explicitement le Programme de partenariat pour développeurs pour son organisation. Notez que ce programme est disponible uniquement pour l'API Anthropic propriétaire, et non pour les utilisateurs de Bedrock ou Vertex.26Si vous acceptez explicitement les méthodes pour nous fournir des matériaux à utiliser pour la formation, comme via le [Programme de partenariat pour développeurs](https://support.claude.com/en/articles/11174108-about-the-development-partner-program), nous pouvons utiliser ces matériaux fournis pour former nos modèles. Un administrateur d'organisation peut accepter explicitement le Programme de partenariat pour développeurs pour son organisation. Notez que ce programme est disponible uniquement pour l'API Anthropic propriétaire, et non pour les utilisateurs d'Amazon Bedrock ou de la plateforme Agent de Google Cloud.

27 27 

28<h3 id="feedback-using-the-/feedback-command">28<h3 id="feedback-using-the-/feedback-command">

29 Retours d'information à l'aide de la commande `/feedback`29 Retours d'information à l'aide de la commande `/feedback`


39 39 

40Après l'invite de notation, vous pouvez voir une question de suivi distincte demandant « Anthropic peut-il consulter votre transcription de session pour nous aider à améliorer Claude Code ? ». Ceci est une deuxième étape optionnelle distincte de la notation :40Après l'invite de notation, vous pouvez voir une question de suivi distincte demandant « Anthropic peut-il consulter votre transcription de session pour nous aider à améliorer Claude Code ? ». Ceci est une deuxième étape optionnelle distincte de la notation :

41 41 

42* **Oui** : télécharge votre transcription de conversation, toute transcription de sous-agent et le fichier journal de session brut du disque vers Anthropic. Les modèles de clé API et de jeton connus sont masqués avant le téléchargement. Le code source, le contenu des fichiers et tout autre contenu de conversation sont téléchargés tels quels. Les transcriptions partagées sont conservées jusqu'à 6 mois. Sur Bedrock, Vertex AI, Foundry et les sessions de [passerelle d'applications Claude](/fr/claude-apps-gateway) connectées, Oui écrit la même charge utile dans une archive locale sous `~/.claude/feedback-bundles/` au lieu de télécharger ; rien ne quitte votre machine jusqu'à ce que vous transmettiez ce fichier.42* **Oui** : télécharge votre transcription de conversation, toute transcription de sous-agent et le fichier journal de session brut du disque vers Anthropic. Les modèles de clé API et de jeton connus sont masqués avant le téléchargement. Le code source, le contenu des fichiers et tout autre contenu de conversation sont téléchargés tels quels. Les transcriptions partagées sont conservées jusqu'à 6 mois. Sur Amazon Bedrock, la plateforme Agent de Google Cloud, Microsoft Foundry et les sessions de [passerelle d'applications Claude](/fr/claude-apps-gateway) connectées, Oui écrit la même charge utile dans une archive locale sous `~/.claude/feedback-bundles/` au lieu de télécharger ; rien ne quitte votre machine jusqu'à ce que vous transmettiez ce fichier.

43* **Non** : refuse sans rien envoyer43* **Non** : refuse sans rien envoyer

44* **Ne plus demander** : refuse et arrête cette question de suivi d'apparaître dans les futures sessions44* **Ne plus demander** : refuse et arrête cette question de suivi d'apparaître dans les futures sessions

45 45 


90Le chiffrement au repos dépend de votre fournisseur de modèle :90Le chiffrement au repos dépend de votre fournisseur de modèle :

91 91 

92| Fournisseur | Chiffrement au repos |92| Fournisseur | Chiffrement au repos |

93| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |93| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |

94| Anthropic API | Chiffrement des disques au niveau de l'infrastructure (AES-256). Activez [Zero Data Retention](/fr/zero-data-retention) pour aucune persistance côté serveur. |94| Anthropic API | Chiffrement des disques au niveau de l'infrastructure (AES-256). Activez [Zero Data Retention](/fr/zero-data-retention) pour aucune persistance côté serveur. |

95| Amazon Bedrock | AES-256 avec clés gérées par AWS. Clés gérées par le client disponibles via AWS KMS. |95| Amazon Bedrock | AES-256 avec clés gérées par AWS. Clés gérées par le client disponibles via AWS KMS. |

96| Google Cloud Vertex AI | Clés de chiffrement gérées par Google. CMEK disponible. |96| Google Cloud's Agent Platform | Clés de chiffrement gérées par Google. CMEK disponible. |

97| Microsoft Foundry | Les demandes sont acheminées vers l'infrastructure Anthropic avec chiffrement des disques AES-256. |97| Microsoft Foundry | Les demandes sont acheminées vers l'infrastructure Anthropic avec chiffrement des disques AES-256. |

98 98 

99Claude Code est construit sur les API d'Anthropic. Pour plus de détails concernant les contrôles de sécurité de l'API, y compris les procédures de journalisation des API, consultez les artefacts de conformité dans le [Centre de confiance Anthropic](https://trust.anthropic.com).99Claude Code est construit sur les API d'Anthropic. Pour plus de détails concernant les contrôles de sécurité de l'API, y compris les procédures de journalisation des API, consultez les artefacts de conformité dans le [Centre de confiance Anthropic](https://trust.anthropic.com).


121 121 

122Lorsque vous exécutez la commande `/feedback`, une copie de votre historique de conversation complet, y compris le code, est envoyée à Anthropic. Avant de soumettre, vous choisissez la quantité d'historique à inclure : la session actuelle uniquement, qui est la valeur par défaut, ou également d'autres sessions du même projet au cours des 24 dernières heures ou 7 derniers jours. Les données sont chiffrées en transit via TLS et stockées dans Google Cloud Storage, qui chiffre les données stockées au repos par défaut. Optionnellement, un problème GitHub est créé dans le référentiel public. Pour refuser, définissez la variable d'environnement `DISABLE_FEEDBACK_COMMAND` sur `1`.122Lorsque vous exécutez la commande `/feedback`, une copie de votre historique de conversation complet, y compris le code, est envoyée à Anthropic. Avant de soumettre, vous choisissez la quantité d'historique à inclure : la session actuelle uniquement, qui est la valeur par défaut, ou également d'autres sessions du même projet au cours des 24 dernières heures ou 7 derniers jours. Les données sont chiffrées en transit via TLS et stockées dans Google Cloud Storage, qui chiffre les données stockées au repos par défaut. Optionnellement, un problème GitHub est créé dans le référentiel public. Pour refuser, définissez la variable d'environnement `DISABLE_FEEDBACK_COMMAND` sur `1`.

123 123 

124Lorsque vous utilisez un fournisseur tiers tel que Bedrock ou Vertex, ou que vous n'avez pas d'identifiants Anthropic configurés, `/feedback` écrit le rapport dans une archive locale sous `~/.claude/feedback-bundles/` au lieu de l'envoyer à Anthropic. Les modèles de clé API et de jeton connus sont masqués avant que l'archive ne soit écrite. Rien ne quitte votre machine jusqu'à ce que vous envoyiez ce fichier à votre représentant du compte Anthropic ou que vous le joigniez à une demande d'assistance.124Lorsque vous utilisez un fournisseur tiers tel qu'Amazon Bedrock ou Google Cloud's Agent Platform, ou que vous n'avez pas d'identifiants Anthropic configurés, `/feedback` écrit le rapport dans une archive locale sous `~/.claude/feedback-bundles/` au lieu de l'envoyer à Anthropic. Les modèles de clé API et de jeton connus sont masqués avant que l'archive ne soit écrite. Rien ne quitte votre machine jusqu'à ce que vous envoyiez ce fichier à votre représentant du compte Anthropic ou que vous le joigniez à une demande d'assistance.

125 125 

126<h2 id="default-behaviors-by-api-provider">126<h2 id="default-behaviors-by-api-provider">

127 Comportements par défaut par fournisseur d'API127 Comportements par défaut par fournisseur d'API

128</h2>128</h2>

129 129 

130Par défaut, les rapports d'erreurs, la télémétrie et les rapports de bogues sont désactivés lors de l'utilisation de Bedrock, Vertex, Foundry ou Claude Platform sur AWS. Les sondages de qualité de session et la vérification de sécurité du domaine WebFetch font exception et s'exécutent quel que soit le fournisseur. Sur une session de [passerelle d'applications Claude](/fr/claude-apps-gateway) connectée, les analyses d'utilisation, les rapports d'erreurs et les évaluations de sondage à Anthropic sont désactivés par la passerelle elle-même, sans paramètre pour les réactiver. Vous pouvez refuser tout le trafic non essentiel, y compris les sondages, à la fois en définissant `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`. Cette variable n'affecte pas la vérification WebFetch, qui a sa propre option de refus. Voici les comportements par défaut complets :130Par défaut, les rapports d'erreurs, la télémétrie et les rapports de bogues sont désactivés lors de l'utilisation d'Amazon Bedrock, de Google Cloud's Agent Platform, de Microsoft Foundry ou de Claude Platform sur AWS. Les sondages de qualité de session et la vérification de sécurité du domaine WebFetch font exception et s'exécutent quel que soit le fournisseur. Sur une session de [passerelle d'applications Claude](/fr/claude-apps-gateway) connectée, les analyses d'utilisation, les rapports d'erreurs et les évaluations de sondage à Anthropic sont désactivés par la passerelle elle-même, sans paramètre pour les réactiver. Vous pouvez refuser tout le trafic non essentiel, y compris les sondages, à la fois en définissant `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`. Cette variable n'affecte pas la vérification WebFetch, qui a sa propre option de refus. Voici les comportements par défaut complets :

131 131 

132| Service | Claude API | Vertex API | Bedrock API | Foundry API | Claude Platform sur AWS |132| Service | Claude API | Google Cloud's Agent Platform API | Amazon Bedrock API | Microsoft Foundry API | Claude Platform sur AWS |

133| ------------------------------------------------ | ------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------ |133| ------------------------------------------------ | ------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------ |

134| **Anthropic (Métriques)** | Activé par défaut.<br />`DISABLE_TELEMETRY=1` pour désactiver. | Désactivé par défaut.<br />`CLAUDE_CODE_USE_VERTEX` doit être 1. | Désactivé par défaut.<br />`CLAUDE_CODE_USE_BEDROCK` doit être 1. | Désactivé par défaut.<br />`CLAUDE_CODE_USE_FOUNDRY` doit être 1. | Désactivé par défaut.<br />`CLAUDE_CODE_USE_ANTHROPIC_AWS` doit être 1. |134| **Anthropic (Métriques)** | Activé par défaut.<br />`DISABLE_TELEMETRY=1` pour désactiver. | Désactivé par défaut.<br />`CLAUDE_CODE_USE_VERTEX` doit être 1. | Désactivé par défaut.<br />`CLAUDE_CODE_USE_BEDROCK` doit être 1. | Désactivé par défaut.<br />`CLAUDE_CODE_USE_FOUNDRY` doit être 1. | Désactivé par défaut.<br />`CLAUDE_CODE_USE_ANTHROPIC_AWS` doit être 1. |

135| **Sentry (Erreurs)** | Activé par défaut.<br />`DISABLE_ERROR_REPORTING=1` pour désactiver. | Désactivé par défaut.<br />`CLAUDE_CODE_USE_VERTEX` doit être 1. | Désactivé par défaut.<br />`CLAUDE_CODE_USE_BEDROCK` doit être 1. | Désactivé par défaut.<br />`CLAUDE_CODE_USE_FOUNDRY` doit être 1. | Désactivé par défaut.<br />`CLAUDE_CODE_USE_ANTHROPIC_AWS` doit être 1. |135| **Sentry (Erreurs)** | Activé par défaut.<br />`DISABLE_ERROR_REPORTING=1` pour désactiver. | Désactivé par défaut.<br />`CLAUDE_CODE_USE_VERTEX` doit être 1. | Désactivé par défaut.<br />`CLAUDE_CODE_USE_BEDROCK` doit être 1. | Désactivé par défaut.<br />`CLAUDE_CODE_USE_FOUNDRY` doit être 1. | Désactivé par défaut.<br />`CLAUDE_CODE_USE_ANTHROPIC_AWS` doit être 1. |


139 139 

140Toutes les variables d'environnement peuvent être vérifiées dans `settings.json` (voir [référence des paramètres](/fr/settings)).140Toutes les variables d'environnement peuvent être vérifiées dans `settings.json` (voir [référence des paramètres](/fr/settings)).

141 141 

142À partir de la v2.1.126, lorsqu'une plateforme hôte définit `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`, les métriques sont activées par défaut pour Vertex, Bedrock et Foundry, et suivent l'option de refus standard `DISABLE_TELEMETRY`. Les rapports d'erreurs Sentry et les rapports `/feedback` restent désactivés par défaut sur ces fournisseurs.142À partir de la v2.1.126, lorsqu'une plateforme hôte définit `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`, les métriques sont activées par défaut pour Google Cloud's Agent Platform, Amazon Bedrock et Microsoft Foundry, et suivent l'option de refus standard `DISABLE_TELEMETRY`. Les rapports d'erreurs Sentry et les rapports `/feedback` restent désactivés par défaut sur ces fournisseurs.

143 143 

144<h3 id="webfetch-domain-safety-check">144<h3 id="webfetch-domain-safety-check">

145 Vérification de sécurité du domaine WebFetch145 Vérification de sécurité du domaine WebFetch

Details

19Pour plus de détails sur une catégorie spécifique, suivez avec la commande dédiée :19Pour plus de détails sur une catégorie spécifique, suivez avec la commande dédiée :

20 20 

21| Commande | Affiche |21| Commande | Affiche |

22| :--------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |22| :--------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

23| `/memory` | Quels fichiers `CLAUDE.md` et règles ont été chargés, plus les entrées de mémoire automatique |23| `/memory` | Quels fichiers `CLAUDE.md` et règles ont été chargés, plus les entrées de mémoire automatique |

24| `/skills` | Les skills disponibles provenant des sources de projet, utilisateur et plugin |24| `/skills` | Les skills disponibles provenant des sources de projet, utilisateur et plugin |

25| `/hooks` | Les configurations de hooks actives |25| `/hooks` | Les configurations de hooks actives |

26| `/mcp` | Les serveurs MCP connectés et leur statut |26| `/mcp` | Les serveurs MCP connectés et leur statut |

27| `/permissions` | Les règles d'autorisation et de refus résolues actuellement en vigueur |27| `/permissions` | Les règles d'autorisation et de refus résolues actuellement en vigueur |

28| `/doctor` | Diagnostics de configuration : clés invalides, erreurs de schéma, santé de l'installation. {/* min-version: 2.1.196 */}À partir de la v2.1.196, signale également les noms de [sous-agents](/fr/sub-agents) en doublon définis dans la même portée et marque lequel est actif |28| `/doctor` | Diagnostics de configuration : santé de l'installation, fichiers de paramètres invalides, extensions inutilisées et noms de [sous-agents](/fr/sub-agents) en doublon dans le même répertoire, avec des corrections proposées |

29| `/debug [issue]` | Active la journalisation de débogage pour la session et invite Claude à diagnostiquer en utilisant la sortie du journal et les chemins de paramètres |29| `/debug [issue]` | Active la journalisation de débogage pour la session et invite Claude à diagnostiquer en utilisant la sortie du journal et les chemins de paramètres |

30| `/status` | Les sources de paramètres actives, y compris si les paramètres gérés sont en vigueur |30| `/status` | Les sources de paramètres actives, y compris si les paramètres gérés sont en vigueur |

31 31 


45 45 

46Les paramètres fusionnent entre les portées gérées, utilisateur, projet et locale. Les paramètres gérés gagnent toujours quand ils sont présents. Parmi le reste, la portée plus proche remplace la plus large dans l'ordre local, puis projet, puis utilisateur. Certains paramètres peuvent également être définis par des drapeaux de ligne de commande ou des [variables d'environnement](/fr/env-vars), qui agissent comme une autre couche de remplacement. Quand un paramètre ne semble pas s'appliquer, la valeur que vous avez définie est généralement remplacée par une autre portée ou une variable d'environnement.46Les paramètres fusionnent entre les portées gérées, utilisateur, projet et locale. Les paramètres gérés gagnent toujours quand ils sont présents. Parmi le reste, la portée plus proche remplace la plus large dans l'ordre local, puis projet, puis utilisateur. Certains paramètres peuvent également être définis par des drapeaux de ligne de commande ou des [variables d'environnement](/fr/env-vars), qui agissent comme une autre couche de remplacement. Quand un paramètre ne semble pas s'appliquer, la valeur que vous avez définie est généralement remplacée par une autre portée ou une variable d'environnement.

47 47 

48Exécutez `/doctor` pour valider vos fichiers de configuration et mettre en évidence les clés invalides ou les erreurs de schéma. Quand `/doctor` signale des problèmes, appuyez sur `f` pour envoyer le rapport de diagnostic à Claude et le laisser vous guider à travers les corrections.48Exécutez `/doctor` pour vérifier votre configuration et installation. Il signale ce qu'il trouve, y compris les fichiers de paramètres invalides, les installations en double et les extensions inutilisées, puis propose des corrections qu'il applique uniquement après votre confirmation. Avant la v2.1.205, `/doctor` ouvrait un écran de diagnostics en lecture seule et appuyer sur `f` envoyait le rapport à Claude pour le corriger.

49 

50Depuis le terminal, `claude doctor` affiche les diagnostics d'installation et de paramètres en lecture seule sans démarrer une session.

49 51 

50Exécutez `/status` pour voir quelles sources de paramètres sont actives, y compris si les paramètres gérés sont en vigueur. Pour comprendre quelle portée gagne pour une clé donnée, consultez [Comment les portées interagissent](/fr/settings#how-scopes-interact).52Exécutez `/status` pour voir quelles sources de paramètres sont actives, y compris si les paramètres gérés sont en vigueur. Pour comprendre quelle portée gagne pour une clé donnée, consultez [Comment les portées interagissent](/fr/settings#how-scopes-interact).

51 53 


67 69 

68Exécutez `/hooks` pour lister chaque hook enregistré pour la session actuelle, groupé par événement. Si un hook que vous avez défini n'apparaît pas, il n'est pas en cours de lecture : les hooks vont sous la clé `"hooks"` dans un fichier de paramètres, pas dans un fichier autonome.70Exécutez `/hooks` pour lister chaque hook enregistré pour la session actuelle, groupé par événement. Si un hook que vous avez défini n'apparaît pas, il n'est pas en cours de lecture : les hooks vont sous la clé `"hooks"` dans un fichier de paramètres, pas dans un fichier autonome.

69 71 

70Si le hook apparaît mais ne se déclenche pas, le matcher est la cause habituelle. Le champ `matcher` est une chaîne unique qui utilise `|` pour correspondre à plusieurs noms d'outils, par exemple `"Edit|Write"`. {/* min-version: 2.1.191 */}Sur Claude Code v2.1.191 ou ultérieur, `,` fonctionne également comme séparateur, donc `"Edit,Write"` est équivalent. Sur les versions antérieures, une virgule passe à l'évaluation regex et le matcher ne correspond jamais, donc utilisez `|` si vous n'êtes pas sur v2.1.191 encore. Un nom d'outil mal orthographié échoue silencieusement pour la même raison. Une valeur de tableau est une erreur de schéma : Claude Code affiche un avis d'erreur de paramètres, `/doctor` signale l'échec de validation et l'entrée du hook est supprimée afin qu'elle n'apparaisse pas dans `/hooks`.72Si le hook apparaît mais ne se déclenche pas, le matcher est la cause habituelle. Vérifiez-le pour ces erreurs :

73 

74* Le champ `matcher` est une chaîne unique qui utilise `|` pour correspondre à plusieurs noms d'outils, par exemple `"Edit|Write"`. {/* min-version: 2.1.191 */}Un séparateur `,` est équivalent, donc `"Edit,Write"` correspond aux mêmes outils. Avant v2.1.191, une virgule passait à l'évaluation regex et le matcher ne correspondait jamais, donc utilisez `|` si vous n'êtes pas sur v2.1.191 encore.

75* Un nom d'outil mal orthographié produit un matcher qui ne correspond à rien, donc le hook échoue silencieusement.

76* Une valeur de tableau est une erreur de schéma : Claude Code affiche un avis d'erreur de paramètres et rejette l'intégralité du fichier de paramètres utilisateur, projet ou local, `claude doctor` signale l'échec de validation, et aucun hook de ce fichier n'apparaît dans `/hooks`. Dans les [paramètres gérés](/fr/settings#settings-files), seule l'entrée invalide est supprimée et les autres hooks du fichier s'appliquent toujours.

71 77 

72Les modifications apportées à `settings.json` prennent effet dans la session en cours après un bref délai de stabilité du fichier. Vous n'avez pas besoin de redémarrer. Si `/hooks` affiche toujours l'ancienne définition quelques secondes après l'enregistrement, exécutez `/hooks` à nouveau pour actualiser la vue.78Les modifications apportées à `settings.json` prennent effet dans la session en cours après un bref délai de stabilité du fichier. Vous n'avez pas besoin de redémarrer. Si `/hooks` affiche toujours l'ancienne définition quelques secondes après l'enregistrement, exécutez `/hooks` à nouveau pour actualiser la vue.

73 79 

74Si `/hooks` affiche le hook mais qu'il ne se déclenche toujours pas, l'étape suivante consiste à regarder l'évaluation du hook en direct. Démarrez une session avec `claude --debug hooks` et déclenchez l'appel d'outil. Le journal de débogage enregistre chaque événement, quels matchers ont été vérifiés et le code de sortie et la sortie du hook. Consultez [Debug hooks](/fr/hooks#debug-hooks) pour le format du journal et [hooks troubleshooting](/fr/hooks-guide#limitations-and-troubleshooting) pour les modèles d'échec courants.80Si `/hooks` affiche le hook mais qu'il ne se déclenche toujours pas, l'étape suivante consiste à regarder l'évaluation du hook en direct. Démarrez une session avec `claude --debug hooks` et déclenchez l'appel d'outil. Le journal de débogage enregistre chaque événement, quels matchers ont été vérifiés, et le code de sortie et la sortie du hook. Consultez [Debug hooks](/fr/hooks#debug-hooks) pour le format du journal et [hooks troubleshooting](/fr/hooks-guide#limitations-and-troubleshooting) pour les modèles d'échec courants.

75 81 

76<h2 id="test-against-a-clean-configuration">82<h2 id="test-against-a-clean-configuration">

77 Tester avec une configuration propre83 Tester avec une configuration propre

78</h2>84</h2>

79 85 

80{/* min-version: 2.1.169 */}Commencez par [`claude --safe-mode`](/fr/cli-reference#cli-flags), qui lance une session avec toutes les personnalisations désactivées, y compris `CLAUDE.md`, les skills, les plugins, les hooks, les serveurs MCP, et les commandes et agents personnalisés. L'authentification, la sélection du modèle, les outils intégrés et les permissions fonctionnent normalement. Si le problème disparaît en mode sécurisé, l'une de ces surfaces en est la cause ; utilisez les vérifications ciblées ci-dessus pour trouver laquelle. Les paramètres gérés déployés par votre organisation s'appliquent toujours partiellement, donc les hooks configurés par la politique et la ligne d'état s'exécutent même en mode sécurisé.86{/* min-version: 2.1.169 */}Commencez par [`claude --safe-mode`](/fr/cli-reference#cli-flags), qui lance une session avec toutes les personnalisations désactivées, y compris `CLAUDE.md`, les skills, les plugins, les hooks, les serveurs MCP, et les commandes et agents personnalisés. L'authentification, la sélection du modèle, les outils intégrés et les permissions fonctionnent normalement. Si le problème disparaît en mode sécurisé, l'une de ces surfaces en est la cause ; utilisez les vérifications ciblées ci-dessus pour trouver laquelle. Le mode sécurisé applique toujours les hooks gérés et la politique de paramètres de votre organisation. Les plugins gérés, les skills, `CLAUDE.md` et les serveurs MCP sont désactivés.

81 87 

82Si le problème persiste en mode sécurisé, ou si vos paramètres eux-mêmes sont suspects, comparez avec une session qui ne charge rien de votre configuration habituelle. Pointez [`CLAUDE_CONFIG_DIR`](/fr/env-vars) vers un répertoire vide pour contourner tout ce qui se trouve sous `~/.claude`, et lancez depuis un répertoire qui n'a pas de dossier `.claude`, `.mcp.json` ou `CLAUDE.md` afin que la configuration du projet soit également ignorée.88Si le problème persiste en mode sécurisé, ou si vos paramètres eux-mêmes sont suspects, comparez avec une session qui ne charge rien de votre configuration habituelle. Pointez [`CLAUDE_CONFIG_DIR`](/fr/env-vars) vers un répertoire vide pour contourner tout ce qui se trouve sous `~/.claude`, et lancez depuis un répertoire qui n'a pas de dossier `.claude`, `.mcp.json` ou `CLAUDE.md` afin que la configuration du projet soit également ignorée.

83 89 

desktop.md +60 −26

Details

29Dans l'onglet Code, chaque conversation est une **session** : elle a son propre historique de chat, dossier de projet et modifications de code, indépendants de toute autre session. La barre latérale répertorie vos sessions et vous permet d'en exécuter plusieurs en parallèle. Au sein d'une session, vous pouvez :29Dans l'onglet Code, chaque conversation est une **session** : elle a son propre historique de chat, dossier de projet et modifications de code, indépendants de toute autre session. La barre latérale répertorie vos sessions et vous permet d'en exécuter plusieurs en parallèle. Au sein d'une session, vous pouvez :

30 30 

31* [Examiner et commenter les différences](#review-changes-with-diff-view), puis [surveiller la PR résultante via CI](#monitor-pull-request-status)31* [Examiner et commenter les différences](#review-changes-with-diff-view), puis [surveiller la PR résultante via CI](#monitor-pull-request-status)

32* [Prévisualiser votre application en cours d'exécution](#preview-your-app) dans un navigateur intégré tandis que Claude vérifie ses propres modifications32* [Prévisualiser votre application en cours d'exécution](#preview-your-app) dans le volet Navigateur tandis que Claude vérifie ses propres modifications, et [ouvrir des sites externes](#browse-external-sites) à côté

33* [Arranger les volets](#arrange-your-workspace) pour le chat, la différence, l'aperçu, le terminal et l'éditeur de fichiers côte à côte33* [Arranger les volets](#arrange-your-workspace) pour le chat, la différence, le navigateur, le terminal et l'éditeur de fichiers côte à côte

34* Poser une [question latérale](#ask-a-side-question-without-derailing-the-session) qui utilise le contexte de la session sans la dérailler34* Poser une [question latérale](#ask-a-side-question-without-derailing-the-session) qui utilise le contexte de la session sans la dérailler

35* [Connecter des outils externes](#connect-external-tools) comme GitHub, Slack et Linear35* [Connecter des outils externes](#connect-external-tools) comme GitHub, Slack et Linear

36* Laisser Claude [ouvrir des applications et contrôler votre écran](#let-claude-use-your-computer)36* Laisser Claude [ouvrir des applications et contrôler votre écran](#let-claude-use-your-computer)


78 Choisir un mode de permission78 Choisir un mode de permission

79</h3>79</h3>

80 80 

81Les modes de permission contrôlent le niveau d'autonomie de Claude pendant une session : s'il demande avant de modifier des fichiers, d'exécuter des commandes ou les deux. Vous pouvez changer de mode à tout moment en utilisant le sélecteur de mode à côté du bouton d'envoi. Commencez par Demander les permissions pour voir exactement ce que Claude fait, puis passez à Accepter automatiquement les modifications ou Plan mode à mesure que vous vous sentez à l'aise.81Les modes de permission contrôlent le niveau d'autonomie de Claude pendant une session : s'il demande avant de modifier des fichiers, d'exécuter des commandes ou les deux. Vous pouvez changer de mode à tout moment en utilisant le sélecteur de mode à côté du bouton d'envoi. Commencez par Manuel pour voir exactement ce que Claude fait, puis passez à Accepter les modifications ou Plan à mesure que vous vous sentez à l'aise.

82 82 

83| Mode | Clé de paramètres | Comportement |83| Mode | Clé de paramètres | Comportement |

84| ---------------------------------------------- | ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |84| ------------------------------ | ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

85| **Demander les permissions** | `default` | Claude demande avant de modifier des fichiers ou d'exécuter des commandes. Vous voyez une différence et pouvez accepter ou rejeter chaque modification. Recommandé pour les nouveaux utilisateurs. |85| **Manuel** | `default` | Claude demande avant de modifier des fichiers ou d'exécuter des commandes. Vous voyez une différence et pouvez accepter ou rejeter chaque modification. Recommandé pour les nouveaux utilisateurs. |

86| **Accepter automatiquement les modifications** | `acceptEdits` | Claude accepte automatiquement les modifications de fichiers et les commandes courantes du système de fichiers comme `mkdir`, `touch` et `mv`, mais demande toujours avant d'exécuter les autres commandes du terminal. Utilisez ceci quand vous faites confiance aux modifications de fichiers et voulez une itération plus rapide. |86| **Accepter les modifications** | `acceptEdits` | Claude accepte automatiquement les modifications de fichiers et les commandes courantes du système de fichiers comme `mkdir`, `touch` et `mv`, mais demande toujours avant d'exécuter les autres commandes du terminal. Utilisez ceci quand vous faites confiance aux modifications de fichiers et voulez une itération plus rapide. |

87| **Plan mode** | `plan` | Claude lit les fichiers et exécute les commandes pour explorer, puis propose un plan sans modifier votre code source. Bon pour les tâches complexes où vous voulez examiner l'approche en premier. |87| **Plan** | `plan` | Claude lit les fichiers et exécute les commandes pour explorer, puis propose un plan sans modifier votre code source. Bon pour les tâches complexes où vous voulez examiner l'approche en premier. |

88| **Auto** | `auto` | Claude exécute toutes les actions avec des vérifications de sécurité en arrière-plan qui vérifient l'alignement avec votre demande. Réduit les invites de permission tout en maintenant la surveillance. Activez dans vos Paramètres → Claude Code. Voir [conditions de disponibilité](#auto-mode-availability) ci-dessous. |88| **Auto** | `auto` | Claude exécute toutes les actions avec des vérifications de sécurité en arrière-plan qui vérifient l'alignement avec votre demande. Réduit les invites de permission tout en maintenant la surveillance. Activez dans vos Paramètres → Claude Code. Voir [conditions de disponibilité](#auto-mode-availability) ci-dessous. |

89| **Contourner les permissions** | `bypassPermissions` | Claude s'exécute sans aucune invite de permission, sauf celles forcées par des [règles d'ask](/fr/permissions#manage-permissions) explicites ; équivalent à `--dangerously-skip-permissions` dans la CLI. Activez dans vos Paramètres → Claude Code sous « Autoriser le mode de contournement des permissions ». Utilisez uniquement dans les conteneurs sandboxés ou les machines virtuelles. Les administrateurs d'entreprise peuvent désactiver cette option. |89| **Contourner les permissions** | `bypassPermissions` | Claude s'exécute sans aucune invite de permission, sauf celles forcées par des [règles d'ask](/fr/permissions#manage-permissions) explicites ou par des classificateurs de sécurité quand Claude [agit sur des sites externes](#browse-external-sites) ; équivalent à `--dangerously-skip-permissions` dans la CLI. Activez dans vos Paramètres → Claude Code sous « Autoriser le mode de contournement des permissions ». Utilisez uniquement dans les conteneurs sandboxés ou les machines virtuelles. Les administrateurs d'entreprise peuvent désactiver cette option. |

90 

91Les versions antérieures de l'onglet Code étiquetaient ces modes Demander les permissions, Accepter automatiquement les modifications et Plan mode.

90 92 

91Le mode de permission `dontAsk` est disponible uniquement dans la [CLI](/fr/permission-modes#allow-only-pre-approved-tools-with-dontask-mode).93Le mode de permission `dontAsk` est disponible uniquement dans la [CLI](/fr/permission-modes#allow-only-pre-approved-tools-with-dontask-mode).

92 94 

93<span id="auto-mode-availability" />95<span id="auto-mode-availability" />

94 96 

95Auto mode est un aperçu de recherche disponible à tous les utilisateurs sur l'API Anthropic et nécessite Claude Opus 4.6 ou version ultérieure, ou Sonnet 4.6 ou version ultérieure. Dans les déploiements Enterprise qui acheminent Desktop vers Google Cloud Vertex AI, auto mode est désactivé jusqu'à ce que vous [définissiez `CLAUDE_CODE_ENABLE_AUTO_MODE`](/fr/permission-modes#enable-auto-mode-on-bedrock-vertex-ai-or-foundry), et seuls Claude Sonnet 5, Opus 4.7 et Opus 4.8 sont supportés là-bas.97Auto mode est un aperçu de recherche disponible à tous les utilisateurs sur l'API Anthropic et nécessite Claude Opus 4.6 ou version ultérieure, ou Sonnet 4.6 ou version ultérieure. Dans les déploiements Enterprise qui acheminent Desktop vers Google Cloud's Agent Platform, auto mode est désactivé jusqu'à ce que vous [définissiez `CLAUDE_CODE_ENABLE_AUTO_MODE`](/fr/permission-modes#enable-auto-mode-on-bedrock-agent-platform-or-foundry), et seuls Claude Sonnet 5, Opus 4.7 et Opus 4.8 sont supportés là-bas.

96 98 

97<Tip title="Bonne pratique">99<Tip title="Bonne pratique">

98 Commencez les tâches complexes en Plan mode pour que Claude trace une approche avant de faire des modifications. Une fois que vous approuvez le plan, passez à Accepter automatiquement les modifications ou Demander les permissions pour l'exécuter. Voir [explorer d'abord, puis planifier, puis coder](/fr/best-practices#explore-first-then-plan-then-code) pour plus d'informations sur ce flux de travail.100 Commencez les tâches complexes en Plan pour que Claude trace une approche avant de faire des modifications. Une fois que vous approuvez le plan, passez à Accepter les modifications ou Manuel pour l'exécuter. Voir [explorer d'abord, puis planifier, puis coder](/fr/best-practices#explore-first-then-plan-then-code) pour plus d'informations sur ce flux de travail.

99</Tip>101</Tip>

100 102 

101Les sessions cloud supportent Accepter automatiquement les modifications, Plan mode et Auto mode. Accepter automatiquement les modifications correspond au mode `default` : les sessions cloud pré-approuvent les modifications de fichiers, donc le sélecteur affiche Accepter automatiquement les modifications au lieu de Demander les permissions. Contourner les permissions n'est pas disponible car l'environnement cloud est déjà sandboxé.103Les sessions cloud supportent Accepter les modifications, Plan et Auto. Accepter les modifications correspond au mode `default` : les sessions cloud pré-approuvent les modifications de fichiers, donc le sélecteur affiche Accepter les modifications au lieu de Manuel. Contourner les permissions n'est pas disponible car l'environnement cloud est déjà sandboxé.

102 104 

103Les administrateurs d'entreprise peuvent restreindre les modes de permission disponibles. Voir [configuration d'entreprise](#enterprise-configuration) pour les détails.105Les administrateurs d'entreprise peuvent restreindre les modes de permission disponibles. Voir [configuration d'entreprise](#enterprise-configuration) pour les détails.

104 106 


106 Aperçu de votre application108 Aperçu de votre application

107</h3>109</h3>

108 110 

109Claude peut démarrer un serveur de développement et ouvrir un navigateur intégré pour vérifier ses modifications. Ceci fonctionne pour les applications web frontend ainsi que les serveurs backend : Claude peut tester les points de terminaison API, afficher les journaux du serveur et itérer sur les problèmes qu'il trouve. Dans la plupart des cas, Claude démarre le serveur automatiquement après la modification des fichiers du projet. Vous pouvez également demander à Claude de prévisualiser à tout moment. Par défaut, Claude [vérifie automatiquement](#auto-verify-changes) les modifications après chaque modification.111Claude peut démarrer un serveur de développement et l'ouvrir dans le volet Navigateur pour vérifier ses modifications. Ceci fonctionne pour les applications web frontend ainsi que les serveurs backend : Claude peut tester les points de terminaison API, afficher les journaux du serveur et itérer sur les problèmes qu'il trouve. Dans la plupart des cas, Claude démarre le serveur automatiquement après la modification des fichiers du projet. Vous pouvez également demander à Claude de prévisualiser à tout moment. Par défaut, Claude [vérifie automatiquement](#auto-verify-changes) les modifications après chaque modification.

110 112 

111Le volet d'aperçu peut également ouvrir des fichiers HTML statiques, des PDF, des images et des vidéos de votre projet. Cliquez sur un chemin HTML, PDF, image ou vidéo dans le chat pour l'ouvrir dans l'aperçu.113Le volet Navigateur peut également ouvrir des fichiers HTML statiques, des PDF, des images et des vidéos de votre projet. Cliquez sur un chemin HTML, PDF, image ou vidéo dans le chat pour l'ouvrir .

112 114 

113À partir du volet d'aperçu, vous pouvez :115À partir du volet Navigateur, vous pouvez :

114 116 

115* Interagir avec votre application en cours d'exécution directement dans le navigateur intégré117* Interagir avec votre application en cours d'exécution directement dans le volet Navigateur

116* Regarder Claude vérifier ses propres modifications automatiquement : il prend des captures d'écran, inspecte le DOM, clique sur les éléments, remplit les formulaires et corrige les problèmes qu'il trouve118* Regarder Claude vérifier ses propres modifications automatiquement : il prend des captures d'écran, inspecte le DOM, clique sur les éléments, remplit les formulaires et corrige les problèmes qu'il trouve

117* Démarrer ou arrêter les serveurs à partir de la liste déroulante **Aperçu** dans la barre d'outils de la session119* Démarrer ou arrêter les serveurs à partir de la liste déroulante des serveurs dans la barre d'outils de la session

118* Conserver les cookies et le stockage local entre les redémarrages du serveur en sélectionnant **Conserver les sessions** dans la liste déroulante, afin que vous n'ayez pas à vous reconnecter pendant le développement120* Conserver les cookies et le stockage local entre les redémarrages du serveur en sélectionnant **Conserver les sessions** dans la liste déroulante, afin que vous n'ayez pas à vous reconnecter pendant le développement

119* Modifier la configuration du serveur ou arrêter tous les serveurs à la fois121* Modifier la configuration du serveur ou arrêter tous les serveurs à la fois

120 122 

121Claude crée la configuration initiale du serveur en fonction de votre projet. Si votre application utilise une commande de développement personnalisée, modifiez `.claude/launch.json` pour correspondre à votre configuration. Voir [Configurer les serveurs d'aperçu](#configure-preview-servers) pour la référence complète.123Claude crée la configuration initiale du serveur en fonction de votre projet. Si votre application utilise une commande de développement personnalisée, modifiez `.claude/launch.json` pour correspondre à votre configuration. Voir [Configurer les serveurs d'aperçu](#configure-preview-servers) pour la référence complète.

122 124 

123Pour effacer les données de session enregistrées, basculez **Conserver les sessions d'aperçu** sur Désactivé dans Paramètres → Claude Code. Pour désactiver complètement l'aperçu, basculez **Aperçu** sur Désactivé dans Paramètres → Claude Code.125Pour effacer les données de session enregistrées, ou pour désactiver complètement le Navigateur, utilisez les bascules dans Paramètres → Claude Code.

126 

127<h3 id="browse-external-sites">

128 Parcourir les sites externes

129</h3>

130 

131Le volet Navigateur est un navigateur à onglets, vous pouvez donc ouvrir la documentation, les suivi de problèmes ou tout autre site à côté de votre application en cours d'exécution. Pour ouvrir le Navigateur, appuyez sur **Cmd+Maj+B** sur macOS ou **Ctrl+Maj+B** sur Windows, ou sélectionnez-le dans le menu **Affichages**. Quand vous cliquez sur un lien externe dans le chat, un sélecteur offre **Ouvrir dans l'application** pour utiliser le volet Navigateur ou **Navigateur par défaut** pour utiliser le vôtre ; **Cmd**-cliquez sur macOS ou **Ctrl**-cliquez sur Windows ouvre un lien dans votre navigateur système directement. Vous pouvez vous connecter à des sites dans le volet, y compris les flux de connexion popup tels que Google OAuth.

132 

133Claude peut lire et interagir avec les pages externes en utilisant les mêmes outils qu'il utilise pour [vérifier votre application](#preview-your-app), avec deux vérifications de sécurité supplémentaires :

134 

135* Les classificateurs de sécurité examinent les actions d'écriture de Claude sur les pages externes, telles que cliquer et taper, dans tous les modes de permission. Ce sont les mêmes classificateurs que [auto mode](#choose-a-permission-mode) utilise, et quand ils signalent une action, vous obtenez une invite de permission quel que soit le mode.

136* Dans les modes de permission autres que Auto et Contourner les permissions, une vérification de liste d'autorisation de domaine s'applique également avant que Claude ne navigue vers un nouveau site.

137 

138<h4 id="approve-claude’s-actions-on-a-site">

139 Approuver les actions de Claude sur un site

140</h4>

141 

142La première fois que Claude agit sur un site externe, une carte de permission apparaît et Claude attend votre choix : **Autoriser une fois**, **Toujours autoriser** ou **Refuser**. **Autoriser une fois** approuve l'action sans rien enregistrer. **Toujours autoriser** enregistre l'approbation pour ce site sur votre appareil, et vous pouvez la révoquer dans Paramètres. Chaque site a besoin de sa propre approbation, y compris les sous-domaines. Vos serveurs de développement locaux et fichiers de projet n'ont pas besoin d'approbation, donc [auto-verify](#auto-verify-changes) continue de fonctionner sans invites.

143 

144Même sur un site approuvé, Claude n'achètera pas d'articles, ne créera pas de comptes ou ne contournera pas les CAPTCHA sans votre entrée. La navigation dans le volet Navigateur utilise le même modèle de sécurité que l'[extension Claude dans Chrome](/fr/chrome). Voir [Utiliser Claude dans Chrome en toute sécurité](https://support.claude.com/en/articles/12902428-using-claude-in-chrome-safely) pour savoir comment Claude gère les sites sensibles et les actions risquées.

145 

146<h4 id="choose-between-the-browser-and-the-chrome-extension">

147 Choisir entre le Navigateur et l'extension Chrome

148</h4>

149 

150Le volet Navigateur utilise un profil de navigateur propre, séparé de votre navigateur personnel, sans aucune de vos connexions enregistrées ou historique. Utilisez-le pour construire et tester votre application et pour les sites qui n'ont pas besoin de votre identité. Quand vous voulez que Claude agisse en tant que vous dans vos sessions connectées, utilisez l'[extension Claude dans Chrome](/fr/chrome) à la place, qui partage l'état de connexion de votre navigateur.

151 

152<h4 id="restrict-external-browsing-for-your-organization">

153 Restreindre la navigation externe pour votre organisation

154</h4>

155 

156Le Navigateur suit les mêmes [contrôles de liste d'autorisation et de liste de blocage de site](https://support.claude.com/en/articles/13065128-claude-in-chrome-admin-controls) que l'extension Claude dans Chrome. Si votre organisation a déjà configuré ces listes pour l'extension, le Navigateur les respecte automatiquement. Les administrateurs peuvent également désactiver les outils de Claude sur les pages externes avec le paramètre géré [`browserExternalPageTools`](#managed-settings). Avec les outils désactivés, les utilisateurs peuvent toujours naviguer vers des sites externes ; les outils de Claude ne peuvent pas les lire ou agir sur eux.

124 157 

125<h3 id="review-changes-with-diff-view">158<h3 id="review-changes-with-diff-view">

126 Examiner les modifications avec la vue de différence159 Examiner les modifications avec la vue de différence


224| `Cmd` `Shift` `]` / `Cmd` `Shift` `[` | Session suivante ou précédente |257| `Cmd` `Shift` `]` / `Cmd` `Shift` `[` | Session suivante ou précédente |

225| `Esc` | Arrêter la réponse de Claude |258| `Esc` | Arrêter la réponse de Claude |

226| `Cmd` `Shift` `D` | Basculer le volet de différence |259| `Cmd` `Shift` `D` | Basculer le volet de différence |

227| `Cmd` `Shift` `P` | Basculer le volet d'aperçu |260| `Cmd` `Shift` `B` | Basculer le volet d'aperçu |

228| `Cmd` `Shift` `S` | Sélectionner un élément dans l'aperçu |261| `Cmd` `Shift` `S` | Sélectionner un élément dans l'aperçu |

229| `Ctrl` `` ` `` | Basculer le volet de terminal |262| `Ctrl` `` ` `` | Basculer le volet de terminal |

230| `Cmd` `\` | Fermer le volet actif |263| `Cmd` `\` | Fermer le volet actif |


437 470 

438Claude détecte automatiquement votre configuration de serveur de développement et stocke la configuration dans `.claude/launch.json` à la racine du dossier que vous avez sélectionné au démarrage de la session. L'aperçu utilise ce dossier comme répertoire de travail, donc si vous avez sélectionné un dossier parent, les sous-dossiers avec leurs propres serveurs de développement ne seront pas détectés automatiquement. Pour travailler avec le serveur d'un sous-dossier, soit démarrez une session dans ce dossier directement, soit ajoutez une configuration manuellement.471Claude détecte automatiquement votre configuration de serveur de développement et stocke la configuration dans `.claude/launch.json` à la racine du dossier que vous avez sélectionné au démarrage de la session. L'aperçu utilise ce dossier comme répertoire de travail, donc si vous avez sélectionné un dossier parent, les sous-dossiers avec leurs propres serveurs de développement ne seront pas détectés automatiquement. Pour travailler avec le serveur d'un sous-dossier, soit démarrez une session dans ce dossier directement, soit ajoutez une configuration manuellement.

439 472 

440Pour personnaliser le démarrage de votre serveur, par exemple pour utiliser `yarn dev` au lieu de `npm run dev` ou pour modifier le port, modifiez le fichier manuellement ou cliquez sur **Modifier la configuration** dans la liste déroulante Aperçu pour l'ouvrir dans votre éditeur de code. Le fichier supporte JSON avec commentaires.473Pour personnaliser le démarrage de votre serveur, par exemple pour utiliser `yarn dev` au lieu de `npm run dev` ou pour modifier le port, modifiez le fichier manuellement ou cliquez sur **Modifier la configuration** dans la liste déroulante du serveur pour l'ouvrir dans votre éditeur de code. Le fichier supporte JSON avec commentaires.

441 474 

442```json theme={null}475```json theme={null}

443{476{


461 494 

462Quand `autoVerify` est activé, Claude vérifie automatiquement les modifications de code après la modification des fichiers. Il prend des captures d'écran, vérifie les erreurs et confirme que les modifications fonctionnent avant de terminer sa réponse.495Quand `autoVerify` est activé, Claude vérifie automatiquement les modifications de code après la modification des fichiers. Il prend des captures d'écran, vérifie les erreurs et confirme que les modifications fonctionnent avant de terminer sa réponse.

463 496 

464La vérification automatique est activée par défaut. Désactivez-la par projet en ajoutant `"autoVerify": false` à `.claude/launch.json`, ou basculez-la à partir du menu déroulant **Aperçu**.497La vérification automatique est activée par défaut. Désactivez-la par projet en ajoutant `"autoVerify": false` à `.claude/launch.json`, ou basculez-la à partir du menu déroulant du serveur.

465 498 

466```json theme={null}499```json theme={null}

467{500{


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

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

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

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

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

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

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


754 788 

755Si vous utilisez déjà la CLI Claude Code, Desktop exécute le même moteur sous-jacent avec une interface graphique. Vous pouvez exécuter les deux simultanément sur la même machine, même sur le même projet. Chacun maintient un historique de session séparé, mais ils partagent la configuration et la mémoire du projet via les fichiers CLAUDE.md.789Si vous utilisez déjà la CLI Claude Code, Desktop exécute le même moteur sous-jacent avec une interface graphique. Vous pouvez exécuter les deux simultanément sur la même machine, même sur le même projet. Chacun maintient un historique de session séparé, mais ils partagent la configuration et la mémoire du projet via les fichiers CLAUDE.md.

756 790 

757Pour déplacer une session CLI dans Desktop, exécutez `/desktop` dans le terminal. Claude enregistre votre session et l'ouvre dans l'application de bureau, puis quitte la CLI. Cette commande est disponible sur macOS et Windows quand vous êtes connecté avec un abonnement Claude. Elle n'est pas disponible avec l'authentification par clé API ou sur Bedrock, Vertex ou Foundry.791Pour déplacer une session CLI dans Desktop, exécutez `/desktop` dans le terminal. Claude enregistre votre session et l'ouvre dans l'application de bureau, puis quitte la CLI. Cette commande est disponible sur macOS et Windows quand vous êtes connecté avec un abonnement Claude. Elle n'est pas disponible avec l'authentification par clé API ou sur Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry.

758 792 

759<Tip>793<Tip>

760 Quand utiliser Desktop vs CLI : utilisez Desktop quand vous voulez gérer les sessions parallèles dans une fenêtre, arranger les volets côte à côte ou examiner les modifications visuellement. Utilisez la CLI quand vous avez besoin de scripts, d'automatisation ou préférez un flux de travail terminal.794 Quand utiliser Desktop vs CLI : utilisez Desktop quand vous voulez gérer les sessions parallèles dans une fenêtre, arranger les volets côte à côte ou examiner les modifications visuellement. Utilisez la CLI quand vous avez besoin de scripts, d'automatisation ou préférez un flux de travail terminal.


804Ce tableau compare les capacités principales entre la CLI et Desktop. Pour une liste complète des drapeaux CLI, voir la [référence CLI](/fr/cli-reference).838Ce tableau compare les capacités principales entre la CLI et Desktop. Pour une liste complète des drapeaux CLI, voir la [référence CLI](/fr/cli-reference).

805 839 

806| Fonctionnalité | CLI | Desktop |840| Fonctionnalité | CLI | Desktop |

807| -------------------------------------------------- | --------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |841| -------------------------------------------------- | ---------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

808| Modes de permission | Tous les modes y compris `dontAsk` | Demander les permissions, Accepter automatiquement les modifications, Plan mode, Auto et Contourner les permissions via Paramètres |842| Modes de permission | Tous les modes y compris `dontAsk` | Manuel, Accepter les modifications et Plan. Les modes Auto et Contourner les permissions apparaissent dans le sélecteur de mode après les avoir activés dans Paramètres |

809| `--dangerously-skip-permissions` | Drapeau CLI | Mode Contourner les permissions. Activez dans Paramètres → Claude Code → « Autoriser le mode de contournement des permissions » |843| `--dangerously-skip-permissions` | Drapeau CLI | Mode Contourner les permissions. Activez dans Paramètres → Claude Code → « Autoriser le mode de contournement des permissions » |

810| [Fournisseurs tiers](/fr/third-party-integrations) | Bedrock, Vertex AI, Foundry | API d'Anthropic par défaut. Les déploiements d'entreprise peuvent configurer Vertex AI et les fournisseurs de passerelle. Voir le [guide de configuration d'entreprise](https://support.claude.com/en/articles/12622667-enterprise-configuration). Pour exécuter l'onglet Code sur Bedrock, Vertex AI, Foundry ou une passerelle LLM auto-hébergée, voir [Cowork on 3P research preview](https://claude.com/docs/cowork/3p/overview). |844| [Fournisseurs tiers](/fr/third-party-integrations) | Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry | API d'Anthropic par défaut. Les déploiements d'entreprise peuvent configurer Google Cloud's Agent Platform et les fournisseurs de passerelle. Voir le [guide de configuration d'entreprise](https://support.claude.com/en/articles/12622667-enterprise-configuration). Pour exécuter l'onglet Code sur Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry ou une passerelle LLM auto-hébergée, voir [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview). |

811| [Serveurs MCP](/fr/mcp) | Configurer dans les fichiers de paramètres | Interface utilisateur Connecteurs pour les sessions locales et SSH, ou fichiers de paramètres |845| [Serveurs MCP](/fr/mcp) | Configurer dans les fichiers de paramètres | Interface utilisateur Connecteurs pour les sessions locales et SSH, ou fichiers de paramètres |

812| [Plugins](/fr/plugins) | Commande `/plugin` | Interface utilisateur du gestionnaire de plugins |846| [Plugins](/fr/plugins) | Commande `/plugin` | Interface utilisateur du gestionnaire de plugins |

813| Fichiers @mention | Basé sur le texte | Avec autocomplétion ; sessions locales et SSH uniquement |847| Fichiers @mention | Basé sur le texte | Avec autocomplétion ; sessions locales et SSH uniquement |


825 859 

826Les fonctionnalités suivantes sont disponibles uniquement dans la CLI ou l'extension VS Code, sauf indication contraire :860Les fonctionnalités suivantes sont disponibles uniquement dans la CLI ou l'extension VS Code, sauf indication contraire :

827 861 

828* **Fournisseurs tiers** : Desktop se connecte à l'API d'Anthropic par défaut. Les déploiements d'entreprise peuvent configurer Vertex AI et les fournisseurs de passerelle via [paramètres gérés](https://support.claude.com/en/articles/12622667-enterprise-configuration). Pour Bedrock ou Foundry dans la CLI, voir le [démarrage rapide](/fr/quickstart). À titre d'exception à la section ci-dessus, [Cowork on 3P research preview](https://claude.com/docs/cowork/3p/overview) exécute l'onglet Code sur Bedrock, Vertex AI, Foundry ou une passerelle LLM auto-hébergée.862* **Fournisseurs tiers** : Desktop se connecte à l'API d'Anthropic par défaut. Les déploiements d'entreprise peuvent configurer Google Cloud's Agent Platform et les fournisseurs de passerelle via [paramètres gérés](https://support.claude.com/en/articles/12622667-enterprise-configuration). Pour Amazon Bedrock ou Microsoft Foundry dans la CLI, voir le [démarrage rapide](/fr/quickstart). À titre d'exception à la section ci-dessus, [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview) exécute l'onglet Code sur Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry ou une passerelle LLM auto-hébergée.

829* **Linux (bêta)** : l'utilisation informatique n'est pas encore disponible dans l'application de bureau Linux. Voir [Claude Desktop sur Linux](/fr/desktop-linux).863* **Linux (bêta)** : l'utilisation informatique n'est pas encore disponible dans l'application de bureau Linux. Voir [Claude Desktop sur Linux](/fr/desktop-linux).

830* **Suggestions de code en ligne** : Desktop ne fournit pas de suggestions de style autocomplétion. Il fonctionne via des prompts conversationnels et des modifications de code explicites.864* **Suggestions de code en ligne** : Desktop ne fournit pas de suggestions de style autocomplétion. Il fonctionne via des prompts conversationnels et des modifications de code explicites.

831* **Équipes d'agents** : les sessions Claude Code parallèles qui se communiquent entre elles sont disponibles dans la [CLI](/fr/agent-teams), pas dans Desktop. Pour le travail multi-agents dans une seule session, utilisez les [flux de travail dynamiques](/fr/workflows), qui s'exécutent dans Desktop.865* **Équipes d'agents** : les sessions Claude Code parallèles qui se communiquent entre elles sont disponibles dans la [CLI](/fr/agent-teams), pas dans Desktop. Pour le travail multi-agents dans une seule session, utilisez les [flux de travail dynamiques](/fr/workflows), qui s'exécutent dans Desktop.

832* **Commandes de dialogue terminal** : les commandes intégrées qui ouvrent un panneau interactif dans le terminal, telles que `/permissions`, `/config` et `/doctor`, ne sont pas disponibles dans l'onglet Code et répondent avec `n'est pas disponible dans cet environnement`. Modifiez les [fichiers de paramètres](/fr/settings) directement pour gérer les règles de permission et la configuration, ou exécutez la commande à partir de la CLI autonome.866* **Commandes de dialogue terminal** : les commandes intégrées qui ouvrent un panneau interactif dans le terminal, telles que `/permissions` et `/config`, ne sont pas disponibles dans l'onglet Code et répondent avec `n'est pas disponible dans cet environnement`. `/config` définit un paramètre quand vous passez `key=value`, par exemple `/config theme=dark` ; seule sa forme de sélecteur n'est pas disponible. Modifiez les [fichiers de paramètres](/fr/settings) directement pour gérer les règles de permission et la configuration, ou exécutez la commande à partir de la CLI autonome.

833 867 

834<h2 id="troubleshooting">868<h2 id="troubleshooting">

835 Dépannage869 Dépannage

desktop-linux.md +26 −2

Details

25 Installation25 Installation

26</h2>26</h2>

27 27 

28Installez à partir du référentiel apt d'Anthropic afin que les mises à jour arrivent via les mises à jour régulières des paquets de votre système.28Installez à partir du référentiel apt d'Anthropic afin que les mises à jour arrivent via les mises à jour régulières des paquets de votre système. Ouvrez un terminal et exécutez les commandes de chaque étape.

29 29 

30<Steps>30<Steps>

31 <Step title="Ajouter le référentiel apt d'Anthropic">31 <Step title="Ajouter le référentiel apt d'Anthropic">

32 Cette étape télécharge la clé de signature avec `curl`, que les installations fraîches de Debian et Ubuntu peuvent ne pas inclure. Si la commande de téléchargement échoue avec `sudo: curl: command not found`, installez d'abord curl :

33 

34 ```bash theme={null}

35 sudo apt install curl

36 ```

37 

32 Téléchargez la clé de signature d'Anthropic :38 Téléchargez la clé de signature d'Anthropic :

33 39 

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


69 Installer à partir d'un fichier téléchargé75 Installer à partir d'un fichier téléchargé

70</h3>76</h3>

71 77 

72Si vous ne pouvez pas utiliser le référentiel apt, téléchargez le paquet `.deb` pour votre architecture (x64 ou arm64) depuis [claude.com/download](https://claude.com/download), puis ouvrez-le avec votre installateur de logiciels ou exécutez-le à partir de votre répertoire de téléchargement :78Si vous ne pouvez pas utiliser le référentiel apt, téléchargez d'abord le paquet `.deb` pour votre architecture (x64 ou arm64) depuis [claude.com/download](https://claude.com/download). Ensuite, ouvrez le fichier téléchargé avec votre installateur de logiciels, ou installez-le avec apt à partir du répertoire qui contient le fichier téléchargé :

73 79 

74```bash theme={null}80```bash theme={null}

75sudo apt install ./claude-desktop_*.deb81sudo apt install ./claude-desktop_*.deb

76```82```

77 83 

84Si apt signale `E: Unsupported file ./claude-desktop_*.deb given on commandline`, le motif ne correspondait pas à un fichier `.deb` dans le répertoire courant. Confirmez que le téléchargement s'est terminé, puis exécutez à nouveau la commande à partir du répertoire qui contient le fichier.

85 

78Un `.deb` installé de cette manière ne reçoit pas de mises à jour. Pour obtenir les mises à jour via apt, ajoutez le référentiel comme indiqué ci-dessus, ou décommentez la ligne `deb` dans l'entrée d'espace réservé que le paquet écrit dans `/etc/apt/sources.list.d/claude-desktop.list`.86Un `.deb` installé de cette manière ne reçoit pas de mises à jour. Pour obtenir les mises à jour via apt, ajoutez le référentiel comme indiqué ci-dessus, ou décommentez la ligne `deb` dans l'entrée d'espace réservé que le paquet écrit dans `/etc/apt/sources.list.d/claude-desktop.list`.

79 87 

80<h2 id="update">88<h2 id="update">


103sudo rm /etc/apt/sources.list.d/claude-desktop.list111sudo rm /etc/apt/sources.list.d/claude-desktop.list

104```112```

105 113 

114<h2 id="troubleshoot">

115 Dépannage

116</h2>

117 

118<h3 id="unable-to-locate-package-claude-desktop">

119 Impossible de localiser le paquet claude-desktop

120</h3>

121 

122Si `sudo apt install claude-desktop` échoue avec `E: Unable to locate package claude-desktop`, apt n'a pas trouvé le référentiel que vous avez ajouté. Vérifiez les points suivants :

123 

124* Confirmez que l'entrée du référentiel a été écrite. `cat /etc/apt/sources.list.d/claude-desktop.list` devrait afficher la ligne `deb` de l'étape [Ajouter le référentiel apt d'Anthropic](#install). Si le fichier est vide ou manquant, exécutez cette étape à nouveau.

125* Confirmez que votre architecture est prise en charge. `dpkg --print-architecture` devrait afficher `amd64` ou `arm64`. Le référentiel ne publie pas de paquets pour d'autres architectures.

126* Exécutez `sudo apt update` à nouveau et vérifiez sa sortie pour les erreurs liées à `downloads.claude.ai`. Une erreur de réseau ou de clé à cet endroit signifie que le référentiel a été ajouté mais n'a pas pu être atteint ou vérifié.

127 

128Si le référentiel est en place et accessible et que le paquet n'est toujours pas trouvé, [installez à partir d'un fichier téléchargé](#install-from-a-downloaded-file) à la place.

129 

106<h2 id="what’s-not-in-the-linux-beta-yet">130<h2 id="what’s-not-in-the-linux-beta-yet">

107 Ce qui n'est pas encore dans la bêta Linux131 Ce qui n'est pas encore dans la bêta Linux

108</h2>132</h2>

Details

113 113 

114**Examiner les modifications avant de valider.** Après que Claude ait modifié les fichiers, un indicateur `+12 -1` apparaît. Cliquez dessus pour ouvrir la [vue de différence](/fr/desktop#review-changes-with-diff-view), examinez les modifications fichier par fichier et commentez des lignes spécifiques. Claude lit vos commentaires et révise. Cliquez sur **Examiner le code** pour que Claude évalue lui-même les différences et laisse des suggestions en ligne.114**Examiner les modifications avant de valider.** Après que Claude ait modifié les fichiers, un indicateur `+12 -1` apparaît. Cliquez dessus pour ouvrir la [vue de différence](/fr/desktop#review-changes-with-diff-view), examinez les modifications fichier par fichier et commentez des lignes spécifiques. Claude lit vos commentaires et révise. Cliquez sur **Examiner le code** pour que Claude évalue lui-même les différences et laisse des suggestions en ligne.

115 115 

116**Ajuster le contrôle que vous avez.** Votre [mode de permission](/fr/desktop#choose-a-permission-mode) contrôle l'équilibre. Demander les permissions (par défaut) nécessite une approbation avant chaque modification. Auto-accepter les modifications accepte automatiquement les modifications de fichiers pour une itération plus rapide. Le mode Plan permet à Claude de cartographier une approche sans toucher à aucun fichier, ce qui est utile avant une grande refonte.116**Ajuster le contrôle que vous avez.** Votre [mode de permission](/fr/desktop#choose-a-permission-mode) définit le niveau de contrôle que Claude peut exercer sans demander d'approbation :

117 

118* **Manuel** : la valeur par défaut. Claude demande avant de modifier les fichiers ou d'exécuter des commandes.

119* **Accepter les modifications** : Claude accepte automatiquement les modifications de fichiers pour une itération plus rapide.

120* **Plan** : Claude propose une approche sans modifier aucun fichier, ce qui est utile avant une grande refonte.

117 121 

118**Ajouter des plugins pour plus de capacités.** Cliquez sur le bouton **+** à côté de la boîte de saisie et sélectionnez **Plugins** pour parcourir et installer les [plugins](/fr/desktop#install-plugins) qui ajoutent des skills, des agents, des MCP servers et bien plus.122**Ajouter des plugins pour plus de capacités.** Cliquez sur le bouton **+** à côté de la boîte de saisie et sélectionnez **Plugins** pour parcourir et installer les [plugins](/fr/desktop#install-plugins) qui ajoutent des skills, des agents, des MCP servers et bien plus.

119 123 

120**Arranger votre espace de travail.** Glissez-déposez les volets de chat, de différence, de terminal, de fichier et d'aperçu dans la disposition que vous souhaitez. Ouvrez le terminal avec **Ctrl+\`** pour exécuter des commandes aux côtés de votre session, ou cliquez sur un chemin de fichier pour l'ouvrir dans le volet de fichier. Consultez [Arranger votre espace de travail](/fr/desktop#arrange-your-workspace).124**Arranger votre espace de travail.** Glissez-déposez les volets de chat, de différence, de terminal, de fichier et de navigateur dans la disposition que vous souhaitez. Ouvrez le terminal avec **Ctrl+\`** pour exécuter des commandes aux côtés de votre session, ou cliquez sur un chemin de fichier pour l'ouvrir dans le volet de fichier. Consultez [Arranger votre espace de travail](/fr/desktop#arrange-your-workspace).

121 125 

122**Prévisualiser votre application.** Cliquez sur la liste déroulante **Preview** pour exécuter votre serveur de développement directement dans le bureau. Claude peut voir l'application en cours d'exécution, tester les points de terminaison, inspecter les journaux et itérer sur ce qu'il voit. Consultez [Prévisualiser votre application](/fr/desktop#preview-your-app).126**Prévisualiser votre application.** Lorsque vous exécutez votre serveur de développement dans le bureau, votre application s'ouvre dans le volet Navigateur, qui peut également [ouvrir des sites externes](/fr/desktop#browse-external-sites). Claude peut voir l'application en cours d'exécution, tester les points de terminaison, inspecter les journaux et itérer sur ce qu'il voit. Consultez [Prévisualiser votre application](/fr/desktop#preview-your-app).

123 127 

124**Suivre votre demande de tirage.** Après avoir ouvert une PR, Claude Code surveille les résultats des vérifications CI et peut corriger automatiquement les défaillances ou fusionner la PR une fois que toutes les vérifications sont réussies. Consultez [Surveiller l'état de la demande de tirage](/fr/desktop#monitor-pull-request-status).128**Suivre votre demande de tirage.** Après avoir ouvert une PR, Claude Code surveille les résultats des vérifications CI et peut corriger automatiquement les défaillances ou fusionner la PR une fois que toutes les vérifications sont réussies. Consultez [Surveiller l'état de la demande de tirage](/fr/desktop#monitor-pull-request-status).

125 129 

devcontainer.md +2 −2

Details

75Ce que vous voyez à l'invite d'authentification dépend de votre fournisseur :75Ce que vous voyez à l'invite d'authentification dépend de votre fournisseur :

76 76 

77* **Anthropic** : connectez-vous via un navigateur avec votre compte Claude ou Anthropic Console77* **Anthropic** : connectez-vous via un navigateur avec votre compte Claude ou Anthropic Console

78* **[Amazon Bedrock, Google Vertex AI ou Microsoft Foundry](/fr/third-party-integrations)** : Claude Code utilise vos identifiants de fournisseur cloud, sans invite de navigateur78* **[Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry](/fr/third-party-integrations)** : Claude Code utilise vos identifiants de fournisseur cloud, sans invite de navigateur

79 79 

80Pour les fournisseurs cloud, transmettez les identifiants dans le conteneur en tant que variables d'environnement via `containerEnv`, un secret Codespaces ou l'identité de charge de travail de votre cloud plutôt que de monter les fichiers d'identifiants depuis l'hôte. Voir [Amazon Bedrock](/fr/amazon-bedrock), [Google Vertex AI](/fr/google-vertex-ai) ou [Microsoft Foundry](/fr/microsoft-foundry) pour la chaîne d'identifiants que Claude Code lit.80Pour les fournisseurs cloud, transmettez les identifiants dans le conteneur en tant que variables d'environnement via `containerEnv`, un secret Codespaces ou l'identité de charge de travail de votre cloud plutôt que de monter les fichiers d'identifiants depuis l'hôte. Voir [Amazon Bedrock](/fr/amazon-bedrock), [Google Cloud's Agent Platform](/fr/google-vertex-ai), ou [Microsoft Foundry](/fr/microsoft-foundry) pour la chaîne d'identifiants que Claude Code lit.

81 81 

82Voir [Choisir votre fournisseur d'API](/fr/admin-setup#choose-your-api-provider) pour décider quel chemin convient à votre organisation.82Voir [Choisir votre fournisseur d'API](/fr/admin-setup#choose-your-api-provider) pour décider quel chemin convient à votre organisation.

83 83 

Details

332* taper pour filtrer par nom ou description du plugin332* taper pour filtrer par nom ou description du plugin

333* appuyer sur Enter pour ouvrir la vue détaillée d'un plugin et l'activer, le désactiver ou le désinstaller333* appuyer sur Enter pour ouvrir la vue détaillée d'un plugin et l'activer, le désactiver ou le désinstaller

334 334 

335Désinstaller un plugin qu'un `.claude/settings.json` de projet active demande quelle portée vous visez : le désactiver pour vous seul, ce qui écrit une substitution dans votre `.claude/settings.local.json` et laisse le plugin installé pour le projet, ou le désinstaller pour tout le monde, ce qui le supprime du `.claude/settings.json` partagé. Nécessite Claude Code v2.1.203 ou ultérieur. Avant v2.1.203, la boîte de dialogue proposait uniquement la désactivation locale.

336 

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

336 338 

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

340 

341Deux types de plugins ne sont jamais listés comme inutilisés :

342 

343* les plugins que votre organisation gère ou que vous chargez avec `--plugin-dir`

344* les plugins qui contribuent un thème, un style de sortie, un moniteur ou un workflow, car ils fournissent de la valeur sans une invocation à suivre

345 

346L'en-tête **Not used recently** et la ligne **Last used** sont tous deux masqués quand votre organisation restreint les marketplaces avec [`strictKnownMarketplaces`](/fr/settings#strictknownmarketplaces).

338 347 

339Les plugins que votre organisation gère ou que vous chargez avec `--plugin-dir` ne sont jamais listés comme inutilisés, et les plugins qui contribuent un serveur LSP, un thème, un style de sortie, un moniteur ou un workflow ne sont jamais listés non plus, car ils fournissent de la valeur sans une invocation à suivre. Le groupe et la ligne **Last used** sont tous deux masqués quand votre organisation restreint les marketplaces avec [`strictKnownMarketplaces`](/fr/settings#strictknownmarketplaces).348Un [serveur de langage](/fr/plugins#add-lsp-servers-to-your-plugin) d'un plugin compte comme utilisé quand il fournit des diagnostics ou répond à une demande de navigation de code, donc un plugin LSP dont le serveur est actif dans vos sessions n'est pas listé comme inutilisé. Avant v2.1.203, l'activité du serveur de langage ne pouvait pas être comptée comme une utilisation, donc les plugins qui contribuent un serveur LSP étaient exemptés du groupe entièrement, de la même manière que les plugins de thème et de style de sortie le sont toujours.

340 349 

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

342 351 

env-vars.md +55 −53

Details

96</h2>96</h2>

97 97 

98| Variable | Objectif |98| Variable | Objectif |

99| :------------------------------------------------------ | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |99| :------------------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

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

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

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

103| `ANTHROPIC_AWS_BASE_URL` | Remplacer l'URL du point de terminaison [Claude Platform on AWS](/fr/claude-platform-on-aws). À utiliser pour les régions personnalisées ou lors du routage via une [passerelle LLM](/fr/llm-gateway). Par défaut `https://aws-external-anthropic.{AWS_REGION}.api.aws` |103| `ANTHROPIC_AWS_BASE_URL` | Remplacer l'URL du point de terminaison [Claude Platform on AWS](/fr/claude-platform-on-aws). À utiliser pour les régions personnalisées ou lors du routage via une [passerelle LLM](/fr/llm-gateway). Par défaut `https://aws-external-anthropic.{AWS_REGION}.api.aws` |

104| `ANTHROPIC_AWS_WORKSPACE_ID` | Requis pour [Claude Platform on AWS](/fr/claude-platform-on-aws). Envoyé à chaque requête en tant qu'en-tête `anthropic-workspace-id` |104| `ANTHROPIC_AWS_WORKSPACE_ID` | Requis pour [Claude Platform on AWS](/fr/claude-platform-on-aws). Envoyé à chaque requête en tant qu'en-tête `anthropic-workspace-id` |

105| `ANTHROPIC_BASE_URL` | Remplacer le point de terminaison de l'API pour acheminer les requêtes via un proxy ou une passerelle. Lorsqu'elle est définie sur un hôte non-first-party, la [recherche d'outils MCP](/fr/mcp#scale-with-mcp-tool-search) est désactivée par défaut. Définissez `ENABLE_TOOL_SEARCH=true` si votre proxy transfère les blocs `tool_reference`. {/* min-version: 2.1.196 */}À partir de v2.1.196, le [Contrôle à distance](/fr/remote-control#requirements) est désactivé lorsque cela pointe vers un hôte autre que `api.anthropic.com`, correspondant à son comportement sur Bedrock, Vertex AI et Foundry |105| `ANTHROPIC_BASE_URL` | Remplacer le point de terminaison de l'API pour acheminer les requêtes via un proxy ou une passerelle. Lorsqu'elle est définie sur un hôte non-first-party, la [recherche d'outils MCP](/fr/mcp#scale-with-mcp-tool-search) est désactivée par défaut. Définissez `ENABLE_TOOL_SEARCH=true` si votre proxy transfère les blocs `tool_reference`. {/* min-version: 2.1.196 */}À partir de v2.1.196, le [Contrôle à distance](/fr/remote-control#requirements) est désactivé lorsque cela pointe vers un hôte autre que `api.anthropic.com`, correspondant à son comportement sur Amazon Bedrock, Google Cloud's Agent Platform et Microsoft Foundry |

106| `ANTHROPIC_BEDROCK_BASE_URL` | Remplacer l'URL du point de terminaison Bedrock. À utiliser pour les points de terminaison Bedrock personnalisés ou lors du routage via une [passerelle LLM](/fr/llm-gateway). Voir [Amazon Bedrock](/fr/amazon-bedrock) |106| `ANTHROPIC_BEDROCK_BASE_URL` | Remplacer l'URL du point de terminaison Amazon Bedrock. À utiliser pour les points de terminaison Amazon Bedrock personnalisés ou lors du routage via une [passerelle LLM](/fr/llm-gateway). Voir [Amazon Bedrock](/fr/amazon-bedrock) |

107| `ANTHROPIC_BEDROCK_MANTLE_BASE_URL` | Remplacer l'URL du point de terminaison Bedrock Mantle. Voir [Point de terminaison Mantle](/fr/amazon-bedrock#use-the-mantle-endpoint) |107| `ANTHROPIC_BEDROCK_MANTLE_BASE_URL` | Remplacer l'URL du point de terminaison Amazon Bedrock Mantle. Voir [Point de terminaison Mantle](/fr/amazon-bedrock#use-the-mantle-endpoint) |

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

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

110| `ANTHROPIC_CUSTOM_HEADERS` | En-têtes personnalisés à ajouter aux requêtes (format `Name: Value`, séparés par des sauts de ligne pour plusieurs en-têtes) |110| `ANTHROPIC_CUSTOM_HEADERS` | En-têtes personnalisés à ajouter aux requêtes (format `Name: Value`, séparés par des sauts de ligne pour plusieurs en-têtes) |

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


129| `ANTHROPIC_DEFAULT_SONNET_MODEL_NAME` | Voir [Configuration du modèle](/fr/model-config#customize-pinned-model-display-and-capabilities) |129| `ANTHROPIC_DEFAULT_SONNET_MODEL_NAME` | Voir [Configuration du modèle](/fr/model-config#customize-pinned-model-display-and-capabilities) |

130| `ANTHROPIC_DEFAULT_SONNET_MODEL_SUPPORTED_CAPABILITIES` | Voir [Configuration du modèle](/fr/model-config#customize-pinned-model-display-and-capabilities) |130| `ANTHROPIC_DEFAULT_SONNET_MODEL_SUPPORTED_CAPABILITIES` | Voir [Configuration du modèle](/fr/model-config#customize-pinned-model-display-and-capabilities) |

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

132| `ANTHROPIC_FOUNDRY_BASE_URL` | URL de base complète pour la ressource Foundry (par exemple, `https://my-resource.services.ai.azure.com/anthropic`). Alternative à `ANTHROPIC_FOUNDRY_RESOURCE` (voir [Microsoft Foundry](/fr/microsoft-foundry)) |132| `ANTHROPIC_FOUNDRY_AUTH_TOKEN` | {/* min-version: 2.1.203 */}Jeton Bearer pour l'authentification Microsoft Foundry, tel qu'un jeton d'accès Microsoft Entra. Claude Code l'envoie en tant qu'en-tête `Authorization: Bearer`. Prend la priorité sur `ANTHROPIC_FOUNDRY_API_KEY` et sur la chaîne d'identifiants par défaut Azure. Voir [Microsoft Foundry](/fr/microsoft-foundry). Nécessite Claude Code v2.1.203 ou ultérieur |

133| `ANTHROPIC_FOUNDRY_RESOURCE` | Nom de la ressource Foundry (par exemple, `my-resource`). Requis si `ANTHROPIC_FOUNDRY_BASE_URL` n'est pas défini (voir [Microsoft Foundry](/fr/microsoft-foundry)) |133| `ANTHROPIC_FOUNDRY_BASE_URL` | URL de base complète pour la ressource Microsoft Foundry (par exemple, `https://my-resource.services.ai.azure.com/anthropic`). Alternative à `ANTHROPIC_FOUNDRY_RESOURCE` (voir [Microsoft Foundry](/fr/microsoft-foundry)) |

134| `ANTHROPIC_FOUNDRY_RESOURCE` | Nom de la ressource Microsoft Foundry (par exemple, `my-resource`). Requis si `ANTHROPIC_FOUNDRY_BASE_URL` n'est pas défini (voir [Microsoft Foundry](/fr/microsoft-foundry)) |

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

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

136| `ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION` | Remplacer la région AWS pour le modèle de classe Haiku lors de l'utilisation de Bedrock ou Bedrock Mantle. Sur Bedrock, cela ne prend effet que lorsque `ANTHROPIC_DEFAULT_HAIKU_MODEL` ou le `ANTHROPIC_SMALL_FAST_MODEL` déprécié est également défini, car Bedrock utilise autrement le modèle principal pour les tâches en arrière-plan |137| `ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION` | Remplacer la région AWS pour le modèle de classe Haiku lors de l'utilisation d'Amazon Bedrock ou Amazon Bedrock Mantle. Sur Amazon Bedrock, cela ne prend effet que lorsque `ANTHROPIC_DEFAULT_HAIKU_MODEL` ou le `ANTHROPIC_SMALL_FAST_MODEL` déprécié est également défini, car Amazon Bedrock utilise autrement le modèle principal pour les tâches en arrière-plan |

137| `ANTHROPIC_VERTEX_BASE_URL` | Remplacer l'URL du point de terminaison Vertex AI. À utiliser pour les points de terminaison Vertex personnalisés ou lors du routage via une [passerelle LLM](/fr/llm-gateway). Voir [Google Vertex AI](/fr/google-vertex-ai) |138| `ANTHROPIC_VERTEX_BASE_URL` | Remplacer l'URL du point de terminaison Google Cloud's Agent Platform. À utiliser pour les points de terminaison Google Cloud's Agent Platform personnalisés ou lors du routage via une [passerelle LLM](/fr/llm-gateway). Voir [Google Cloud's Agent Platform](/fr/google-vertex-ai) |

138| `ANTHROPIC_VERTEX_PROJECT_ID` | ID de projet GCP pour les requêtes Vertex AI. Remplacé par `GCLOUD_PROJECT`, `GOOGLE_CLOUD_PROJECT` ou le projet dans votre fichier d'identifiants `GOOGLE_APPLICATION_CREDENTIALS`. Voir [Google Vertex AI](/fr/google-vertex-ai) |139| `ANTHROPIC_VERTEX_PROJECT_ID` | ID de projet GCP pour les requêtes Google Cloud's Agent Platform. Remplacé par `GCLOUD_PROJECT`, `GOOGLE_CLOUD_PROJECT` ou le projet dans votre fichier d'identifiants `GOOGLE_APPLICATION_CREDENTIALS`. Voir [Google Cloud's Agent Platform](/fr/google-vertex-ai) |

139| `ANTHROPIC_WORKSPACE_ID` | ID d'espace de travail pour la [fédération d'identité de charge de travail](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation). Définissez ceci lorsque votre règle de fédération est limitée à plus d'un espace de travail pour que l'échange de jetons sache quel espace de travail cibler |140| `ANTHROPIC_WORKSPACE_ID` | ID d'espace de travail pour la [fédération d'identité de charge de travail](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation). Définissez ceci lorsque votre règle de fédération est limitée à plus d'un espace de travail pour que l'échange de jetons sache quel espace de travail cibler |

140| `API_FORCE_IDLE_TIMEOUT` | {/* min-version: 2.1.169 */}Remplacer le délai d'expiration d'inactivité de 5 minutes qui interrompt une réponse de modèle en continu lorsqu'aucun octet n'arrive. Définissez sur `0` pour désactiver le délai d'expiration, par exemple lorsqu'une [passerelle](/fr/llm-gateway) lente ou un modèle local fait une pause plus longue que 5 minutes entre les chunks. Définissez sur `1` pour maintenir le délai d'expiration sur chaque fournisseur. Lorsqu'il n'est pas défini, le délai d'expiration est inactif sur les connexions API Anthropic directes et [Claude Platform on AWS](/fr/claude-platform-on-aws), où le chien de garde de flux au niveau des octets de Claude Code s'exécute, et actif sur tous les autres fournisseurs, y compris [Vertex AI](/fr/google-vertex-ai), [Foundry](/fr/microsoft-foundry), [Mantle](/fr/amazon-bedrock#use-the-mantle-endpoint), [Bedrock](/fr/amazon-bedrock) et les connexions de passerelle, de sorte qu'un flux bloqué s'interrompt au lieu de rester suspendu. À partir de v2.1.169 |141| `API_FORCE_IDLE_TIMEOUT` | {/* min-version: 2.1.169 */}Remplacer le délai d'expiration d'inactivité de 5 minutes qui interrompt une réponse de modèle en continu lorsqu'aucun octet n'arrive. Définissez sur `0` pour désactiver le délai d'expiration, par exemple lorsqu'une [passerelle](/fr/llm-gateway) lente ou un modèle local fait une pause plus longue que 5 minutes entre les chunks. Définissez sur `1` pour maintenir le délai d'expiration sur chaque fournisseur. Lorsqu'il n'est pas défini, le délai d'expiration est inactif sur les connexions API Anthropic directes et [Claude Platform on AWS](/fr/claude-platform-on-aws), où le chien de garde de flux au niveau des octets de Claude Code s'exécute, et actif sur tous les autres fournisseurs, y compris [Google Cloud's Agent Platform](/fr/google-vertex-ai), [Microsoft Foundry](/fr/microsoft-foundry), [Mantle](/fr/amazon-bedrock#use-the-mantle-endpoint), [Amazon Bedrock](/fr/amazon-bedrock) et les connexions de passerelle, de sorte qu'un flux bloqué s'interrompt au lieu de rester suspendu. À partir de v2.1.169 |

141| `API_TIMEOUT_MS` | Délai d'expiration pour les requêtes API en millisecondes (par défaut : 600 000, ou 10 minutes ; maximum : 2 147 483 647). Augmentez ceci lorsque les requêtes expirent sur les réseaux lents ou lors du routage via un proxy. Les valeurs au-dessus du maximum dépassent le minuteur sous-jacent et provoquent l'échec immédiat des requêtes |142| `API_TIMEOUT_MS` | Délai d'expiration pour les requêtes API en millisecondes (par défaut : 600 000, ou 10 minutes ; maximum : 2 147 483 647). Augmentez ceci lorsque les requêtes expirent sur les réseaux lents ou lors du routage via un proxy. Les valeurs au-dessus du maximum dépassent le minuteur sous-jacent et provoquent l'échec immédiat des requêtes |

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

143| `BASH_DEFAULT_TIMEOUT_MS` | Délai d'expiration par défaut pour les commandes bash longues (par défaut : 120 000, ou 2 minutes) |144| `BASH_DEFAULT_TIMEOUT_MS` | Délai d'expiration par défaut pour les commandes bash longues (par défaut : 120 000, ou 2 minutes) |

144| `BASH_MAX_OUTPUT_LENGTH` | Nombre maximum de caractères dans les sorties bash avant que la sortie complète soit enregistrée dans un fichier et que Claude reçoive le chemin plus un court aperçu. Voir [Comportement de l'outil Bash](/fr/tools-reference#bash-tool-behavior) |145| `BASH_MAX_OUTPUT_LENGTH` | Nombre maximum de caractères dans les sorties bash avant que la sortie complète soit enregistrée dans un fichier et que Claude reçoive le chemin plus un court aperçu. Voir [Comportement de l'outil Bash](/fr/tools-reference#bash-tool-behavior) |

145| `BASH_MAX_TIMEOUT_MS` | Délai d'expiration maximal que le modèle peut définir pour les commandes bash longues (par défaut : 600 000, ou 10 minutes) |146| `BASH_MAX_TIMEOUT_MS` | Délai d'expiration maximal que le modèle peut définir pour les commandes bash longues (par défaut : 600 000, ou 10 minutes) |

146| `CCR_FORCE_BUNDLE` | Définissez sur `1` pour forcer [`claude --remote`](/fr/claude-code-on-the-web#send-local-repositories-without-github) à regrouper et télécharger votre référentiel local même lorsque l'accès à GitHub est disponible |147| `CCR_FORCE_BUNDLE` | Définissez sur `1` pour forcer [`claude --cloud`](/fr/claude-code-on-the-web#send-local-repositories-without-github) à regrouper et télécharger votre référentiel local même lorsque l'accès à GitHub est disponible |

147| `CLAUDECODE` | Défini sur `1` dans les sous-processus que Claude Code génère (outils Bash et PowerShell, sessions tmux, commandes [hook](/fr/hooks), commandes de [ligne d'état](/fr/statusline), sous-processus du serveur MCP [stdio](/fr/mcp)). Les extensions IDE définissent également ceci dans leurs terminaux intégrés. À utiliser pour détecter quand un script s'exécute à l'intérieur d'un sous-processus généré par Claude Code. Pour vérifier si le processus actuel a été généré directement par un appel d'outil ou un hook, plutôt qu'à l'intérieur d'un serveur MCP stdio que Claude Code a démarré, utilisez `CLAUDE_CODE_CHILD_SESSION` à la place |148| `CLAUDECODE` | Défini sur `1` dans les sous-processus que Claude Code génère (outils Bash et PowerShell, sessions tmux, commandes [hook](/fr/hooks), commandes de [ligne d'état](/fr/statusline), sous-processus du serveur MCP [stdio](/fr/mcp)). Les extensions IDE définissent également ceci dans leurs terminaux intégrés. À utiliser pour détecter quand un script s'exécute à l'intérieur d'un sous-processus généré par Claude Code. Pour vérifier si le processus actuel a été généré directement par un appel d'outil ou un hook, plutôt qu'à l'intérieur d'un serveur MCP stdio que Claude Code a démarré, utilisez `CLAUDE_CODE_CHILD_SESSION` à la place |

148| `CLAUDE_AFK_COUNTDOWN_MS` | {/* min-version: 2.1.198 */}Combien de millisecondes avant le compte à rebours d'auto-continuation apparaît sur un dialogue `AskUserQuestion` sans réponse. Par défaut `20000` (20 secondes). Voir `CLAUDE_AFK_TIMEOUT_MS`. Nécessite Claude Code v2.1.198 ou ultérieur |149| `CLAUDE_AFK_COUNTDOWN_MS` | {/* min-version: 2.1.198 */}Combien de millisecondes avant le compte à rebours d'auto-continuation apparaît sur un dialogue [`AskUserQuestion`](/fr/tools-reference) sans réponse. Par défaut `20000` (20 secondes), plafonné au délai d'expiration d'auto-continuation. N'a aucun effet sauf si l'auto-continuation est activée ; voir le paramètre [`askUserQuestionTimeout`](/fr/settings#available-settings) et `CLAUDE_AFK_TIMEOUT_MS`. Nécessite Claude Code v2.1.198 ou ultérieur |

149| `CLAUDE_AFK_TIMEOUT_MS` | {/* min-version: 2.1.198 */}Combien de millisecondes de temps d'inactivité avant qu'un dialogue [`AskUserQuestion`](/fr/tools-reference) sans réponse se poursuive automatiquement sans vous. Par défaut `60000` (60 secondes). Pour garder les questions ouvertes pendant que vous êtes absent, définissez une grande valeur comme `86400000` (24 heures). La définition de `0` ne désactive pas le délai d'expiration ; elle ferme le dialogue immédiatement. Nécessite Claude Code v2.1.198 ou ultérieur |150| `CLAUDE_AFK_TIMEOUT_MS` | {/* min-version: 2.1.198 */}Combien de millisecondes de temps d'inactivité avant qu'un dialogue [`AskUserQuestion`](/fr/tools-reference) sans réponse se poursuive automatiquement sans vous. {/* min-version: 2.1.200 */}L'auto-continuation est désactivée par défaut ; participez avec le paramètre [`askUserQuestionTimeout`](/fr/settings#available-settings). Cette variable est un remplacement pour les démos et les tests automatisés : lorsqu'elle est définie, elle prend la priorité sur ce paramètre et active l'auto-continuation même lorsque le paramètre n'est pas défini ou est `never`. La définition de `0` ne désactive pas le délai d'expiration ; elle ferme le dialogue immédiatement. Dans v2.1.198 et v2.1.199, l'auto-continuation était activée par défaut avec un délai d'expiration de `60000` (60 secondes). Nécessite Claude Code v2.1.198 ou ultérieur |

150| `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` | Définissez sur `1` pour désactiver tous les types de [subagent](/fr/sub-agents) intégrés tels que Explore et Plan. S'applique uniquement en mode non interactif (l'indicateur `-p`). Utile pour les utilisateurs du SDK qui veulent une ardoise vierge |151| `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` | Définissez sur `1` pour désactiver tous les types de [subagent](/fr/sub-agents) intégrés tels que Explore et Plan. S'applique uniquement en mode non interactif (l'indicateur `-p`). Utile pour les utilisateurs du SDK qui veulent une ardoise vierge |

151| `CLAUDE_AGENT_SDK_MCP_NO_PREFIX` | Définissez sur `1` pour ignorer le préfixe `mcp__<server>__` sur les noms d'outils des serveurs MCP créés par le SDK. Les outils utilisent leurs noms d'origine. Utilisation du SDK uniquement |152| `CLAUDE_AGENT_SDK_MCP_NO_PREFIX` | Définissez sur `1` pour ignorer le préfixe `mcp__<server>__` sur les noms d'outils des serveurs MCP créés par le SDK. Les outils utilisent leurs noms d'origine. Utilisation du SDK uniquement |

152| `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS` | Délai d'expiration de blocage en millisecondes pour les subagents en arrière-plan. Par défaut `600000` (10 minutes). Le minuteur se réinitialise à chaque événement de progression en continu ; si aucune progression n'arrive dans la fenêtre, le subagent est interrompu et la tâche est marquée comme échouée, exposant tout résultat partiel au parent |153| `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS` | Délai d'expiration de blocage en millisecondes pour les subagents en arrière-plan. Par défaut `600000` (10 minutes). Le minuteur se réinitialise à chaque événement de progression en continu ; si aucune progression n'arrive dans la fenêtre, le subagent est interrompu et la tâche est marquée comme échouée, exposant tout résultat partiel au parent |


184| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | Définissez sur `1` pour désactiver toutes les fonctionnalités de tâche en arrière-plan, y compris le paramètre `run_in_background` sur les outils Bash et subagent, l'arrière-plan automatique et le raccourci Ctrl+B |185| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | Définissez sur `1` pour désactiver toutes les fonctionnalités de tâche en arrière-plan, y compris le paramètre `run_in_background` sur les outils Bash et subagent, l'arrière-plan automatique et le raccourci Ctrl+B |

185| `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF` | {/* min-version: 2.1.196 */}Définissez sur `1` pour arrêter les commandes shell en arrière-plan en cours d'exécution, les workflows dynamiques, {/* min-version: 2.1.198 */}et, à partir de v2.1.198, les subagents en arrière-plan d'une [session en arrière-plan](/fr/agent-view) lorsque le [superviseur](/fr/agent-view#the-supervisor-process) arrête, redémarre ou met à jour le processus de cette session, au lieu de les transmettre au processus suivant de la session. Affecte uniquement cette transmission : la mise en arrière-plan d'une session avec `←` ou [`/background`](/fr/agent-view#from-inside-a-session) porte toujours le travail en cours, et `CLAUDE_DISABLE_ADOPT` désactive les deux. Nécessite Claude Code v2.1.196 ou ultérieur |186| `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF` | {/* min-version: 2.1.196 */}Définissez sur `1` pour arrêter les commandes shell en arrière-plan en cours d'exécution, les workflows dynamiques, {/* min-version: 2.1.198 */}et, à partir de v2.1.198, les subagents en arrière-plan d'une [session en arrière-plan](/fr/agent-view) lorsque le [superviseur](/fr/agent-view#the-supervisor-process) arrête, redémarre ou met à jour le processus de cette session, au lieu de les transmettre au processus suivant de la session. Affecte uniquement cette transmission : la mise en arrière-plan d'une session avec `←` ou [`/background`](/fr/agent-view#from-inside-a-session) porte toujours le travail en cours, et `CLAUDE_DISABLE_ADOPT` désactive les deux. Nécessite Claude Code v2.1.196 ou ultérieur |

186| `CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP` | {/* min-version: 2.1.193 */}Définissez sur `1` pour arrêter Claude Code de terminer les [commandes shell en arrière-plan](/fr/interactive-mode#background-bash-commands) lorsque le système d'exploitation signale une pression mémoire. Par défaut, sur macOS et Linux, Claude Code termine un shell en arrière-plan démarré dans la session principale sur un signal de pression mémoire une fois que la session a été inactive pendant 30 minutes et qu'aucun tour ou subagent n'est en cours d'exécution. Windows n'a pas de signal de pression mémoire, de sorte que cette variable n'a aucun effet là-bas. Nécessite Claude Code v2.1.193 ou ultérieur |187| `CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP` | {/* min-version: 2.1.193 */}Définissez sur `1` pour arrêter Claude Code de terminer les [commandes shell en arrière-plan](/fr/interactive-mode#background-bash-commands) lorsque le système d'exploitation signale une pression mémoire. Par défaut, sur macOS et Linux, Claude Code termine un shell en arrière-plan démarré dans la session principale sur un signal de pression mémoire une fois que la session a été inactive pendant 30 minutes et qu'aucun tour ou subagent n'est en cours d'exécution. Windows n'a pas de signal de pression mémoire, de sorte que cette variable n'a aucun effet là-bas. Nécessite Claude Code v2.1.193 ou ultérieur |

187| `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` | Définissez sur `1` pour désactiver les [skills](/fr/skills) et workflows qui sont fournis avec Claude Code : les skills groupés et les workflows intégrés sont supprimés entièrement, tandis que les commandes slash intégrées comme `/init` restent tapables mais sont masquées au modèle. Les skills des plugins, `.claude/skills/` et `.claude/commands/` ne sont pas affectés. Équivalent au paramètre [`disableBundledSkills`](/fr/settings#available-settings) ; `0` ne le remplace pas |188| `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` | Définissez sur `1` pour désactiver les [skills](/fr/skills) et workflows qui sont fournis avec Claude Code : les skills groupés et les workflows intégrés sont supprimés entièrement, tandis que les commandes slash intégrées comme `/init` restent tapables mais sont masquées au modèle. `/doctor` reste tapable comme les commandes intégrées ; masquez-le avec `DISABLE_DOCTOR_COMMAND` à la place. Les skills des plugins, `.claude/skills/` et `.claude/commands/` ne sont pas affectés. Équivalent au paramètre [`disableBundledSkills`](/fr/settings#available-settings) ; `0` ne le remplace pas |

188| `CLAUDE_CODE_DISABLE_CLAUDE_MDS` | Définissez sur `1` pour empêcher le chargement de tous les fichiers de mémoire CLAUDE.md dans le contexte, y compris les fichiers utilisateur, projet et mémoire automatique |189| `CLAUDE_CODE_DISABLE_CLAUDE_MDS` | Définissez sur `1` pour empêcher le chargement de tous les fichiers de mémoire CLAUDE.md dans le contexte, y compris les fichiers utilisateur, projet et mémoire automatique |

189| `CLAUDE_CODE_DISABLE_CRON` | Définissez sur `1` pour désactiver les [tâches planifiées](/fr/scheduled-tasks). Le skill `/loop` et les outils cron deviennent indisponibles et toutes les tâches déjà planifiées cessent de se déclencher, y compris les tâches qui s'exécutent déjà en milieu de session |190| `CLAUDE_CODE_DISABLE_CRON` | Définissez sur `1` pour désactiver les [tâches planifiées](/fr/scheduled-tasks). Le skill `/loop` et les outils cron deviennent indisponibles et toutes les tâches déjà planifiées cessent de se déclencher, y compris les tâches qui s'exécutent déjà en milieu de session |

190| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | Définissez sur `1` pour supprimer les en-têtes de requête `anthropic-beta` spécifiques à Anthropic et les champs de schéma d'outil bêta (tels que `defer_loading` et `eager_input_streaming`) des requêtes API. Utilisez ceci lorsqu'une passerelle proxy rejette les requêtes avec des erreurs comme « Unexpected value(s) for the `anthropic-beta` header » ou « Extra inputs are not permitted ». Les champs standard (`name`, `description`, `input_schema`, `cache_control`) sont conservés |191| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | Définissez sur `1` pour supprimer les en-têtes de requête `anthropic-beta` spécifiques à Anthropic et les champs de schéma d'outil bêta (tels que `defer_loading` et `eager_input_streaming`) des requêtes API. Utilisez ceci lorsqu'une passerelle proxy rejette les requêtes avec des erreurs comme « Unexpected value(s) for the `anthropic-beta` header » ou « Extra inputs are not permitted ». Les champs standard (`name`, `description`, `input_schema`, `cache_control`) sont conservés |


193| `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` | Définissez sur `1` pour désactiver les sondages de qualité de session « Comment Claude se débrouille-t-il ? ». Les sondages sont également désactivés lorsque `DISABLE_TELEMETRY`, `DO_NOT_TRACK` ou `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` est défini, sauf si `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` participe à nouveau. Pour définir un taux d'échantillonnage au lieu de désactiver complètement, utilisez le paramètre [`feedbackSurveyRate`](/fr/settings#available-settings). Voir [Sondages de qualité de session](/fr/data-usage#session-quality-surveys) |194| `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` | Définissez sur `1` pour désactiver les sondages de qualité de session « Comment Claude se débrouille-t-il ? ». Les sondages sont également désactivés lorsque `DISABLE_TELEMETRY`, `DO_NOT_TRACK` ou `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` est défini, sauf si `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` participe à nouveau. Pour définir un taux d'échantillonnage au lieu de désactiver complètement, utilisez le paramètre [`feedbackSurveyRate`](/fr/settings#available-settings). Voir [Sondages de qualité de session](/fr/data-usage#session-quality-surveys) |

194| `CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING` | Définissez sur `1` pour désactiver le [checkpointing](/fr/checkpointing) de fichier. La commande `/rewind` ne pourra pas restaurer les modifications de code |195| `CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING` | Définissez sur `1` pour désactiver le [checkpointing](/fr/checkpointing) de fichier. La commande `/rewind` ne pourra pas restaurer les modifications de code |

195| `CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS` | Définissez sur `1` pour supprimer les instructions de flux de travail de commit et PR intégrées et l'instantané du statut git de l'invite système de Claude. Utile lors de l'utilisation de vos propres skills de flux de travail git. Prend la priorité sur le paramètre [`includeGitInstructions`](/fr/settings#available-settings) lorsqu'il est défini |196| `CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS` | Définissez sur `1` pour supprimer les instructions de flux de travail de commit et PR intégrées et l'instantané du statut git de l'invite système de Claude. Utile lors de l'utilisation de vos propres skills de flux de travail git. Prend la priorité sur le paramètre [`includeGitInstructions`](/fr/settings#available-settings) lorsqu'il est défini |

196| `CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP` | Définissez sur `1` pour empêcher le remappage automatique d'Opus 4.0 et 4.1 à la version Opus actuelle sur l'API Anthropic. À utiliser lorsque vous souhaitez intentionnellement épingler une version plus ancienne du modèle. Le remappage ne s'exécute pas sur Bedrock, Vertex ou Foundry |197| `CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP` | Définissez sur `1` pour empêcher le remappage automatique d'Opus 4.0 et 4.1 à la version Opus actuelle sur l'API Anthropic. À utiliser lorsque vous souhaitez intentionnellement épingler une version plus ancienne du modèle. Le remappage ne s'exécute pas sur Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry |

197| `CLAUDE_CODE_DISABLE_MOUSE` | Définissez sur `1` pour désactiver le suivi de la souris dans le [rendu en plein écran](/fr/fullscreen). Le défilement au clavier avec `PgUp` et `PgDn` fonctionne toujours. Utilisez ceci pour conserver le comportement natif de copie à la sélection de votre terminal |198| `CLAUDE_CODE_DISABLE_MOUSE` | Définissez sur `1` pour désactiver le suivi de la souris dans le [rendu en plein écran](/fr/fullscreen). Le défilement au clavier avec `PgUp` et `PgDn` fonctionne toujours. Utilisez ceci pour conserver le comportement natif de copie à la sélection de votre terminal |

198| `CLAUDE_CODE_DISABLE_MOUSE_CLICKS` | {/* min-version: 2.1.195 */}Définissez sur `1` pour désactiver le clic, le glissement et le survol dans le [rendu en plein écran](/fr/fullscreen) tout en conservant le défilement à la molette de la souris. À utiliser lorsque vous souhaitez que le défilement à la molette fonctionne à l'intérieur de Claude Code mais que vous ne souhaitez pas que les clics positionnent le curseur, développent la sortie d'outil ou ouvrent des liens. `CLAUDE_CODE_DISABLE_MOUSE` prend la priorité lorsque les deux sont définis. Nécessite Claude Code v2.1.195 ou ultérieur |199| `CLAUDE_CODE_DISABLE_MOUSE_CLICKS` | {/* min-version: 2.1.195 */}Définissez sur `1` pour désactiver le clic, le glissement et le survol dans le [rendu en plein écran](/fr/fullscreen) tout en conservant le défilement à la molette de la souris. À utiliser lorsque vous souhaitez que le défilement à la molette fonctionne à l'intérieur de Claude Code mais que vous ne souhaitez pas que les clics positionnent le curseur, développent la sortie d'outil ou ouvrent des liens. `CLAUDE_CODE_DISABLE_MOUSE` prend la priorité lorsque les deux sont définis. Nécessite Claude Code v2.1.195 ou ultérieur |

199| `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` | Équivalent de la définition de `DISABLE_AUTOUPDATER`, `DISABLE_FEEDBACK_COMMAND`, `DISABLE_ERROR_REPORTING` et `DISABLE_TELEMETRY` |200| `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` | Équivalent de la définition de `DISABLE_AUTOUPDATER`, `DISABLE_FEEDBACK_COMMAND`, `DISABLE_ERROR_REPORTING` et `DISABLE_TELEMETRY` |


206| `CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL` | Définissez sur `1` pour désactiver le défilement virtuel dans le [rendu en plein écran](/fr/fullscreen) et afficher chaque message dans la transcription. Utilisez ceci si le défilement en mode plein écran affiche des régions vierges où les messages devraient apparaître |207| `CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL` | Définissez sur `1` pour désactiver le défilement virtuel dans le [rendu en plein écran](/fr/fullscreen) et afficher chaque message dans la transcription. Utilisez ceci si le défilement en mode plein écran affiche des régions vierges où les messages devraient apparaître |

207| `CLAUDE_CODE_DISABLE_WORKFLOWS` | Définissez sur `1` pour désactiver les [workflows](/fr/workflows#turn-workflows-off). Équivalent au paramètre [`disableWorkflows`](/fr/settings#available-settings) |208| `CLAUDE_CODE_DISABLE_WORKFLOWS` | Définissez sur `1` pour désactiver les [workflows](/fr/workflows#turn-workflows-off). Équivalent au paramètre [`disableWorkflows`](/fr/settings#available-settings) |

208| `CLAUDE_CODE_EFFORT_LEVEL` | Définissez le niveau d'effort pour les modèles pris en charge. Valeurs : `low`, `medium`, `high`, `xhigh`, `max` ou `auto` pour utiliser le niveau par défaut du modèle. Les niveaux disponibles dépendent du modèle. Prend la priorité sur `/effort` et le paramètre `effortLevel`. Voir [Ajuster le niveau d'effort](/fr/model-config#adjust-effort-level) |209| `CLAUDE_CODE_EFFORT_LEVEL` | Définissez le niveau d'effort pour les modèles pris en charge. Valeurs : `low`, `medium`, `high`, `xhigh`, `max` ou `auto` pour utiliser le niveau par défaut du modèle. Les niveaux disponibles dépendent du modèle. Prend la priorité sur `/effort` et le paramètre `effortLevel`. Voir [Ajuster le niveau d'effort](/fr/model-config#adjust-effort-level) |

209| `CLAUDE_CODE_ENABLE_AUTO_MODE` | {/* min-version: 2.1.158 */}Définissez sur `1` pour rendre le [mode auto](/fr/permission-modes#eliminate-prompts-with-auto-mode) disponible sur Amazon Bedrock, Google Cloud Vertex AI, Microsoft Foundry et les sessions [passerelle d'applications Claude](/fr/claude-apps-gateway) signées. Nécessite Claude Code v2.1.158 ou ultérieur. N'a aucun effet sur l'API Anthropic, où le mode auto est disponible par défaut. Voir [Activer le mode auto sur Bedrock, Vertex AI ou Foundry](/fr/permission-modes#enable-auto-mode-on-bedrock-vertex-ai-or-foundry) |210| `CLAUDE_CODE_ENABLE_APPEND_SUBAGENT_PROMPT` | {/* min-version: 2.1.205 */}Définissez sur `1` pour activer l'ajout de texte supplémentaire à la fin de l'invite système de chaque [subagent](/fr/sub-agents). Le drapeau [`--append-subagent-system-prompt`](/fr/cli-reference#cli-flags) fournit le texte ajouté et définit cette variable automatiquement, de sorte que vous n'ayez pas besoin de la définir vous-même. Nécessite Claude Code v2.1.205 ou ultérieur |

211| `CLAUDE_CODE_ENABLE_AUTO_MODE` | {/* min-version: 2.1.158 */}Définissez sur `1` pour rendre le [mode auto](/fr/permission-modes#eliminate-prompts-with-auto-mode) disponible sur Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry et les sessions [passerelle d'applications Claude](/fr/claude-apps-gateway) signées. Nécessite Claude Code v2.1.158 ou ultérieur. N'a aucun effet sur l'API Anthropic, où le mode auto est disponible par défaut. Voir [Activer le mode auto sur Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry](/fr/permission-modes#enable-auto-mode-on-bedrock-agent-platform-or-foundry) |

210| `CLAUDE_CODE_ENABLE_AWAY_SUMMARY` | Remplacer la disponibilité du [récapitulatif de session](/fr/interactive-mode#session-recap). Définissez sur `0` pour forcer les récapitulatifs désactivés indépendamment du bouton bascule `/config`. Définissez sur `1` pour forcer les récapitulatifs activés lorsque [`awaySummaryEnabled`](/fr/settings#available-settings) est `false`. Prend la priorité sur le paramètre et le bouton bascule `/config` |212| `CLAUDE_CODE_ENABLE_AWAY_SUMMARY` | Remplacer la disponibilité du [récapitulatif de session](/fr/interactive-mode#session-recap). Définissez sur `0` pour forcer les récapitulatifs désactivés indépendamment du bouton bascule `/config`. Définissez sur `1` pour forcer les récapitulatifs activés lorsque [`awaySummaryEnabled`](/fr/settings#available-settings) est `false`. Prend la priorité sur le paramètre et le bouton bascule `/config` |

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

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

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

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

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

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


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

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

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

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

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

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

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


260| `CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY` | Définissez sur `1` pour arrêter Claude Code de passer `-ExecutionPolicy Bypass` lors du lancement de PowerShell pour les appels d'outils, les hooks et les commandes de ligne d'état, et respecter la politique d'exécution effective de la machine à la place. Par défaut, Claude Code contourne la politique d'exécution au niveau du processus pour que les scripts `.ps1` et les importations de modules fonctionnent sur les installations Windows par défaut avec Restricted. Le contournement au niveau du processus ne remplace jamais la `MachinePolicy` ou `UserPolicy` de Group Policy indépendamment de ce paramètre |262| `CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY` | Définissez sur `1` pour arrêter Claude Code de passer `-ExecutionPolicy Bypass` lors du lancement de PowerShell pour les appels d'outils, les hooks et les commandes de ligne d'état, et respecter la politique d'exécution effective de la machine à la place. Par défaut, Claude Code contourne la politique d'exécution au niveau du processus pour que les scripts `.ps1` et les importations de modules fonctionnent sur les installations Windows par défaut avec Restricted. Le contournement au niveau du processus ne remplace jamais la `MachinePolicy` ou `UserPolicy` de Group Policy indépendamment de ce paramètre |

261| `CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS` | {/* min-version: 2.1.182 */}Temps maximal en millisecondes que le [mode non interactif](/fr/headless#background-tasks-at-exit) avec l'indicateur `-p` attend après le tour final pour les subagents en arrière-plan et les workflows dont le résultat fait partie de la sortie. Par défaut : `600000`, ou 10 minutes. Lorsque le plafond est dépassé, les tâches en arrière-plan restantes sont terminées et le processus se termine. Définissez sur `0` pour attendre indéfiniment. Ce plafond est distinct de la période de grâce de cinq secondes qui s'applique aux shells en arrière-plan simples |263| `CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS` | {/* min-version: 2.1.182 */}Temps maximal en millisecondes que le [mode non interactif](/fr/headless#background-tasks-at-exit) avec l'indicateur `-p` attend après le tour final pour les subagents en arrière-plan et les workflows dont le résultat fait partie de la sortie. Par défaut : `600000`, ou 10 minutes. Lorsque le plafond est dépassé, les tâches en arrière-plan restantes sont terminées et le processus se termine. Définissez sur `0` pour attendre indéfiniment. Ce plafond est distinct de la période de grâce de cinq secondes qui s'applique aux shells en arrière-plan simples |

262| `CLAUDE_CODE_PROPAGATE_TRACEPARENT` | {/* min-version: 2.1.152 */}Définissez sur `1` pour propager le contexte de trace W3C lorsque `ANTHROPIC_BASE_URL` pointe vers un proxy personnalisé. La propagation couvre l'en-tête `traceparent` sur les requêtes de modèle et MCP HTTP et la variable d'environnement `TRACEPARENT` pour les sous-processus Bash, PowerShell et hook. Par défaut, la propagation est activée uniquement lors de la connexion directe à l'API Anthropic. Ajouté dans v2.1.152. Voir [Traces (bêta)](/fr/monitoring-usage#traces-beta) |264| `CLAUDE_CODE_PROPAGATE_TRACEPARENT` | {/* min-version: 2.1.152 */}Définissez sur `1` pour propager le contexte de trace W3C lorsque `ANTHROPIC_BASE_URL` pointe vers un proxy personnalisé. La propagation couvre l'en-tête `traceparent` sur les requêtes de modèle et MCP HTTP et la variable d'environnement `TRACEPARENT` pour les sous-processus Bash, PowerShell et hook. Par défaut, la propagation est activée uniquement lors de la connexion directe à l'API Anthropic. Ajouté dans v2.1.152. Voir [Traces (bêta)](/fr/monitoring-usage#traces-beta) |

263| `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` | Défini par les plates-formes hôtes qui intègrent Claude Code et gèrent le routage du fournisseur de modèles en son nom. Lorsqu'elle est définie, la sélection du fournisseur, le point de terminaison et les variables d'authentification telles que `CLAUDE_CODE_USE_BEDROCK`, `ANTHROPIC_BASE_URL` et `ANTHROPIC_API_KEY` dans les fichiers de paramètres sont ignorés pour que les paramètres utilisateur ne puissent pas remplacer le routage de l'hôte. L'opt-out automatique de la télémétrie pour Bedrock, Vertex et Foundry est également ignoré, de sorte que la télémétrie suit l'opt-out standard `DISABLE_TELEMETRY`. Voir [Comportements par défaut par fournisseur API](/fr/data-usage#default-behaviors-by-api-provider) |265| `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` | Défini par les plates-formes hôtes qui intègrent Claude Code et gèrent le routage du fournisseur de modèles en son nom. Lorsqu'elle est définie, la sélection du fournisseur, le point de terminaison et les variables d'authentification telles que `CLAUDE_CODE_USE_BEDROCK`, `ANTHROPIC_BASE_URL` et `ANTHROPIC_API_KEY` dans les fichiers de paramètres sont ignorés pour que les paramètres utilisateur ne puissent pas remplacer le routage de l'hôte. L'opt-out automatique de la télémétrie pour Amazon Bedrock, Google Cloud's Agent Platform et Microsoft Foundry est également ignoré, de sorte que la télémétrie suit l'opt-out standard `DISABLE_TELEMETRY`. Voir [Comportements par défaut par fournisseur API](/fr/data-usage#default-behaviors-by-api-provider) |

264| `CLAUDE_CODE_PROXY_RESOLVES_HOSTS` | Définissez sur `1` pour permettre au proxy d'effectuer la résolution DNS au lieu de l'appelant. Opt-in pour les environnements où le proxy doit gérer la résolution du nom d'hôte |266| `CLAUDE_CODE_PROXY_RESOLVES_HOSTS` | Définissez sur `1` pour permettre au proxy d'effectuer la résolution DNS au lieu de l'appelant. Opt-in pour les environnements où le proxy doit gérer la résolution du nom d'hôte |

265| `CLAUDE_CODE_REMOTE` | Défini automatiquement sur `true` lorsque Claude Code s'exécute en tant que [session cloud](/fr/claude-code-on-the-web). Lisez ceci à partir d'un hook ou d'un script de configuration pour détecter si vous êtes dans un environnement cloud |267| `CLAUDE_CODE_REMOTE` | Défini automatiquement sur `true` lorsque Claude Code s'exécute en tant que [session cloud](/fr/claude-code-on-the-web). Lisez ceci à partir d'un hook ou d'un script de configuration pour détecter si vous êtes dans un environnement cloud |

266| `CLAUDE_CODE_REMOTE_SESSION_ID` | Défini automatiquement dans les [sessions cloud](/fr/claude-code-on-the-web) à l'ID de session actuel. Lisez ceci pour construire un lien vers la transcription de session. Voir [Lier la sortie à la session](/fr/claude-code-on-the-web#link-output-back-to-the-session) |268| `CLAUDE_CODE_REMOTE_SESSION_ID` | Défini automatiquement dans les [sessions cloud](/fr/claude-code-on-the-web) à l'ID de session actuel. Lisez ceci pour construire un lien vers la transcription de session. Voir [Lier la sortie à la session](/fr/claude-code-on-the-web#link-output-back-to-the-session) |


277| `CLAUDE_CODE_SIMPLE` | Définissez sur `1` pour exécuter avec une invite système minimale et uniquement les outils Bash, lecture de fichier et édition de fichier. Les outils MCP de `--mcp-config` sont toujours disponibles. Désactive la découverte automatique des hooks, skills, plugins, serveurs MCP, mémoire automatique et CLAUDE.md. Les jetons OAuth et les identifiants du trousseau ne sont pas lus, donc l'authentification Anthropic doit provenir de `ANTHROPIC_API_KEY` ou d'un `apiKeyHelper` dans `--settings`. Équivalent à la transmission de [`--bare`](/fr/headless#start-faster-with-bare-mode) |279| `CLAUDE_CODE_SIMPLE` | Définissez sur `1` pour exécuter avec une invite système minimale et uniquement les outils Bash, lecture de fichier et édition de fichier. Les outils MCP de `--mcp-config` sont toujours disponibles. Désactive la découverte automatique des hooks, skills, plugins, serveurs MCP, mémoire automatique et CLAUDE.md. Les jetons OAuth et les identifiants du trousseau ne sont pas lus, donc l'authentification Anthropic doit provenir de `ANTHROPIC_API_KEY` ou d'un `apiKeyHelper` dans `--settings`. Équivalent à la transmission de [`--bare`](/fr/headless#start-faster-with-bare-mode) |

278| `CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT` | Définissez sur `1` pour utiliser une invite système plus courte et des descriptions d'outils abrégées sur n'importe quel modèle. Définissez sur `0`, `false`, `no` ou `off` pour refuser même sur les modèles où l'expérience ou la configuration du serveur l'activerait autrement. L'ensemble complet d'outils, les hooks, les serveurs MCP et la découverte CLAUDE.md restent activés |280| `CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT` | Définissez sur `1` pour utiliser une invite système plus courte et des descriptions d'outils abrégées sur n'importe quel modèle. Définissez sur `0`, `false`, `no` ou `off` pour refuser même sur les modèles où l'expérience ou la configuration du serveur l'activerait autrement. L'ensemble complet d'outils, les hooks, les serveurs MCP et la découverte CLAUDE.md restent activés |

279| `CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH` | Ignorer l'authentification côté client pour [Claude Platform on AWS](/fr/claude-platform-on-aws), pour les passerelles qui signent les requêtes elles-mêmes |281| `CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH` | Ignorer l'authentification côté client pour [Claude Platform on AWS](/fr/claude-platform-on-aws), pour les passerelles qui signent les requêtes elles-mêmes |

280| `CLAUDE_CODE_SKIP_BEDROCK_AUTH` | Ignorer l'authentification AWS pour Bedrock (par exemple, lors de l'utilisation d'une passerelle LLM) |282| `CLAUDE_CODE_SKIP_BEDROCK_AUTH` | Ignorer l'authentification AWS pour Amazon Bedrock (par exemple, lors de l'utilisation d'une passerelle LLM) |

281| `CLAUDE_CODE_SKIP_FOUNDRY_AUTH` | Ignorer l'authentification Azure pour Microsoft Foundry. Pour une passerelle, définissez l'identifiant dans `ANTHROPIC_FOUNDRY_API_KEY` à la place ; sans clé API cette variable laisse le client Foundry incapable d'envoyer des requêtes |283| `CLAUDE_CODE_SKIP_FOUNDRY_AUTH` | Ignorer l'authentification Azure pour Microsoft Foundry, pour un proxy ou une passerelle qui injecte son propre en-tête `Authorization`. Claude Code envoie les requêtes sans identifiant Azure et préserve l'en-tête `Authorization` que vous fournissez, par exemple via `ANTHROPIC_CUSTOM_HEADERS`. Ignoré lorsque `ANTHROPIC_FOUNDRY_API_KEY` ou `ANTHROPIC_FOUNDRY_AUTH_TOKEN` est défini. {/* min-version: 2.1.203 */}Avant v2.1.203, cette variable laissait le client Microsoft Foundry incapable d'envoyer des requêtes sauf si une clé API était également définie |

282| `CLAUDE_CODE_SKIP_MANTLE_AUTH` | Ignorer l'authentification AWS pour Bedrock Mantle (par exemple, lors de l'utilisation d'une passerelle LLM) |284| `CLAUDE_CODE_SKIP_MANTLE_AUTH` | Ignorer l'authentification AWS pour Amazon Bedrock Mantle (par exemple, lors de l'utilisation d'une passerelle LLM) |

283| `CLAUDE_CODE_SKIP_PROMPT_HISTORY` | Définissez sur `1` pour ignorer l'écriture de l'historique des invites et des transcriptions de session sur le disque. Les sessions démarrées avec cette variable définie n'apparaissent pas dans `--resume`, `--continue` ou l'historique de la flèche vers le haut. Utile pour les sessions scriptées éphémères |285| `CLAUDE_CODE_SKIP_PROMPT_HISTORY` | Définissez sur `1` pour ignorer l'écriture de l'historique des invites et des transcriptions de session sur le disque. Les sessions démarrées avec cette variable définie n'apparaissent pas dans `--resume`, `--continue` ou l'historique de la flèche vers le haut. Utile pour les sessions scriptées éphémères |

284| `CLAUDE_CODE_SKIP_VERTEX_AUTH` | Ignorer l'authentification Google pour Vertex (par exemple, lors de l'utilisation d'une passerelle LLM) |286| `CLAUDE_CODE_SKIP_VERTEX_AUTH` | Ignorer l'authentification Google pour Google Cloud's Agent Platform (par exemple, lors de l'utilisation d'une passerelle LLM) |

285| `CLAUDE_CODE_STOP_HOOK_BLOCK_CAP` | Nombre maximal de fois consécutives qu'un hook [Stop](/fr/hooks#stop) ou [SubagentStop](/fr/hooks#subagentstop) peut bloquer la fin du tour avant que Claude Code le remplace et termine le tour de toute façon (par défaut : 8). Définissez sur `0` pour désactiver le plafond. Augmentez ceci si votre hook a légitimement besoin de plus d'itérations pour se résoudre |287| `CLAUDE_CODE_STOP_HOOK_BLOCK_CAP` | Nombre maximal de fois consécutives qu'un hook [Stop](/fr/hooks#stop) ou [SubagentStop](/fr/hooks#subagentstop) peut bloquer la fin du tour avant que Claude Code le remplace et termine le tour de toute façon (par défaut : 8). Définissez sur `0` pour désactiver le plafond. Augmentez ceci si votre hook a légitimement besoin de plus d'itérations pour se résoudre |

286| `CLAUDE_CODE_SUBAGENT_MODEL` | Voir [Configuration du modèle](/fr/model-config). {/* min-version: 2.1.196 */}À partir de v2.1.196, la définir sur `inherit` est la même que de la laisser non définie ; les versions antérieures traitaient `inherit` comme un remplacement qui forçait chaque subagent sur le modèle de la conversation principale |288| `CLAUDE_CODE_SUBAGENT_MODEL` | Voir [Configuration du modèle](/fr/model-config). {/* min-version: 2.1.196 */}À partir de v2.1.196, la définir sur `inherit` est la même que de la laisser non définie ; les versions antérieures traitaient `inherit` comme un remplacement qui forçait chaque subagent sur le modèle de la conversation principale |

287| `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` | Définissez sur `1` pour supprimer les identifiants Anthropic et des fournisseurs de cloud des environnements de sous-processus (outil Bash, hooks, serveurs MCP stdio). Le processus Claude parent conserve ces identifiants pour les appels API, mais les processus enfants ne peuvent pas les lire, réduisant l'exposition aux attaques par injection de prompt qui tentent d'exfiltrer les secrets via l'expansion du shell. Sur Linux, cela exécute également les sous-processus Bash dans un espace de noms PID isolé pour qu'ils ne puissent pas lire les environnements de processus hôte via `/proc` ; en conséquence, `ps`, `pgrep` et `kill` ne peuvent pas voir ou signaler les processus hôte. `claude-code-action` définit ceci automatiquement lorsque `allowed_non_write_users` est configuré |289| `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` | Définissez sur `1` pour supprimer les identifiants Anthropic et des fournisseurs de cloud des environnements de sous-processus (outil Bash, hooks, serveurs MCP stdio). Le processus Claude parent conserve ces identifiants pour les appels API, mais les processus enfants ne peuvent pas les lire, réduisant l'exposition aux attaques par injection de prompt qui tentent d'exfiltrer les secrets via l'expansion du shell. Sur Linux, cela exécute également les sous-processus Bash dans un espace de noms PID isolé pour qu'ils ne puissent pas lire les environnements de processus hôte via `/proc` ; en conséquence, `ps`, `pgrep` et `kill` ne peuvent pas voir ou signaler les processus hôte. `claude-code-action` définit ceci automatiquement lorsque `allowed_non_write_users` est configuré |


296| `CLAUDE_CODE_TMPDIR` | Remplacer le répertoire temporaire utilisé pour les fichiers temporaires internes. Claude Code ajoute `/claude-{uid}/` sur Unix ou `/claude/` sur Windows à ce chemin. Par défaut : `/tmp` sur macOS, `os.tmpdir()` sur Linux et Windows. {/* min-version: 2.1.161 */}À partir de v2.1.161, sur macOS et Linux, les sous-processus Bash [sandboxés](/fr/sandboxing) reçoivent un `$TMPDIR` de secours court sous la valeur par défaut du système lorsque votre remplacement est un chemin long, car certains outils échouent lorsque les chemins temporaires deviennent trop longs. Les commandes Bash non sandboxées héritent de votre `$TMPDIR` shell inchangé. Les fichiers temporaires propres de Claude Code utilisent toujours votre remplacement |298| `CLAUDE_CODE_TMPDIR` | Remplacer le répertoire temporaire utilisé pour les fichiers temporaires internes. Claude Code ajoute `/claude-{uid}/` sur Unix ou `/claude/` sur Windows à ce chemin. Par défaut : `/tmp` sur macOS, `os.tmpdir()` sur Linux et Windows. {/* min-version: 2.1.161 */}À partir de v2.1.161, sur macOS et Linux, les sous-processus Bash [sandboxés](/fr/sandboxing) reçoivent un `$TMPDIR` de secours court sous la valeur par défaut du système lorsque votre remplacement est un chemin long, car certains outils échouent lorsque les chemins temporaires deviennent trop longs. Les commandes Bash non sandboxées héritent de votre `$TMPDIR` shell inchangé. Les fichiers temporaires propres de Claude Code utilisent toujours votre remplacement |

297| `CLAUDE_CODE_TMUX_TRUECOLOR` | Définissez sur `1` pour permettre la sortie truecolor 24 bits à l'intérieur de tmux. Par défaut, Claude Code limite à 256 couleurs lorsque `$TMUX` est défini car tmux ne transmet pas les séquences d'échappement truecolor à moins d'être configuré. Définissez ceci après avoir ajouté `set -ga terminal-overrides ',*:Tc'` à votre `~/.tmux.conf`. Voir [Configuration du terminal](/fr/terminal-config) pour d'autres paramètres tmux |299| `CLAUDE_CODE_TMUX_TRUECOLOR` | Définissez sur `1` pour permettre la sortie truecolor 24 bits à l'intérieur de tmux. Par défaut, Claude Code limite à 256 couleurs lorsque `$TMUX` est défini car tmux ne transmet pas les séquences d'échappement truecolor à moins d'être configuré. Définissez ceci après avoir ajouté `set -ga terminal-overrides ',*:Tc'` à votre `~/.tmux.conf`. Voir [Configuration du terminal](/fr/terminal-config) pour d'autres paramètres tmux |

298| `CLAUDE_CODE_USE_ANTHROPIC_AWS` | Utiliser [Claude Platform on AWS](/fr/claude-platform-on-aws) |300| `CLAUDE_CODE_USE_ANTHROPIC_AWS` | Utiliser [Claude Platform on AWS](/fr/claude-platform-on-aws) |

299| `CLAUDE_CODE_USE_BEDROCK` | Utiliser [Bedrock](/fr/amazon-bedrock) |301| `CLAUDE_CODE_USE_BEDROCK` | Utiliser [Amazon Bedrock](/fr/amazon-bedrock) |

300| `CLAUDE_CODE_USE_FOUNDRY` | Utiliser [Microsoft Foundry](/fr/microsoft-foundry) |302| `CLAUDE_CODE_USE_FOUNDRY` | Utiliser [Microsoft Foundry](/fr/microsoft-foundry) |

301| `CLAUDE_CODE_USE_MANTLE` | Utiliser le [point de terminaison Mantle](/fr/amazon-bedrock#use-the-mantle-endpoint) de Bedrock |303| `CLAUDE_CODE_USE_MANTLE` | Utiliser le [point de terminaison Mantle](/fr/amazon-bedrock#use-the-mantle-endpoint) d'Amazon Bedrock |

302| `CLAUDE_CODE_USE_NATIVE_FILE_SEARCH` | Définissez sur `1` pour découvrir les commandes personnalisées, les subagents et les styles de sortie à l'aide des API de fichiers Node.js au lieu de ripgrep. Définissez ceci si le binaire ripgrep fourni est indisponible ou bloqué dans votre environnement. N'affecte pas les outils Grep ou de recherche de fichiers |304| `CLAUDE_CODE_USE_NATIVE_FILE_SEARCH` | Définissez sur `1` pour découvrir les commandes personnalisées, les subagents et les styles de sortie à l'aide des API de fichiers Node.js au lieu de ripgrep. Définissez ceci si le binaire ripgrep fourni est indisponible ou bloqué dans votre environnement. N'affecte pas les outils Grep ou de recherche de fichiers |

303| `CLAUDE_CODE_USE_POWERSHELL_TOOL` | Contrôle l'outil PowerShell. Sur Windows sans Git Bash, l'outil est activé automatiquement ; définissez sur `0` pour le désactiver. Sur Windows avec Git Bash installé, l'outil se déploie progressivement : définissez sur `1` pour participer ou `0` pour refuser. Sur Linux, macOS et WSL, définissez sur `1` pour l'activer, ce qui nécessite `pwsh` sur votre `PATH`. Lorsqu'il est activé sur Windows, Claude peut exécuter les commandes PowerShell en mode natif au lieu de les acheminer via Git Bash. Voir [Outil PowerShell](/fr/tools-reference#powershell-tool) |305| `CLAUDE_CODE_USE_POWERSHELL_TOOL` | Contrôle l'outil PowerShell. Sur Windows sans Git Bash, l'outil est activé automatiquement ; définissez sur `0` pour le désactiver. Sur Windows avec Git Bash installé, l'outil se déploie progressivement : définissez sur `1` pour participer ou `0` pour refuser. Sur Linux, macOS et WSL, définissez sur `1` pour l'activer, ce qui nécessite `pwsh` sur votre `PATH`. Lorsqu'il est activé sur Windows, Claude peut exécuter les commandes PowerShell en mode natif au lieu de les acheminer via Git Bash. Voir [Outil PowerShell](/fr/tools-reference#powershell-tool) |

304| `CLAUDE_CODE_USE_VERTEX` | Utiliser [Vertex](/fr/google-vertex-ai) |306| `CLAUDE_CODE_USE_VERTEX` | Utiliser [Google Cloud's Agent Platform](/fr/google-vertex-ai) |

305| `CLAUDE_CONFIG_DIR` | Remplacer le répertoire de configuration (par défaut : `~/.claude`). Tous les paramètres, identifiants, historique de session et plugins sont stockés sous ce chemin. Utile pour exécuter plusieurs comptes côte à côte : par exemple, `alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'` |307| `CLAUDE_CONFIG_DIR` | Remplacer le répertoire de configuration (par défaut : `~/.claude`). Tous les paramètres, identifiants, historique de session et plugins sont stockés sous ce chemin. Utile pour exécuter plusieurs comptes côte à côte : par exemple, `alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'` |

306| `CLAUDE_DISABLE_ADOPT` | {/* min-version: 2.1.195 */}Définissez sur `1` pour arrêter le travail en arrière-plan en cours au lieu de le transporter lorsque vous mettez une session en arrière-plan en appuyant sur `←` ou avec [`/background`](/fr/agent-view#from-inside-a-session). Claude Code vous demande de confirmer avant la mise en arrière-plan, puis arrête les tâches qui seraient autrement transportées. Nécessite Claude Code v2.1.195 ou ultérieur |308| `CLAUDE_DISABLE_ADOPT` | {/* min-version: 2.1.195 */}Définissez sur `1` pour arrêter le travail en arrière-plan en cours au lieu de le transporter lorsque vous mettez une session en arrière-plan en appuyant sur `←` ou avec [`/background`](/fr/agent-view#from-inside-a-session). Claude Code vous demande de confirmer avant la mise en arrière-plan, puis arrête les tâches qui seraient autrement transportées. Nécessite Claude Code v2.1.195 ou ultérieur |

307| `CLAUDE_EFFORT` | Défini automatiquement dans les sous-processus des outils Bash et les commandes hook au [niveau d'effort](/fr/model-config#adjust-effort-level) actif pour le tour : `low`, `medium`, `high`, `xhigh` ou `max`. Ultracode n'est pas un niveau distinct et rapporte comme `xhigh`. Correspond au champ `effort.level` passé aux [hooks](/fr/hooks). Défini uniquement lorsque le modèle actuel prend en charge le paramètre d'effort |309| `CLAUDE_EFFORT` | Défini automatiquement dans les sous-processus des outils Bash et les commandes hook au [niveau d'effort](/fr/model-config#adjust-effort-level) actif pour le tour : `low`, `medium`, `high`, `xhigh` ou `max`. Ultracode n'est pas un niveau distinct et rapporte comme `xhigh`. Correspond au champ `effort.level` passé aux [hooks](/fr/hooks). Défini uniquement lorsque le modèle actuel prend en charge le paramètre d'effort |

308| `CLAUDE_ENABLE_BYTE_WATCHDOG` | Définissez sur `1` pour forcer l'activation du chien de garde d'inactivité au niveau des octets, ou définissez sur `0` pour forcer la désactivation. Lorsqu'il n'est pas défini, le chien de garde est activé par défaut pour les connexions API Anthropic directes et [Claude Platform on AWS](/fr/claude-platform-on-aws). Le chien de garde d'octets abandonne une connexion lorsqu'aucun octet n'arrive sur le fil pendant 180 secondes par défaut sur les connexions API Anthropic directes, 300 secondes sur Claude Platform on AWS et lorsqu'il est activé sur Bedrock, ou pour la valeur de `CLAUDE_STREAM_IDLE_TIMEOUT_MS` lorsqu'elle est définie, qui est limitée à un minimum de 5 minutes, indépendamment du chien de garde au niveau des événements |310| `CLAUDE_ENABLE_BYTE_WATCHDOG` | Définissez sur `1` pour forcer l'activation du chien de garde d'inactivité au niveau des octets, ou définissez sur `0` pour forcer la désactivation. Lorsqu'il n'est pas défini, le chien de garde est activé par défaut pour les connexions API Anthropic directes et [Claude Platform on AWS](/fr/claude-platform-on-aws). Le chien de garde d'octets abandonne une connexion lorsqu'aucun octet n'arrive sur le fil pendant 180 secondes par défaut sur les connexions API Anthropic directes, 300 secondes sur Claude Platform on AWS et lorsqu'il est activé sur Amazon Bedrock, ou pour la valeur de `CLAUDE_STREAM_IDLE_TIMEOUT_MS` lorsqu'elle est définie, qui est limitée à un minimum de 5 minutes, indépendamment du chien de garde au niveau des événements |

309| `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK` | Définissez sur `1` pour activer le chien de garde d'inactivité de streaming au niveau des octets sur les réponses Amazon Bedrock `vnd.amazon.eventstream`. Désactivé par défaut. Configurez le délai d'expiration avec `CLAUDE_STREAM_IDLE_TIMEOUT_MS` |311| `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK` | Définissez sur `1` pour activer le chien de garde d'inactivité de streaming au niveau des octets sur les réponses Amazon Bedrock `vnd.amazon.eventstream`. Désactivé par défaut. Configurez le délai d'expiration avec `CLAUDE_STREAM_IDLE_TIMEOUT_MS` |

310| `CLAUDE_ENABLE_STREAM_WATCHDOG` | Définissez sur `0` pour forcer-désactiver le chien de garde d'inactivité de streaming au niveau des événements, ou définissez sur `1` pour forcer-activer. {/* min-version: 2.1.196 */}Lorsqu'il n'est pas défini, le chien de garde est activé par défaut pour tous les fournisseurs. Avant v2.1.196, la valeur par défaut non définie était contrôlée par le serveur sur l'API Anthropic directe et désactivée sur les autres fournisseurs. {/* min-version: 2.1.169 */}À partir de v2.1.169, les fournisseurs autres que l'API Anthropic directe et Claude Platform on AWS ont également un délai d'expiration d'inactivité du corps de 5 minutes par défaut indépendant de cette variable ; voir `API_FORCE_IDLE_TIMEOUT`. Sur Bedrock, vous pouvez également activer le chien de garde indépendant au niveau des octets avec `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK` ; les deux s'exécutent ensemble lorsque les deux sont définis. Configurez le délai d'expiration avec `CLAUDE_STREAM_IDLE_TIMEOUT_MS` |312| `CLAUDE_ENABLE_STREAM_WATCHDOG` | Définissez sur `0` pour forcer-désactiver le chien de garde d'inactivité de streaming au niveau des événements, ou définissez sur `1` pour forcer-activer. {/* min-version: 2.1.196 */}Lorsqu'il n'est pas défini, le chien de garde est activé par défaut pour tous les fournisseurs. Avant v2.1.196, la valeur par défaut non définie était contrôlée par le serveur sur l'API Anthropic directe et désactivée sur les autres fournisseurs. {/* min-version: 2.1.169 */}À partir de v2.1.169, les fournisseurs autres que l'API Anthropic directe et Claude Platform on AWS ont également un délai d'expiration d'inactivité du corps de 5 minutes par défaut indépendant de cette variable ; voir `API_FORCE_IDLE_TIMEOUT`. Sur Amazon Bedrock, vous pouvez également activer le chien de garde indépendant au niveau des octets avec `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK` ; les deux s'exécutent ensemble lorsque les deux sont définis. Configurez le délai d'expiration avec `CLAUDE_STREAM_IDLE_TIMEOUT_MS` |

311| `CLAUDE_ENV_FILE` | Chemin d'accès à un script shell dont le contenu Claude Code exécute avant chaque commande Bash dans le même processus shell, de sorte que les exports du fichier sont visibles pour la commande. À utiliser pour persister l'activation de virtualenv ou conda entre les commandes. Également rempli dynamiquement par les hooks [SessionStart](/fr/hooks#persist-environment-variables), [Setup](/fr/hooks#setup), [CwdChanged](/fr/hooks#cwdchanged) et [FileChanged](/fr/hooks#filechanged) |313| `CLAUDE_ENV_FILE` | Chemin d'accès à un script shell dont le contenu Claude Code exécute avant chaque commande Bash dans le même processus shell, de sorte que les exports du fichier sont visibles pour la commande. À utiliser pour persister l'activation de virtualenv ou conda entre les commandes. Également rempli dynamiquement par les hooks [SessionStart](/fr/hooks#persist-environment-variables), [Setup](/fr/hooks#setup), [CwdChanged](/fr/hooks#cwdchanged) et [FileChanged](/fr/hooks#filechanged) |

312| `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` | Préfixe pour les noms de session [Contrôle à distance](/fr/remote-control) générés automatiquement lorsqu'aucun nom explicite n'est fourni. Par défaut, le nom d'hôte de votre machine, produisant des noms comme `myhost-graceful-unicorn`. Le drapeau CLI `--remote-control-session-name-prefix` définit la même valeur pour une seule invocation |314| `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` | Préfixe pour les noms de session [Contrôle à distance](/fr/remote-control) générés automatiquement lorsqu'aucun nom explicite n'est fourni. Par défaut, le nom d'hôte de votre machine, produisant des noms comme `myhost-graceful-unicorn`. Le drapeau CLI `--remote-control-session-name-prefix` définit la même valeur pour une seule invocation |

313| `CLAUDE_STREAM_IDLE_TIMEOUT_MS` | Délai d'expiration en millisecondes avant que le chien de garde d'inactivité de streaming ferme une connexion bloquée. Lorsque vous définissez cette variable explicitement, le minimum est `300000` (5 minutes) ; les valeurs inférieures sont silencieusement limitées pour absorber les pauses de réflexion étendue et la mise en mémoire tampon du proxy. Lorsqu'il n'est pas défini, le chien de garde au niveau des événements par défaut à 300 secondes et le chien de garde au niveau des octets par défaut à 180 secondes sur les connexions API Anthropic directes (300 secondes sur Claude Platform on AWS et les autres fournisseurs). La valeur par défaut non définie de 180 secondes du chien de garde au niveau des octets est une valeur distincte et n'est pas soumise à la limite de 5 minutes. Le délai d'expiration d'inactivité du corps décrit sous `API_FORCE_IDLE_TIMEOUT` s'applique indépendamment. Sur Bedrock, s'applique également lorsque `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1` |315| `CLAUDE_STREAM_IDLE_TIMEOUT_MS` | Délai d'expiration en millisecondes avant que le chien de garde d'inactivité de streaming ferme une connexion bloquée. Lorsque vous définissez cette variable explicitement, le minimum est `300000` (5 minutes) ; les valeurs inférieures sont silencieusement limitées pour absorber les pauses de réflexion étendue et la mise en mémoire tampon du proxy. Lorsqu'il n'est pas défini, le chien de garde au niveau des événements par défaut à 300 secondes et le chien de garde au niveau des octets par défaut à 180 secondes sur les connexions API Anthropic directes (300 secondes sur Claude Platform on AWS et les autres fournisseurs). La valeur par défaut non définie de 180 secondes du chien de garde au niveau des octets est une valeur distincte et n'est pas soumise à la limite de 5 minutes. Le délai d'expiration d'inactivité du corps décrit sous `API_FORCE_IDLE_TIMEOUT` s'applique indépendamment. Sur Amazon Bedrock, s'applique également lorsque `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1` |

314| `DEBUG` | Définissez sur `1` pour activer le mode débogage, équivalent au lancement avec [`--debug`](/fr/cli-reference#cli-flags). Les journaux de débogage sont écrits dans `~/.claude/debug/<session-id>.txt`, ou dans le chemin défini par `CLAUDE_CODE_DEBUG_LOGS_DIR`. Seules les valeurs véridiques `1`, `true`, `yes` et `on` activent le mode débogage, donc les modèles d'espace de noms comme `DEBUG=express:*` définis pour d'autres outils ne le déclenchent pas |316| `DEBUG` | Définissez sur `1` pour activer le mode débogage, équivalent au lancement avec [`--debug`](/fr/cli-reference#cli-flags). Les journaux de débogage sont écrits dans `~/.claude/debug/<session-id>.txt`, ou dans le chemin défini par `CLAUDE_CODE_DEBUG_LOGS_DIR`. Seules les valeurs véridiques `1`, `true`, `yes` et `on` activent le mode débogage, donc les modèles d'espace de noms comme `DEBUG=express:*` définis pour d'autres outils ne le déclenchent pas |

315| `DISABLE_AUTOUPDATER` | Définissez sur `1` pour désactiver les mises à jour automatiques en arrière-plan. La commande manuelle `claude update` fonctionne toujours. Utilisez `DISABLE_UPDATES` pour bloquer les deux |317| `DISABLE_AUTOUPDATER` | Définissez sur `1` pour désactiver les mises à jour automatiques en arrière-plan. La commande manuelle `claude update` fonctionne toujours. Utilisez `DISABLE_UPDATES` pour bloquer les deux |

316| `DISABLE_AUTO_COMPACT` | Définissez sur `1` pour désactiver le compactage automatique lorsque vous approchez de la limite de contexte. La commande manuelle `/compact` reste disponible. À utiliser lorsque vous souhaitez un contrôle explicite sur le moment du compactage |318| `DISABLE_AUTO_COMPACT` | Définissez sur `1` pour désactiver le compactage automatique lorsque vous approchez de la limite de contexte. La commande manuelle `/compact` reste disponible. À utiliser lorsque vous souhaitez un contrôle explicite sur le moment du compactage |

317| `DISABLE_COMPACT` | Définissez sur `1` pour désactiver tout compactage : à la fois le compactage automatique et la commande manuelle `/compact` |319| `DISABLE_COMPACT` | Définissez sur `1` pour désactiver tout compactage : à la fois le compactage automatique et la commande manuelle `/compact` |

318| `DISABLE_COST_WARNINGS` | Définissez sur `1` pour désactiver les messages d'avertissement de coût |320| `DISABLE_COST_WARNINGS` | Définissez sur `1` pour désactiver les messages d'avertissement de coût |

319| `DISABLE_DOCTOR_COMMAND` | Définissez sur `1` pour masquer la commande `/doctor`. Utile pour les déploiements gérés où les utilisateurs ne doivent pas exécuter les diagnostics d'installation |321| `DISABLE_DOCTOR_COMMAND` | Définissez sur `1` pour masquer la commande [`/doctor`](/fr/commands#all-commands) et son alias `/checkup`. Utile pour les déploiements gérés où les utilisateurs ne doivent pas exécuter les diagnostics d'installation à partir d'une session. N'affecte pas la commande du terminal `claude doctor`. {/* min-version: 2.1.205 */}Avant v2.1.205, cette variable masquait l'écran de diagnostics `/doctor` |

320| `DISABLE_ERROR_REPORTING` | Définissez sur `1` pour refuser la création de rapports d'erreurs Sentry |322| `DISABLE_ERROR_REPORTING` | Définissez sur `1` pour refuser la création de rapports d'erreurs Sentry |

321| `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 |323| `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 |

322| `DISABLE_FEEDBACK_COMMAND` | Définissez sur `1` pour désactiver la commande `/feedback`. Le nom plus ancien `DISABLE_BUG_COMMAND` est également accepté |324| `DISABLE_FEEDBACK_COMMAND` | Définissez sur `1` pour désactiver la commande `/feedback`. Le nom plus ancien `DISABLE_BUG_COMMAND` est également accepté |

323| `DISABLE_GROWTHBOOK` | Définissez sur `1` pour désactiver la récupération des drapeaux de fonctionnalités GrowthBook et utiliser les valeurs par défaut du code pour chaque drapeau. La journalisation des événements de télémétrie reste activée sauf si `DISABLE_TELEMETRY` est également défini |325| `DISABLE_GROWTHBOOK` | Définissez sur `1` pour désactiver la récupération des drapeaux de fonctionnalités GrowthBook et utiliser les valeurs par défaut du code pour chaque drapeau. La journalisation des événements de télémétrie reste activée sauf si `DISABLE_TELEMETRY` est également défini |

324| `DISABLE_INSTALLATION_CHECKS` | Définissez sur `1` pour désactiver les avertissements d'installation. À utiliser uniquement lors de la gestion manuelle de l'emplacement d'installation, car cela peut masquer les problèmes avec les installations standard |326| `DISABLE_INSTALLATION_CHECKS` | Définissez sur `1` pour désactiver les avertissements d'installation. À utiliser uniquement lors de la gestion manuelle de l'emplacement d'installation, car cela peut masquer les problèmes avec les installations standard |

325| `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 (Bedrock, Vertex ou Foundry) |327| `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) |

326| `DISABLE_INTERLEAVED_THINKING` | Définissez sur `1` pour empêcher l'envoi de l'en-tête bêta de réflexion entrelacée. Utile lorsque votre passerelle LLM ou fournisseur ne prend pas en charge la [réflexion entrelacée](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#interleaved-thinking) |328| `DISABLE_INTERLEAVED_THINKING` | Définissez sur `1` pour empêcher l'envoi de l'en-tête bêta de réflexion entrelacée. Utile lorsque votre passerelle LLM ou fournisseur ne prend pas en charge la [réflexion entrelacée](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#interleaved-thinking) |

327| `DISABLE_LOGIN_COMMAND` | Définissez sur `1` pour masquer la commande `/login`. Utile lorsque l'authentification est gérée en externe via des clés API ou `apiKeyHelper` |329| `DISABLE_LOGIN_COMMAND` | Définissez sur `1` pour masquer la commande `/login`. Utile lorsque l'authentification est gérée en externe via des clés API ou `apiKeyHelper` |

328| `DISABLE_LOGOUT_COMMAND` | Définissez sur `1` pour masquer la commande `/logout` |330| `DISABLE_LOGOUT_COMMAND` | Définissez sur `1` pour masquer la commande `/logout` |


336| `DISABLE_UPGRADE_COMMAND` | Définissez sur `1` pour masquer la commande `/upgrade` |338| `DISABLE_UPGRADE_COMMAND` | Définissez sur `1` pour masquer la commande `/upgrade` |

337| `DO_NOT_TRACK` | Définissez sur `1` pour refuser la télémétrie. Équivalent à la définition de `DISABLE_TELEMETRY`. Claude Code honore ceci en tant que convention standard inter-outils reconnue par de nombreux CLI de développeurs |339| `DO_NOT_TRACK` | Définissez sur `1` pour refuser la télémétrie. Équivalent à la définition de `DISABLE_TELEMETRY`. Claude Code honore ceci en tant que convention standard inter-outils reconnue par de nombreux CLI de développeurs |

338| `ENABLE_CLAUDEAI_MCP_SERVERS` | Définissez sur `false` pour désactiver les [serveurs MCP claude.ai](/fr/mcp#use-mcp-servers-from-claude-ai) dans Claude Code. Activé par défaut pour les utilisateurs connectés. Pour désactiver par projet ou par organisation, définissez [`disableClaudeAiConnectors`](/fr/settings#available-settings) dans les paramètres à la place |340| `ENABLE_CLAUDEAI_MCP_SERVERS` | Définissez sur `false` pour désactiver les [serveurs MCP claude.ai](/fr/mcp#use-mcp-servers-from-claude-ai) dans Claude Code. Activé par défaut pour les utilisateurs connectés. Pour désactiver par projet ou par organisation, définissez [`disableClaudeAiConnectors`](/fr/settings#available-settings) dans les paramètres à la place |

339| `ENABLE_PROMPT_CACHING_1H` | Définissez sur `1` pour demander une TTL de cache d'invite d'une heure au lieu des 5 minutes par défaut. Destiné aux utilisateurs de clé API, [Bedrock](/fr/amazon-bedrock), [Vertex](/fr/google-vertex-ai), [Foundry](/fr/microsoft-foundry) et [Claude Platform on AWS](/fr/claude-platform-on-aws). Les utilisateurs d'abonnement reçoivent automatiquement une TTL d'une heure. Les écritures de cache d'une heure sont facturées à un taux plus élevé |341| `ENABLE_PROMPT_CACHING_1H` | Définissez sur `1` pour demander une TTL de cache d'invite d'une heure au lieu des 5 minutes par défaut. Destiné aux utilisateurs de clé API, [Amazon Bedrock](/fr/amazon-bedrock), [Google Cloud's Agent Platform](/fr/google-vertex-ai), [Microsoft Foundry](/fr/microsoft-foundry) et [Claude Platform on AWS](/fr/claude-platform-on-aws). Les utilisateurs d'abonnement reçoivent automatiquement une TTL d'une heure. Les écritures de cache d'une heure sont facturées à un taux plus élevé |

340| `ENABLE_PROMPT_CACHING_1H_BEDROCK` | Déprécié. Utilisez `ENABLE_PROMPT_CACHING_1H` à la place |342| `ENABLE_PROMPT_CACHING_1H_BEDROCK` | Déprécié. Utilisez `ENABLE_PROMPT_CACHING_1H` à la place |

341| `ENABLE_TOOL_SEARCH` | Contrôle la [recherche d'outils MCP](/fr/mcp#scale-with-mcp-tool-search). Non défini : tous les outils MCP différés par défaut, mais chargés en amont sur Vertex AI ou lorsque `ANTHROPIC_BASE_URL` pointe vers un hôte non-first-party. Valeurs : `true` (toujours différer et envoyer l'en-tête bêta, les requêtes échouent sur les modèles Vertex AI antérieurs à Sonnet 4.5 ou Opus 4.5, ou sur les proxies qui ne prennent pas en charge `tool_reference`), `auto` (mode seuil : charger en amont si les outils s'ajustent dans 10 % du contexte), `auto:N` (seuil personnalisé, par exemple, `auto:5` pour 5 %), `false` (charger tous en amont) |343| `ENABLE_TOOL_SEARCH` | Contrôle la [recherche d'outils MCP](/fr/mcp#scale-with-mcp-tool-search). Non défini : tous les outils MCP différés par défaut, mais chargés en amont sur Google Cloud's Agent Platform ou lorsque `ANTHROPIC_BASE_URL` pointe vers un hôte non-first-party. Valeurs : `true` (toujours différer et envoyer l'en-tête bêta, les requêtes échouent sur les modèles Google Cloud's Agent Platform antérieurs à Sonnet 4.5 ou Opus 4.5, ou sur les proxies qui ne prennent pas en charge `tool_reference`), `auto` (mode seuil : charger en amont si les outils s'ajustent dans 10 % du contexte), `auto:N` (seuil personnalisé, par exemple, `auto:5` pour 5 %), `false` (charger tous en amont) |

342| `FALLBACK_FOR_ALL_PRIMARY_MODELS` | Définissez sur n'importe quelle valeur non vide pour faire arrêter tous les modèles, pas seulement Opus, de réessayer avec une erreur de surcharge répétée lorsqu'aucun modèle de secours n'est configuré. {/* min-version: 2.1.160 */}À partir de v2.1.160, une [chaîne de modèles de secours](/fr/model-config#fallback-model-chains) configurée se déclenche sur les erreurs de surcharge répétées pour n'importe quel modèle principal, de sorte que cette variable n'affecte pas le basculement vers un modèle de secours |344| `FALLBACK_FOR_ALL_PRIMARY_MODELS` | Définissez sur n'importe quelle valeur non vide pour faire arrêter tous les modèles, pas seulement Opus, de réessayer avec une erreur de surcharge répétée lorsqu'aucun modèle de secours n'est configuré. {/* min-version: 2.1.160 */}À partir de v2.1.160, une [chaîne de modèles de secours](/fr/model-config#fallback-model-chains) configurée se déclenche sur les erreurs de surcharge répétées pour n'importe quel modèle principal, de sorte que cette variable n'affecte pas le basculement vers un modèle de secours |

343| `FORCE_AUTOUPDATE_PLUGINS` | Définissez sur `1` pour forcer les mises à jour automatiques des plugins même lorsque la mise à jour automatique principale est désactivée via `DISABLE_AUTOUPDATER` |345| `FORCE_AUTOUPDATE_PLUGINS` | Définissez sur `1` pour forcer les mises à jour automatiques des plugins même lorsque la mise à jour automatique principale est désactivée via `DISABLE_AUTOUPDATER` |

344| `FORCE_PROMPT_CACHING_5M` | Définissez sur `1` pour forcer la TTL de cache d'invite de 5 minutes même lorsque la TTL d'une heure s'appliquerait autrement. Remplace `ENABLE_PROMPT_CACHING_1H` |346| `FORCE_PROMPT_CACHING_5M` | Définissez sur `1` pour forcer la TTL de cache d'invite de 5 minutes même lorsque la TTL d'une heure s'appliquerait autrement. Remplace `ENABLE_PROMPT_CACHING_1H` |


355| `MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZE` | Nombre maximal de serveurs MCP distants (HTTP/SSE) à connecter en parallèle au démarrage (par défaut : 20) |357| `MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZE` | Nombre maximal de serveurs MCP distants (HTTP/SSE) à connecter en parallèle au démarrage (par défaut : 20) |

356| `MCP_SERVER_CONNECTION_BATCH_SIZE` | Nombre maximal de serveurs MCP locaux (stdio) à connecter en parallèle au démarrage (par défaut : 3) |358| `MCP_SERVER_CONNECTION_BATCH_SIZE` | Nombre maximal de serveurs MCP locaux (stdio) à connecter en parallèle au démarrage (par défaut : 3) |

357| `MCP_TIMEOUT` | Délai d'expiration en millisecondes pour le démarrage du serveur MCP (par défaut : 30 000, ou 30 secondes) |359| `MCP_TIMEOUT` | Délai d'expiration en millisecondes pour le démarrage du serveur MCP (par défaut : 30 000, ou 30 secondes) |

358| `MCP_TOOL_TIMEOUT` | Délai d'expiration en millisecondes pour l'exécution de l'outil MCP (par défaut : 100 000 000, environ 28 heures). Un champ `timeout` par serveur dans `.mcp.json` remplace ceci pour ce serveur. Pour la variable env, les valeurs inférieures à 1 000 sont arrondies à une seconde ; pour le champ par serveur, les valeurs inférieures à 1 000 sont ignorées |360| `MCP_TOOL_TIMEOUT` | Délai d'expiration en millisecondes pour l'exécution de l'outil MCP (par défaut : 100 000 000, environ 28 heures). Un champ `timeout` par serveur dans `.mcp.json` remplace ceci pour ce serveur. {/* min-version: 2.1.203 */}Un `timeout` par serveur d'au moins 1 000 définit également la fenêtre d'inactivité minimale pour les appels d'outils de ce serveur, de sorte que `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` ne les interrompt jamais plus tôt ; cela nécessite Claude Code v2.1.203 ou ultérieur. Pour la variable env, les valeurs inférieures à 1 000 sont arrondies à une seconde ; pour le champ par serveur, les valeurs inférieures à 1 000 sont ignorées |

359| `NO_PROXY` | Liste des domaines et adresses IP vers lesquels les requêtes seront émises directement, en contournant le proxy |361| `NO_PROXY` | Liste des domaines et adresses IP vers lesquels les requêtes seront émises directement, en contournant le proxy |

360| `OTEL_LOG_ASSISTANT_RESPONSES` | {/* min-version: 2.1.193 */}Définissez sur `1` pour inclure le texte de la réponse du modèle sur les événements de journal OpenTelemetry `assistant_response`. Lorsqu'il n'est pas défini, la valeur de `OTEL_LOG_USER_PROMPTS` est utilisée à la place. Définissez sur `0` pour garder les réponses masquées même lorsque `OTEL_LOG_USER_PROMPTS` est défini. Nécessite Claude Code v2.1.193 ou ultérieur. Voir [Surveillance](/fr/monitoring-usage#assistant-response-event) |362| `OTEL_LOG_ASSISTANT_RESPONSES` | {/* min-version: 2.1.193 */}Définissez sur `1` pour inclure le texte de la réponse du modèle sur les événements de journal OpenTelemetry `assistant_response`. Lorsqu'il n'est pas défini, la valeur de `OTEL_LOG_USER_PROMPTS` est utilisée à la place. Définissez sur `0` pour garder les réponses masquées même lorsque `OTEL_LOG_USER_PROMPTS` est défini. Nécessite Claude Code v2.1.193 ou ultérieur. Voir [Surveillance](/fr/monitoring-usage#assistant-response-event) |

361| `OTEL_LOG_RAW_API_BODIES` | Émettre la requête et la réponse JSON complètes de l'API Anthropic Messages en tant qu'événements de journal `api_request_body` / `api_response_body`. Définissez sur `1` pour les corps en ligne tronqués à 60 Ko, ou `file:<dir>` pour écrire les corps non tronqués sur le disque et émettre une référence de chemin `body_ref` à la place. Désactivé par défaut ; les corps incluent l'historique complet de la conversation. Voir [Surveillance](/fr/monitoring-usage#api-request-body-event) |363| `OTEL_LOG_RAW_API_BODIES` | Émettre la requête et la réponse JSON complètes de l'API Anthropic Messages en tant qu'événements de journal `api_request_body` / `api_response_body`. Définissez sur `1` pour les corps en ligne tronqués à 60 Ko, ou `file:<dir>` pour écrire les corps non tronqués sur le disque et émettre une référence de chemin `body_ref` à la place. Désactivé par défaut ; les corps incluent l'historique complet de la conversation. Voir [Surveillance](/fr/monitoring-usage#api-request-body-event) |

362| `OTEL_LOG_TOOL_CONTENT` | Définissez sur `1` pour inclure le contenu d'entrée et de sortie d'outil dans les événements d'intervalle OpenTelemetry. Désactivé par défaut pour protéger les données sensibles. Voir [Surveillance](/fr/monitoring-usage) |364| `OTEL_LOG_TOOL_CONTENT` | Définissez sur `1` pour inclure le contenu d'entrée et de sortie d'outil dans les événements d'intervalle OpenTelemetry. Désactivé par défaut pour protéger les données sensibles. Voir [Surveillance](/fr/monitoring-usage) |

363| `OTEL_LOG_TOOL_DETAILS` | Définissez sur `1` pour inclure les arguments d'entrée d'outil, les noms de serveurs MCP, les chaînes d'erreur brutes en cas d'échec d'outil, la catégorie de refus sur les événements `api_refusal` et d'autres détails d'outils dans les traces et journaux OpenTelemetry. Désactivé par défaut pour protéger les informations personnelles. Voir [Surveillance](/fr/monitoring-usage) |365| `OTEL_LOG_TOOL_DETAILS` | Définissez sur `1` pour inclure les arguments d'entrée d'outil, les noms de serveurs MCP, les noms de workflows créés par l'utilisateur, les chaînes d'erreur brutes en cas d'échec d'outil, la catégorie de refus sur les événements `api_refusal` et d'autres détails d'outils dans les traces et journaux OpenTelemetry. Désactivé par défaut pour protéger les informations personnelles. Voir [Surveillance](/fr/monitoring-usage) |

364| `OTEL_LOG_USER_PROMPTS` | Définissez sur `1` pour inclure le texte de l'invite utilisateur dans les traces et journaux OpenTelemetry. Désactivé par défaut (les invites sont masquées). Voir [Surveillance](/fr/monitoring-usage) |366| `OTEL_LOG_USER_PROMPTS` | Définissez sur `1` pour inclure le texte de l'invite utilisateur dans les traces et journaux OpenTelemetry. Désactivé par défaut (les invites sont masquées). Voir [Surveillance](/fr/monitoring-usage) |

365| `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` | Définissez sur `false` pour exclure l'UUID du compte des attributs de métriques (par défaut : inclus). Voir [Surveillance](/fr/monitoring-usage) |367| `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` | Définissez sur `false` pour exclure l'UUID du compte des attributs de métriques (par défaut : inclus). Voir [Surveillance](/fr/monitoring-usage) |

366| `OTEL_METRICS_INCLUDE_ENTRYPOINT` | {/* min-version: 2.1.152 */}Définissez sur `true` pour inclure le point d'entrée de session dans les attributs de métriques (par défaut : exclu). Ajouté dans v2.1.152. Voir [Surveillance](/fr/monitoring-usage) |368| `OTEL_METRICS_INCLUDE_ENTRYPOINT` | {/* min-version: 2.1.152 */}Définissez sur `true` pour inclure le point d'entrée de session dans les attributs de métriques (par défaut : exclu). Ajouté dans v2.1.152. Voir [Surveillance](/fr/monitoring-usage) |


368| `OTEL_METRICS_INCLUDE_SESSION_ID` | Définissez sur `false` pour exclure l'ID de session des attributs de métriques (par défaut : inclus). Voir [Surveillance](/fr/monitoring-usage) |370| `OTEL_METRICS_INCLUDE_SESSION_ID` | Définissez sur `false` pour exclure l'ID de session des attributs de métriques (par défaut : inclus). Voir [Surveillance](/fr/monitoring-usage) |

369| `OTEL_METRICS_INCLUDE_VERSION` | Définissez sur `true` pour inclure la version de Claude Code dans les attributs de métriques (par défaut : exclu). Voir [Surveillance](/fr/monitoring-usage) |371| `OTEL_METRICS_INCLUDE_VERSION` | Définissez sur `true` pour inclure la version de Claude Code dans les attributs de métriques (par défaut : exclu). Voir [Surveillance](/fr/monitoring-usage) |

370| `SLASH_COMMAND_TOOL_CHAR_BUDGET` | Remplacer le budget de caractères pour les métadonnées de skill affichées à l'[outil Skill](/fr/skills#control-who-invokes-a-skill). Le budget s'adapte dynamiquement à 1 % de la fenêtre de contexte, avec un repli de 8 000 caractères. Nom hérité conservé pour la compatibilité rétroactive |372| `SLASH_COMMAND_TOOL_CHAR_BUDGET` | Remplacer le budget de caractères pour les métadonnées de skill affichées à l'[outil Skill](/fr/skills#control-who-invokes-a-skill). Le budget s'adapte dynamiquement à 1 % de la fenêtre de contexte, avec un repli de 8 000 caractères. Nom hérité conservé pour la compatibilité rétroactive |

371| `TASK_MAX_OUTPUT_LENGTH` | Nombre maximal de caractères dans la sortie du [sub agent](/fr/sub-agents) avant la troncature (par défaut : 32 000, maximum : 160 000). Lorsqu'elle est tronquée, la sortie complète est enregistrée sur le disque et le chemin est inclus dans la réponse tronquée |373| `TASK_MAX_OUTPUT_LENGTH` | Nombre maximal de caractères dans la sortie du [subagent](/fr/sub-agents) avant la troncature (par défaut : 32 000, maximum : 160 000). Lorsqu'elle est tronquée, la sortie complète est enregistrée sur le disque et le chemin est inclus dans la réponse tronquée |

372| `USE_BUILTIN_RIPGREP` | Définissez sur `0` pour utiliser le `rg` installé sur le système au lieu du `rg` inclus avec Claude Code |374| `USE_BUILTIN_RIPGREP` | Définissez sur `0` pour utiliser le `rg` installé sur le système au lieu du `rg` inclus avec Claude Code |

373| `VERTEX_REGION_CLAUDE_3_5_HAIKU` | Remplacer la région pour Claude 3.5 Haiku lors de l'utilisation de Vertex AI |375| `VERTEX_REGION_CLAUDE_3_5_HAIKU` | Remplacer la région pour Claude 3.5 Haiku lors de l'utilisation de Google Cloud's Agent Platform |

374| `VERTEX_REGION_CLAUDE_3_5_SONNET` | Remplacer la région pour Claude 3.5 Sonnet lors de l'utilisation de Vertex AI |376| `VERTEX_REGION_CLAUDE_3_5_SONNET` | Remplacer la région pour Claude 3.5 Sonnet lors de l'utilisation de Google Cloud's Agent Platform |

375| `VERTEX_REGION_CLAUDE_3_7_SONNET` | Remplacer la région pour Claude 3.7 Sonnet lors de l'utilisation de Vertex AI |377| `VERTEX_REGION_CLAUDE_3_7_SONNET` | Remplacer la région pour Claude 3.7 Sonnet lors de l'utilisation de Google Cloud's Agent Platform |

376| `VERTEX_REGION_CLAUDE_4_0_OPUS` | Remplacer la région pour Claude 4.0 Opus lors de l'utilisation de Vertex AI |378| `VERTEX_REGION_CLAUDE_4_0_OPUS` | Remplacer la région pour Claude 4.0 Opus lors de l'utilisation de Google Cloud's Agent Platform |

377| `VERTEX_REGION_CLAUDE_4_0_SONNET` | Remplacer la région pour Claude 4.0 Sonnet lors de l'utilisation de Vertex AI |379| `VERTEX_REGION_CLAUDE_4_0_SONNET` | Remplacer la région pour Claude 4.0 Sonnet lors de l'utilisation de Google Cloud's Agent Platform |

378| `VERTEX_REGION_CLAUDE_4_1_OPUS` | Remplacer la région pour Claude 4.1 Opus lors de l'utilisation de Vertex AI |380| `VERTEX_REGION_CLAUDE_4_1_OPUS` | Remplacer la région pour Claude 4.1 Opus lors de l'utilisation de Google Cloud's Agent Platform |

379| `VERTEX_REGION_CLAUDE_4_5_OPUS` | Remplacer la région pour Claude Opus 4.5 lors de l'utilisation de Vertex AI |381| `VERTEX_REGION_CLAUDE_4_5_OPUS` | Remplacer la région pour Claude Opus 4.5 lors de l'utilisation de Google Cloud's Agent Platform |

380| `VERTEX_REGION_CLAUDE_4_5_SONNET` | Remplacer la région pour Claude Sonnet 4.5 lors de l'utilisation de Vertex AI |382| `VERTEX_REGION_CLAUDE_4_5_SONNET` | Remplacer la région pour Claude Sonnet 4.5 lors de l'utilisation de Google Cloud's Agent Platform |

381| `VERTEX_REGION_CLAUDE_4_6_OPUS` | Remplacer la région pour Claude Opus 4.6 lors de l'utilisation de Vertex AI |383| `VERTEX_REGION_CLAUDE_4_6_OPUS` | Remplacer la région pour Claude Opus 4.6 lors de l'utilisation de Google Cloud's Agent Platform |

382| `VERTEX_REGION_CLAUDE_4_6_SONNET` | Remplacer la région pour Claude Sonnet 4.6 lors de l'utilisation de Vertex AI |384| `VERTEX_REGION_CLAUDE_4_6_SONNET` | Remplacer la région pour Claude Sonnet 4.6 lors de l'utilisation de Google Cloud's Agent Platform |

383| `VERTEX_REGION_CLAUDE_4_7_OPUS` | {/* min-version: 2.1.111 */}Remplacer la région pour Claude Opus 4.7 lors de l'utilisation de Vertex AI. Ajouté dans v2.1.111 |385| `VERTEX_REGION_CLAUDE_4_7_OPUS` | {/* min-version: 2.1.111 */}Remplacer la région pour Claude Opus 4.7 lors de l'utilisation de Google Cloud's Agent Platform. Ajouté dans v2.1.111 |

384| `VERTEX_REGION_CLAUDE_4_8_OPUS` | {/* min-version: 2.1.154 */}Remplacer la région pour Claude Opus 4.8 lors de l'utilisation de Vertex AI. Ajouté dans v2.1.154 |386| `VERTEX_REGION_CLAUDE_4_8_OPUS` | {/* min-version: 2.1.154 */}Remplacer la région pour Claude Opus 4.8 lors de l'utilisation de Google Cloud's Agent Platform. Ajouté dans v2.1.154 |

385| `VERTEX_REGION_CLAUDE_5_SONNET` | {/* min-version: 2.1.197 */}Remplacer la région pour Claude Sonnet 5 lors de l'utilisation de Vertex AI. Ajouté dans v2.1.197 |387| `VERTEX_REGION_CLAUDE_5_SONNET` | {/* min-version: 2.1.197 */}Remplacer la région pour Claude Sonnet 5 lors de l'utilisation de Google Cloud's Agent Platform. Ajouté dans v2.1.197 |

386| `VERTEX_REGION_CLAUDE_FABLE_5` | {/* min-version: 2.1.170 */}Remplacer la région pour Claude Fable 5 lors de l'utilisation de Vertex AI. Ajouté dans v2.1.170 |388| `VERTEX_REGION_CLAUDE_FABLE_5` | {/* min-version: 2.1.170 */}Remplacer la région pour Claude Fable 5 lors de l'utilisation de Google Cloud's Agent Platform. Ajouté dans v2.1.170 |

387| `VERTEX_REGION_CLAUDE_HAIKU_4_5` | Remplacer la région pour Claude Haiku 4.5 lors de l'utilisation de Vertex AI |389| `VERTEX_REGION_CLAUDE_HAIKU_4_5` | Remplacer la région pour Claude Haiku 4.5 lors de l'utilisation de Google Cloud's Agent Platform |

388 390 

389Les variables d'exportateur OpenTelemetry standard (`OTEL_METRICS_EXPORTER`, `OTEL_LOGS_EXPORTER`, `OTEL_EXPORTER_OTLP_ENDPOINT`, `OTEL_EXPORTER_OTLP_PROTOCOL`, `OTEL_EXPORTER_OTLP_HEADERS`, `OTEL_METRIC_EXPORT_INTERVAL`, `OTEL_RESOURCE_ATTRIBUTES` et les variantes spécifiques au signal) sont également prises en charge. Voir [Surveillance](/fr/monitoring-usage) pour les détails de configuration.391Les variables d'exportateur OpenTelemetry standard (`OTEL_METRICS_EXPORTER`, `OTEL_LOGS_EXPORTER`, `OTEL_EXPORTER_OTLP_ENDPOINT`, `OTEL_EXPORTER_OTLP_PROTOCOL`, `OTEL_EXPORTER_OTLP_HEADERS`, `OTEL_METRIC_EXPORT_INTERVAL`, `OTEL_RESOURCE_ATTRIBUTES` et les variantes spécifiques au signal) sont également prises en charge. Voir [Surveillance](/fr/monitoring-usage) pour les détails de configuration.

390 392 

errors.md +453 −245

Details

53| `SSL certificate verification failed` | [Réseau](#ssl-certificate-errors) |53| `SSL certificate verification failed` | [Réseau](#ssl-certificate-errors) |

54| `SSL certificate error (...)` during login or startup | [Réseau](#ssl-certificate-errors) |54| `SSL certificate error (...)` during login or startup | [Réseau](#ssl-certificate-errors) |

55| `403` with `x-deny-reason: host_not_allowed` in a cloud or routine session | [Réseau](#host-not-allowed-in-a-cloud-session) |55| `403` with `x-deny-reason: host_not_allowed` in a cloud or routine session | [Réseau](#host-not-allowed-in-a-cloud-session) |

56| `Couldn't reconnect to your Remote Control session` | [Réseau](#couldn%E2%80%99t-reconnect-to-your-remote-control-session) |

56| `Prompt is too long` | [Erreurs de requête](#prompt-is-too-long) |57| `Prompt is too long` | [Erreurs de requête](#prompt-is-too-long) |

57| `Error during compaction: Conversation too long` | [Erreurs de requête](#error-during-compaction-conversation-too-long) |58| `Error during compaction: Conversation too long` | [Erreurs de requête](#error-during-compaction-conversation-too-long) |

58| `Request too large` | [Erreurs de requête](#request-too-large) |59| `Request too large` | [Erreurs de requête](#request-too-large) |


61| `PDF too large` / `PDF is password protected` | [Erreurs de requête](#pdf-errors) |62| `PDF too large` / `PDF is password protected` | [Erreurs de requête](#pdf-errors) |

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

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

65| `Model ... is not a recognized model id` | [Erreurs de requête](#model-is-not-a-recognized-model-id) |

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

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

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

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

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

69| `Claude Code is unable to respond to this request, which appears to violate our Usage Policy` | [Erreurs de requête](#usage-policy-refusal) |71| `Claude Code is unable to respond to this request, which appears to violate our Usage Policy` | [Erreurs de requête](#usage-policy-refusal) |

72| `<model> has safety measures that flagged this message for a cybersecurity topic` | [Erreurs de requête](#safety-measures-flagged-a-cybersecurity-topic) |

73| `Installation was killed before it could finish (exit code 137)` | [Erreurs d'installation](#installation-was-killed-before-it-could-finish) |

74| `The connection dropped while downloading the update` | [Erreurs d'installation](#the-connection-dropped-while-downloading-the-update) |

75| `Download timed out: exceeded the total deadline` | [Erreurs d'installation](#the-connection-dropped-while-downloading-the-update) |

70| `--bg and --print conflict` | [Erreurs de ligne de commande](#command-line-errors) |76| `--bg and --print conflict` | [Erreurs de ligne de commande](#command-line-errors) |

77| `Error: --json-schema is not a valid JSON Schema` | [Erreurs de ligne de commande](#command-line-errors) |

78| `Could not import <server>: <reason>` | [Erreurs de ligne de commande](#could-not-import-a-server-from-claude-desktop) |

79| `Marketplace "<name>" is registered from an untrusted source` | [Erreurs de plugin](#marketplace-is-registered-from-an-untrusted-source) |

80| `Ignoring N permissions.allow entries from ... this workspace has not been trusted` | [Avertissements de configuration](#workspace-has-not-been-trusted) |

71| Responses seem lower quality than usual | [Qualité des réponses](#responses-seem-lower-quality-than-usual) |81| Responses seem lower quality than usual | [Qualité des réponses](#responses-seem-lower-quality-than-usual) |

72 82 

73<h2 id="automatic-retries">83<h2 id="automatic-retries">


99 Erreurs serveur109 Erreurs serveur

100</h2>110</h2>

101 111 

102Ces erreurs proviennent du fournisseur d'inférence plutôt que de votre compte ou de votre requête. Sur l'API Anthropic, cela signifie l'infrastructure Anthropic. Sur Bedrock, Vertex AI, Foundry ou une passerelle personnalisée, cela signifie l'infrastructure de ce fournisseur.112Ces erreurs proviennent du fournisseur d'inférence plutôt que de votre compte ou de votre demande. Sur l'API Anthropic, cela signifie l'infrastructure Anthropic. Sur Amazon Bedrock, la plateforme Agent de Google Cloud, Microsoft Foundry ou une passerelle personnalisée, cela signifie l'infrastructure de ce fournisseur.

103 113 

104<h3 id="api-error-500-internal-server-error">114<h3 id="api-error-500-internal-server-error">

105 API Error: 500 Internal server error115 Erreur API : 500 Erreur serveur interne

106</h3>116</h3>

107 117 

108Claude Code affiche le code de statut et le message d'erreur de l'API pour toute réponse 5xx. L'exemple ci-dessous montre une réponse 500 sur l'API Anthropic :118Claude Code affiche le code d'état et le message d'erreur de l'API pour toute réponse 5xx. L'exemple ci-dessous montre une réponse 500 sur l'API Anthropic :

109 119 

110```text theme={null}120```text theme={null}

111API Error: 500 Internal server error. This is a server-side issue, usually temporary — try again in a moment. If it persists, check https://status.claude.com.121API Error: 500 Internal server error. This is a server-side issue, usually temporary — try again in a moment. If it persists, check https://status.claude.com.

112```122```

113 123 

114La phrase finale indique où vérifier la santé du service et varie selon le fournisseur. Les configurations Bedrock, Vertex AI et Foundry indiquent le statut du service de ce fournisseur. Une `ANTHROPIC_BASE_URL` personnalisée indique l'hôte de la passerelle.124La phrase finale indique où vérifier l'état du service et varie selon le fournisseur. Les configurations Amazon Bedrock, Google Cloud's Agent Platform et Microsoft Foundry indiquent l'état du service de ce fournisseur. Une `ANTHROPIC_BASE_URL` personnalisée indique l'hôte de la passerelle.

115 125 

116Cela indique une défaillance inattendue à l'intérieur de l'API. Elle n'est pas causée par votre prompt, vos paramètres ou votre compte.126Cela indique une défaillance inattendue à l'intérieur de l'API. Elle n'est pas causée par votre prompt, vos paramètres ou votre compte.

117 127 

118**Que faire :**128**Que faire :**

119 129 

120* Vérifiez [status.claude.com](https://status.claude.com), ou la page de statut du fournisseur nommée dans le message, pour les incidents actifs130* Vérifiez [status.claude.com](https://status.claude.com), ou la page d'état du fournisseur nommée dans le message, pour les incidents actifs

121* Attendez une minute, puis envoyez votre message à nouveau. Votre message original est toujours dans la conversation, donc pour un long prompt vous pouvez taper `try again` au lieu de coller le tout.131* Attendez une minute, puis renvoyez votre message. Votre message original est toujours dans la conversation, donc pour un long prompt vous pouvez taper `try again` au lieu de coller le tout.

122* Si l'erreur persiste sans incident affiché, exécutez `/feedback` pour qu'Anthropic puisse enquêter avec les détails de votre requête. Consultez [Signaler une erreur](#report-an-error) si `/feedback` n'est pas disponible dans votre environnement.132* Si l'erreur persiste sans incident signalé, exécutez `/feedback` pour qu'Anthropic puisse enquêter avec les détails de votre demande. Consultez [Report an error](#report-an-error) si `/feedback` n'est pas disponible dans votre environnement.

123 133 

124<h3 id="api-error-repeated-529-overloaded-errors">134<h3 id="api-error-repeated-529-overloaded-errors">

125 API Error: Repeated 529 Overloaded errors135 Erreur API : Erreurs 529 Overloaded répétées

126</h3>136</h3>

127 137 

128L'API est temporairement à pleine capacité pour tous les utilisateurs. Claude Code a déjà réessayé plusieurs fois avant d'afficher ce message :138L'API est temporairement à capacité pour tous les utilisateurs. Claude Code a déjà réessayé plusieurs fois avant d'afficher ce message :

129 139 

130```text theme={null}140```text theme={null}

131API Error: Repeated 529 Overloaded errors. The API is at capacity — this is usually temporary. Try again in a moment. If it persists, check https://status.claude.com.141API Error: Repeated 529 Overloaded errors. The API is at capacity — this is usually temporary. Try again in a moment. If it persists, check https://status.claude.com.


137 147 

138**Que faire :**148**Que faire :**

139 149 

140* Vérifiez [status.claude.com](https://status.claude.com), ou la page de statut du fournisseur nommée dans le message, pour les avis de capacité150* Vérifiez [status.claude.com](https://status.claude.com), ou la page d'état du fournisseur nommée dans le message, pour les avis de capacité

141* Réessayez dans quelques minutes151* Réessayez dans quelques minutes

142* Exécutez `/model` et basculez vers un modèle différent pour continuer à travailler, car la capacité est suivie par modèle. Claude Code vous invite à le faire lorsqu'un modèle est sous une charge particulièrement élevée, par exemple `Opus is experiencing high load, please use /model to switch to Sonnet`.152* Exécutez `/model` et basculez vers un modèle différent pour continuer à travailler, car la capacité est suivie par modèle. Claude Code vous invite à le faire quand un modèle est sous une charge particulièrement élevée, par exemple `Opus is experiencing high load, please use /model to switch to Sonnet`.

143 153 

144<h3 id="request-timed-out">154<h3 id="request-timed-out">

145 Request timed out155 Délai d'attente de la demande dépassé

146</h3>156</h3>

147 157 

148L'API n'a pas répondu avant la date limite de connexion.158L'API n'a pas répondu avant la limite de connexion.

149 159 

150```text theme={null}160```text theme={null}

151Request timed out161Request timed out

152```162```

153 163 

154Cela peut se produire pendant les périodes de charge élevée ou lorsqu'une très grande réponse est générée. Le délai d'attente par défaut de la requête est de 10 minutes.164Cela peut se produire pendant les périodes de charge élevée ou quand le modèle génère une réponse très volumineuse. Le délai d'attente de demande par défaut est de 10 minutes.

155 165 

156**Que faire :**166**Que faire :**

157 167 

158* Réessayez la requête168* Réessayez la demande

159* Pour les tâches longues, divisez le travail en prompts plus petits169* Pour les tâches longues, divisez le travail en prompts plus petits

160* Si un réseau lent ou un proxy est la cause, augmentez `API_TIMEOUT_MS` comme décrit dans [Tentatives automatiques](#automatic-retries)170* Si un réseau lent ou un proxy en est la cause, augmentez `API_TIMEOUT_MS` comme décrit dans [Automatic retries](#automatic-retries)

161* Si les délais d'attente sont fréquents et que votre réseau est par ailleurs sain, consultez [Erreurs réseau et de connexion](#network-and-connection-errors) ci-dessous171* Si les délais d'attente sont fréquents et votre réseau est par ailleurs sain, consultez [Network and connection errors](#network-and-connection-errors) ci-dessous

162 172 

163<h3 id="the-response-above-may-be-incomplete">173<h3 id="the-response-above-may-be-incomplete">

164 The response above may be incomplete174 La réponse ci-dessus peut être incomplète

165</h3>175</h3>

166 176 

167Une réponse en streaming a échoué après que Claude ait déjà produit une sortie visible. Réenvoyer la requête pourrait exécuter les mêmes appels d'outils deux fois, donc Claude Code conserve ce qui a déjà été diffusé et ajoute cet avis à la place de rejeter le tour. La variante que vous voyez nomme la cause :177Une réponse en streaming a échoué après que Claude ait déjà produit une sortie visible. Le renvoi de la demande pourrait exécuter les mêmes appels d'outils deux fois, donc Claude Code conserve ce qui a déjà été diffusé en streaming et ajoute cet avis à la place de rejeter le tour. La variante que vous voyez indique la cause :

168 178 

169```text theme={null}179```text theme={null}

170API Error: Server error mid-response. The response above may be incomplete.180API Error: Server error mid-response. The response above may be incomplete.


172API Error: Response stalled mid-stream. The response above may be incomplete.182API Error: Response stalled mid-stream. The response above may be incomplete.

173```183```

174 184 

175* {/* min-version: 2.1.199 */}}`Server error mid-response` : une erreur serveur surchargée ou 5xx en milieu de flux. Cette variante nécessite Claude Code v2.1.199 ou ultérieur ; avant cela, ce cas rejetait la sortie partielle et signalait le tour entier comme une erreur.185* {/* min-version: 2.1.199 */}`Server error mid-response` : une erreur serveur surchargée ou 5xx en milieu de flux. Cette variante nécessite Claude Code v2.1.199 ou ultérieur ; avant cela, ce cas rejetait la sortie partielle et signalait le tour entier comme une erreur.

176* `Connection closed mid-response` : la connexion s'est déconnectée.186* `Connection closed mid-response` : la connexion a été interrompue.

177* `Response stalled mid-stream` : le flux a arrêté d'envoyer des données.187* `Response stalled mid-stream` : le flux a cessé d'envoyer des données.

178 188 

179**Que faire :**189**Que faire :**

180 190 

181* Lisez la réponse qui a été diffusée. Rien n'a été perdu, mais les dernières phrases ou appels d'outils peuvent manquer.191* Lisez la réponse qui a été diffusée en streaming. Rien n'a été perdu, mais les dernières phrases ou appels d'outils peuvent manquer.

182* Répondez avec `continue` pour que Claude reprenne là où il s'est arrêté192* Répondez avec `continue` pour que Claude reprenne là où il s'est arrêté

183* Si la même erreur apparaît avant toute sortie visible, Claude Code réessaie la requête au lieu de la finaliser. Consultez [Tentatives automatiques](#automatic-retries).193* Si la même erreur apparaît avant toute sortie visible, Claude Code réessaye la demande au lieu de la finaliser. Consultez [Automatic retries](#automatic-retries).

184 194 

185<h3 id="auto-mode-cannot-determine-the-safety-of-an-action">195<h3 id="auto-mode-cannot-determine-the-safety-of-an-action">

186 Auto mode cannot determine the safety of an action196 Le mode auto ne peut pas déterminer la sécurité d'une action

187</h3>197</h3>

188 198 

189Le modèle que le [mode auto](/fr/permission-modes#eliminate-prompts-with-auto-mode) utilise pour classer les actions n'a pas pu produire une décision, donc le mode auto n'a pas approuvé l'action automatiquement. Le message que vous voyez dépend de la raison pour laquelle le classificateur a échoué.199Le modèle que [le mode auto](/fr/permission-modes#eliminate-prompts-with-auto-mode) utilise pour classer les actions n'a pas pu produire une décision, donc le mode auto n'a pas approuvé l'action automatiquement. Le message que vous voyez dépend de la raison de l'échec du classificateur.

190 200 

191Les lectures, les recherches et les modifications dans votre répertoire de travail ignorent le classificateur, donc elles continuent à fonctionner dans tous ces cas.201Les lectures, recherches et modifications à l'intérieur de votre répertoire de travail ignorent le classificateur, donc elles continuent à fonctionner dans tous ces cas.

192 202 

193Lorsque le modèle classificateur est surchargé :203Quand le modèle classificateur est surchargé :

194 204 

195```text theme={null}205```text theme={null}

196<model> is temporarily unavailable, so auto mode cannot determine the safety of <tool> right now. Wait briefly and then try this action again.206<model> is temporarily unavailable, so auto mode cannot determine the safety of <tool> right now. Wait briefly and then try this action again.


198 208 

199**Que faire :**209**Que faire :**

200 210 

201* Réessayez après quelques secondes ; Claude voit le même message et réessaie généralement automatiquement211* Réessayez après quelques secondes ; Claude voit le même message et réessaye généralement de lui-même

202* Si les tentatives continuent d'échouer, continuez avec les tâches en lecture seule et revenez à l'action bloquée plus tard212* Si les tentatives continuent d'échouer, continuez avec les tâches en lecture seule et revenez à l'action bloquée plus tard

203* C'est transitoire et sans rapport avec l'[admissibilité du mode auto](/fr/permission-modes#eliminate-prompts-with-auto-mode) ; vous n'avez pas besoin de modifier les paramètres213* C'est transitoire et sans rapport avec [l'admissibilité du mode auto](/fr/permission-modes#eliminate-prompts-with-auto-mode) ; vous n'avez pas besoin de modifier les paramètres

204 214 

205Lorsque le classificateur a renvoyé une réponse non analysable :215Quand le classificateur a renvoyé une réponse non analysable :

206 216 

207```text theme={null}217```text theme={null}

208Auto mode could not evaluate this action and is blocking it for safety — run with --debug for details218Auto mode could not evaluate this action and is blocking it for safety — run with --debug for details


213* Réessayez l'action ; cela réussit généralement à la tentative suivante223* Réessayez l'action ; cela réussit généralement à la tentative suivante

214* Exécutez `claude --debug` et répétez l'action pour voir la réponse du classificateur sous-jacente dans le journal de débogage224* Exécutez `claude --debug` et répétez l'action pour voir la réponse du classificateur sous-jacente dans le journal de débogage

215 225 

216Lorsqu'une vérification de sécurité API distincte a bloqué la requête du classificateur en raison du contenu de la conversation antérieure :226Quand une vérification de sécurité API distincte a bloqué la demande du classificateur en raison du contenu de la conversation antérieure :

217 227 

218```text theme={null}228```text theme={null}

219Auto mode could not evaluate this action and is blocking it for safety — a safety check separate from auto mode blocked this request because of earlier conversation content — it isn't about the action itself — run with --debug for details229Auto mode could not evaluate this action and is blocking it for safety — a safety check separate from auto mode blocked this request because of earlier conversation content — it isn't about the action itself — run with --debug for details


221 231 

222**Que faire :**232**Que faire :**

223 233 

224* Ce n'est pas une décision concernant votre action. Le contenu déjà dans votre conversation a déclenché un filtre de sécurité sur l'API lorsque le mode auto a envoyé la conversation au classificateur234* Ce n'est pas une décision concernant votre action. Le contenu déjà dans votre conversation a déclenché un filtre de sécurité sur l'API quand le mode auto a envoyé la conversation au classificateur

225* Réessayer n'aidera pas ; le même contenu de conversation déclenchera à nouveau le filtre235* Le renvoi n'aidera pas ; le même contenu de conversation déclenchera le filtre à nouveau

226* Basculez vers un [mode de permission](/fr/permission-modes) différent pour pouvoir approuver l'action lorsque vous y êtes invité, ou démarrez une nouvelle conversation sans le contenu déclencheur236* Basculez vers un [mode de permission](/fr/permission-modes) différent pour pouvoir approuver l'action quand vous y êtes invité, ou commencez une nouvelle conversation sans le contenu déclencheur

227 237 

228Lorsque la conversation a grandi au-delà de la fenêtre de contexte du classificateur :238Quand la conversation a grandi au-delà de la fenêtre de contexte du classificateur :

229 239 

230```text theme={null}240```text theme={null}

231Auto mode classifier transcript exceeded context window — falling back to manual approval (try /compact to reduce conversation size)241Auto mode classifier transcript exceeded context window — falling back to manual approval (try /compact to reduce conversation size)

232```242```

233 243 

234Dans une session interactive, le mode auto revient à une invite de permission normale pour cette action afin que vous puissiez l'approuver ou la refuser manuellement. En [mode non-interactif](/fr/headless) l'exécution s'arrête car la transcription ne fait que croître et réessayer ne peut pas réussir.244Dans une session interactive, le mode auto revient à une invite de permission normale pour cette action afin que vous puissiez l'approuver ou la refuser manuellement. En [mode non-interactif](/fr/headless), l'exécution s'arrête car la transcription ne fait que croître et le renvoi ne peut pas réussir.

235 245 

236**Que faire :**246**Que faire :**

237 247 

238* Approuvez ou refusez l'action dans l'invite qui apparaît248* Approuvez ou refusez l'action dans l'invite qui apparaît

239* Exécutez `/compact` pour réduire la taille de la conversation afin que les actions suivantes s'ajustent à nouveau dans la fenêtre du classificateur249* Exécutez `/compact` pour réduire la taille de la conversation afin que les actions suivantes s'adaptent à nouveau à la fenêtre du classificateur

240 250 

241<h3 id="agent-terminated-early-due-to-an-api-error">251<h3 id="agent-terminated-early-due-to-an-api-error">

242 Agent terminated early due to an API error252 Agent terminé prématurément en raison d'une erreur API

243</h3>253</h3>

244 254 

245{/* min-version: 2.1.199 */}La requête API d'un [sous-agent](/fr/sub-agents) a échoué de manière terminale, par exemple parce qu'une limite d'utilisation a été atteinte ou que les tentatives pour une erreur serveur se sont épuisées, donc le sous-agent s'est arrêté avant de terminer sa tâche. Ce message nécessite Claude Code v2.1.199 ou ultérieur ; avant cela, le texte d'erreur API était renvoyé à Claude comme s'il s'agissait du résultat du sous-agent.255{/* min-version: 2.1.199 */}La demande API d'un [sous-agent](/fr/sub-agents) a échoué de manière terminale, par exemple parce qu'une limite d'utilisation a été atteinte ou que les tentatives pour une erreur serveur ont épuisé, donc le sous-agent s'est arrêté avant de terminer sa tâche. Ce message nécessite Claude Code v2.1.199 ou ultérieur ; avant cela, le texte d'erreur API était renvoyé à Claude comme s'il s'agissait du résultat du sous-agent.

246 256 

247```text theme={null}257```text theme={null}

248Agent terminated early due to an API error: <error detail>258Agent terminated early due to an API error: <error detail>


250 260 

251**Que faire :**261**Que faire :**

252 262 

253* Faites correspondre le détail de l'erreur après les deux points à sa propre section sur cette page, telle que [Limites d'utilisation](#usage-limits) ou [Erreurs serveur](#server-errors), et suivez les étapes de cette section263* Faites correspondre le détail de l'erreur après les deux points à sa propre section sur cette page, telle que [Usage limits](#usage-limits) ou [Server errors](#server-errors), et suivez les étapes de cette section

254* Une fois que l'erreur sous-jacente est résolue, demandez à Claude de réessayer la tâche ou de [reprendre le sous-agent](/fr/sub-agents#resume-subagents)264* Une fois que l'erreur sous-jacente est résolue, demandez à Claude de réessayer la tâche ou de [reprendre le sous-agent](/fr/sub-agents#resume-subagents)

255 265 

256Lorsqu'une limite de débit, une surcharge ou une erreur serveur interrompt un sous-agent au premier plan qui a déjà produit une sortie, Claude reçoit cette sortie partielle marquée comme incomplète au lieu de cette erreur. Consultez [Erreurs API dans les sous-agents](/fr/sub-agents#api-errors-in-subagents).266Quand une limite de débit, une surcharge ou une erreur serveur interrompt un sous-agent au premier plan qui a déjà produit une sortie textuelle, Claude reçoit cette sortie partielle marquée comme incomplète au lieu de cette erreur. {/* min-version: 2.1.200 */}Un sous-agent dont la seule sortie était des appels d'outils reçoit également cette erreur ; en v2.1.199, cela renvoyait un résultat partiel vide à la place. Consultez [API errors in subagents](/fr/sub-agents#api-errors-in-subagents).

257 267 

258<h2 id="usage-limits">268<h2 id="usage-limits">

259 Limites d'utilisation269 Limites d'utilisation


262Ces erreurs signifient qu'un quota lié à votre compte ou à votre plan a été atteint. Elles sont distinctes des [erreurs serveur](#server-errors), qui affectent tout le monde.272Ces erreurs signifient qu'un quota lié à votre compte ou à votre plan a été atteint. Elles sont distinctes des [erreurs serveur](#server-errors), qui affectent tout le monde.

263 273 

264<h3 id="you’ve-hit-your-session-limit">274<h3 id="you’ve-hit-your-session-limit">

265 You've hit your session limit275 Vous avez atteint votre limite de session

266</h3>276</h3>

267 277 

268Les plans d'abonnement incluent une allocation d'utilisation roulante. Lorsqu'elle s'épuise, vous voyez l'un de ces messages :278Les plans d'abonnement incluent une allocation d'utilisation glissante. Quand elle s'épuise, vous voyez l'un de ces messages :

269 279 

270```text theme={null}280```text theme={null}

271You've hit your session limit · resets 3:45pm281You've hit your session limit · resets 3:45pm


275 285 

276Claude Code bloque les demandes supplémentaires jusqu'à l'heure de réinitialisation indiquée dans le message.286Claude Code bloque les demandes supplémentaires jusqu'à l'heure de réinitialisation indiquée dans le message.

277 287 

278**Que faire :**288**À faire :**

279 289 

280* Attendez l'heure de réinitialisation indiquée dans l'erreur290* Attendez l'heure de réinitialisation indiquée dans l'erreur

281* Exécutez `/usage` pour voir les limites de votre plan et quand elles se réinitialisent291* Exécutez `/usage` pour voir les limites de votre plan et quand elles se réinitialisent

282* Exécutez `/usage-credits` pour acheter une utilisation supplémentaire sur Pro et Max, ou pour la demander à votre administrateur sur Team et Enterprise. Consultez [usage credits for paid plans](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) pour savoir comment cela est facturé.292* Exécutez `/usage-credits` pour acheter une utilisation supplémentaire sur Pro et Max, ou pour la demander à votre administrateur sur Team et Enterprise. Consultez [usage credits for paid plans](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) pour savoir comment cela est facturé.

283* Pour mettre à niveau votre plan pour des limites de base plus élevées, consultez [claude.com/pricing](https://claude.com/pricing)293* Pour mettre à niveau votre plan vers des limites de base plus élevées, consultez [claude.com/pricing](https://claude.com/pricing)

284 294 

285Pour surveiller votre allocation restante avant d'atteindre la limite, ajoutez les champs `rate_limits` à une [ligne d'état personnalisée](/fr/statusline#rate-limit-usage), ou dans l'application Desktop cliquez sur l'[anneau d'utilisation](/fr/desktop#check-usage) à côté du sélecteur de modèle.295Pour surveiller votre allocation restante avant d'atteindre la limite, ajoutez les champs `rate_limits` à une [ligne d'état personnalisée](/fr/statusline#rate-limit-usage), ou dans l'application Desktop, cliquez sur l'[anneau d'utilisation](/fr/desktop#check-usage) à côté du sélecteur de modèle.

286 296 

287<h3 id="usage-credits-required-for-1m-context">297<h3 id="usage-credits-required-for-1m-context">

288 Usage credits required for 1M context298 Crédits d'utilisation requis pour le contexte 1M

289</h3>299</h3>

290 300 

291Le modèle sélectionné utilise la fenêtre de contexte étendue 1M-token, et votre plan ne l'inclut que par le biais de crédits d'utilisation.301Le modèle sélectionné utilise la fenêtre de contexte étendue 1M-token, et votre plan ne l'inclut que par le biais de crédits d'utilisation.


294API Error: Usage credits required for 1M context · run /usage-credits to turn them on, or /model to switch to standard context304API Error: Usage credits required for 1M context · run /usage-credits to turn them on, or /model to switch to standard context

295```305```

296 306 

297Il s'agit d'une vérification de droit, et non d'un épuisement de quota. Elle se déclenche même lorsque vos allocations de session et hebdomadaires ont une capacité restante. Consultez [Extended context](/fr/model-config#extended-context) pour savoir quels plans incluent directement le contexte 1M et lesquels nécessitent des crédits d'utilisation.307Il s'agit d'une vérification de droit, et non d'un épuisement de quota. Elle se déclenche même quand vos allocations de session et hebdomadaires ont de la capacité restante. Consultez [Extended context](/fr/model-config#extended-context) pour voir quels plans incluent directement le contexte 1M et lesquels nécessitent des crédits d'utilisation.

298 308 

299{/* min-version: 2.1.172 */}Lorsque cette erreur apparaît en milieu de conversation parce que le contexte a dépassé 200 K tokens, Claude Code compacte automatiquement la conversation en dessous de la limite de contexte standard et maintient la session à cette limite par la suite, donc aucune action n'est nécessaire. Sur les versions antérieures à v2.1.172, l'erreur s'est répétée à chaque demande ultérieure, y compris `/compact` ; exécutez `/clear` sur ces versions pour récupérer. Les étapes ci-dessous s'appliquent lorsque vous avez explicitement sélectionné un modèle `[1m]`.309{/* min-version: 2.1.172 */}Quand cette erreur apparaît au milieu d'une conversation parce que le contexte a dépassé 200K tokens, Claude Code compacte automatiquement la conversation en dessous de la limite de contexte standard et maintient la session à cette limite par la suite, donc aucune action n'est nécessaire. Sur les versions antérieures à v2.1.172, l'erreur s'est répétée à chaque demande ultérieure, y compris `/compact` ; exécutez `/clear` sur ces versions pour récupérer. Les étapes ci-dessous s'appliquent quand vous avez explicitement sélectionné un modèle `[1m]`.

300 310 

301**Que faire :**311**À faire :**

302 312 

303* Exécutez `/model` et sélectionnez la variante sans le suffixe `[1m]` pour revenir à la fenêtre de contexte standard313* Exécutez `/model` et sélectionnez la variante sans le suffixe `[1m]` pour revenir à la fenêtre de contexte standard

304* Exécutez `/usage-credits` pour activer la facturation au compteur pour la variante 1M sur Pro et Max, ou pour la demander à votre administrateur sur Team et Enterprise314* Exécutez `/usage-credits` pour activer la facturation mesurée pour la variante 1M sur Pro et Max, ou pour la demander à votre administrateur sur Team et Enterprise

305* Si l'erreur persiste après `/model`, un ID de modèle 1M peut être défini ailleurs. Consultez [There's an issue with the selected model](#there%E2%80%99s-an-issue-with-the-selected-model) pour les emplacements de configuration à vérifier par ordre de priorité.315* Si l'erreur persiste après `/model`, un ID de modèle 1M peut être défini ailleurs. Consultez [There's an issue with the selected model](#there%E2%80%99s-an-issue-with-the-selected-model) pour les emplacements de configuration à vérifier par ordre de priorité.

306* Pour supprimer entièrement les variantes 1M du sélecteur de modèle, définissez [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/fr/env-vars)316* Pour supprimer entièrement les variantes 1M du sélecteur de modèle, définissez [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/fr/env-vars)

307 317 

308<h3 id="server-is-temporarily-limiting-requests">318<h3 id="server-is-temporarily-limiting-requests">

309 Server is temporarily limiting requests319 Le serveur limite temporairement les demandes

310</h3>320</h3>

311 321 

312L'API a appliqué un accélérateur de courte durée qui n'est pas lié à votre quota de plan.322L'API a appliqué un throttle de courte durée qui n'est pas lié à votre quota de plan.

313 323 

314```text theme={null}324```text theme={null}

315API Error: Server is temporarily limiting requests (not your usage limit)325API Error: Server is temporarily limiting requests (not your usage limit)

316```326```

317 327 

318Claude Code distingue ceux-ci de votre limite de plan par l'absence des en-têtes de quota unifiés qu'une réponse de limite réelle porte. {/* min-version: 2.1.199 */}À partir de la v2.1.199, ceci est [réessayé automatiquement](#automatic-retries) avec backoff avant d'être affiché, quelle que soit la façon dont vous vous authentifiez. Sur les versions antérieures, une session connectée avec un abonnement claude.ai a échoué le tour à la première occurrence ; seules les connexions par clé API et Enterprise l'ont réessayé.328Claude Code les distingue de votre limite de plan par l'absence des en-têtes de quota unifiés qu'une réponse de limite réelle porte. {/* min-version: 2.1.199 */}À partir de v2.1.199, ceci est [réessayé automatiquement](#automatic-retries) avec backoff avant d'être affiché, quelle que soit votre méthode d'authentification. Sur les versions antérieures, une session connectée avec un abonnement claude.ai a échoué le tour à la première occurrence ; seules les authentifications par clé API et Enterprise l'ont réessayé.

319 329 

320**Que faire :**330**À faire :**

321 331 

322* Attendez brièvement et réessayez332* Attendez brièvement et réessayez

323* Vérifiez [status.claude.com](https://status.claude.com) si cela persiste333* Vérifiez [status.claude.com](https://status.claude.com) si cela persiste

324 334 

325<h3 id="request-rejected-429">335<h3 id="request-rejected-429">

326 Request rejected (429)336 Demande rejetée (429)

327</h3>337</h3>

328 338 

329Vous avez atteint la limite de débit configurée pour votre clé API, votre projet Amazon Bedrock ou votre projet Google Vertex AI.339Vous avez atteint la limite de débit configurée pour votre clé API, votre projet Amazon Bedrock ou votre projet Google Cloud.

330 340 

331```text theme={null}341```text theme={null}

332API Error: Request rejected (429) · this may be a temporary capacity issue. If it persists, check https://status.claude.com.342API Error: Request rejected (429) · this may be a temporary capacity issue. If it persists, check https://status.claude.com.

333```343```

334 344 

335La phrase de fin indique où vérifier l'état du service et varie selon le fournisseur. Les configurations Bedrock, Vertex AI et Foundry indiquent plutôt la page d'état du service de ce fournisseur au lieu de la page d'état Anthropic. Une `ANTHROPIC_BASE_URL` personnalisée indique l'hôte de la passerelle.345La phrase de fin indique où vérifier la santé du service et varie selon le fournisseur. Les configurations Amazon Bedrock, Google Cloud's Agent Platform et Microsoft Foundry nomment la page d'état du service de ce fournisseur au lieu de la page d'état Anthropic. Une `ANTHROPIC_BASE_URL` personnalisée nomme l'hôte de la passerelle.

336 346 

337**Que faire :**347**À faire :**

338 348 

339* Exécutez `/status` et confirmez que les identifiants actifs sont ceux que vous attendez. Une `ANTHROPIC_API_KEY` égarée dans votre environnement peut acheminer les requêtes via une clé de niveau inférieur au lieu de votre abonnement.349* Exécutez `/status` et confirmez que les identifiants actifs sont ceux que vous attendez. Une `ANTHROPIC_API_KEY` égarée dans votre environnement peut acheminer les demandes via une clé de niveau inférieur au lieu de votre abonnement.

340* Vérifiez la console de votre fournisseur pour les limites actives et demandez un niveau supérieur si nécessaire350* Vérifiez votre console de fournisseur pour les limites actives et demandez un niveau supérieur si nécessaire

341* Pour les clés API Anthropic, consultez la [référence des limites de débit](https://platform.claude.com/docs/en/api/rate-limits) pour savoir comment fonctionnent les niveaux et comment définir des plafonds par espace de travail351* Pour les clés API Anthropic, consultez la [référence des limites de débit](https://platform.claude.com/docs/en/api/rate-limits) pour savoir comment fonctionnent les niveaux et comment définir des plafonds par espace de travail

342* Réduisez la concurrence : réduisez [`CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY`](/fr/env-vars), évitez d'exécuter de nombreux sous-agents parallèles, ou basculez vers un modèle plus petit avec `/model` pour les exécutions scriptées à haut volume352* Réduisez la concurrence : abaissez [`CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY`](/fr/env-vars), évitez d'exécuter de nombreux sous-agents parallèles, ou passez à un modèle plus petit avec `/model` pour les exécutions scriptées à haut volume

343 353 

344<h3 id="credit-balance-is-too-low">354<h3 id="credit-balance-is-too-low">

345 Credit balance is too low355 Le solde de crédit est trop faible

346</h3>356</h3>

347 357 

348Votre organisation Console a épuisé ses crédits prépayés.358Votre organisation Console a épuisé ses crédits prépayés.


351Credit balance is too low361Credit balance is too low

352```362```

353 363 

354**Que faire :**364**À faire :**

355 365 

356* Ajoutez des crédits sur [platform.claude.com/settings/billing](https://platform.claude.com/settings/billing), et envisagez d'activer le rechargement automatique pour que le solde se remplisse avant d'atteindre zéro366* Ajoutez des crédits sur [platform.claude.com/settings/billing](https://platform.claude.com/settings/billing), et envisagez d'activer le rechargement automatique pour que le solde se reconstitue avant d'atteindre zéro

357* Basculez vers l'authentification par abonnement avec `/login` si vous avez un plan Pro, Max, Team ou Enterprise367* Passez à l'authentification par abonnement avec `/login` si vous avez un plan Pro, Max, Team ou Enterprise

358* Définissez des plafonds de dépenses par espace de travail dans la Console pour empêcher un seul projet de drainer le solde de l'organisation. Consultez [Gérer les coûts efficacement](/fr/costs).368* Définissez des plafonds de dépenses par espace de travail dans la Console pour empêcher un seul projet de drainer le solde de l'organisation. Consultez [Manage costs effectively](/fr/costs).

359 369 

360<h2 id="authentication-errors">370<h2 id="authentication-errors">

361 Erreurs d'authentification371 Erreurs d'authentification

362</h2>372</h2>

363 373 

364Ces erreurs signifient que Claude Code ne peut pas prouver qui vous êtes à l'API. Exécutez `/status` à tout moment pour voir quel identifiant est actuellement actif.374Ces erreurs signifient que Claude Code ne peut pas prouver votre identité à l'API. Exécutez `/status` à tout moment pour voir quelle credential est actuellement active.

365 375 

366<h3 id="not-logged-in">376<h3 id="not-logged-in">

367 Not logged in377 Non connecté

368</h3>378</h3>

369 379 

370Aucun identifiant valide n'est disponible pour cette session.380Aucune credential valide n'est disponible pour cette session.

371 381 

372```text theme={null}382```text theme={null}

373Not logged in · Please run /login383Not logged in · Please run /login

374```384```

375 385 

376**Que faire :**386**À faire :**

377 387 

378* Exécutez `/login` pour vous authentifier avec votre abonnement Claude ou votre compte Console388* Exécutez `/login` pour vous authentifier avec votre abonnement Claude ou votre compte Console

379* Si vous vous attendiez à ce qu'une variable d'environnement vous authentifie, confirmez que `ANTHROPIC_API_KEY` est définie et exportée dans le shell où vous avez lancé `claude`389* Si vous vous attendiez à ce qu'une variable d'environnement vous authentifie, confirmez que `ANTHROPIC_API_KEY` est définie et exportée dans le shell où vous avez lancé `claude`

380* Pour l'intégration continue ou l'automatisation où la connexion interactive n'est pas possible, configurez un script [`apiKeyHelper`](/fr/settings#available-settings) qui récupère une clé au démarrage390* Pour l'intégration continue ou l'automatisation où la connexion interactive n'est pas possible, configurez un script [`apiKeyHelper`](/fr/settings#available-settings) qui récupère une clé au démarrage

381* Consultez [Précédence d'authentification](/fr/authentication#authentication-precedence) pour comprendre quel identifiant gagne lorsque plusieurs sont présents391* Consultez [Précédence d'authentification](/fr/authentication#authentication-precedence) pour comprendre quelle credential Claude Code utilise quand plusieurs sont présentes

382 392 

383Si vous êtes invité à vous connecter à plusieurs reprises, consultez [Not logged in or token expired](/fr/troubleshoot-install#not-logged-in-or-token-expired) pour les corrections d'horloge système et de Keychain macOS.393Si vous êtes invité à vous connecter à plusieurs reprises, consultez [Non connecté ou token expiré](/fr/troubleshoot-install#not-logged-in-or-token-expired) pour les corrections d'horloge système et de Keychain macOS.

384 394 

385<h3 id="could-not-resolve-authentication-method">395<h3 id="could-not-resolve-authentication-method">

386 Could not resolve authentication method396 Impossible de résoudre la méthode d'authentification

387</h3>397</h3>

388 398 

389La session a atteint le client API sans aucun identifiant. Cela apparaît dans les [sessions en arrière-plan](/fr/agent-view), les sessions cloud et les contextes du SDK Agent où la vérification de connexion interactive ne s'exécute pas avant la première requête.399La session a atteint le client API sans aucune credential. Cela apparaît dans les [sessions en arrière-plan](/fr/agent-view), les sessions cloud et les contextes Agent SDK où la vérification de connexion interactive ne s'exécute pas avant la première requête.

390 400 

391```text theme={null}401```text theme={null}

392Could not resolve authentication method. Expected one of apiKey, authToken, credentials, config, or profile to be set. Or for one of the "X-Api-Key" or "Authorization" headers to be explicitly omitted402Could not resolve authentication method. Expected one of apiKey, authToken, credentials, config, or profile to be set. Or for one of the "X-Api-Key" or "Authorization" headers to be explicitly omitted

393```403```

394 404 

395{/* min-version: 2.1.174 */}Avant la v2.1.174, une session en arrière-plan ou cloud assignée à un worker pré-initialisé inactif pouvait échouer de cette façon même lorsque des identifiants valides étaient configurés. Mettez à niveau pour récupérer. Sur les versions actuelles, l'erreur signifie qu'aucun identifiant n'était disponible pour le processus worker.405{/* min-version: 2.1.174 */}Avant la v2.1.174, une session en arrière-plan ou cloud assignée à un worker pré-initialisé inactif pouvait échouer de cette façon même quand des credentials valides étaient configurées. Mettez à jour pour récupérer. Sur les versions actuelles, l'erreur signifie qu'aucune credential n'était disponible pour le processus worker.

396 406 

397**Que faire :**407**À faire :**

398 408 

399* Mettez à niveau vers la v2.1.174 ou ultérieure si cela apparaît dans une session en arrière-plan ou cloud et que vos identifiants sont déjà configurés409* Mettez à jour vers la v2.1.174 ou ultérieure si cela apparaît dans une session en arrière-plan ou cloud et que vos credentials sont déjà configurées

400* Confirmez que `ANTHROPIC_API_KEY`, `CLAUDE_CODE_OAUTH_TOKEN` ou vos identifiants de fournisseur cloud sont définis dans l'environnement qui lance le worker, pas seulement dans votre shell interactif410* Confirmez que `ANTHROPIC_API_KEY`, `CLAUDE_CODE_OAUTH_TOKEN` ou vos credentials du fournisseur cloud sont définis dans l'environnement qui lance le worker, pas seulement dans votre shell interactif

401* Pour le SDK Agent, consultez [configuration de l'authentification](/fr/agent-sdk/overview#get-started)411* Pour l'Agent SDK, consultez [configuration de l'authentification](/fr/agent-sdk/overview#get-started)

402* Exécutez `/status` dans une session interactive dans le même environnement pour confirmer quelle source d'identifiant se résout412* Exécutez `/status` dans une session interactive dans le même environnement pour confirmer quelle source de credential se résout

403 413 

404<h3 id="invalid-api-key">414<h3 id="invalid-api-key">

405 Invalid API key415 Clé API invalide

406</h3>416</h3>

407 417 

408La variable d'environnement `ANTHROPIC_API_KEY` ou le script `apiKeyHelper` a renvoyé une clé que l'API a rejetée.418La variable d'environnement `ANTHROPIC_API_KEY` ou le script `apiKeyHelper` a retourné une clé que l'API a rejetée.

409 419 

410```text theme={null}420```text theme={null}

411Invalid API key · Fix external API key421Invalid API key · Fix external API key

412```422```

413 423 

414**Que faire :**424**À faire :**

415 425 

416* Vérifiez les fautes de frappe et confirmez que la clé n'a pas été révoquée dans la [Console](https://platform.claude.com/settings/keys)426* Vérifiez les fautes de frappe et confirmez que la clé n'a pas été révoquée dans la [Console](https://platform.claude.com/settings/keys)

417* Exécutez `env | grep ANTHROPIC` dans le même shell. Des outils comme direnv, les plugins shell dotenv et les terminaux IDE peuvent charger une clé obsolète à partir d'un fichier `.env` dans votre projet sans que vous la définissiez explicitement.427* Exécutez `env | grep ANTHROPIC` dans le même shell. Des outils comme direnv, les plugins shell dotenv et les terminaux IDE peuvent charger une clé obsolète à partir d'un fichier `.env` dans votre projet sans que vous la définissiez explicitement.

418* Déconfigurez `ANTHROPIC_API_KEY` et exécutez `/login` pour utiliser l'authentification par abonnement à la place428* Déconfigurez `ANTHROPIC_API_KEY` et exécutez `/login` pour utiliser l'authentification par abonnement à la place

419* Si la clé provient d'un script [`apiKeyHelper`](/fr/settings#available-settings), exécutez le script directement pour confirmer qu'il imprime une clé valide sur stdout429* Si la clé provient d'un script [`apiKeyHelper`](/fr/settings#available-settings), exécutez le script directement pour confirmer qu'il imprime une clé valide sur stdout

420* Exécutez `/status` pour confirmer quelle source d'identifiant Claude Code utilise réellement430* Exécutez `/status` pour confirmer quelle source de credential Claude Code utilise réellement

421 431 

422<h3 id="this-organization-has-been-disabled">432<h3 id="this-organization-has-been-disabled">

423 This organization has been disabled433 Cette organisation a été désactivée

424</h3>434</h3>

425 435 

426Une `ANTHROPIC_API_KEY` obsolète d'une organisation Console désactivée remplace votre connexion par abonnement.436Une `ANTHROPIC_API_KEY` obsolète d'une organisation Console désactivée remplace votre connexion par abonnement.


430API Error: 400 ... This organization has been disabled.440API Error: 400 ... This organization has been disabled.

431```441```

432 442 

433Les variables d'environnement ont la priorité sur `/login`, donc une clé exportée dans votre profil shell ou chargée à partir d'un fichier `.env` est utilisée même lorsque vous avez un abonnement Pro ou Max fonctionnant. En mode non interactif (`-p`), la clé est toujours utilisée lorsqu'elle est présente.443Les variables d'environnement ont la priorité sur `/login`, donc une clé exportée dans votre profil shell ou chargée à partir d'un fichier `.env` est utilisée même quand vous avez un abonnement Pro ou Max fonctionnant. En mode non-interactif (`-p`), la clé est toujours utilisée quand elle est présente.

434 444 

435**Que faire :**445**À faire :**

436 446 

437* Déconfigurez `ANTHROPIC_API_KEY` dans le shell actuel et supprimez-le de votre profil shell, puis relancez `claude`447* Déconfigurez `ANTHROPIC_API_KEY` dans le shell actuel et supprimez-la de votre profil shell, puis relancez `claude`

438* Exécutez `/status` après pour confirmer que l'identifiant actif est votre abonnement448* Exécutez `/status` après pour confirmer que la credential active est votre abonnement

439* Si aucune variable d'environnement n'est définie et que l'erreur persiste, l'organisation désactivée est celle liée à votre `/login`. Contactez le support ou connectez-vous avec un compte différent.449* Si aucune variable d'environnement n'est définie et que l'erreur persiste, l'organisation désactivée est celle liée à votre `/login`. Contactez le support ou connectez-vous avec un compte différent.

440 450 

441<h3 id="your-organization-has-disabled-api-key-authentication">451<h3 id="your-organization-has-disabled-api-key-authentication">

442 Your organization has disabled API key authentication452 Votre organisation a désactivé l'authentification par clé API

443</h3>453</h3>

444 454 

445Ce message nécessite Claude Code v2.1.169 ou ultérieur. L'administrateur de votre organisation Console a désactivé l'authentification par clé API, donc l'API rejette la clé que Claude Code envoie. L'indice de récupération après le `·` varie selon d'où provient la clé :455Ce message nécessite Claude Code v2.1.169 ou ultérieur. L'administrateur de votre organisation Console a désactivé l'authentification par clé API, donc l'API rejette la clé que Claude Code envoie. L'indice de récupération après le `·` varie selon d'où provient la clé :


453 463 

454Les variables d'environnement et `apiKeyHelper` ont la priorité sur `/login`, donc exécuter `/login` seul n'aide pas tant que l'un ou l'autre fournit toujours une clé. Consultez [Précédence d'authentification](/fr/authentication#authentication-precedence).464Les variables d'environnement et `apiKeyHelper` ont la priorité sur `/login`, donc exécuter `/login` seul n'aide pas tant que l'un ou l'autre fournit toujours une clé. Consultez [Précédence d'authentification](/fr/authentication#authentication-precedence).

455 465 

456**Que faire :**466**À faire :**

457 467 

458* Si le message nomme `ANTHROPIC_API_KEY`, déconfigurez-le dans le shell actuel et supprimez-le de votre profil shell ou du fichier `.env`, puis relancez `claude`468* Si le message nomme `ANTHROPIC_API_KEY`, déconfigurez-la dans le shell actuel et supprimez-la de votre profil shell ou fichier `.env`, puis relancez `claude`

459* Si le message nomme `apiKeyHelper`, supprimez le paramètre [`apiKeyHelper`](/fr/settings#available-settings) de votre `settings.json`469* Si le message nomme `apiKeyHelper`, supprimez le paramètre [`apiKeyHelper`](/fr/settings#available-settings) de votre `settings.json`

460* Exécutez `/login` pour vous connecter avec votre compte claude.ai470* Exécutez `/login` pour vous connecter avec votre compte claude.ai

461* Exécutez `/status` après pour confirmer que l'identifiant actif est votre abonnement plutôt qu'une clé API471* Exécutez `/status` après pour confirmer que la credential active est votre abonnement plutôt qu'une clé API

462* Si vous avez besoin de l'authentification par clé API pour l'automatisation, demandez à votre administrateur d'organisation de la réactiver dans la Console472* Si vous avez besoin de l'authentification par clé API pour l'automatisation, demandez à votre administrateur d'organisation de la réactiver dans la Console

463 473 

464<h3 id="your-organization-has-disabled-claude-subscription-access">474<h3 id="your-organization-has-disabled-claude-subscription-access">

465 Your organization has disabled Claude subscription access475 Votre organisation a désactivé l'accès à l'abonnement Claude

466</h3>476</h3>

467 477 

468Votre organisation Claude ne permet pas de se connecter à Claude Code avec une connexion par abonnement. Exécuter `/login` à nouveau avec le même compte retourne la même erreur.478Votre organisation Claude ne permet pas de se connecter à Claude Code avec une connexion par abonnement. Exécuter `/login` à nouveau avec le même compte retourne la même erreur.


471Your organization has disabled Claude subscription access for Claude Code · Use an Anthropic API key instead, or ask your admin to enable access481Your organization has disabled Claude subscription access for Claude Code · Use an Anthropic API key instead, or ask your admin to enable access

472```482```

473 483 

474C'est un paramètre d'organisation côté serveur, il ne peut donc pas être remplacé par les paramètres locaux, les variables d'environnement ou les drapeaux CLI.484C'est un paramètre d'organisation côté serveur, donc il ne peut pas être remplacé à partir des paramètres locaux, des variables d'environnement ou des drapeaux CLI.

475 485 

476Le SDK Agent et le mode non interactif `-p` affichent cela comme le code d'erreur `oauth_org_not_allowed`.486L'Agent SDK et le mode non-interactif `-p` présentent cela comme le code d'erreur `oauth_org_not_allowed`.

477 487 

478**Que faire :**488**À faire :**

479 489 

480* Demandez à votre administrateur d'activer l'accès à Claude Code pour votre organisation490* Demandez à votre administrateur d'activer l'accès à Claude Code pour votre organisation

481* Authentifiez-vous avec une clé API Console au lieu de votre abonnement. Consultez [Authentification Claude Console](/fr/authentication#claude-console-authentication) pour la configuration.491* Authentifiez-vous avec une clé API Console au lieu de votre abonnement. Consultez [Authentification Claude Console](/fr/authentication#claude-console-authentication) pour la configuration.

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

483 493 

484<h3 id="routines-are-disabled-by-your-organization’s-policy">494<h3 id="routines-are-disabled-by-your-organization’s-policy">

485 Routines are disabled by your organization's policy495 Les routines sont désactivées par la politique de votre organisation

486</h3>496</h3>

487 497 

488Un propriétaire dans votre organisation Team ou Enterprise a désactivé les routines au niveau de l'organisation. L'erreur apparaît lorsque vous essayez de créer ou d'exécuter une routine, y compris à partir de `/schedule` et de l'interface utilisateur [Routines](/fr/routines) sur claude.ai/code.498Un propriétaire de votre organisation Team ou Enterprise a désactivé les routines au niveau de l'organisation. L'erreur apparaît quand vous essayez de créer ou d'exécuter une routine, y compris à partir de `/schedule` et de l'interface utilisateur [Routines](/fr/routines) sur claude.ai/code.

489 499 

490```text theme={null}500```text theme={null}

491Routines are disabled by your organization's policy.501Routines are disabled by your organization's policy.

492```502```

493 503 

494C'est un paramètre côté serveur, il ne peut donc pas être remplacé par les paramètres locaux, les variables d'environnement ou les drapeaux CLI.504C'est un paramètre côté serveur, donc il ne peut pas être remplacé à partir des paramètres locaux, des variables d'environnement ou des drapeaux CLI.

495 505 

496**Que faire :**506**À faire :**

497 507 

498* Demandez à un propriétaire de votre organisation d'activer le bouton bascule **Routines** sur [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code)508* Demandez à un propriétaire de votre organisation d'activer le bouton bascule **Routines** sur [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code)

499* Pour les travaux ponctuels programmés qui ne nécessitent pas de routines au niveau de l'organisation, consultez [tâches programmées](/fr/scheduled-tasks)509* Pour un travail programmé ponctuel qui ne nécessite pas de routines au niveau de l'organisation, consultez [tâches programmées](/fr/scheduled-tasks)

500 510 

501<h3 id="remote-control-requires-the-anthropic-api">511<h3 id="remote-control-requires-the-anthropic-api">

502 Remote Control requires the Anthropic API512 Remote Control nécessite l'API Anthropic

503</h3>513</h3>

504 514 

505La session ne communique pas directement avec l'API Anthropic, il n'y a donc pas de backend claude.ai pour que [Remote Control](/fr/remote-control) s'apparie avec.515La session ne parle pas directement à l'API Anthropic, donc il n'y a pas de backend claude.ai pour que [Remote Control](/fr/remote-control) s'apparie avec.

506 516 

507```text theme={null}517```text theme={null}

508Remote Control is only available when using Claude via api.anthropic.com.518Remote Control is only available when using Claude via api.anthropic.com.

509```519```

510 520 

511Cela apparaît sur Amazon Bedrock, Google Vertex AI et Microsoft Foundry. {/* min-version: 2.1.196 */}À partir de la v2.1.196, cela apparaît également lorsque [`ANTHROPIC_BASE_URL`](/fr/env-vars) pointe vers un hôte autre que `api.anthropic.com`, comme une [passerelle LLM](/fr/llm-gateway) ou un proxy, même lorsque vous vous connectez avec claude.ai.521Cela apparaît sur Amazon Bedrock, la plateforme Agent de Google Cloud et Microsoft Foundry. {/* min-version: 2.1.196 */}À partir de la v2.1.196, cela apparaît également quand [`ANTHROPIC_BASE_URL`](/fr/env-vars) pointe vers un hôte autre que `api.anthropic.com`, comme une [passerelle LLM](/fr/llm-gateway) ou un proxy, même quand vous vous connectez avec claude.ai.

512 522 

513**Que faire :**523**À faire :**

514 524 

515* Déconfigurez `ANTHROPIC_BASE_URL` et redémarrez la session, ou démarrez Remote Control à partir d'une session qui communique directement avec l'API Anthropic525* Déconfigurez `ANTHROPIC_BASE_URL` et redémarrez la session, ou démarrez Remote Control à partir d'une session qui parle directement à l'API Anthropic

516* Pour ce message et les autres messages de démarrage de Remote Control, consultez [Troubleshoot Remote Control](/fr/remote-control#troubleshooting)526* Pour ce message et les autres messages de démarrage de Remote Control, consultez [Dépannage de Remote Control](/fr/remote-control#troubleshooting)

517 527 

518<h3 id="oauth-token-revoked-or-expired">528<h3 id="oauth-token-revoked-or-expired">

519 OAuth token revoked or expired529 Token OAuth révoqué ou expiré

520</h3>530</h3>

521 531 

522Votre connexion enregistrée n'est plus valide. Un jeton révoqué signifie que vous vous êtes déconnecté partout ou qu'un administrateur a supprimé l'accès ; un jeton expiré signifie que l'actualisation automatique a échoué en milieu de session.532Votre connexion enregistrée n'est plus valide. Un token révoqué signifie que vous vous êtes déconnecté partout ou qu'un administrateur a supprimé l'accès ; un token expiré signifie que l'actualisation automatique a échoué en cours de session.

523 533 

524```text theme={null}534```text theme={null}

525OAuth token revoked · Please run /login535OAuth token revoked · Please run /login


527API Error: 401 ... authentication_error537API Error: 401 ... authentication_error

528```538```

529 539 

530**Que faire :**540**À faire :**

531 541 

532* Exécutez `/login` pour vous reconnecter542* Exécutez `/login` pour vous reconnecter

533* Si l'erreur revient dans la même session après la réauthentification, exécutez d'abord `/logout` pour effacer complètement le jeton stocké, puis `/login`543* Si l'erreur revient dans la même session après réauthentification, exécutez d'abord `/logout` pour effacer complètement le token stocké, puis `/login`

534* Pour les invites répétées de connexion entre les lancements, consultez les vérifications d'horloge système et de Keychain macOS dans [Troubleshooting](/fr/troubleshoot-install#not-logged-in-or-token-expired)544* Pour les invites répétées à vous connecter entre les lancements, consultez les vérifications d'horloge système et de Keychain macOS dans [Dépannage](/fr/troubleshoot-install#not-logged-in-or-token-expired)

535* Pour les autres défaillances incluant `403 Forbidden` et les problèmes de navigateur OAuth, consultez [Login and authentication](/fr/troubleshoot-install#login-and-authentication)545* Pour les autres défaillances incluant `403 Forbidden` et les problèmes de navigateur OAuth, consultez [Connexion et authentification](/fr/troubleshoot-install#login-and-authentication)

536 546 

537<h3 id="oauth-scope-requirement">547<h3 id="oauth-scope-requirement">

538 OAuth scope requirement548 Exigence de portée OAuth

539</h3>549</h3>

540 550 

541Le jeton stocké est antérieur à une portée de permission qu'une fonctionnalité plus récente nécessite. Vous voyez cela le plus souvent à partir de `/usage` et de l'indicateur d'utilisation de la ligne d'état :551Le token stocké est antérieur à une portée de permission qu'une fonctionnalité plus récente nécessite. Vous voyez cela le plus souvent à partir de `/usage` et de l'indicateur d'utilisation de la ligne d'état :

542 552 

543```text theme={null}553```text theme={null}

544OAuth token does not meet scope requirement: user:profile554OAuth token does not meet scope requirement: user:profile

545```555```

546 556 

547**Que faire :**557**À faire :**

548 558 

549* Exécutez `/login` pour créer un nouveau jeton avec les portées actuelles. Vous n'avez pas besoin de vous déconnecter d'abord.559* Exécutez `/login` pour obtenir un nouveau token avec les portées actuelles. Vous n'avez pas besoin de vous déconnecter d'abord.

550 560 

551<h3 id="aws-credentials-expired-or-invalid">561<h3 id="aws-credentials-expired-or-invalid">

552 AWS credentials expired or invalid562 Les credentials AWS ont expiré ou sont invalides

553</h3>563</h3>

554 564 

555{/* min-version: 2.1.198 */}Ce message nécessite Claude Code v2.1.198 ou ultérieur et n'apparaît que lorsque [`awsAuthRefresh`](/fr/amazon-bedrock#advanced-credential-configuration) est défini dans votre fichier de paramètres. Votre jeton de session AWS a expiré ou a été rejeté, et l'actualisation automatique que Claude Code a déjà exécutée n'a pas produit un identifiant que l'API accepte. Il apparaît sur un 401 de [Claude Platform on AWS](/fr/claude-platform-on-aws) ou du [point de terminaison Mantle](/fr/amazon-bedrock#use-the-mantle-endpoint), c'est ainsi que ces fournisseurs signalent un jeton de sécurité expiré.565{/* min-version: 2.1.198 */}Ce message nécessite Claude Code v2.1.198 ou ultérieur et n'apparaît que quand [`awsAuthRefresh`](/fr/amazon-bedrock#advanced-credential-configuration) est défini dans votre fichier de paramètres. Votre token de session AWS a expiré ou a été rejeté, et l'actualisation automatique que Claude Code a déjà exécutée n'a pas produit une credential que l'API accepte. Cela apparaît sur un 401 de [Claude Platform on AWS](/fr/claude-platform-on-aws) ou du [point de terminaison Mantle](/fr/amazon-bedrock#use-the-mantle-endpoint), c'est ainsi que ces fournisseurs signalent un token de sécurité expiré.

556 566 

557L'indice d'action au milieu nomme la commande `awsAuthRefresh` de vos paramètres, donc il varie. La partie stable est le début `AWS credentials expired or invalid` :567L'indice d'action au milieu nomme la commande `awsAuthRefresh` de vos paramètres, donc il varie. La partie stable est le début `AWS credentials expired or invalid` :

558 568 


560AWS credentials expired or invalid · run /login and select "Claude Platform on AWS · refresh credentials", or run `aws sso login --profile myprofile` in another terminal · API Error: 401 ...570AWS credentials expired or invalid · run /login and select "Claude Platform on AWS · refresh credentials", or run `aws sso login --profile myprofile` in another terminal · API Error: 401 ...

561```571```

562 572 

563Sans `awsAuthRefresh` configuré, le même 401 affiche le message générique `Please run /login` à la place, qui ne peut pas actualiser les identifiants AWS.573Sans `awsAuthRefresh` configuré, le même 401 affiche le message générique `Please run /login` à la place, qui ne peut pas actualiser les credentials AWS.

564 574 

565**Que faire :**575**À faire :**

566 576 

567* Exécutez la commande `awsAuthRefresh` nommée dans le message, telle que `aws sso login --profile myprofile`, dans un autre terminal et complétez la connexion au navigateur, puis réessayez577* Exécutez la commande `awsAuthRefresh` nommée dans le message, comme `aws sso login --profile myprofile`, dans un autre terminal et complétez la connexion au navigateur, puis réessayez

568* Dans une session interactive, exécutez `/login`, choisissez **3rd-party platform**, puis sélectionnez **Claude Platform on AWS · refresh credentials** sous **Using 3rd-party platforms** pour exécuter la même commande sans redémarrer Claude Code. Consultez [Configure AWS credentials](/fr/claude-platform-on-aws#1-configure-aws-credentials)578* Dans une session interactive, exécutez `/login`, choisissez **plateforme tierce**, puis sélectionnez **Claude Platform on AWS · refresh credentials** sous **Utilisation de plateformes tierces** pour exécuter la même commande sans redémarrer Claude Code. Consultez [Configurer les credentials AWS](/fr/claude-platform-on-aws#1-configure-aws-credentials)

569* Si l'erreur se répète après que la commande d'actualisation réussisse, confirmez que l'identité est valide en dehors de Claude Code avec `aws sts get-caller-identity` dans le même shell et profil579* Si l'erreur se répète après que la commande d'actualisation réussisse, confirmez que l'identité est valide en dehors de Claude Code avec `aws sts get-caller-identity` dans le même shell et profil

570 580 

571<h3 id="aws-authentication-failed">581<h3 id="aws-authentication-failed">

572 AWS authentication failed582 L'authentification AWS a échoué

573</h3>583</h3>

574 584 

575{/* min-version: 2.1.198 */}Ce message nécessite Claude Code v2.1.198 ou ultérieur et n'apparaît que lorsque [`awsAuthRefresh`](/fr/amazon-bedrock#advanced-credential-configuration) est défini dans votre fichier de paramètres. Votre fournisseur AWS a renvoyé un 403, ou [Amazon Bedrock](/fr/amazon-bedrock) a renvoyé un 401.585{/* min-version: 2.1.198 */}Ce message nécessite Claude Code v2.1.198 ou ultérieur et n'apparaît que quand [`awsAuthRefresh`](/fr/amazon-bedrock#advanced-credential-configuration) est défini dans votre fichier de paramètres. Votre fournisseur AWS a retourné un 403, ou [Amazon Bedrock](/fr/amazon-bedrock) a retourné un 401.

576 586 

577Claude Code ne peut pas dire quelle cause vous avez atteinte. Amazon Bedrock signale un jeton de sécurité expiré comme un 403, mais un 403 est aussi comment il signale un refus d'autorisation, tel qu'une `AccessDeniedException` d'une permission IAM manquante ou d'un modèle qui n'est pas activé pour votre compte.587Claude Code ne peut pas dire quelle cause vous avez atteinte. Amazon Bedrock signale un token de sécurité expiré comme un 403, mais un 403 est aussi comment il signale un refus d'autorisation, comme une `AccessDeniedException` d'une permission IAM manquante ou d'un modèle qui n'est pas activé pour votre compte.

578 588 

579Un 401 d'Amazon Bedrock atterrit également ici plutôt que sous [AWS credentials expired or invalid](#aws-credentials-expired-or-invalid), car Bedrock ne signale pas un jeton expiré comme un 401. Un 401 de ce point de terminaison provient généralement de quelque chose d'autre dans le chemin de la requête, tel qu'un proxy d'entreprise.589Un 401 d'Amazon Bedrock atterrit également ici plutôt que sous [Les credentials AWS ont expiré ou sont invalides](#aws-credentials-expired-or-invalid), car Amazon Bedrock ne signale pas un token expiré comme un 401. Un 401 de ce point de terminaison provient généralement de quelque chose d'autre dans le chemin de la requête, comme un proxy d'entreprise.

580 590 

581Une actualisation des identifiants corrige un jeton expiré et ne peut pas corriger les autres causes, donc le message offre les deux :591Une actualisation de credential corrige un token expiré et ne peut pas corriger les autres causes, donc le message offre les deux :

582 592 

583```text theme={null}593```text theme={null}

584AWS authentication failed · run /login and select "Claude Platform on AWS · refresh credentials", or run `aws sso login --profile myprofile` in another terminal · if credentials are current, check AWS permissions and model access · API Error: 403 ...594AWS authentication failed · run /login and select "Claude Platform on AWS · refresh credentials", or run `aws sso login --profile myprofile` in another terminal · if credentials are current, check AWS permissions and model access · API Error: 403 ...


586 596 

587L'indice d'action au milieu nomme la commande `awsAuthRefresh` de vos paramètres, donc il varie. La partie stable est le début `AWS authentication failed`.597L'indice d'action au milieu nomme la commande `awsAuthRefresh` de vos paramètres, donc il varie. La partie stable est le début `AWS authentication failed`.

588 598 

589**Que faire :**599**À faire :**

590 600 

591* Exécutez la commande `awsAuthRefresh` nommée dans le message, ou `aws sso login`, au cas où un identifiant expiré serait la cause601* Exécutez la commande `awsAuthRefresh` nommée dans le message, ou `aws sso login`, au cas où une credential expirée serait la cause

592* Si vos identifiants sont actuels, confirmez que les permissions IAM dans [IAM configuration](/fr/amazon-bedrock#iam-configuration) sont attachées à l'identité que vous utilisez et que le modèle sélectionné est activé pour votre compte et votre région602* Si vos credentials sont actuelles, confirmez que les permissions IAM dans [Configuration IAM](/fr/amazon-bedrock#iam-configuration) sont attachées à l'identité que vous utilisez et que le modèle sélectionné est activé pour votre compte et région

593* Exécutez `aws sts get-caller-identity` pour confirmer quelle identité vos requêtes utilisent ; un `AWS_PROFILE` obsolète ou un profil par défaut est une cause courante d'une incompatibilité de permission603* Exécutez `aws sts get-caller-identity` pour confirmer quelle identité vos requêtes utilisent ; un `AWS_PROFILE` obsolète ou un profil par défaut est une cause courante d'une incompatibilité de permission

594 604 

595<h2 id="network-and-connection-errors">605<h2 id="network-and-connection-errors">

596 Erreurs réseau et de connexion606 Erreurs de réseau et de connexion

597</h2>607</h2>

598 608 

599Ces erreurs signifient qu'une demande réseau de Claude Code n'a pas pu atteindre sa destination. Elles proviennent généralement de votre réseau local, proxy ou pare-feu, ou de la politique réseau de l'environnement cloud.609Ces erreurs signifient qu'une requête réseau de Claude Code n'a pas pu atteindre sa destination. Elles proviennent généralement de votre réseau local, d'un proxy, d'un pare-feu, ou de la politique réseau de l'environnement cloud.

600 610 

601<h3 id="unable-to-connect-to-api">611<h3 id="unable-to-connect-to-api">

602 Unable to connect to API612 Impossible de se connecter à l'API

603</h3>613</h3>

604 614 

605La connexion TCP à l'API a échoué ou ne s'est jamais complétée.615La connexion TCP à l'API a échoué ou ne s'est jamais complétée.


613Request timed out. Check your internet connection and proxy settings623Request timed out. Check your internet connection and proxy settings

614```624```

615 625 

616Les causes courantes incluent l'absence d'accès Internet, un VPN qui bloque `api.anthropic.com`, ou un proxy d'entreprise requis qui n'est pas configuré.626Les causes courantes incluent l'absence d'accès à Internet, un VPN qui bloque `api.anthropic.com`, ou un proxy d'entreprise requis qui n'est pas configuré.

617 627 

618**Que faire :**628**Que faire :**

619 629 

620* Confirmez que vous pouvez atteindre l'hôte API à partir du même shell en exécutant `curl -I https://api.anthropic.com`. Sur Windows PowerShell, utilisez `curl.exe -I https://api.anthropic.com` pour que l'alias `Invoke-WebRequest` intégré ne soit pas utilisé.630* Confirmez que vous pouvez atteindre l'hôte API depuis le même shell en exécutant `curl -I https://api.anthropic.com`. Sur Windows PowerShell, utilisez `curl.exe -I https://api.anthropic.com` pour que l'alias `Invoke-WebRequest` intégré ne soit pas utilisé.

621* Si vous êtes derrière un proxy d'entreprise, définissez `HTTPS_PROXY` avant de lancer Claude Code et consultez [Configuration réseau](/fr/network-config)631* Si vous êtes derrière un proxy d'entreprise, définissez `HTTPS_PROXY` avant de lancer Claude Code et consultez [Configuration réseau](/fr/network-config)

622* Si vous acheminez via une passerelle LLM ou un relais, définissez [`ANTHROPIC_BASE_URL`](/fr/env-vars) sur son adresse. Consultez [Connecter Claude Code à une passerelle LLM](/fr/llm-gateway-connect) pour la configuration.632* Si vous routez via une passerelle LLM ou un relais, définissez [`ANTHROPIC_BASE_URL`](/fr/env-vars) sur son adresse. Consultez [Connecter Claude Code à une passerelle LLM](/fr/llm-gateway-connect) pour la configuration.

623* Assurez-vous que votre pare-feu autorise les hôtes répertoriés dans [Exigences d'accès réseau](/fr/network-config#network-access-requirements)633* Assurez-vous que votre pare-feu autorise les hôtes listés dans [Exigences d'accès réseau](/fr/network-config#network-access-requirements)

624* Les défaillances intermittentes sont [réessayées automatiquement](#automatic-retries) ; les défaillances persistantes pointent vers un problème de réseau local634* Les défaillances intermittentes sont [réessayées automatiquement](#automatic-retries) ; les défaillances persistantes indiquent un problème réseau local

625 635 

626Si `curl` réussit mais que Claude Code échoue toujours, la cause est généralement quelque chose entre le runtime et le réseau plutôt que le réseau lui-même :636Si `curl` réussit mais que Claude Code échoue toujours, la cause est généralement quelque chose entre le runtime et le réseau plutôt que le réseau lui-même :

627 637 

628* Sur Linux et WSL, vérifiez `/etc/resolv.conf` pour un serveur de noms inaccessible. WSL en particulier peut hériter d'un résolveur cassé de l'hôte.638* Sur Linux et WSL, vérifiez `/etc/resolv.conf` pour un serveur de noms inaccessible. WSL en particulier peut hériter d'un résolveur cassé de l'hôte.

629* Sur macOS, un client VPN qui a été déconnecté ou désinstallé peut laisser une interface de tunnel ou une règle de routage. Vérifiez `ifconfig` pour les interfaces `utun` obsolètes et supprimez l'extension réseau du VPN dans les Paramètres système.639* Sur macOS, un client VPN qui a été déconnecté ou désinstallé peut laisser une interface tunnel ou une règle de routage. Vérifiez `ifconfig` pour les interfaces `utun` obsolètes et supprimez l'extension réseau du VPN dans Paramètres système.

630* Docker Desktop et les runtimes de conteneurs similaires peuvent intercepter le trafic sortant. Quittez-les et réessayez pour exclure cela.640* Docker Desktop et les runtimes de conteneurs similaires peuvent intercepter le trafic sortant. Quittez-les et réessayez pour exclure cette possibilité.

631 641 

632<h3 id="ssl-certificate-errors">642<h3 id="ssl-certificate-errors">

633 SSL certificate errors643 Erreurs de certificat SSL

634</h3>644</h3>

635 645 

636Un proxy ou un appareil de sécurité sur votre réseau intercepte le trafic TLS avec son propre certificat, et Claude Code ne lui fait pas confiance.646Un proxy ou un appareil de sécurité sur votre réseau intercepte le trafic TLS avec son propre certificat, et Claude Code ne lui fait pas confiance.


640Unable to connect to API: Self-signed certificate detected650Unable to connect to API: Self-signed certificate detected

641```651```

642 652 

643{/* min-version: 2.1.199 */}À partir de la v2.1.199, une défaillance de validation de certificat n'est pas réessayée, donc cette erreur apparaît à la première tentative au lieu d'après le [budget de tentative](#automatic-retries) complet. Les versions antérieures ont passé quelques minutes à réessayer avant de l'afficher. Les conditions TLS transitoires, telles qu'un délai d'attente de poignée de main, réessaient toujours.653{/* min-version: 2.1.199 */}À partir de la v2.1.199, une défaillance de validation de certificat n'est pas réessayée, donc cette erreur apparaît à la première tentative au lieu d'après le [budget de retry](#automatic-retries) complet. Les versions antérieures ont passé quelques minutes à réessayer avant de l'afficher. Les conditions TLS transitoires, telles qu'un délai d'expiration de poignée de main, sont toujours réessayées.

644 654 

645Lors de `/login` et de la vérification de connectivité au démarrage, la même défaillance est signalée avec le code OpenSSL et le correctif en ligne :655Pendant `/login` et la vérification de connectivité au démarrage, la même défaillance est signalée avec le code OpenSSL et le correctif en ligne :

646 656 

647```text theme={null}657```text theme={null}

648SSL certificate error (UNABLE_TO_GET_ISSUER_CERT_LOCALLY). If you are behind a corporate proxy or TLS-intercepting firewall, set NODE_EXTRA_CA_CERTS to your CA bundle path, or ask IT to allowlist *.anthropic.com. Run /doctor for details.658SSL certificate error (UNABLE_TO_GET_ISSUER_CERT_LOCALLY). If you are behind a corporate proxy or TLS-intercepting firewall, set NODE_EXTRA_CA_CERTS to your CA bundle path, or ask IT to allowlist *.anthropic.com. Run `claude doctor` for details.

649```659```

650 660 

651**Que faire :**661**Que faire :**

652 662 

653* Exportez le bundle CA de votre organisation et pointez Claude Code dessus avec `NODE_EXTRA_CA_CERTS=/path/to/ca-bundle.pem`663* Exportez le bundle CA de votre organisation et pointez Claude Code dessus avec `NODE_EXTRA_CA_CERTS=/path/to/ca-bundle.pem`

654* Consultez [Configuration réseau](/fr/network-config#custom-ca-certificates) pour les instructions de configuration complètes664* Consultez [Configuration réseau](/fr/network-config#custom-ca-certificates) pour les instructions de configuration complètes

655* Ne définissez pas `NODE_TLS_REJECT_UNAUTHORIZED=0`, qui désactive complètement la validation des certificats665* Ne définissez pas `NODE_TLS_REJECT_UNAUTHORIZED=0`, qui désactive entièrement la validation de certificat

656 666 

657<h3 id="host-not-allowed-in-a-cloud-session">667<h3 id="host-not-allowed-in-a-cloud-session">

658 Host not allowed in a cloud session668 Hôte non autorisé dans une session cloud

659</h3>669</h3>

660 670 

661Une demande HTTP sortante d'une session cloud ou d'une routine a été bloquée par la politique réseau de l'environnement.671Une requête HTTP sortante d'une session cloud ou d'une routine a été bloquée par la politique réseau de l'environnement.

662 672 

663```text theme={null}673```text theme={null}

664HTTP 403674HTTP 403

665x-deny-reason: host_not_allowed675x-deny-reason: host_not_allowed

666```676```

667 677 

668Vous pouvez également voir un certificat TLS qui ne correspond pas au certificat réel de la destination. L'environnement cloud achemine le trafic sortant via un proxy qui applique la politique réseau, donc un certificat non correspondant signifie que le proxy a terminé la connexion, pas la destination.678Vous pouvez également voir un certificat TLS qui ne correspond pas au certificat réel de la destination. L'environnement cloud route le trafic sortant via un proxy qui applique la politique réseau, donc un certificat non correspondant signifie que le proxy a terminé la connexion, pas la destination.

669 679 

670Ce n'est pas un problème réseau côté client. Les sessions cloud et les [routines](/fr/routines) s'exécutent à l'intérieur d'un environnement en sandbox dont le trafic sortant est filtré selon la liste d'autorisation de l'environnement. L'environnement **Default** utilise l'accès **Trusted**, qui autorise la [liste d'autorisation par défaut](/fr/claude-code-on-the-web#default-allowed-domains) des registres de paquets, des API de fournisseurs cloud, des registres de conteneurs et des domaines de développement courants, mais bloque tout le reste.680Ce n'est pas un problème réseau côté client. Les sessions cloud et les [routines](/fr/routines) s'exécutent dans un environnement en sandbox dont le trafic sortant est filtré selon la liste d'autorisation de l'environnement. L'environnement **Default** utilise l'accès **Trusted**, qui autorise la [liste d'autorisation par défaut](/fr/claude-code-on-the-web#default-allowed-domains) des registres de paquets, des API de fournisseurs cloud, des registres de conteneurs et des domaines de développement courants, mais bloque tout le reste.

671 681 

672**Que faire :**682**Que faire :**

673 683 


675* Dans la boîte de dialogue **Update 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](/fr/claude-code-on-the-web#default-allowed-domains) aux côtés de vos domaines personnalisés. Sélectionnez **Full** à la place si vous souhaitez un accès sans restriction.685* Dans la boîte de dialogue **Update 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](/fr/claude-code-on-the-web#default-allowed-domains) aux côtés de vos domaines personnalisés. Sélectionnez **Full** à la place si vous souhaitez un accès sans restriction.

676* Cliquez sur **Save changes**. La prochaine exécution utilise la liste d'autorisation mise à jour.686* Cliquez sur **Save changes**. La prochaine exécution utilise la liste d'autorisation mise à jour.

677 687 

678Consultez [Accès réseau](/fr/claude-code-on-the-web#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.688Consultez [Network access](/fr/claude-code-on-the-web#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.

689 

690<h3 id="couldn’t-reconnect-to-your-remote-control-session">

691 Impossible de se reconnecter à votre session Remote Control

692</h3>

693 

694```text theme={null}

695Couldn't reconnect to your Remote Control session. Retry, or start a fresh session without --resume.

696```

697 

698La reprise avec `claude --resume` ou `claude --continue` se reconnecte à la session [Remote Control](/fr/remote-control) enregistrée dans cette conversation. Ce message signifie que la reconnexion a échoué pour une raison qui peut être temporaire, telle qu'une interruption réseau ou une erreur serveur, donc Claude Code ne peut pas confirmer si la session distante existe toujours. Votre session locale continue de s'exécuter sans Remote Control.

699 

700**Que faire :**

701 

702* Exécutez `/remote-control` pour réessayer la connexion

703* Démarrez Claude Code sans `--resume` pour créer une nouvelle session Remote Control

704* Pour les autres messages de démarrage Remote Control, consultez [Dépanner Remote Control](/fr/remote-control#troubleshooting)

705 

706Vous ne verrez pas ce message lorsque le serveur confirme que la session précédente n'existe plus ; Claude Code en crée une nouvelle dans ce cas. {/* min-version: 2.1.200 */}Avant la v2.1.200, toute défaillance de reconnexion créait une nouvelle session Remote Control, ce qui laissait des sessions supplémentaires dans la liste des sessions sur claude.ai/code.

679 707 

680<h2 id="request-errors">708<h2 id="request-errors">

681 Erreurs de requête709 Erreurs de requête

682</h2>710</h2>

683 711 

684Ces erreurs signifient que l'API a reçu votre requête mais a rejeté son contenu.712Ces erreurs concernent le contenu de votre requête. La plupart proviennent de l'API après qu'elle ait rejeté la requête ; quelques-unes sont produites localement par Claude Code avant l'envoi de toute requête.

685 713 

686<h3 id="prompt-is-too-long">714<h3 id="prompt-is-too-long">

687 Prompt is too long715 Le prompt est trop long

688</h3>716</h3>

689 717 

690La conversation plus les fichiers joints dépassent la fenêtre de contexte du modèle.718La conversation plus les fichiers joints dépassent la fenêtre de contexte du modèle.


693Prompt is too long721Prompt is too long

694```722```

695 723 

696**Que faire :**724**À faire :**

697 725 

698* Exécutez `/compact` pour résumer les tours antérieurs et libérer de l'espace, ou `/clear` pour recommencer726* Exécutez `/compact` pour résumer les tours précédents et libérer de l'espace, ou `/clear` pour recommencer à zéro

699* Exécutez `/context` pour voir une ventilation de ce qui consomme la fenêtre : prompt système, outils, fichiers mémoire et messages727* Exécutez `/context` pour voir une ventilation de ce qui consomme la fenêtre : prompt système, outils, fichiers mémoire et messages

700* Désactivez les serveurs MCP que vous n'utilisez pas avec `/mcp disable <name>` pour supprimer leurs définitions d'outils du contexte728* Désactivez les serveurs MCP que vous n'utilisez pas avec `/mcp disable <name>` pour supprimer leurs définitions d'outils du contexte

701* Réduisez les fichiers mémoire `CLAUDE.md` volumineux, ou déplacez les instructions dans les [règles à portée de chemin](/fr/memory#path-specific-rules) qui se chargent uniquement lorsqu'elles sont pertinentes729* Réduisez les fichiers mémoire `CLAUDE.md` volumineux, ou déplacez les instructions dans les [règles limitées au chemin](/fr/memory#path-specific-rules) qui se chargent uniquement lorsqu'elles sont pertinentes

702* Les sous-agents héritent de chaque définition d'outil MCP de la session parent, ce qui peut remplir leur fenêtre de contexte avant le premier tour. Désactivez les serveurs MCP que vous n'utilisez pas avant de générer des sous-agents.730* Les sous-agents héritent de chaque définition d'outil MCP de la session parent, ce qui peut remplir leur fenêtre de contexte avant le premier tour. Désactivez les serveurs MCP que vous n'utilisez pas avant de générer des sous-agents.

703* La compaction automatique est activée par défaut et empêche normalement cette erreur. Si vous avez défini [`DISABLE_AUTO_COMPACT`](/fr/env-vars), réactivez-la ou exécutez `/compact` manuellement avant que la fenêtre ne se remplisse.731* L'auto-compact est activé par défaut et empêche normalement cette erreur. Si vous avez défini [`DISABLE_AUTO_COMPACT`](/fr/env-vars), réactivez-le ou exécutez `/compact` manuellement avant que la fenêtre ne se remplisse.

704 732 

705Consultez [Explore the context window](/fr/context-window) pour une vue interactive de la façon dont le contexte se remplit.733Consultez [Explorez la fenêtre de contexte](/fr/context-window) pour une vue interactive de la façon dont le contexte se remplit.

706 734 

707<h3 id="error-during-compaction-conversation-too-long">735<h3 id="error-during-compaction-conversation-too-long">

708 Error during compaction: Conversation too long736 Erreur lors de la compaction : Conversation trop longue

709</h3>737</h3>

710 738 

711`/compact` lui-même a échoué car il n'y a pas assez d'espace libre pour contenir le résumé qu'il produit.739`/compact` lui-même a échoué car il n'y a pas assez d'espace libre dans le contexte pour contenir le résumé qu'il produit.

712 740 

713```text theme={null}741```text theme={null}

714Error during compaction: Conversation too long. Press esc twice to go up a few messages and try again.742Error during compaction: Conversation too long. Press esc twice to go up a few messages and try again.

715```743```

716 744 

717Cela peut se produire lorsque la fenêtre est déjà pleine au moment où la compaction automatique se déclenche, ou lorsque vous exécutez `/compact` après avoir vu `Prompt is too long`.745Cela peut se produire lorsque la fenêtre est déjà pleine au moment où l'auto-compact se déclenche, ou lorsque vous exécutez `/compact` après avoir vu `Prompt is too long`.

718 746 

719**Que faire :**747**À faire :**

720 748 

721* Appuyez sur Esc deux fois pour ouvrir la liste des messages et revenir plusieurs tours en arrière. Cela supprime les messages les plus récents du contexte. Ensuite, exécutez `/compact` à nouveau.749* Appuyez deux fois sur Échap pour ouvrir la liste des messages et revenir plusieurs tours en arrière. Cela supprime les messages les plus récents du contexte. Ensuite, exécutez `/compact` à nouveau.

722* Si revenir en arrière ne libère pas assez d'espace, exécutez `/clear` pour démarrer une nouvelle session. Votre conversation précédente est préservée et peut être rouverte avec `/resume`.750* Si revenir en arrière ne libère pas assez d'espace, exécutez `/clear` pour démarrer une nouvelle session. Votre conversation précédente est conservée et peut être rouverte avec `/resume`.

723 751 

724<h3 id="request-too-large">752<h3 id="request-too-large">

725 Request too large753 Requête trop volumineuse

726</h3>754</h3>

727 755 

728Le corps de la requête brute a dépassé la limite d'octets de l'API avant la tokenisation, généralement en raison d'un fichier collé volumineux ou d'une pièce jointe.756Le corps de la requête brute a dépassé la limite d'octets de l'API avant la tokenisation, généralement en raison d'un fichier volumineux collé ou d'une pièce jointe.

729 757 

730```text theme={null}758```text theme={null}

731Request too large (max 30 MB). Double press esc to go back and remove or shrink the attached content.759Request too large (max 30 MB). Double press esc to go back and remove or shrink the attached content.

732```760```

733 761 

734C'est une limite de taille sur la requête HTTP, distincte de la [limite de fenêtre de contexte](#prompt-is-too-long).762Il s'agit d'une limite de taille sur la requête HTTP, distincte de la [limite de la fenêtre de contexte](#prompt-is-too-long).

735 763 

736**Que faire :**764**À faire :**

737 765 

738* Appuyez sur Esc deux fois et revenir en arrière au-delà du tour qui a ajouté le contenu surdimensionné766* Appuyez deux fois sur Échap et revenez en arrière au-delà du tour qui a ajouté le contenu surdimensionné

739* Référencez les fichiers volumineux par chemin au lieu de coller leur contenu, afin que Claude puisse les lire par morceaux767* Référencez les fichiers volumineux par chemin au lieu de coller leur contenu, afin que Claude puisse les lire par morceaux

740* Pour les images, consultez [Image was too large](#image-was-too-large) ci-dessous768* Pour les images, consultez [L'image était trop volumineuse](#limage-était-trop-volumineuse) ci-dessous

741 769 

742<h3 id="image-was-too-large">770<h3 id="image-was-too-large">

743 Image was too large771 L'image était trop volumineuse

744</h3>772</h3>

745 773 

746Une image collée ou jointe dépasse les limites de taille ou de dimension de l'API.774Une image collée ou jointe dépasse les limites de taille ou de dimension de l'API.


750API Error: 400 ... image dimensions exceed max allowed size778API Error: 400 ... image dimensions exceed max allowed size

751```779```

752 780 

753{/* min-version: 2.1.142 */}Claude Code remplace l'image non traitée par un espace réservé textuel et réessaie, donc les messages suivants réussissent. Sur les versions antérieures à 2.1.142, une image collée pouvait rester dans la conversation et répéter la même erreur à chaque message suivant. Pour récupérer sur ces versions, appuyez sur Esc deux fois et revenir en arrière au-delà du tour où l'image a été ajoutée.781{/* min-version: 2.1.142 */}Claude Code remplace l'image non traitée par un espace réservé textuel et réessaie, de sorte que les messages suivants réussissent. Sur les versions antérieures à 2.1.142, une image collée pouvait rester dans la conversation et répéter la même erreur à chaque message suivant. Pour récupérer sur ces versions, appuyez deux fois sur Échap et revenez en arrière au-delà du tour où l'image a été ajoutée.

754 782 

755**Que faire :**783**À faire :**

756 784 

757* Redimensionnez l'image avant de la coller. L'API accepte les images jusqu'à 8 000 pixels sur le bord le plus long pour une seule image, ou 2 000 pixels lorsque de nombreuses images sont en contexte.785* Redimensionnez l'image avant de la coller. L'API accepte les images jusqu'à 8 000 pixels sur le côté le plus long pour une seule image, ou 2 000 pixels lorsque de nombreuses images sont en contexte.

758* Prenez une capture d'écran plus serrée de la région pertinente au lieu de l'écran complet786* Prenez une capture d'écran plus serrée de la région pertinente au lieu de l'écran complet

759 787 

760<h3 id="unable-to-resize-image">788<h3 id="unable-to-resize-image">

761 Unable to resize image789 Impossible de redimensionner l'image

762</h3>790</h3>

763 791 

764Claude Code n'a pas pu réduire l'échelle d'une image jointe avant de l'envoyer à l'API.792Claude Code n'a pas pu réduire une image jointe avant de l'envoyer à l'API.

765 793 

766```text theme={null}794```text theme={null}

767Unable to resize image — image processing is unavailable and dimensions could not be read from the file header. Please convert the image to PNG, JPEG, GIF, or WebP.795Unable to resize image — image processing is unavailable and dimensions could not be read from the file header. Please convert the image to PNG, JPEG, GIF, or WebP.


770Unable to resize image — could not verify image dimensions are within the 2000x2000px API limit.798Unable to resize image — could not verify image dimensions are within the 2000x2000px API limit.

771```799```

772 800 

773Claude Code redimensionne normalement les grandes images automatiquement. Ces erreurs signifient que le processeur d'image natif n'a pas pu se charger ou a renvoyé une erreur, donc l'image n'a pas pu être redimensionnée pour s'adapter aux limites de l'API.801Claude Code redimensionne normalement les grandes images automatiquement. Ces erreurs signifient que le processeur d'image natif n'a pas pu se charger ou a renvoyé une erreur, de sorte que l'image n'a pas pu être redimensionnée pour s'adapter aux limites de l'API.

774 802 

775**Que faire :**803**À faire :**

776 804 

777* Si le message vous demande de convertir l'image, convertissez-la en PNG, JPEG, GIF ou WebP et joignez-la à nouveau. Claude Code peut vérifier les dimensions de ces formats sans le processeur d'image.805* Si le message vous demande de convertir l'image, convertissez-la en PNG, JPEG, GIF ou WebP et joignez-la à nouveau. Claude Code peut vérifier les dimensions de ces formats sans le processeur d'image.

778* Si le message signale une limite de dimension ou de taille, redimensionnez ou recompressez l'image en dessous de cette limite avant de la joindre.806* Si le message signale une limite de dimension ou de taille, redimensionnez ou recompressez l'image en dessous de cette limite avant de la joindre.

779 807 

780<h3 id="pdf-errors">808<h3 id="pdf-errors">

781 PDF errors809 Erreurs PDF

782</h3>810</h3>

783 811 

784Le PDF que vous avez joint n'a pas pu être traité.812Le PDF que vous avez joint n'a pas pu être traité.


789The PDF file was not valid. Try converting to a different format first.817The PDF file was not valid. Try converting to a different format first.

790```818```

791 819 

792**Que faire :**820**À faire :**

793 821 

794* Pour les PDF surdimensionnés, demandez à Claude de lire une plage de pages avec l'outil Read au lieu de joindre le fichier entier, ou extrayez le texte avec un outil comme `pdftotext` et référencez le fichier de sortie par chemin822* Pour les PDF surdimensionnés, demandez à Claude de lire une plage de pages avec l'outil Read au lieu de joindre le fichier entier, ou extrayez le texte avec un outil comme `pdftotext` et référencez le fichier de sortie par chemin

795* Pour les PDF protégés ou invalides, supprimez le mot de passe ou réexportez le fichier à partir de son application source, puis réessayez823* Pour les PDF protégés ou invalides, supprimez le mot de passe ou réexportez le fichier depuis son application source, puis réessayez

796 824 

797<h3 id="extra-inputs-are-not-permitted">825<h3 id="extra-inputs-are-not-permitted">

798 Extra inputs are not permitted826 Les entrées supplémentaires ne sont pas autorisées

799</h3>827</h3>

800 828 

801Un proxy ou une passerelle LLM entre Claude Code et l'API a supprimé l'en-tête de requête `anthropic-beta`, donc l'API a rejeté les champs qui en dépendent.829Un proxy ou une passerelle LLM entre Claude Code et l'API a supprimé l'en-tête de requête `anthropic-beta`, de sorte que l'API a rejeté les champs qui en dépendent.

802 830 

803```text theme={null}831```text theme={null}

804API Error: 400 ... Extra inputs are not permitted ... context_management832API Error: 400 ... Extra inputs are not permitted ... context_management


808 836 

809Claude Code envoie des champs bêta uniquement tels que `context_management`, `effort` et les `input_examples` d'outils aux côtés d'un en-tête `anthropic-beta` qui les active. Lorsqu'une passerelle transfère le corps mais supprime l'en-tête, l'API voit des champs qu'elle ne reconnaît pas.837Claude Code envoie des champs bêta uniquement tels que `context_management`, `effort` et les `input_examples` d'outils aux côtés d'un en-tête `anthropic-beta` qui les active. Lorsqu'une passerelle transfère le corps mais supprime l'en-tête, l'API voit des champs qu'elle ne reconnaît pas.

810 838 

811**Que faire :**839**À faire :**

812 840 

813* Configurez votre passerelle pour transférer l'en-tête `anthropic-beta`. Consultez [feature pass-through](/fr/llm-gateway-protocol#feature-pass-through) pour savoir ce que les passerelles doivent transférer.841* Configurez votre passerelle pour transférer l'en-tête `anthropic-beta`. Consultez [feature pass-through](/fr/llm-gateway-protocol#feature-pass-through) pour savoir ce que les passerelles doivent transférer.

814* En dernier recours, définissez [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](/fr/env-vars) avant de lancer. Cela désactive les fonctionnalités qui nécessitent l'en-tête bêta pour que les requêtes réussissent via une passerelle qui ne peut pas le transférer.842* En dernier recours, définissez [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](/fr/env-vars) avant de lancer. Cela désactive les fonctionnalités qui nécessitent l'en-tête bêta afin que les requêtes réussissent via une passerelle qui ne peut pas le transférer.

815 843 

816<h3 id="there’s-an-issue-with-the-selected-model">844<h3 id="there’s-an-issue-with-the-selected-model">

817 There's an issue with the selected model845 Il y a un problème avec le modèle sélectionné

818</h3>846</h3>

819 847 

820Le nom du modèle configuré n'a pas été reconnu ou votre compte n'a pas accès à celui-ci. À partir de v2.1.160, l'indice de fin, montré ici sous sa forme interactive, varie selon la surface.848Le nom du modèle configuré n'a pas été reconnu ou votre compte n'a pas accès à celui-ci. À partir de v2.1.160, l'indice de fin, montré ici sous sa forme interactive, varie selon la surface.


823There's an issue with the selected model (claude-...). It may not exist or you may not have access to it. Run /model to pick a different model.851There's an issue with the selected model (claude-...). It may not exist or you may not have access to it. Run /model to pick a different model.

824```852```

825 853 

826**Que faire :**854**À faire :**

827 855 

828* **CLI interactif** : exécutez `/model` pour choisir parmi les modèles disponibles pour votre compte.856* **CLI interactif** : exécutez `/model` pour choisir parmi les modèles disponibles pour votre compte.

829* **Mode non interactif (`-p`)** : passez `--model` avec un alias ou un ID valide, ou définissez [`ANTHROPIC_MODEL`](/fr/env-vars). Le texte d'erreur affiche `Run --model` sur cette surface.857* **Mode non interactif (`-p`)** : passez `--model` avec un alias ou un ID valide, ou définissez [`ANTHROPIC_MODEL`](/fr/env-vars). Le texte d'erreur affiche `Run --model` sur cette surface.

830* **SDK Agent** : le texte d'erreur omet l'indice car le modèle est défini par programmation. Définissez [`model` sur `Options`](/fr/agent-sdk/typescript#options) en TypeScript ou [`ClaudeAgentOptions(model=...)`](/fr/agent-sdk/python#claudeagentoptions) en Python, et gérez l'erreur structurée `model_not_found` pour afficher votre propre retry ou sélecteur de modèle.858* **Agent SDK** : le texte d'erreur omet l'indice car le modèle est défini par programmation. Définissez [`model` sur `Options`](/fr/agent-sdk/typescript#options) en TypeScript ou [`ClaudeAgentOptions(model=...)`](/fr/agent-sdk/python#claudeagentoptions) en Python, et gérez l'erreur structurée `model_not_found` pour afficher votre propre retry ou sélecteur de modèle.

831* Utilisez un alias tel que `sonnet` ou `opus` au lieu d'un ID complet versionné. Les alias se résolvent à une version maintenue par défaut pour qu'ils ne deviennent pas obsolètes. Consultez [Model configuration](/fr/model-config).859* Utilisez un alias tel que `sonnet` ou `opus` au lieu d'un ID complet avec version. Les alias se résolvent en une valeur par défaut maintenue afin qu'ils ne deviennent pas obsolètes. Consultez [Configuration du modèle](/fr/model-config).

832* Si le mauvais modèle continue de revenir dans l'interface CLI, un ID obsolète est défini quelque part. Vérifiez dans [l'ordre de priorité](/fr/model-config#setting-your-model) : l'indicateur `--model`, la variable d'environnement `ANTHROPIC_MODEL`, puis le champ `model` dans `.claude/settings.local.json`, le fichier `.claude/settings.json` de votre projet, et `~/.claude/settings.json`. Supprimez la valeur obsolète et Claude Code revient à votre compte par défaut.860* Si le mauvais modèle continue à revenir dans la CLI, un ID obsolète est défini quelque part. Vérifiez dans [l'ordre de priorité](/fr/model-config#setting-your-model) : l'indicateur `--model`, la variable d'environnement `ANTHROPIC_MODEL`, puis le champ `model` dans `.claude/settings.local.json`, le `.claude/settings.json` de votre projet, et `~/.claude/settings.json`. Supprimez la valeur obsolète et Claude Code revient à la valeur par défaut de votre compte.

833* Pour les déploiements Vertex AI, consultez [Vertex AI troubleshooting](/fr/google-vertex-ai#troubleshooting).861* Pour les déploiements Google Cloud's Agent Platform, consultez [Dépannage de Google Cloud's Agent Platform](/fr/google-vertex-ai#troubleshooting).

862 

863<h3 id="model-is-not-a-recognized-model-id">

864 Le modèle n'est pas un ID de modèle reconnu

865</h3>

866 

867La chaîne de modèle que vous avez transmise à un changement de modèle n'est pas un alias de modèle, un ID de modèle que cette version de Claude Code connaît, ou un ID qui commence par `claude-`. Les causes habituelles sont une faute de frappe dans l'ID, un nom d'affichage tel que `Sonnet 5` où l'ID `claude-sonnet-5` est attendu, ou un alias que seules les versions plus récentes de Claude Code reconnaissent. Claude Code rejette immédiatement le changement. Avant v2.1.200, Claude Code enregistrait la chaîne et échouait à la requête suivante avec [Il y a un problème avec le modèle sélectionné](#there%E2%80%99s-an-issue-with-the-selected-model).

868 

869```text theme={null}

870Model "claud-sonnet-5" is not a recognized model id. Did you mean 'claude-sonnet-5'?

871```

872 

873L'indice de fin nomme l'alias ou l'ID de modèle le plus proche. Lorsque rien n'est assez proche, il lit `Run /model to see available models.` à la place.

874 

875Claude Code produit cette erreur localement au moment où le changement est demandé, avant toute requête API. Elle s'applique lorsqu'un modèle est défini via la méthode [Agent SDK](/fr/agent-sdk/typescript) `setModel()` ou par une application telle que l'[application de bureau](/fr/desktop) qui exécute la CLI Claude Code pour vous.

876 

877**À faire :**

878 

879* Exécutez `/model` sans argument pour ouvrir le sélecteur et choisir parmi les modèles disponibles pour votre compte, puis transmettez l'alias ou l'ID affiché là

880* Si vous avez utilisé un alias qu'une version plus récente de Claude Code supporte, exécutez `claude update`. Un ID complet qui commence par `claude-` réussit cette vérification même lorsque le modèle est plus récent que votre version de Claude Code, donc la mise à niveau n'est pas nécessaire pour ceux-ci.

881* Un modèle enregistré avant v2.1.200 n'est pas réparé par cette vérification. Si une valeur obsolète continue à revenir, supprimez-la des emplacements listés sous [Il y a un problème avec le modèle sélectionné](#there%E2%80%99s-an-issue-with-the-selected-model).

882* La vérification s'exécute uniquement sur l'API Anthropic. Sur Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, [Claude Platform on AWS](/fr/claude-platform-on-aws), et derrière une [passerelle LLM](/fr/llm-gateway) ou une `ANTHROPIC_BASE_URL` personnalisée, votre fournisseur ou passerelle définit les noms de modèles, de sorte que Claude Code accepte n'importe quelle chaîne et la transmet.

834 883 

835<h3 id="claude-opus-is-not-available-with-the-claude-pro-plan">884<h3 id="claude-opus-is-not-available-with-the-claude-pro-plan">

836 Claude Opus is not available with the Claude Pro plan885 Claude Opus n'est pas disponible avec le plan Claude Pro

837</h3>886</h3>

838 887 

839Votre plan d'abonnement actif n'inclut pas le modèle que vous avez sélectionné.888Votre plan d'abonnement actif n'inclut pas le modèle que vous avez sélectionné.


842Claude Opus is not available with the Claude Pro plan · Select a different model in /model891Claude Opus is not available with the Claude Pro plan · Select a different model in /model

843```892```

844 893 

845**Que faire :**894**À faire :**

846 895 

847* Exécutez `/model` et sélectionnez un modèle que votre plan inclut896* Exécutez `/model` et sélectionnez un modèle que votre plan inclut

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

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

850 899 

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

852 Model is restricted by your organization's settings901 Le modèle est restreint par les paramètres de votre organisation

853</h3>902</h3>

854 903 

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

856 905 

857```text theme={null}906```text theme={null}

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

859```908```

860 909 

861**Que faire :**910Claude Code traite un alias de famille de modèles, l'un de `opus`, `sonnet`, `haiku`, ou `fable`, comme une demande de cette famille plutôt que de sa version la plus récente. Sur l'API Anthropic et sur [Claude Platform on AWS](/fr/claude-platform-on-aws), un alias de famille restreint se résout à la version la plus récente de la famille que votre organisation et la liste d'autorisation `availableModels` permettent, et l'avis de substitution nomme cette version. Claude Code rejette `/model <alias>` uniquement lorsque chaque version de la famille est restreinte. Avant v2.1.205, un alias de famille était substitué ou rejeté en fonction de sa version la plus récente seule, même lorsqu'une version plus ancienne de la même famille était autorisée.

911 

912**À faire :**

862 913 

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

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

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

866 917 

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

868 thinking.type.enabled is not supported for this model919 thinking.type.enabled n'est pas supporté pour ce modèle

869</h3>920</h3>

870 921 

871Votre version de Claude Code est plus ancienne que le minimum pour Sonnet 5, Opus 4.8 ou Opus 4.7. L'interface CLI a envoyé une configuration de réflexion que le modèle n'accepte plus.922Votre version de Claude Code est plus ancienne que le minimum pour Sonnet 5, Opus 4.8, ou Opus 4.7. La CLI a envoyé une configuration de réflexion que le modèle n'accepte plus.

872 923 

873```text theme={null}924```text theme={null}

874API Error: 400 ... "thinking.type.enabled" is not supported for this model. Use "thinking.type.adaptive" and "output_config.effort" to control thinking behavior.925API Error: 400 ... "thinking.type.enabled" is not supported for this model. Use "thinking.type.adaptive" and "output_config.effort" to control thinking behavior.

875```926```

876 927 

877**Que faire :**928**À faire :**

878 929 

879* Exécutez `claude update` et redémarrez Claude Code. Opus 4.7 nécessite v2.1.111 ou ultérieur. Opus 4.8 nécessite v2.1.154 ou ultérieur. Sonnet 5 nécessite v2.1.197 ou ultérieur930* Exécutez `claude update` et redémarrez Claude Code. Opus 4.7 nécessite v2.1.111 ou ultérieur. Opus 4.8 nécessite v2.1.154 ou ultérieur. Sonnet 5 nécessite v2.1.197 ou ultérieur

880* Si vous ne pouvez pas mettre à niveau, exécutez `/model` et sélectionnez Opus 4.6 ou Sonnet 4.6 à la place931* Si vous ne pouvez pas mettre à niveau, exécutez `/model` et sélectionnez Opus 4.6 ou Sonnet 4.6 à la place

881* {/* min-version: agent-sdk@0.3.197 */}Si vous rencontrez cela dans le [Agent SDK](/fr/agent-sdk/overview), mettez à niveau le package SDK à la place. Opus 4.8 nécessite le SDK TypeScript v0.3.154 ou ultérieur et le SDK Python v0.2.88 ou ultérieur. Sonnet 5 nécessite le SDK TypeScript v0.3.197 ou ultérieur932* {/* min-version: agent-sdk@0.3.197 */}Si vous rencontrez ceci dans l'[Agent SDK](/fr/agent-sdk/overview), mettez à niveau le package SDK à la place. Opus 4.8 nécessite TypeScript SDK v0.3.154 ou ultérieur et Python SDK v0.2.88 ou ultérieur. Sonnet 5 nécessite TypeScript SDK v0.3.197 ou ultérieur

882 933 

883<h3 id="thinking-budget-exceeds-output-limit">934<h3 id="thinking-budget-exceeds-output-limit">

884 Thinking budget exceeds output limit935 Le budget de réflexion dépasse la limite de sortie

885</h3>936</h3>

886 937 

887Le budget de réflexion étendue configuré dépasse la longueur de réponse maximale, donc il n'y a pas de place pour la réponse réelle.938Le budget de réflexion étendue configuré dépasse la longueur de réponse maximale, il n'y a donc pas de place pour la réponse réelle.

888 939 

889```text theme={null}940```text theme={null}

890API Error: 400 ... max_tokens must be greater than thinking.budget_tokens941API Error: 400 ... max_tokens must be greater than thinking.budget_tokens

891```942```

892 943 

893Claude Code ajuste automatiquement ces valeurs sur l'API Anthropic. Vous voyez généralement cette erreur sur Amazon Bedrock ou Google Vertex AI lorsque [`MAX_THINKING_TOKENS`](/fr/env-vars) est défini plus haut que la limite de sortie du fournisseur, ou lorsque le mode plan augmente le budget de réflexion.944Claude Code ajuste ces valeurs automatiquement sur l'API Anthropic. Vous voyez généralement cette erreur sur Amazon Bedrock ou Google Cloud's Agent Platform lorsque [`MAX_THINKING_TOKENS`](/fr/env-vars) est défini plus haut que la limite de sortie du fournisseur, ou lorsque le mode plan augmente le budget de réflexion.

894 945 

895**Que faire :**946**À faire :**

896 947 

897* Réduisez `MAX_THINKING_TOKENS`, ou augmentez [`CLAUDE_CODE_MAX_OUTPUT_TOKENS`](/fr/env-vars) au-dessus du budget de réflexion948* Abaissez `MAX_THINKING_TOKENS`, ou augmentez [`CLAUDE_CODE_MAX_OUTPUT_TOKENS`](/fr/env-vars) au-dessus du budget de réflexion

898* Consultez [Extended thinking](/fr/model-config#extended-thinking) pour savoir comment le budget interagit avec la longueur de sortie949* Consultez [Réflexion étendue](/fr/model-config#extended-thinking) pour savoir comment le budget interagit avec la longueur de sortie

899 950 

900<h3 id="tool-use-or-thinking-block-mismatch">951<h3 id="tool-use-or-thinking-block-mismatch">

901 Tool use or thinking block mismatch952 Décalage de bloc d'utilisation d'outil ou de réflexion

902</h3>953</h3>

903 954 

904L'historique de la conversation a atteint l'API dans un état incohérent, généralement après qu'un appel d'outil a été interrompu ou qu'un tour a été modifié en milieu de flux.955L'historique de conversation a atteint l'API dans un état incohérent, généralement après qu'un appel d'outil ait été interrompu ou qu'un tour ait été modifié en cours de flux.

905 956 

906```text theme={null}957```text theme={null}

907API Error: 400 due to tool use concurrency issues. Run /rewind to recover the conversation.958API Error: 400 due to tool use concurrency issues. Run /rewind to recover the conversation.


911 962 

912Les trois variantes signifient la même chose : la séquence de blocs `tool_use`, `tool_result` et `thinking` dans l'historique ne correspond plus à ce que l'API attend.963Les trois variantes signifient la même chose : la séquence de blocs `tool_use`, `tool_result` et `thinking` dans l'historique ne correspond plus à ce que l'API attend.

913 964 

914**Que faire :**965**À faire :**

915 966 

916* {/* max-version: 2.1.155 */}Si vous utilisez Opus 4.7 ou Opus 4.8, exécutez d'abord `claude update`. Les versions antérieures à v2.1.156 peuvent déclencher cette erreur lors de l'utilisation normale d'outils, et `/rewind` ne l'efface pas.967* {/* max-version: 2.1.155 */}Si vous utilisez Opus 4.7 ou Opus 4.8, exécutez d'abord `claude update`. Les versions antérieures à v2.1.156 peuvent déclencher cette erreur lors de l'utilisation normale d'outils, et `/rewind` ne la supprime pas.

917* Exécutez `/rewind`, ou appuyez sur Esc deux fois, pour revenir à un point de contrôle avant le tour corrompu et continuer à partir de là. Consultez [Checkpointing](/fr/checkpointing) pour savoir comment les points de contrôle sont créés et restaurés.968* Exécutez `/rewind`, ou appuyez deux fois sur Échap, pour revenir à un point de contrôle avant le tour corrompu et continuer à partir de là. Consultez [Points de contrôle](/fr/checkpointing) pour savoir comment les points de contrôle sont créés et restaurés.

918 969 

919<h3 id="usage-policy-refusal">970<h3 id="usage-policy-refusal">

920 Usage Policy refusal971 Refus de la politique d'utilisation

921</h3>972</h3>

922 973 

923L'API a refusé de répondre car le contenu de la conversation a déclenché une vérification de la [Politique d'utilisation](https://www.anthropic.com/legal/aup). Le message inclut un ID de requête que vous pouvez citer au support si vous pensez que le refus est incorrect.974L'API a refusé de répondre car le contenu de la conversation a déclenché une vérification de la [Politique d'utilisation](https://www.anthropic.com/legal/aup). Le message inclut un ID de requête que vous pouvez citer au support si vous pensez que le refus est incorrect.


926API Error: Claude Code is unable to respond to this request, which appears to violate our Usage Policy (https://www.anthropic.com/legal/aup). Please double press esc to edit your last message or start a new session for Claude Code to assist with a different task.977API Error: Claude Code is unable to respond to this request, which appears to violate our Usage Policy (https://www.anthropic.com/legal/aup). Please double press esc to edit your last message or start a new session for Claude Code to assist with a different task.

927```978```

928 979 

929La vérification évalue la conversation complète, pas seulement votre dernier prompt, donc envoyer un nouveau message dans la même session réactive généralement le même refus. Il en va de même après la fermeture et la réouverture de la session avec `--continue` ou `--resume`, puisque la transcription sur disque contient toujours le contenu déclencheur.980La vérification évalue la conversation complète, pas seulement votre dernier prompt, de sorte que l'envoi d'un nouveau message dans la même session réactive généralement le même refus. Il en va de même après la sortie et la réouverture de la session avec `--continue` ou `--resume`, puisque la transcription sur disque contient toujours le contenu déclencheur. Sur [Amazon Bedrock](/fr/amazon-bedrock), [Google Cloud's Agent Platform](/fr/google-vertex-ai), et [Microsoft Foundry](/fr/microsoft-foundry), ce message couvre également les requêtes que les mesures de sécurité du modèle ont signalées comme un sujet de cybersécurité. Consultez [Les mesures de sécurité ont signalé un sujet de cybersécurité](#safety-measures-flagged-a-cybersecurity-topic).

981 

982**À faire :**

983 

984* Appuyez deux fois sur Échap ou exécutez `/rewind` pour revenir à un point de contrôle avant le tour qui a déclenché le refus, puis reformulez ou adoptez une approche différente. Consultez [Points de contrôle](/fr/checkpointing).

985* Si vous ne pouvez pas identifier quel tour l'a causé, exécutez `/clear` pour démarrer une nouvelle conversation dans le même projet. Votre conversation précédente est conservée sur disque et reste disponible dans `/resume`.

986* En [mode non interactif](/fr/headless) (`-p`), où la rembobinage n'est pas disponible, réessayez avec un prompt reformulé dans une nouvelle session sans `--continue`. Les vérifications de politique varient selon le modèle, de sorte que le passage à un modèle différent avec `--model` peut également résoudre le refus dans certains cas.

987 

988<h3 id="safety-measures-flagged-a-cybersecurity-topic">

989 Les mesures de sécurité ont signalé un sujet de cybersécurité

990</h3>

991 

992Les mesures de sécurité du modèle ont signalé le contenu de la conversation comme un sujet de cybersécurité. Le message nomme le modèle qui a signalé la requête :

993 

994```text theme={null}

995API Error: Opus 4.8 has safety measures that flagged this message for a cybersecurity topic. To learn about the Cyber Verification Program and apply for access, visit our help center: https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude.

996 

997If you were not engaging in a cybersecurity topic, please send feedback via /feedback.

998```

999 

1000Le message renvoie au [Programme de vérification de la cybersécurité](https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude), qui accorde l'accès pour les travaux de cybersécurité légitimes. La protection elle-même est côté serveur et antérieure à v2.1.203 ; cette version a changé uniquement la formulation du message et la page vers laquelle il renvoie.

1001 

1002Ce que vous voyez dépend de votre fournisseur et de votre mode :

1003 

1004* Sur [Amazon Bedrock](/fr/amazon-bedrock), [Google Cloud's Agent Platform](/fr/google-vertex-ai), et [Microsoft Foundry](/fr/microsoft-foundry), un drapeau de cybersécurité produit le message [Refus de la politique d'utilisation](#refus-de-la-politique-dutilisation) à la place.

1005* [Le mode non interactif](/fr/headless) omet la phrase `/feedback`.

1006 

1007{/* max-version: 2.1.202 */}Avant v2.1.203, le message lisait `<model>'s safeguards flagged this message for a cybersecurity topic. If your work requires this access, you can apply for an exemption:` suivi d'un lien de formulaire d'exemption.

1008 

1009**À faire :**

1010 

1011* Si votre travail nécessite ce contenu, demandez l'accès via le [Programme de vérification de la cybersécurité](https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude)

1012* Si votre requête n'était pas sur un sujet de cybersécurité, exécutez `/feedback` pour signaler le faux positif

1013* Pour continuer à travailler dans la même session, appuyez deux fois sur Échap ou exécutez `/rewind` pour revenir à un point de contrôle avant le tour qui a déclenché le drapeau, puis adoptez une approche différente. Consultez [Points de contrôle](/fr/checkpointing).

1014 

1015<h2 id="installation-errors">

1016 Erreurs d'installation

1017</h2>

1018 

1019Ces erreurs apparaissent lors de l'installation ou de la mise à jour de Claude Code, à partir du [script d'installation](/fr/setup#install-claude-code), `claude install`, ou `claude update`. Pour les problèmes de `command not found`, PATH, permission et TLS lors de la configuration, consultez [Dépannage de l'installation et de la connexion](/fr/troubleshoot-install).

1020 

1021<h3 id="installation-was-killed-before-it-could-finish">

1022 L'installation a été interrompue avant de pouvoir se terminer

1023</h3>

1024 

1025Le script d'installation signale quand l'étape `claude install` est terminée par un signal. Sur Linux, le code de sortie 137 signifie que le processus a reçu SIGKILL, et sur un hôte à faible mémoire, c'est généralement le tueur de mémoire insuffisante (OOM) du noyau. Le script affiche cette explication et se termine avec le code 137 :

1026 

1027```text theme={null}

1028Installation was killed before it could finish (exit code 137). This usually means the system ran out of memory.

1029Claude Code needs roughly 512MB of free memory to install. Free up memory, then run this script again.

1030```

1031 

1032Pour tout autre signal fatal, et pour le code de sortie 137 sur macOS, le script affiche `Installation was killed before it could finish (exit code <N>)` avec le code de sortie réel et omet l'explication de mémoire insuffisante. Le message provient du script d'installation que macOS et Linux utilisent, qui couvre également les installations à l'intérieur de WSL ; les scripts d'installation Windows natifs ne l'affichent jamais. Avant la v2.1.200, le script se terminait avec seulement la ligne `Killed` du shell.

930 1033 

931**Que faire :**1034**Que faire :**

932 1035 

933* Appuyez sur Esc deux fois ou exécutez `/rewind` pour revenir à un point de contrôle avant le tour qui a déclenché le refus, puis reformulez ou adoptez une approche différente. Consultez [Checkpointing](/fr/checkpointing).1036* Arrêtez les autres processus pour libérer de la mémoire, puis relancez le programme d'installation

934* Si vous ne pouvez pas identifier quel tour l'a causé, exécutez `/clear` pour démarrer une nouvelle conversation dans le même projet. Votre conversation précédente est préservée sur disque et reste disponible dans `/resume`.1037* Ajoutez de l'espace d'échange ou passez à une instance plus grande. Consultez [Installation interrompue sur les serveurs Linux à faible mémoire](/fr/troubleshoot-install#install-killed-on-low-memory-linux-servers) pour les commandes de fichier d'échange.

935* En [mode non interactif](/fr/headless) (`-p`), où la rembobinage n'est pas disponible, réessayez avec un prompt reformulé dans une nouvelle session sans `--continue`. Les vérifications de politique varient selon le modèle, donc passer à un modèle différent avec `--model` peut également résoudre le refus dans certains cas.1038 

1039<h3 id="the-connection-dropped-while-downloading-the-update">

1040 La connexion s'est interrompue lors du téléchargement de la mise à jour

1041</h3>

1042 

1043La connexion au serveur de téléchargement s'est fermée pendant que `claude install`, `claude update`, ou le [programme de mise à jour automatique](/fr/setup#auto-updates) récupérait le binaire Claude Code, et les tentatives n'ont pas récupéré. Claude Code réessaie le téléchargement quand la connexion s'interrompt, le transfert s'arrête, ou le fichier téléchargé échoue sa somme de contrôle, jusqu'à trois tentatives au total. Une erreur HTTP complétée, comme un 404, n'est pas réessayée car le serveur a déjà répondu. {/* min-version: 2.1.202 */}Avant la v2.1.202, une seule connexion interrompue échouait le téléchargement immédiatement avec l'erreur simple `aborted` au lieu de réessayer.

1044 

1045```text theme={null}

1046The connection dropped while downloading the update (attempt 3/3: aborted). Check your network — proxies sometimes cut off large downloads.

1047```

1048 

1049Le texte entre parenthèses nomme quelle tentative a échoué et l'erreur réseau sous-jacente. `claude update` précède le message avec `Error: Failed to install native update` sur stderr.

1050 

1051Un téléchargement qui reste connecté mais ne se termine pas dans les 10 minutes échoue avec `Download timed out: exceeded the total deadline` à la place. Claude Code ne réessaie pas un téléchargement qui a expiré, car une connexion trop lente pour se terminer dans le délai ne se terminera pas lors d'une tentative immédiate non plus. Les étapes ci-dessous s'appliquent aux deux messages. Avant la v2.1.205, le même délai de 10 minutes était signalé comme le générique `timeout of 600000ms exceeded` du client HTTP.

1052 

1053La cause habituelle est un proxy ou une passerelle qui ferme un long transfert avant qu'il ne se termine. Le binaire Claude Code est un grand téléchargement, donc une limite de connexion proxy qui n'affecte jamais le trafic API normal peut quand même l'interrompre.

1054 

1055**Que faire :**

1056 

1057* Exécutez `claude update` à nouveau. Sur un réseau par ailleurs sain, le téléchargement réussit généralement à la prochaine exécution. Pour le message d'expiration, exécutez-le à nouveau à partir d'un réseau plus rapide ou moins limité.

1058* Si votre réseau nécessite un proxy, définissez `HTTPS_PROXY` avant d'exécuter le programme d'installation ou `claude update`. Consultez [Vérifier la connectivité réseau](/fr/troubleshoot-install#check-network-connectivity).

1059* Si un proxy d'entreprise continue de fermer le transfert, demandez à votre équipe réseau d'autoriser le téléchargement complet depuis `downloads.claude.ai`. Consultez [Exigences d'accès réseau](/fr/network-config#network-access-requirements).

1060* Exécutez `claude doctor` à partir de votre shell pour les diagnostics d'installation

936 1061 

937<h2 id="command-line-errors">1062<h2 id="command-line-errors">

938 Erreurs de ligne de commande1063 Erreurs de ligne de commande

939</h2>1064</h2>

940 1065 

941Ces erreurs proviennent de la propre validation de Claude Code de la ligne de commande `claude`. Claude Code les imprime immédiatement, avant de créer une session ou d'envoyer une requête API.1066Ces erreurs proviennent de la commande `claude` et de ses sous-commandes. Claude Code les affiche avant d'exécuter votre prompt ou d'envoyer une requête API.

942 1067 

943<h3 id="conflict-between-bg-and-print">1068<h3 id="conflict-between-bg-and-print">

944 Conflict between --bg and --print1069 Conflit entre --bg et --print

945</h3>1070</h3>

946 1071 

947Ce message nécessite Claude Code v2.1.198 ou ultérieur. Vous avez combiné `--bg` avec `-p` ou `--print` dans la même invocation `claude`. `--bg` démarre une [session en arrière-plan](/fr/agent-view#from-your-shell) que vous attachez plus tard avec `claude agents`, tandis que `--print` s'exécute [non-interactivement](/fr/headless) et ne démarre jamais la session interactive que `claude agents` attache. Avant v2.1.198, cette combinaison créait silencieusement une tâche en arrière-plan qui ne pouvait jamais être attachée.1072Ce message nécessite Claude Code v2.1.198 ou version ultérieure. Vous avez combiné `--bg` avec `-p` ou `--print` dans la même invocation `claude`. `--bg` démarre une [session en arrière-plan](/fr/agent-view#from-your-shell) à laquelle vous vous connectez ultérieurement avec `claude agents`, tandis que `--print` s'exécute [de manière non interactive](/fr/headless) et ne démarre jamais la session interactive à laquelle `claude agents` se connecte. Avant la v2.1.198, cette combinaison créait silencieusement un travail en arrière-plan qui ne pouvait jamais être attaché.

948 1073 

949```text theme={null}1074```text theme={null}

950--bg and --print conflict: --print never starts the interactive session that `claude agents` attaches to, so the job would be unattachable. The prompt is the positional — drop --print: `claude --bg '<task>'`.1075--bg and --print conflict: --print never starts the interactive session that `claude agents` attaches to, so the job would be unattachable. The prompt is the positional — drop --print: `claude --bg '<task>'`.

951```1076```

952 1077 

1078**Ce qu'il faut faire :**

1079 

1080* Supprimez `-p` ou `--print`. `--bg` prend le prompt comme argument positionnel, donc `claude --bg "<task>"` est la commande complète. Voir [Dispatch new agents from your shell](/fr/agent-view#from-your-shell).

1081* Pour exécuter le prompt de manière non interactive et imprimer le résultat au lieu de créer une session en arrière-plan, supprimez `--bg` et exécutez `claude -p "<task>"`

1082 

1083<h3 id="the-json-schema-value-is-not-a-valid-json-schema">

1084 La valeur --json-schema n'est pas un JSON Schema valide

1085</h3>

1086 

1087Le schéma que vous avez transmis à [`--json-schema`](/fr/cli-reference#cli-flags) en [mode non interactif](/fr/headless#get-structured-output) a échoué la compilation JSON Schema, donc `claude` se termine avec le code 1 au lieu d'exécuter le prompt. Avant la v2.1.205, un schéma invalide produisait une sortie non structurée sans erreur, et tout schéma utilisant le mot-clé `format` était traité comme invalide.

1088 

1089```text theme={null}

1090Error: --json-schema is not a valid JSON Schema: data/type must be equal to one of the allowed values

1091```

1092 

1093Le texte après le deuxième deux-points est le diagnostic du validateur et nomme le mot-clé ou l'emplacement qui a échoué. Les schémas qui utilisent le mot-clé `format`, comme `"format": "email"`, sont valides : Claude Code accepte `format` comme annotation et ne l'applique pas.

1094 

1095Claude Code exécute deux vérifications avant la compilation du schéma : il rejette une valeur qui n'est pas du JSON analysable avec `Error: --json-schema is not valid JSON`, et du JSON valide qui n'est pas un objet avec `Error: --json-schema must be a JSON object`.

1096 

1097**Ce qu'il faut faire :**

1098 

1099* Corrigez la partie du schéma que le diagnostic nomme, puis réexécutez la commande

1100* Si le diagnostic est `schema too large`, réduisez l'imbrication du schéma et la réutilisation de `$ref`

1101* Voir [Get structured output](/fr/headless#get-structured-output) pour un schéma et une commande fonctionnels

1102 

1103<h3 id="could-not-import-a-server-from-claude-desktop">

1104 Impossible d'importer un serveur depuis Claude Desktop

1105</h3>

1106 

1107Claude Code n'a pas pu ajouter l'un des serveurs que vous avez sélectionnés dans `claude mcp add-from-claude-desktop`. La commande importe toujours les autres serveurs sélectionnés et affiche une ligne par serveur qu'elle n'a pas pu ajouter. Avant la v2.1.205, le premier serveur qui a échoué a arrêté l'importation et aucun des serveurs sélectionnés n'a été ajouté.

1108 

1109```text theme={null}

1110Could not import my server: Invalid name my server. Names can only contain letters, numbers, hyphens, and underscores.

1111```

1112 

1113Le texte après le nom du serveur est la raison. La plus courante est la vérification du nom : Claude Desktop autorise les caractères dans les noms de serveurs, tels que les espaces et les points, que `claude mcp` restreint aux lettres, chiffres, traits d'union et traits de soulignement. D'autres raisons incluent une configuration de serveur qui échoue la validation et un serveur bloqué par la [politique MCP](/fr/managed-mcp) de votre organisation.

1114 

1115**Ce qu'il faut faire :**

1116 

1117* Renommez le serveur dans `claude_desktop_config.json` pour utiliser uniquement des lettres, des chiffres, des traits d'union et des traits de soulignement, puis exécutez `claude mcp add-from-claude-desktop` à nouveau

1118* Ajoutez ce serveur directement avec `claude mcp add` ou `claude mcp add-json` sous un nom valide. Voir [Import MCP servers from Claude Desktop](/fr/mcp#import-mcp-servers-from-claude-desktop).

1119 

1120<h2 id="plugin-errors">

1121 Erreurs de plugin

1122</h2>

1123 

1124Ces erreurs proviennent de la configuration des [plugins](/fr/plugins) et des [marketplaces](/fr/plugin-marketplaces). Pour les problèmes de plugin qui ne produisent pas l'un des messages de cette page, comme une URL de marketplace qui ne se charge pas ou un plugin qui s'installe mais n'apparaît pas, consultez [Dépannage des plugins](/fr/discover-plugins#troubleshooting).

1125 

1126<h3 id="marketplace-is-registered-from-an-untrusted-source">

1127 Marketplace enregistrée à partir d'une source non fiable

1128</h3>

1129 

1130La marketplace est enregistrée sous un nom qui est [réservé aux marketplaces officielles d'Anthropic](/fr/plugin-marketplaces#marketplace-schema), mais sa source enregistrée n'est pas un référentiel GitHub `anthropics`. Claude Code revérifie les noms réservés chaque fois qu'il charge ou actualise une marketplace, de sorte que la marketplace et les plugins installés à partir de celle-ci cessent de se charger. Avant la v2.1.205, le nom n'était vérifié que lors de l'ajout de la marketplace, de sorte qu'une entrée enregistrée avant que son nom ne soit réservé continuait à se charger.

1131 

1132```text theme={null}

1133Marketplace "claude-community" is registered from an untrusted source: The name 'claude-community' is reserved for official Anthropic marketplaces. Only repositories from 'github.com/anthropics/' can use this name. To fix it, remove the marketplace and re-add it from the official source.

1134```

1135 

1136**À faire :**

1137 

1138* Exécutez `claude plugin marketplace remove <name>`, puis ajoutez à nouveau la marketplace à partir du référentiel officiel `github.com/anthropics`

1139* Si vous publiez une marketplace tierce qui utilisait le nom avant qu'il ne soit réservé, renommez-la et demandez aux utilisateurs de la rajouter à partir de votre source

1140* Consultez la liste des noms réservés sous [Schéma de marketplace](/fr/plugin-marketplaces#marketplace-schema)

1141 

1142<h2 id="configuration-warnings">

1143 Avertissements de configuration

1144</h2>

1145 

1146Claude Code écrit ces messages sur stderr au démarrage plutôt que d'afficher une erreur dans la conversation. Ils signalent la configuration qu'il a lue mais n'a pas appliquée.

1147 

1148<h3 id="workspace-has-not-been-trusted">

1149 L'espace de travail n'a pas été approuvé

1150</h3>

1151 

1152Claude Code a trouvé des règles `permissions.allow` ou des entrées `permissions.additionalDirectories` dans le fichier `.claude/settings.json` ou `.claude/settings.local.json` du projet et ne les a pas appliquées, car [les règles d'autorisation des paramètres du projet nécessitent l'approbation de l'espace de travail](/fr/permissions#project-allow-rules-and-workspace-trust). Le nombre, le nom du paramètre et le fichier nommé dans le message varient selon votre configuration. Les règles `deny` et `ask` ne sont pas affectées.

1153 

1154```text theme={null}

1155Ignoring 2 permissions.allow entries from .claude/settings.local.json: this workspace has not been trusted. Run Claude Code interactively here once and accept the trust dialog, or set projects["/Users/you/project"].hasTrustDialogAccepted: true in /Users/you/.claude.json.

1156```

1157 

953**Que faire :**1158**Que faire :**

954 1159 

955* Supprimez `-p` ou `--print`. `--bg` prend le prompt comme argument positionnel, donc `claude --bg "<task>"` est la commande complète. Consultez [Dispatch new agents from your shell](/fr/agent-view#from-your-shell).1160* Exécutez `claude` dans le répertoire et acceptez la boîte de dialogue d'approbation. {/* min-version: 2.1.200 */}La boîte de dialogue s'affiche même si un répertoire parent est déjà approuvé, répertorie les règles retenues et vous permet de refuser et de continuer à travailler sans elles. Avant la v2.1.200, aucune boîte de dialogue n'apparaissait dans cette situation, donc cette étape ne pouvait pas être complétée là.

956* Pour exécuter le prompt non-interactivement et imprimer le résultat au lieu de créer une session en arrière-plan, supprimez `--bg` et exécutez `claude -p "<task>"`1161* En [mode non interactif](/fr/headless) avec `-p`, aucune boîte de dialogue n'est affichée. Définissez l'entrée `hasTrustDialogAccepted` dans `~/.claude.json` en utilisant la clé `projects` exacte que le message affiche.

1162* {/* min-version: 2.1.200 */}Si le message nomme `.claude/settings.local.json` et que vous avez démarré Claude Code en dehors d'un référentiel git ou dans votre répertoire personnel, mettez à jour vers la v2.1.200 ou une version ultérieure. Les versions 2.1.196 à 2.1.199 ont traité votre propre `.claude/settings.local.json` comme fournie par le référentiel dans ces espaces de travail. Voir [Règles d'autorisation du projet et approbation de l'espace de travail](/fr/permissions#project-allow-rules-and-workspace-trust).

957 1163 

958<h2 id="responses-seem-lower-quality-than-usual">1164<h2 id="responses-seem-lower-quality-than-usual">

959 Les réponses semblent de qualité inférieure à la normale1165 Les réponses semblent de qualité inférieure à la normale

960</h2>1166</h2>

961 1167 

962Si les réponses de Claude semblent moins capables que vous ne l'attendez mais qu'aucune erreur n'est affichée, la cause est généralement l'état de la conversation plutôt que le modèle lui-même. Claude Code ne change pas silencieusement les versions de modèle. Il peut basculer vers un modèle de secours dans trois cas spécifiques :1168Si les réponses de Claude semblent moins performantes que prévu mais qu'aucune erreur n'est affichée, la cause est généralement l'état de la conversation plutôt que le modèle lui-même. Claude Code ne change pas silencieusement les versions de modèle. Il peut basculer vers un modèle de secours dans trois cas spécifiques :

963 1169 

964* Un [`--fallback-model`](/fr/cli-reference#cli-flags) configuré prend le relais après une erreur de disponibilité, pour ce tour uniquement, avec un avis dans la transcription1170* Un [`--fallback-model`](/fr/cli-reference#cli-flags) configuré prend le relais après une erreur de disponibilité, pour ce tour uniquement, avec un avis dans la transcription

965* Une vérification de démarrage Bedrock ou Vertex AI trouve votre modèle par défaut indisponible1171* Une vérification de démarrage d'Amazon Bedrock ou de la plateforme Agent de Google Cloud détecte que votre modèle par défaut n'est pas disponible

966* Le [basculement automatique du modèle](/fr/model-config#automatic-model-fallback) sur Fable 5 déplace la session vers le modèle Opus par défaut et affiche un avis dans la transcription1172* Le [basculement automatique du modèle](/fr/model-config#automatic-model-fallback) sur Fable 5 déplace la session vers le modèle Opus par défaut et affiche un avis dans la transcription

967 1173 

968La vérification de sélection du modèle ci-dessous capture les deuxième et troisième cas ; le premier apparaît comme un avis de transcription plutôt qu'un changement `/model`. La [configuration du modèle](/fr/model-config) explique quand chaque secours s'applique.1174La vérification de sélection du modèle ci-dessous détecte les deuxième et troisième cas ; le premier apparaît comme un avis de transcription plutôt qu'un changement de `/model`. La [configuration du modèle](/fr/model-config) explique quand chaque basculement s'applique.

1175 

1176Vérifiez d'abord ceci :

969 1177 

970Vérifiez d'abord ceux-ci :1178* **Sélection du modèle** : exécutez `/model` pour confirmer que vous êtes sur le modèle attendu. Un choix `/model` précédent ou une variable d'environnement `ANTHROPIC_MODEL` peut vous placer sur un modèle plus petit que prévu.

1179* **Niveau d'effort** : exécutez `/effort` pour vérifier le niveau de raisonnement actuel et l'augmenter pour le débogage difficile ou le travail de conception. Les valeurs par défaut varient selon le modèle, vérifiez donc avant de supposer que vous êtes en dessous du maximum. Consultez [Ajuster le niveau d'effort](/fr/model-config#adjust-effort-level) pour les valeurs par défaut par modèle et le raccourci `ultrathink`.

1180* **Pression contextuelle** : exécutez `/context` pour voir le remplissage de la fenêtre. S'il est proche de la capacité, exécutez `/compact` à un point naturel ou `/clear` pour recommencer. Consultez [Explorer la fenêtre contextuelle](/fr/context-window) pour voir comment l'auto-compact affecte les tours précédents.

1181* **Instructions obsolètes** : les fichiers `CLAUDE.md` volumineux ou obsolètes et les définitions d'outils MCP consomment du contexte et peuvent orienter les réponses. {/* min-version: 2.1.205 */}Le `/doctor` signale les fichiers mémoire surdimensionnés et les extensions inutilisées, et `/context` affiche l'utilisation des jetons des outils MCP. Avant la v2.1.205, `/doctor` ouvrait un écran de diagnostics qui signalait les fichiers mémoire surdimensionnés et les définitions de sous-agents.

971 1182 

972* **Sélection du modèle** : exécutez `/model` pour confirmer que vous êtes sur le modèle que vous attendez. Un choix `/model` précédent ou une variable d'environnement `ANTHROPIC_MODEL` peut vous mettre sur un modèle plus petit que prévu.1183Quand une réponse s'avère incorrecte, revenir en arrière fonctionne généralement mieux que de répondre avec des corrections. Appuyez deux fois sur Échap ou exécutez `/rewind` pour revenir avant le mauvais tour, puis reformulez l'invite avec plus de détails. Corriger dans le fil de discussion conserve la mauvaise tentative en contexte, ce qui peut ancrer les réponses ultérieures à celle-ci. Consultez [Checkpointing](/fr/checkpointing).

973* **Niveau d'effort** : exécutez `/effort` pour vérifier le niveau de raisonnement actuel et augmentez-le pour le débogage difficile ou le travail de conception. Les valeurs par défaut varient selon le modèle, donc vérifiez avant de supposer que vous êtes en dessous du maximum. Consultez [Ajuster le niveau d'effort](/fr/model-config#adjust-effort-level) pour les valeurs par défaut par modèle et le raccourci `ultrathink`.

974* **Pression de contexte** : exécutez `/context` pour voir à quel point la fenêtre est pleine. Si elle est près de la capacité, exécutez `/compact` à un point de rupture naturel ou `/clear` pour recommencer. Consultez [Explorer la fenêtre de contexte](/fr/context-window) pour savoir comment la compaction automatique affecte les tours antérieurs.

975* **Instructions obsolètes** : les fichiers `CLAUDE.md` volumineux ou obsolètes et les définitions d'outils MCP consomment du contexte et peuvent orienter les réponses. `/doctor` signale les fichiers mémoire surdimensionnés et les définitions de sous-agents ; `/context` affiche l'utilisation des jetons d'outils MCP.

976 1184 

977Lorsqu'une réponse s'avère mauvaise, le rembobinage fonctionne généralement mieux que de répondre avec des corrections. Appuyez sur Esc deux fois ou exécutez `/rewind` pour revenir avant le mauvais tour, puis reformulez le prompt avec plus de détails. Corriger dans le fil conserve la mauvaise tentative en contexte, ce qui peut ancrer les réponses ultérieures à celle-ci. Consultez [Checkpointing](/fr/checkpointing).1185Si la qualité semble toujours mauvaise après vérification des éléments ci-dessus, exécutez `/feedback` et décrivez ce que vous attendiez par rapport à ce que vous avez obtenu. Les commentaires soumis de cette manière incluent la transcription de la conversation, ce qui est le moyen le plus rapide pour Anthropic de diagnostiquer une véritable régression. Consultez [Signaler une erreur](#report-an-error) si `/feedback` n'est pas disponible dans votre environnement.

978 1186 

979Si la qualité semble toujours incorrecte après avoir vérifié ce qui précède, exécutez `/feedback` et décrivez ce que vous attendiez par rapport à ce que vous avez obtenu. Les commentaires soumis de cette manière incluent la transcription de la conversation, ce qui est le moyen le plus rapide pour Anthropic de diagnostiquer une véritable régression. Consultez [Signaler une erreur](#report-an-error) si `/feedback` n'est pas disponible dans votre environnement.1187{/* min-version: 2.1.201 */}Si Sonnet 5 refuse une demande et cite une injection d'invite suspectée sur Claude Code v2.1.200 ou antérieur, exécutez `claude update` pour récupérer le correctif v2.1.201.

980 1188 

981<h2 id="report-an-error">1189<h2 id="report-an-error">

982 Signaler une erreur1190 Signaler une erreur

983</h2>1191</h2>

984 1192 

985Pour les erreurs de composants que cette page ne couvre pas, consultez le guide pertinent :1193Pour les erreurs provenant de composants non couverts par cette page, consultez le guide pertinent :

986 1194 

987* Le serveur MCP n'a pas pu se connecter ou s'authentifier : [MCP](/fr/mcp)1195* Le serveur MCP n'a pas pu se connecter ou s'authentifier : [MCP](/fr/mcp)

988* Le script hook a échoué ou a bloqué un outil : [Debug hooks](/fr/hooks#debug-hooks)1196* Le script hook a échoué ou a bloqué un outil : [Déboguer les hooks](/fr/hooks#debug-hooks)

989* Autorisation refusée ou erreurs du système de fichiers lors de l'installation : [Troubleshoot installation and login](/fr/troubleshoot-install)1197* Erreur de permission ou erreurs du système de fichiers lors de l'installation : [Dépanner l'installation et la connexion](/fr/troubleshoot-install)

990 1198 

991Si une erreur n'est pas répertoriée ici ou que la correction suggérée n'aide pas :1199Si une erreur n'est pas répertoriée ici ou si la correction suggérée ne vous aide pas :

992 1200 

993* Exécutez `/feedback` dans Claude Code pour envoyer la transcription et une description à Anthropic. La commande offre également d'ouvrir un problème GitHub prérempli. Sur Bedrock, Vertex AI, Foundry et d'autres fournisseurs tiers, `/feedback` enregistre une archive locale que vous pouvez envoyer à votre représentant de compte Anthropic à la place.1201* Exécutez `/feedback` dans Claude Code pour envoyer la transcription et une description à Anthropic. La commande propose également d'ouvrir un problème GitHub prérempli. Sur Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry et d'autres fournisseurs tiers, `/feedback` enregistre une archive locale que vous pouvez envoyer à votre représentant de compte Anthropic.

994* Exécutez `/doctor` pour vérifier les problèmes de configuration locale1202* Exécutez `claude doctor` depuis votre shell pour un diagnostic en lecture seule de votre installation, ou exécutez le diagnostic `/doctor` dans Claude Code pour trouver et corriger les problèmes de configuration

995* Vérifiez [status.claude.com](https://status.claude.com) pour les incidents actifs1203* Consultez [status.claude.com](https://status.claude.com) pour les incidents actifs

996* Recherchez les [problèmes existants](https://github.com/anthropics/claude-code/issues) sur GitHub1204* Recherchez les [problèmes existants](https://github.com/anthropics/claude-code/issues) sur GitHub

fast-mode.md +3 −3

Details

38* Tapez `/fast` et appuyez sur Tab pour activer ou désactiver38* Tapez `/fast` et appuyez sur Tab pour activer ou désactiver

39* Définissez `"fastMode": true` dans votre [fichier de paramètres utilisateur](/fr/settings)39* Définissez `"fastMode": true` dans votre [fichier de paramètres utilisateur](/fr/settings)

40 40 

41Par défaut, le mode rapide persiste entre les sessions. Les administrateurs peuvent configurer le mode rapide pour qu'il se réinitialise à chaque session. Consultez [opt-in par session](#require-per-session-opt-in) pour plus de détails.41Par défaut, le mode rapide que vous activez dans une session interactive persiste entre les sessions. {/* min-version: 2.1.205 */}En [mode non-interactif](/fr/headless), avec le drapeau `-p`, `/fast` fonctionne uniquement dans une session lancée avec le mode rapide dans sa valeur [`--settings`](/fr/cli-reference#cli-flags), par exemple `claude -p --settings '{"fastMode": true}'` ; le basculement s'applique alors uniquement à cette session et n'est pas enregistré comme votre paramètre par défaut, et dans toute autre session non-interactive, la commande signale que le mode rapide n'est pas disponible. Les administrateurs peuvent configurer le mode rapide pour qu'il se réinitialise à chaque session. Consultez [opt-in par session](#require-per-session-opt-in) pour plus de détails.

42 42 

43Pour la meilleure efficacité des coûts, activez le mode rapide au début d'une session plutôt que de basculer en milieu de conversation. Consultez [comprendre le compromis de coût](#understand-the-cost-tradeoff) pour plus de détails.43Pour la meilleure efficacité des coûts, activez le mode rapide au début d'une session plutôt que de basculer en milieu de conversation. Consultez [comprendre le compromis de coût](#understand-the-cost-tradeoff) pour plus de détails.

44 44 


103 103 

104Le mode rapide nécessite tous les éléments suivants :104Le mode rapide nécessite tous les éléments suivants :

105 105 

106* **API Anthropic ou abonnement uniquement** : le mode rapide est disponible via l'API Anthropic Console et pour les plans d'abonnement Claude utilisant les crédits d'utilisation. Il n'est pas disponible sur Amazon Bedrock, Google Vertex AI, Microsoft Azure Foundry ou Claude Platform sur AWS.106* **API Anthropic ou abonnement uniquement** : le mode rapide est disponible via l'API Anthropic Console et pour les plans d'abonnement Claude utilisant les crédits d'utilisation. Il n'est pas disponible sur Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry ou Claude Platform sur AWS.

107* **Crédits d'utilisation activés** : votre compte doit avoir les crédits d'utilisation activés, ce qui permet la facturation au-delà de l'utilisation incluse dans votre plan. Pour les comptes individuels, activez ceci dans vos [paramètres de facturation Console](https://platform.claude.com/settings/organization/billing). Pour Teams et Enterprise, un administrateur doit activer les crédits d'utilisation pour l'organisation.107* **Crédits d'utilisation activés** : votre compte doit avoir les crédits d'utilisation activés, ce qui permet la facturation au-delà de l'utilisation incluse dans votre plan. Pour les comptes individuels, activez ceci dans vos [paramètres de facturation Console](https://platform.claude.com/settings/organization/billing). Pour Teams et Enterprise, un administrateur doit activer les crédits d'utilisation pour l'organisation.

108 108 

109<Note>109<Note>


131 Opt-in par session131 Opt-in par session

132</h3>132</h3>

133 133 

134Par défaut, le mode rapide persiste entre les sessions : si un utilisateur active le mode rapide, il reste activé dans les sessions futures. Les administrateurs sur les plans [Team](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=fast_mode_teams#team-&-enterprise) ou [Enterprise](https://anthropic.com/contact-sales?utm_source=claude_code\&utm_medium=docs\&utm_content=fast_mode_enterprise) peuvent empêcher cela en définissant `fastModePerSessionOptIn` à `true` dans les [paramètres gérés](/fr/settings#settings-files) ou les [paramètres gérés par le serveur](/fr/server-managed-settings). Cela fait que chaque session commence avec le mode rapide désactivé, obligeant les utilisateurs à l'activer explicitement avec `/fast`.134Par défaut, le mode rapide qu'un utilisateur active dans une session interactive persiste entre les sessions : il reste activé dans les sessions futures. Les administrateurs sur les plans [Team](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=fast_mode_teams#team-&-enterprise) ou [Enterprise](https://anthropic.com/contact-sales?utm_source=claude_code\&utm_medium=docs\&utm_content=fast_mode_enterprise) peuvent empêcher cela en définissant `fastModePerSessionOptIn` à `true` dans les [paramètres gérés](/fr/settings#settings-files) ou les [paramètres gérés par le serveur](/fr/server-managed-settings). Cela fait que chaque session commence avec le mode rapide désactivé, obligeant les utilisateurs à l'activer explicitement avec `/fast`.

135 135 

136```json theme={null}136```json theme={null}

137{137{

Details

4 4 

5# Disponibilité des fonctionnalités5# Disponibilité des fonctionnalités

6 6 

7> Comparez les fonctionnalités de Claude Code disponibles sur les plans d'abonnement Anthropic, la Console Anthropic, Amazon Bedrock, Claude Platform sur AWS, Google Vertex AI et Microsoft Foundry.7> Comparez les fonctionnalités de Claude Code disponibles sur les plans d'abonnement Anthropic, la Console Anthropic, Amazon Bedrock, Claude Platform sur AWS, Google Cloud's Agent Platform et Microsoft Foundry.

8 8 

9L'interface CLI de Claude Code et tout ce qui s'exécute localement fonctionnent de manière identique chez chaque fournisseur. Pour les instructions de configuration par fournisseur, consultez l'[aperçu du déploiement en entreprise](/fr/third-party-integrations). Pour accéder directement à ce qui manque chez votre fournisseur, consultez les onglets [résumé par fournisseur](#summary-by-provider).9L'interface CLI de Claude Code et tout ce qui s'exécute localement fonctionnent de manière identique chez chaque fournisseur. Pour les instructions de configuration par fournisseur, consultez l'[aperçu du déploiement en entreprise](/fr/third-party-integrations). Pour accéder directement à ce qui manque chez votre fournisseur, consultez les onglets [résumé par fournisseur](#summary-by-provider).

10 10 


20* **Console Anthropic** : vous vous authentifiez avec une clé API Anthropic20* **Console Anthropic** : vous vous authentifiez avec une clé API Anthropic

21* **Amazon Bedrock** : vous utilisez les modèles Claude du catalogue de modèles Bedrock et définissez `CLAUDE_CODE_USE_BEDROCK`. Le [point de terminaison Mantle](/fr/amazon-bedrock#use-the-mantle-endpoint) (`CLAUDE_CODE_USE_MANTLE`) est couvert par cette colonne21* **Amazon Bedrock** : vous utilisez les modèles Claude du catalogue de modèles Bedrock et définissez `CLAUDE_CODE_USE_BEDROCK`. Le [point de terminaison Mantle](/fr/amazon-bedrock#use-the-mantle-endpoint) (`CLAUDE_CODE_USE_MANTLE`) est couvert par cette colonne

22* **Claude Platform sur AWS** : vous avez acheté Claude via AWS Marketplace mais appelez l'API Anthropic, et définissez `CLAUDE_CODE_USE_ANTHROPIC_AWS`22* **Claude Platform sur AWS** : vous avez acheté Claude via AWS Marketplace mais appelez l'API Anthropic, et définissez `CLAUDE_CODE_USE_ANTHROPIC_AWS`

23* **Google Vertex AI** : géré par Google ; vous définissez `CLAUDE_CODE_USE_VERTEX`23* **Google Cloud's Agent Platform** : géré par Google ; vous définissez `CLAUDE_CODE_USE_VERTEX`

24* **Microsoft Foundry** : géré par Anthropic sur Azure ; vous définissez `CLAUDE_CODE_USE_FOUNDRY`24* **Microsoft Foundry** : géré par Anthropic sur Azure ; vous définissez `CLAUDE_CODE_USE_FOUNDRY`

25 25 

26<h3 id="features-available-on-every-provider">26<h3 id="features-available-on-every-provider">


53* [Artifacts](/fr/artifacts) : plans Pro, Max, Team et Enterprise53* [Artifacts](/fr/artifacts) : plans Pro, Max, Team et Enterprise

54* [Voice dictation](/fr/voice-dictation)54* [Voice dictation](/fr/voice-dictation)

55 55 

56Desktop est l'exception partielle : les déploiements en entreprise peuvent acheminer Desktop vers Vertex AI ou un fournisseur de passerelle via les [paramètres gérés](https://support.claude.com/en/articles/12622667-enterprise-configuration), et l'[aperçu de recherche Cowork on 3P](https://claude.com/docs/cowork/3p/overview) exécute l'onglet Code sur Bedrock, Vertex AI, Foundry ou une passerelle LLM auto-hébergée. Pour la disponibilité par plan de ces fonctionnalités, consultez [Disponibilité par plan d'abonnement](#availability-by-subscription-plan).56Desktop est l'exception partielle : les déploiements en entreprise peuvent acheminer Desktop vers Google Cloud's Agent Platform ou un fournisseur de passerelle via les [paramètres gérés](https://support.claude.com/en/articles/12622667-enterprise-configuration), et [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview) exécute l'onglet Code sur Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry ou une passerelle LLM auto-hébergée. Pour la disponibilité par plan de ces fonctionnalités, consultez [Disponibilité par plan d'abonnement](#availability-by-subscription-plan).

57 57 

58<h3 id="cli-capabilities-that-vary-by-provider">58<h3 id="cli-capabilities-that-vary-by-provider">

59 Capacités CLI qui varient selon le fournisseur59 Capacités CLI qui varient selon le fournisseur


69 <th>Console Anthropic</th>69 <th>Console Anthropic</th>

70 <th>Amazon Bedrock</th>70 <th>Amazon Bedrock</th>

71 <th>Claude Platform sur AWS</th>71 <th>Claude Platform sur AWS</th>

72 <th>Google Vertex AI</th>72 <th>Google Cloud's Agent Platform</th>

73 <th>Microsoft Foundry</th>73 <th>Microsoft Foundry</th>

74 </tr>74 </tr>

75 </thead>75 </thead>


161 <th>Console Anthropic</th>161 <th>Console Anthropic</th>

162 <th>Amazon Bedrock</th>162 <th>Amazon Bedrock</th>

163 <th>Claude Platform sur AWS</th>163 <th>Claude Platform sur AWS</th>

164 <th>Google Vertex AI</th>164 <th>Google Cloud's Agent Platform</th>

165 <th>Microsoft Foundry</th>165 <th>Microsoft Foundry</th>

166 </tr>166 </tr>

167 </thead>167 </thead>


199 </tbody>199 </tbody>

200</table>200</table>

201 201 

202<span id="fn1" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>1</sup> Sur Vertex AI, la recherche web est disponible pour les modèles Claude 4 et versions ultérieures.<br />202<span id="fn1" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>1</sup> Sur Google Cloud's Agent Platform, la recherche web est disponible pour les modèles Claude 4 et versions ultérieures.<br />

203<span id="fn2" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>2</sup> Nécessite `CLAUDE_CODE_ENABLE_AUTO_MODE`. Consultez [Configuration du mode Auto](/fr/auto-mode-config).<br />203<span id="fn2" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>2</sup> Nécessite `CLAUDE_CODE_ENABLE_AUTO_MODE`. Consultez [Configuration du mode Auto](/fr/auto-mode-config).<br />

204<span id="fn3" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>3</sup> Les intervalles explicites tels que `/loop every 2 hours` fonctionnent chez chaque fournisseur. Sur Bedrock, Vertex AI et Foundry, `/loop` ne peut pas choisir son propre intervalle ou fournir l'invite de maintenance par défaut, donc une invite sans intervalle s'exécute toutes les 10 minutes, et `/loop` sans arguments affiche le message d'utilisation. Consultez [Scheduled tasks](/fr/scheduled-tasks).<br />204<span id="fn3" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>3</sup> Les intervalles explicites tels que `/loop every 2 hours` fonctionnent chez chaque fournisseur. Sur Amazon Bedrock, Google Cloud's Agent Platform et Microsoft Foundry, `/loop` ne peut pas choisir son propre intervalle ou fournir l'invite de maintenance par défaut, donc une invite sans intervalle s'exécute toutes les 10 minutes, et `/loop` sans arguments affiche le message d'utilisation. Consultez [Scheduled tasks](/fr/scheduled-tasks).<br />

205<span id="fn4" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>4</sup> Soumis à votre accord avec le fournisseur de cloud.<br />205<span id="fn4" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>4</sup> Soumis à votre accord avec le fournisseur de cloud.<br />

206<span id="fn5" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>5</sup> Tableau de bord et API uniquement. [Contribution metrics](/fr/analytics#enable-contribution-metrics) nécessite une organisation Claude.ai Team ou Enterprise.206<span id="fn5" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>5</sup> Tableau de bord et API uniquement. [Contribution metrics](/fr/analytics#enable-contribution-metrics) nécessite une organisation Claude.ai Team ou Enterprise.

207 207 


213 Résumé par fournisseur213 Résumé par fournisseur

214</h3>214</h3>

215 215 

216Chaque onglet répertorie ce qui n'est pas disponible ou partiellement supporté chez ce fournisseur, avec des alternatives le cas échéant. Tout ce qui n'est pas répertorié fonctionne de la même manière que sur un abonnement Claude. Sur Bedrock, Vertex AI, Foundry et Claude Platform sur AWS, la création de rapports d'erreurs et la télémétrie vers Anthropic sont désactivées par défaut. Consultez [comportements par défaut par fournisseur API](/fr/data-usage#default-behaviors-by-api-provider) pour connaître le trafic qui atteint toujours Anthropic et comment refuser.216Chaque onglet répertorie ce qui n'est pas disponible ou partiellement supporté chez ce fournisseur, avec des alternatives le cas échéant. Tout ce qui n'est pas répertorié fonctionne de la même manière que sur un abonnement Claude. Sur Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry et Claude Platform sur AWS, la création de rapports d'erreurs et la télémétrie vers Anthropic sont désactivées par défaut. Consultez [comportements par défaut par fournisseur API](/fr/data-usage#default-behaviors-by-api-provider) pour connaître le trafic qui atteint toujours Anthropic et comment refuser.

217 217 

218<Tabs>218<Tabs>

219 <Tab title="Amazon Bedrock">219 <Tab title="Amazon Bedrock">


221 221 

222 **Support partiel :**222 **Support partiel :**

223 223 

224 * [Desktop](/fr/desktop) : uniquement via l'[aperçu de recherche Cowork on 3P](https://claude.com/docs/cowork/3p/overview)224 * [Desktop](/fr/desktop) : uniquement via [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview)

225 * [Auto mode](/fr/auto-mode-config) : définissez `CLAUDE_CODE_ENABLE_AUTO_MODE`225 * [Auto mode](/fr/auto-mode-config) : définissez `CLAUDE_CODE_ENABLE_AUTO_MODE`

226 * [`/loop`](/fr/scheduled-tasks) : intervalles explicites uniquement226 * [`/loop`](/fr/scheduled-tasks) : intervalles explicites uniquement

227 * [Zero Data Retention](/fr/zero-data-retention) : soumis à votre accord AWS227 * [Zero Data Retention](/fr/zero-data-retention) : soumis à votre accord AWS


232 <Tab title="Claude Platform sur AWS">232 <Tab title="Claude Platform sur AWS">

233 **Non disponible :** toutes les [fonctionnalités qui nécessitent un abonnement Claude](#features-that-require-a-claude-subscription), plus [fast mode](/fr/fast-mode), [Advisor](/fr/advisor), [Channels](/fr/channels), le [tableau de bord analytique](/fr/analytics) et les [paramètres gérés par le serveur](/fr/server-managed-settings).233 **Non disponible :** toutes les [fonctionnalités qui nécessitent un abonnement Claude](#features-that-require-a-claude-subscription), plus [fast mode](/fr/fast-mode), [Advisor](/fr/advisor), [Channels](/fr/channels), le [tableau de bord analytique](/fr/analytics) et les [paramètres gérés par le serveur](/fr/server-managed-settings).

234 234 

235 **Disponible** là où Bedrock ne l'est pas : [web search](/fr/tools-reference#websearch-tool-behavior), [auto mode](/fr/auto-mode-config) sans drapeau d'opt-in et [`/loop` self-pacing](/fr/scheduled-tasks).235 **Disponible** là où Amazon Bedrock ne l'est pas : [web search](/fr/tools-reference#websearch-tool-behavior), [auto mode](/fr/auto-mode-config) sans drapeau d'opt-in et [`/loop` self-pacing](/fr/scheduled-tasks).

236 236 

237 **Alternatives :** pour la planification, utilisez [`/loop`](/fr/scheduled-tasks) au lieu de `/schedule`. Pour les sessions cloud, utilisez [GitHub Actions](/fr/github-actions) ou [GitLab CI/CD](/fr/gitlab-ci-cd).237 **Alternatives :** pour la planification, utilisez [`/loop`](/fr/scheduled-tasks) au lieu de `/schedule`. Pour les sessions cloud, utilisez [GitHub Actions](/fr/github-actions) ou [GitLab CI/CD](/fr/gitlab-ci-cd).

238 </Tab>238 </Tab>

239 239 

240 <Tab title="Google Vertex AI">240 <Tab title="Google Cloud's Agent Platform">

241 **Non disponible :** toutes les [fonctionnalités qui nécessitent un abonnement Claude](#features-that-require-a-claude-subscription), plus [fast mode](/fr/fast-mode), [Advisor](/fr/advisor), [Channels](/fr/channels), le [tableau de bord analytique](/fr/analytics) et les [paramètres gérés par le serveur](/fr/server-managed-settings).241 **Non disponible :** toutes les [fonctionnalités qui nécessitent un abonnement Claude](#features-that-require-a-claude-subscription), plus [fast mode](/fr/fast-mode), [Advisor](/fr/advisor), [Channels](/fr/channels), le [tableau de bord analytique](/fr/analytics) et les [paramètres gérés par le serveur](/fr/server-managed-settings).

242 242 

243 **Support partiel :**243 **Support partiel :**

244 244 

245 * [Desktop](/fr/desktop) : via les [paramètres gérés](https://support.claude.com/en/articles/12622667-enterprise-configuration) ou l'[aperçu de recherche Cowork on 3P](https://claude.com/docs/cowork/3p/overview)245 * [Desktop](/fr/desktop) : via les [paramètres gérés](https://support.claude.com/en/articles/12622667-enterprise-configuration) ou [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview)

246 * [Web search](/fr/tools-reference#websearch-tool-behavior) : modèles Claude 4 et versions ultérieures246 * [Web search](/fr/tools-reference#websearch-tool-behavior) : modèles Claude 4 et versions ultérieures

247 * [Auto mode](/fr/auto-mode-config) : définissez `CLAUDE_CODE_ENABLE_AUTO_MODE`247 * [Auto mode](/fr/auto-mode-config) : définissez `CLAUDE_CODE_ENABLE_AUTO_MODE`

248 * [`/loop`](/fr/scheduled-tasks) : intervalles explicites uniquement248 * [`/loop`](/fr/scheduled-tasks) : intervalles explicites uniquement


256 256 

257 **Support partiel :**257 **Support partiel :**

258 258 

259 * [Desktop](/fr/desktop) : uniquement via l'[aperçu de recherche Cowork on 3P](https://claude.com/docs/cowork/3p/overview)259 * [Desktop](/fr/desktop) : uniquement via [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview)

260 * [Auto mode](/fr/auto-mode-config) : définissez `CLAUDE_CODE_ENABLE_AUTO_MODE`260 * [Auto mode](/fr/auto-mode-config) : définissez `CLAUDE_CODE_ENABLE_AUTO_MODE`

261 * [`/loop`](/fr/scheduled-tasks) : intervalles explicites uniquement261 * [`/loop`](/fr/scheduled-tasks) : intervalles explicites uniquement

262 * [Zero Data Retention](/fr/zero-data-retention) : soumis à votre accord Azure262 * [Zero Data Retention](/fr/zero-data-retention) : soumis à votre accord Azure


275 Disponibilité par plan d'abonnement275 Disponibilité par plan d'abonnement

276</h2>276</h2>

277 277 

278Si vous vous authentifiez via Bedrock, Vertex AI, Foundry ou une clé API de la Console Anthropic, cette section ne s'applique pas à vous. Lorsque vous vous connectez avec un compte claude.ai, votre plan détermine les fonctionnalités ci-dessous qui sont disponibles.278Si vous vous authentifiez via Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry ou une clé API de la Console Anthropic, cette section ne s'applique pas à vous. Lorsque vous vous connectez avec un compte claude.ai, votre plan détermine les fonctionnalités ci-dessous qui sont disponibles.

279 279 

280| Fonctionnalité | Pro | Max | Team | Enterprise |280| Fonctionnalité | Pro | Max | Team | Enterprise |

281| :-------------------------------------------------------------------------------------- | :-- | :-- | :------------ | :-------------------------------- |281| :-------------------------------------------------------------------------------------- | :-- | :-- | :------------ | :-------------------------------- |


303 Disponibilité des modèles303 Disponibilité des modèles

304</h2>304</h2>

305 305 

306Pour connaître les modèles Claude et les tailles de fenêtre contextuelle disponibles par fournisseur et région, consultez [Configuration des modèles](/fr/model-config) et l'[aperçu des modèles](https://platform.claude.com/docs/en/about-claude/models/overview). Vision, entrée PDF et réflexion étendue sont des capacités de modèle plutôt que des fonctionnalités de Claude Code et fonctionnent chez chaque fournisseur qui propose le modèle. [Prompt caching](/fr/prompt-caching) fonctionne de la même manière chez la plupart des fournisseurs ; sur Bedrock, le support varie selon le modèle.306Pour connaître les modèles Claude et les tailles de fenêtre contextuelle disponibles par fournisseur et région, consultez [Configuration des modèles](/fr/model-config) et l'[aperçu des modèles](https://platform.claude.com/docs/en/about-claude/models/overview). Vision, entrée PDF et réflexion étendue sont des capacités de modèle plutôt que des fonctionnalités de Claude Code et fonctionnent chez chaque fournisseur qui propose le modèle. [Prompt caching](/fr/prompt-caching) fonctionne de la même manière chez la plupart des fournisseurs ; sur Amazon Bedrock, le support varie selon le modèle.

307 307 

308<h2 id="related-resources">308<h2 id="related-resources">

309 Ressources connexes309 Ressources connexes

310</h2>310</h2>

311 311 

312* [Aperçu du déploiement en entreprise](/fr/third-party-integrations) : comparez l'authentification, la facturation et les régions entre les fournisseurs312* [Aperçu du déploiement en entreprise](/fr/third-party-integrations) : comparez l'authentification, la facturation et les régions entre les fournisseurs

313* Guides de configuration des fournisseurs : [Amazon Bedrock](/fr/amazon-bedrock), [Claude Platform sur AWS](/fr/claude-platform-on-aws), [Google Vertex AI](/fr/google-vertex-ai), [Microsoft Foundry](/fr/microsoft-foundry)313* Guides de configuration des fournisseurs : [Amazon Bedrock](/fr/amazon-bedrock), [Claude Platform sur AWS](/fr/claude-platform-on-aws), [Google Cloud's Agent Platform](/fr/google-vertex-ai), [Microsoft Foundry](/fr/microsoft-foundry)

314* [Plateformes et intégrations](/fr/platforms) : où Claude Code s'exécute, y compris l'interface CLI, Desktop, les extensions IDE, le web, mobile et CI/CD314* [Plateformes et intégrations](/fr/platforms) : où Claude Code s'exécute, y compris l'interface CLI, Desktop, les extensions IDE, le web, mobile et CI/CD

fullscreen.md +3 −1

Details

172 172 

173Le rendu en plein écran est incompatible avec le mode d'intégration tmux d'iTerm2, qui est le mode dans lequel vous entrez avec `tmux -CC`. En mode intégration, iTerm2 rend chaque volet tmux comme une division native plutôt que de laisser tmux dessiner sur le terminal. Le tampon d'écran alternatif et le suivi de la souris ne fonctionnent pas correctement là : la molette de la souris ne fait rien, et le double-clic peut corrompre l'état du terminal. N'activez pas le rendu en plein écran dans les sessions `tmux -CC`. Le tmux régulier à l'intérieur d'iTerm2, sans `-CC`, fonctionne bien.173Le rendu en plein écran est incompatible avec le mode d'intégration tmux d'iTerm2, qui est le mode dans lequel vous entrez avec `tmux -CC`. En mode intégration, iTerm2 rend chaque volet tmux comme une division native plutôt que de laisser tmux dessiner sur le terminal. Le tampon d'écran alternatif et le suivi de la souris ne fonctionnent pas correctement là : la molette de la souris ne fait rien, et le double-clic peut corrompre l'état du terminal. N'activez pas le rendu en plein écran dans les sessions `tmux -CC`. Le tmux régulier à l'intérieur d'iTerm2, sans `-CC`, fonctionne bien.

174 174 

175tmux ne supporte pas la sortie synchronisée, donc vous pouvez voir plus de scintillement lors des redessins que lors de l'exécution de Claude Code directement dans votre terminal. Si le scintillement est notable, en particulier sur SSH, exécutez Claude Code dans son propre onglet de terminal en dehors de tmux.175Toutes les versions de tmux n'appliquent pas la sortie synchronisée des applications, donc vous pouvez voir plus de scintillement lors des redessins sous tmux que lors de l'exécution de Claude Code directement dans votre terminal. Si le scintillement est notable, en particulier sur SSH, mettez à niveau vers la dernière version de tmux ou exécutez Claude Code dans son propre onglet de terminal en dehors de tmux. Vérifiez votre version de tmux avec `tmux -V`.

176 

177{/* min-version: 2.1.200 */}Claude Code active la sortie synchronisée automatiquement lorsqu'il détecte tmux 3.4 ou version ultérieure à partir de la variable `TERM_PROGRAM_VERSION`, et revient à l'interrogation directe du terminal pour la prise en charge de la sortie synchronisée lorsque la version ne peut pas être déterminée. Le fait que les redessins deviennent réellement atomiques dépend de votre version de tmux respectant la sortie synchronisée ; si vous voyez toujours du scintillement sous tmux 3.4 ou version ultérieure, mettez à niveau vers la dernière version de tmux. Cette détection nécessite Claude Code v2.1.200 ou version ultérieure.

176 178 

177<h2 id="keep-native-text-selection">179<h2 id="keep-native-text-selection">

178 Conserver la sélection de texte natif180 Conserver la sélection de texte natif

github-actions.md +24 −24

Details

51<Note>51<Note>

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

53 * L'application GitHub demandera des permissions de lecture et d'écriture pour Contents, Issues et Pull requests53 * L'application GitHub demandera des permissions de lecture et d'écriture pour Contents, Issues et Pull requests

54 * Cette méthode de démarrage rapide n'est disponible que pour les utilisateurs directs de l'API Claude. Si vous utilisez Amazon Bedrock ou Google Vertex AI, veuillez consulter la section [Utilisation avec Amazon Bedrock et Google Vertex AI](#using-with-amazon-bedrock-%26-google-vertex-ai).54 * Cette méthode de démarrage rapide n'est disponible que pour les utilisateurs directs de l'API Claude. Si vous utilisez Amazon Bedrock ou Google Cloud's Agent Platform, veuillez consulter la section [Utilisation avec Amazon Bedrock et Google Cloud](#using-with-amazon-bedrock-and-google-cloud).

55</Note>55</Note>

56 56 

57<h2 id="manual-setup">57<h2 id="manual-setup">


320 Lorsque vous répondez à des commentaires d'issue ou de PR, Claude répond automatiquement aux mentions @claude. Pour les autres événements, utilisez le paramètre `prompt` pour fournir des instructions.320 Lorsque vous répondez à des commentaires d'issue ou de PR, Claude répond automatiquement aux mentions @claude. Pour les autres événements, utilisez le paramètre `prompt` pour fournir des instructions.

321</Tip>321</Tip>

322 322 

323<h2 id="using-with-amazon-bedrock--google-vertex-ai">323<h2 id="using-with-amazon-bedrock-and-google-cloud">

324 Utilisation avec Amazon Bedrock et Google Vertex AI324 Utilisation avec Amazon Bedrock et Google Cloud

325</h2>325</h2>

326 326 

327Pour les environnements d'entreprise, vous pouvez utiliser Claude Code GitHub Actions avec votre propre infrastructure cloud. Cette approche vous donne le contrôle sur la résidence des données et la facturation tout en maintenant les mêmes fonctionnalités.327Pour les environnements d'entreprise, vous pouvez utiliser Claude Code GitHub Actions avec votre propre infrastructure cloud. Cette approche vous donne le contrôle sur la résidence des données et la facturation tout en maintenant les mêmes fonctionnalités.


332 332 

333Avant de configurer Claude Code GitHub Actions avec les fournisseurs cloud, vous avez besoin de :333Avant de configurer Claude Code GitHub Actions avec les fournisseurs cloud, vous avez besoin de :

334 334 

335<h4 id="for-google-cloud-vertex-ai">335<h4 id="for-google-cloud’s-agent-platform">

336 Pour Google Cloud Vertex AI :336 Pour Google Cloud's Agent Platform :

337</h4>337</h4>

338 338 

3391. Un projet Google Cloud avec Vertex AI activé3391. Un projet Google Cloud avec Google Cloud's Agent Platform activé

3402. Workload Identity Federation configuré pour GitHub Actions3402. Workload Identity Federation configuré pour GitHub Actions

3413. Un compte de service avec les permissions requises3413. Un compte de service avec les permissions requises

3424. Une application GitHub (recommandée) ou utilisez le GITHUB\_TOKEN par défaut3424. Une application GitHub (recommandée) ou utilisez le GITHUB\_TOKEN par défaut


347 347 

3481. Un compte AWS avec Amazon Bedrock activé3481. Un compte AWS avec Amazon Bedrock activé

3492. GitHub OIDC Identity Provider configuré dans AWS3492. GitHub OIDC Identity Provider configuré dans AWS

3503. Un rôle IAM avec les permissions Bedrock3503. Un rôle IAM avec les permissions Amazon Bedrock

3514. Une application GitHub (recommandée) ou utilisez le GITHUB\_TOKEN par défaut3514. Une application GitHub (recommandée) ou utilisez le GITHUB\_TOKEN par défaut

352 352 

353<Steps>353<Steps>

354 <Step title="Créer une application GitHub personnalisée (Recommandée pour les fournisseurs tiers)">354 <Step title="Créer une application GitHub personnalisée (Recommandée pour les fournisseurs tiers)">

355 Pour un meilleur contrôle et une meilleure sécurité lors de l'utilisation de fournisseurs tiers comme Vertex AI ou Bedrock, nous recommandons de créer votre propre application GitHub :355 Pour un meilleur contrôle et une meilleure sécurité lors de l'utilisation de fournisseurs tiers comme Google Cloud's Agent Platform ou Amazon Bedrock, nous recommandons de créer votre propre application GitHub :

356 356 

357 1. Allez à [https://github.com/settings/apps/new](https://github.com/settings/apps/new)357 1. Allez à [https://github.com/settings/apps/new](https://github.com/settings/apps/new)

358 2. Remplissez les informations de base :358 2. Remplissez les informations de base :


428 Consultez la [documentation AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_providers_create_oidc.html) pour les instructions détaillées de configuration OIDC.428 Consultez la [documentation AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_providers_create_oidc.html) pour les instructions détaillées de configuration OIDC.

429 </Accordion>429 </Accordion>

430 430 

431 <Accordion title="Google Vertex AI">431 <Accordion title="Google Cloud's Agent Platform">

432 **Configurez Google Cloud pour permettre à GitHub Actions de s'authentifier de manière sécurisée sans stocker les credentials.**432 **Configurez Google Cloud pour permettre à GitHub Actions de s'authentifier de manière sécurisée sans stocker les credentials.**

433 433 

434 > **Note de sécurité** : Utilisez des configurations spécifiques au repository et accordez uniquement les permissions minimales requises.434 > **Note de sécurité** : Utilisez des configurations spécifiques au repository et accordez uniquement les permissions minimales requises.


438 1. **Activez les APIs** dans votre projet Google Cloud :438 1. **Activez les APIs** dans votre projet Google Cloud :

439 * IAM Credentials API439 * IAM Credentials API

440 * Security Token Service (STS) API440 * Security Token Service (STS) API

441 * Vertex AI API441 * Google Cloud's Agent Platform API

442 442 

443 2. **Créez les ressources Workload Identity Federation** :443 2. **Créez les ressources Workload Identity Federation** :

444 * Créez un Workload Identity Pool444 * Créez un Workload Identity Pool


483 * `APP_ID` : L'ID de votre application GitHub483 * `APP_ID` : L'ID de votre application GitHub

484 * `APP_PRIVATE_KEY` : Le contenu de la clé privée (.pem)484 * `APP_PRIVATE_KEY` : Le contenu de la clé privée (.pem)

485 485 

486 #### Pour Google Cloud Vertex AI486 #### Pour Google Cloud's Agent Platform

487 487 

488 1. **Pour l'authentification GCP** :488 1. **Pour l'authentification GCP** :

489 * `GCP_WORKLOAD_IDENTITY_PROVIDER`489 * `GCP_WORKLOAD_IDENTITY_PROVIDER`


504 </Step>504 </Step>

505 505 

506 <Step title="Créer des fichiers de flux de travail">506 <Step title="Créer des fichiers de flux de travail">

507 Créez des fichiers de flux de travail GitHub Actions qui s'intègrent à votre fournisseur cloud. Les exemples ci-dessous montrent des configurations complètes pour AWS Bedrock et Google Vertex AI :507 Créez des fichiers de flux de travail GitHub Actions qui s'intègrent à votre fournisseur cloud. Les exemples ci-dessous montrent des configurations complètes pour Amazon Bedrock et Google Cloud's Agent Platform :

508 508 

509 <AccordionGroup>509 <AccordionGroup>

510 <Accordion title="Flux de travail AWS Bedrock">510 <Accordion title="Flux de travail Amazon Bedrock">

511 **Prérequis :**511 **Prérequis :**

512 512 

513 * Accès AWS Bedrock activé avec permissions de modèle Claude513 * Accès Amazon Bedrock activé avec permissions de modèle Claude

514 * GitHub configuré en tant que fournisseur d'identité OIDC dans AWS514 * GitHub configuré en tant que fournisseur d'identité OIDC dans AWS

515 * Rôle IAM avec permissions Bedrock qui fait confiance à GitHub Actions515 * Rôle IAM avec permissions Amazon Bedrock qui fait confiance à GitHub Actions

516 516 

517 **Secrets GitHub requis :**517 **Secrets GitHub requis :**

518 518 

519 | Nom du secret | Description |519 | Nom du secret | Description |

520 | -------------------- | ------------------------------------------------------------------------ |520 | -------------------- | ------------------------------------------------------------------------ |

521 | `AWS_ROLE_TO_ASSUME` | ARN du rôle IAM pour l'accès à Bedrock |521 | `AWS_ROLE_TO_ASSUME` | ARN du rôle IAM pour l'accès à Amazon Bedrock |

522 | `APP_ID` | Votre ID d'application GitHub (à partir des paramètres de l'application) |522 | `APP_ID` | Votre ID d'application GitHub (à partir des paramètres de l'application) |

523 | `APP_PRIVATE_KEY` | La clé privée que vous avez générée pour votre application GitHub |523 | `APP_PRIVATE_KEY` | La clé privée que vous avez générée pour votre application GitHub |

524 524 


573 ```573 ```

574 574 

575 <Tip>575 <Tip>

576 Le format d'ID de modèle pour Bedrock inclut un préfixe de région (par exemple, `us.anthropic.claude-sonnet-4-6`).576 Le format d'ID de modèle pour Amazon Bedrock inclut un préfixe de région (par exemple, `us.anthropic.claude-sonnet-4-6`).

577 </Tip>577 </Tip>

578 </Accordion>578 </Accordion>

579 579 

580 <Accordion title="Flux de travail Google Vertex AI">580 <Accordion title="Flux de travail Google Cloud's Agent Platform">

581 **Prérequis :**581 **Prérequis :**

582 582 

583 * Vertex AI API activée dans votre projet GCP583 * Google Cloud's Agent Platform API activée dans votre projet GCP

584 * Workload Identity Federation configurée pour GitHub584 * Workload Identity Federation configurée pour GitHub

585 * Compte de service avec permissions Vertex AI585 * Compte de service avec permissions Google Cloud's Agent Platform

586 586 

587 **Secrets GitHub requis :**587 **Secrets GitHub requis :**

588 588 

589 | Nom du secret | Description |589 | Nom du secret | Description |

590 | -------------------------------- | ------------------------------------------------------------------------ |590 | -------------------------------- | ------------------------------------------------------------------------ |

591 | `GCP_WORKLOAD_IDENTITY_PROVIDER` | Nom de ressource du fournisseur d'identité de charge de travail |591 | `GCP_WORKLOAD_IDENTITY_PROVIDER` | Nom de ressource du fournisseur d'identité de charge de travail |

592 | `GCP_SERVICE_ACCOUNT` | E-mail du compte de service avec accès à Vertex AI |592 | `GCP_SERVICE_ACCOUNT` | E-mail du compte de service avec accès à Google Cloud's Agent Platform |

593 | `APP_ID` | Votre ID d'application GitHub (à partir des paramètres de l'application) |593 | `APP_ID` | Votre ID d'application GitHub (à partir des paramètres de l'application) |

594 | `APP_PRIVATE_KEY` | La clé privée que vous avez générée pour votre application GitHub |594 | `APP_PRIVATE_KEY` | La clé privée que vous avez générée pour votre application GitHub |

595 595 


675 Erreurs d'authentification675 Erreurs d'authentification

676</h3>676</h3>

677 677 

678Confirmez que la clé API est valide et dispose des permissions suffisantes. Pour Bedrock/Vertex, vérifiez la configuration des credentials et assurez-vous que les secrets sont nommés correctement dans les flux de travail.678Confirmez que la clé API est valide et dispose des permissions suffisantes. Pour Amazon Bedrock ou la plateforme Agent de Google Cloud, vérifiez la configuration des credentials et assurez-vous que les secrets sont nommés correctement dans les flux de travail.

679 679 

680<h2 id="advanced-configuration">680<h2 id="advanced-configuration">

681 Configuration avancée681 Configuration avancée


697| `github_token` | Token GitHub pour l'accès API | Non |697| `github_token` | Token GitHub pour l'accès API | Non |

698| `trigger_phrase` | Phrase de déclenchement personnalisée (par défaut : « @claude ») | Non |698| `trigger_phrase` | Phrase de déclenchement personnalisée (par défaut : « @claude ») | Non |

699| `use_bedrock` | Utiliser Amazon Bedrock au lieu de l'API Claude | Non |699| `use_bedrock` | Utiliser Amazon Bedrock au lieu de l'API Claude | Non |

700| `use_vertex` | Utiliser Google Vertex AI au lieu de l'API Claude | Non |700| `use_vertex` | Utiliser Google Cloud's Agent Platform au lieu de l'API Claude | Non |

701 701 

702\*Le prompt est optionnel - lorsqu'il est omis pour les commentaires d'issue/PR, Claude répond à la phrase de déclenchement\702\*Le prompt est optionnel - lorsqu'il est omis pour les commentaires d'issue/PR, Claude répond à la phrase de déclenchement\

703\*\*Requis pour l'API Claude directe, pas pour Bedrock/Vertex703\*\*Requis pour l'API Claude directe, pas pour Amazon Bedrock ou Google Cloud's Agent Platform

704 704 

705<h4 id="pass-cli-arguments">705<h4 id="pass-cli-arguments">

706 Passer les arguments CLI706 Passer les arguments CLI

Details

10 Le support de GitHub Enterprise Server est disponible pour les plans Team et Enterprise.10 Le support de GitHub Enterprise Server est disponible pour les plans Team et Enterprise.

11</Note>11</Note>

12 12 

13Le support de GitHub Enterprise Server (GHES) permet à votre organisation d'utiliser Claude Code avec des dépôts hébergés sur votre instance GitHub auto-gérée au lieu de github.com. Une fois qu'un administrateur connecte votre instance GHES, les développeurs peuvent exécuter des sessions web, obtenir des révisions de code automatisées et installer des plugins à partir de marketplaces internes sans aucune configuration par dépôt.13Le support de GitHub Enterprise Server (GHES) permet à votre organisation d'utiliser Claude Code avec des dépôts hébergés sur votre instance GitHub auto-gérée au lieu de github.com. Une fois qu'un propriétaire connecte votre instance GHES, les développeurs peuvent exécuter des sessions web et obtenir des révisions de code automatisées sans aucune configuration par dépôt. Les marketplaces de plugins hébergées sur votre instance sont également pris en charge ; les exigences en matière d'identifiants varient selon la surface, comme décrit dans [Plugin marketplaces on GHES](#plugin-marketplaces-on-ghes).

14 14 

15Pour les dépôts sur github.com, consultez [Claude Code sur le web](/fr/claude-code-on-the-web) et [Révision de code](/fr/code-review). Pour exécuter Claude dans votre propre infrastructure CI, consultez [GitHub Actions](/fr/github-actions).15Pour les dépôts sur github.com, consultez [Claude Code sur le web](/fr/claude-code-on-the-web) et [Révision de code](/fr/code-review). Pour exécuter Claude dans votre propre infrastructure CI, consultez [GitHub Actions](/fr/github-actions).

16 16 


21Le tableau ci-dessous montre quelles fonctionnalités de Claude Code supportent GHES et les différences éventuelles par rapport au comportement de github.com.21Le tableau ci-dessous montre quelles fonctionnalités de Claude Code supportent GHES et les différences éventuelles par rapport au comportement de github.com.

22 22 

23| Fonctionnalité | Support GHES | Notes |23| Fonctionnalité | Support GHES | Notes |

24| :------------------------ | :------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------ |24| :------------------------ | :------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------- |

25| Claude Code sur le web | ✅ Supporté | Un propriétaire connecte l'instance GHES une fois ; les développeurs utilisent `claude --remote` ou [claude.ai/code](https://claude.ai/code) comme d'habitude |25| Claude Code sur le web | ✅ Supporté | Un propriétaire connecte l'instance GHES une fois ; les développeurs utilisent `claude --cloud` ou [claude.ai/code](https://claude.ai/code) comme d'habitude |

26| Révision de code | ✅ Supporté | Mêmes révisions de PR automatisées que github.com |26| Révision de code | ✅ Supporté | Mêmes révisions de PR automatisées que github.com |

27| Claude Security | ✅ Supporté | Disponible en bêta publique pour les plans Enterprise à [claude.ai/security](https://claude.ai/security) |27| Claude Security | ✅ Supporté | Disponible en bêta publique pour les plans Enterprise à [claude.ai/security](https://claude.ai/security) |

28| Sessions Teleport | ✅ Supporté | Déplacez les sessions entre le web et le terminal avec `--teleport` |28| Sessions Teleport | ✅ Supporté | Déplacez les sessions entre le web et le terminal avec `--teleport` |

29| Marketplaces de plugins | ✅ Supporté | Utilisez les URL git complètes au lieu du raccourci `owner/repo` |29| Marketplaces de plugins | ✅ Supporté | Les exigences en matière d'identifiants varient selon la surface. Voir [Marketplaces de plugins sur GHES](#plugin-marketplaces-on-ghes) |

30| Métriques de contribution | ✅ Supporté | Livrées via webhooks au [tableau de bord d'analyse](/fr/analytics) |30| Métriques de contribution | ✅ Supporté | Livrées via webhooks au [tableau de bord d'analyse](/fr/analytics) |

31| GitHub Actions | ✅ Supporté | Nécessite une configuration manuelle du workflow ; `/install-github-app` est github.com uniquement |31| GitHub Actions | ✅ Supporté | Nécessite une configuration manuelle du workflow ; `/install-github-app` est github.com uniquement |

32| Serveur GitHub MCP | ❌ Non supporté | Le serveur GitHub MCP ne fonctionne pas avec les instances GHES |32| Serveur GitHub MCP | ❌ Non supporté | Le serveur GitHub MCP ne fonctionne pas avec les instances GHES |


107Ensuite, démarrez une session web. Claude détecte l'hôte GHES à partir de votre télécommande git et achemine la session via votre instance configurée de l'organisation :107Ensuite, démarrez une session web. Claude détecte l'hôte GHES à partir de votre télécommande git et achemine la session via votre instance configurée de l'organisation :

108 108 

109```bash theme={null}109```bash theme={null}

110claude --remote "Add retry logic to the payment webhook handler"110claude --cloud "Add retry logic to the payment webhook handler"

111```111```

112 112 

113La session s'exécute sur l'infrastructure Anthropic, clone votre dépôt à partir de GHES et repousse les modifications vers une branche. Surveillez la progression avec `/tasks` ou à [claude.ai/code](https://claude.ai/code). Consultez [Claude Code sur le web](/fr/claude-code-on-the-web) pour le flux de travail complet de la session distante, y compris la révision des différences, la correction automatique et les routines.113La session s'exécute sur l'infrastructure Anthropic, clone votre dépôt à partir de GHES et repousse les modifications vers une branche. Surveillez la progression avec `/tasks` ou à [claude.ai/code](https://claude.ai/code). Consultez [Claude Code sur le web](/fr/claude-code-on-the-web) pour le flux de travail complet de la session distante, y compris la révision des différences, la correction automatique et les routines.


122 Marketplaces de plugins sur GHES122 Marketplaces de plugins sur GHES

123</h2>123</h2>

124 124 

125Hébergez des marketplaces de plugins sur votre instance GHES pour distribuer les outils internes dans votre organisation. La structure de la marketplace est identique aux marketplaces hébergées sur github.com ; la seule différence est la façon dont vous les référencez.125Hébergez des marketplaces de plugins sur votre instance GHES pour distribuer les outils internes dans votre organisation. La structure de la marketplace est identique aux marketplaces hébergées sur github.com, mais l'installation fonctionne différemment selon l'endroit où vous ajoutez la marketplace, et les identifiants varient selon les surfaces :

126 

127| Surface | Fonctionnement de l'installation | Ce dont chaque utilisateur a besoin |

128| :----------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

129| Claude Code CLI et bureau | Claude Code clone le dépôt de la marketplace en utilisant les identifiants git existants de la machine | Accès Git à votre hôte GHES depuis leur machine |

130| Paramètres gérés (`extraKnownMarketplaces`) | Claude Code enregistre l'entrée et clone le dépôt en utilisant les identifiants git existants de la machine | Accès Git à votre hôte GHES depuis leur machine |

131| Paramètres de plugin de l'organisation claude.ai | Un propriétaire sélectionne l'instance GHES comme source ; le backend d'Anthropic récupère et synchronise le dépôt en utilisant l'application GitHub de la [configuration d'administration](#admin-setup) | Rien par utilisateur une fois ajouté. Le propriétaire qui l'ajoute doit avoir son propre compte GitHub Enterprise connecté comme vérification d'accès, et l'application GitHub doit être installée sur le dépôt de la marketplace |

132| Paramètres utilisateur claude.ai | Le backend d'Anthropic récupère le dépôt en utilisant la connexion GitHub Enterprise de l'utilisateur qui le soumet | Son propre compte GitHub Enterprise connecté à Claude |

133| Claude Code sur le web | Les sessions cloud clonent les marketplaces à l'intérieur du sandbox de la session. Le sandbox ne peut atteindre votre instance GHES que lorsque le dépôt de la session se trouve sur cette même instance, et ses identifiants git sont limités aux dépôts de la session | Non fiable pour les marketplaces hébergées sur GHES : un hôte différent du dépôt de la session n'est pas accessible, et même les installations sur la même instance peuvent échouer. Utilisez plutôt la CLI, les paramètres gérés ou claude.ai |

134 

135<Warning>

136 Les connexions GitHub Enterprise sur claude.ai sont par utilisateur lorsqu'une marketplace est ajoutée à partir des paramètres utilisateur. La [configuration d'administration](#admin-setup) connecte votre instance GHES à votre organisation, mais elle ne connecte pas les comptes utilisateur individuels : chaque utilisateur qui ajoute une marketplace GHES à partir de ses propres paramètres doit d'abord connecter son propre compte GitHub Enterprise, et la connexion d'un utilisateur, y compris celle du propriétaire, ne couvre personne d'autre. Les marketplaces ajoutées par un propriétaire dans les paramètres de plugin de l'organisation ne mettent pas cette exigence sur les utilisateurs, car les récupérations continues utilisent l'application GitHub de l'organisation. Le propriétaire qui ajoute la marketplace doit toujours avoir son propre compte GitHub Enterprise connecté au moment de l'ajout.

137</Warning>

126 138 

127<h3 id="add-a-ghes-marketplace">139<h3 id="add-a-ghes-marketplace">

128 Ajouter une marketplace GHES140 Ajouter une marketplace GHES

129</h3>141</h3>

130 142 

131Le raccourci `owner/repo` se résout toujours en github.com. Pour les marketplaces hébergées sur GHES, utilisez l'URL git complète :143Le raccourci `owner/repo` se résout toujours en github.com. Pour les marketplaces hébergées sur GHES, utilisez l'URL git complète. Les URL HTTPS sont recommandées :

132 144 

133```bash theme={null}145```bash theme={null}

134/plugin marketplace add git@github.example.com:platform/claude-plugins.git146/plugin marketplace add https://github.example.com/platform/claude-plugins.git

135```147```

136 148 

137Les URL HTTPS fonctionnent également :149Les URL SSH fonctionnent si la machine fait déjà confiance à votre hôte GHES :

138 150 

139```bash theme={null}151```bash theme={null}

140/plugin marketplace add https://github.example.com/platform/claude-plugins.git152/plugin marketplace add git@github.example.com:platform/claude-plugins.git

141```153```

142 154 

155Claude Code exécute git de manière non-interactive et rejette les connexions SSH aux hôtes qui ne figurent pas dans le fichier `known_hosts` de la machine. Une URL HTTPS avec un assistant d'identifiants git évite l'exigence `known_hosts`.

156 

143Consultez [Créer et distribuer une marketplace de plugins](/fr/plugin-marketplaces) pour le guide complet de la création de marketplaces.157Consultez [Créer et distribuer une marketplace de plugins](/fr/plugin-marketplaces) pour le guide complet de la création de marketplaces.

144 158 

159<h3 id="pre-register-ghes-marketplaces-with-managed-settings">

160 Pré-enregistrer les marketplaces GHES avec les paramètres gérés

161</h3>

162 

163Le paramètre `extraKnownMarketplaces` pré-enregistre une marketplace afin que les développeurs l'obtiennent sans configuration manuelle. Il fonctionne à partir de [n'importe quel fichier de paramètres](/fr/settings#extraknownmarketplaces), y compris le `.claude/settings.json` d'un dépôt ; les paramètres gérés le livrent à l'échelle de l'organisation :

164 

165```json theme={null}

166{

167 "extraKnownMarketplaces": {

168 "internal-tools": {

169 "source": {

170 "source": "git",

171 "url": "https://github.example.com/platform/claude-plugins.git"

172 }

173 }

174 }

175}

176```

177 

178Claude Code installe ces marketplaces localement : il enregistre chaque entrée et clone le dépôt avec les identifiants git existants de la machine. Ce chemin ne passe pas par claude.ai, donc la connexion GitHub Enterprise par utilisateur n'est pas requise. Pour un déploiement réussi :

179 

180* **Utilisez une URL git complète.** Le raccourci `owner/repo` se résout toujours en github.com et ne peut pas référencer un hôte GHES.

181* **Préférez les URL HTTPS.** Les clones SSH échouent sur les machines qui ne font pas déjà confiance à votre clé d'hôte GHES. Une URL HTTPS avec l'assistant d'identifiants git standard de votre organisation fonctionne sur n'importe quelle machine avec des identifiants configurés.

182* **Confirmez que chaque machine peut cloner à partir de votre hôte GHES.** Si une machine manque d'identifiants, la marketplace est enregistrée mais jamais installée, et ses plugins signalent qu'ils ne sont pas trouvés au lieu de demander des identifiants.

183* **Confirmez que le paramètre atteint chaque machine.** Un fichier de paramètres gérés ne prend effet que sur les machines sur lesquelles il est déployé, par exemple via votre système de gestion des appareils. Consultez [paramètres gérés](/fr/settings#settings-files) pour les emplacements des fichiers.

184 

145<h3 id="allowlist-ghes-marketplaces-in-managed-settings">185<h3 id="allowlist-ghes-marketplaces-in-managed-settings">

146 Mettre en liste blanche les marketplaces GHES dans les paramètres gérés186 Mettre en liste blanche les marketplaces GHES dans les paramètres gérés

147</h3>187</h3>


159}199}

160```200```

161 201 

162Vous pouvez également pré-enregistrer les marketplaces pour les développeurs afin qu'elles apparaissent sans configuration manuelle. Cet exemple rend une marketplace d'outils internes disponible à l'échelle de l'organisation :

163 

164```json theme={null}

165{

166 "extraKnownMarketplaces": {

167 "internal-tools": {

168 "source": {

169 "source": "git",

170 "url": "git@github.example.com:platform/claude-plugins.git"

171 }

172 }

173 }

174}

175```

176 

177Consultez la référence des paramètres [strictKnownMarketplaces](/fr/settings#strictknownmarketplaces) et [extraKnownMarketplaces](/fr/settings#extraknownmarketplaces) pour le schéma complet.202Consultez la référence des paramètres [strictKnownMarketplaces](/fr/settings#strictknownmarketplaces) et [extraKnownMarketplaces](/fr/settings#extraknownmarketplaces) pour le schéma complet.

178 203 

179<h2 id="limitations">204<h2 id="limitations">


193 La session web échoue à cloner le dépôt218 La session web échoue à cloner le dépôt

194</h3>219</h3>

195 220 

196Si `claude --remote` échoue avec une erreur de clonage, vérifiez qu'un propriétaire a terminé la configuration de votre instance GHES et que la GitHub App est installée sur le dépôt sur lequel vous travaillez. Demandez au propriétaire qui a connecté l'instance de confirmer que le nom d'hôte enregistré dans les paramètres Claude correspond au nom d'hôte de votre télécommande git.221Si `claude --cloud` échoue avec une erreur de clonage, vérifiez qu'un propriétaire a terminé la configuration de votre instance GHES et que la GitHub App est installée sur le dépôt sur lequel vous travaillez. Demandez au propriétaire qui a connecté l'instance de confirmer que le nom d'hôte enregistré dans les paramètres Claude correspond au nom d'hôte de votre télécommande git.

197 222 

198<h3 id="marketplace-add-fails-with-a-policy-error">223<h3 id="marketplace-add-fails-with-a-policy-error">

199 L'ajout de marketplace échoue avec une erreur de politique224 L'ajout de marketplace échoue avec une erreur de politique


201 226 

202Si `/plugin marketplace add` est bloqué pour votre URL GHES, votre organisation a restreint les sources de marketplace. Demandez à votre administrateur d'ajouter une entrée `hostPattern` pour le nom d'hôte de votre GHES dans les [paramètres gérés](#allowlist-ghes-marketplaces-in-managed-settings).227Si `/plugin marketplace add` est bloqué pour votre URL GHES, votre organisation a restreint les sources de marketplace. Demandez à votre administrateur d'ajouter une entrée `hostPattern` pour le nom d'hôte de votre GHES dans les [paramètres gérés](#allowlist-ghes-marketplaces-in-managed-settings).

203 228 

229<h3 id="marketplace-add-on-claude-ai-fails-with-a-github-access-error">

230 L'ajout de marketplace sur claude.ai échoue avec une erreur d'accès GitHub

231</h3>

232 

233Si l'ajout d'un marketplace GHES à partir de vos paramètres utilisateur échoue avec une erreur générique comme « Marketplace n'a pas pu être ajouté », vérifiez d'abord votre connexion GitHub Enterprise. C'est ce qui s'affiche lorsque votre propre compte GitHub Enterprise n'est pas connecté à Claude, même si l'instance GHES de votre organisation est configurée et que d'autres utilisateurs sont connectés. La boîte de dialogue ne pointe pas vers le flux de connexion GitHub Enterprise, et l'option « Se connecter à GitHub » sur l'onglet Parcourir se connecte à github.com, ce qui n'accorde pas l'accès aux dépôts GHES.

234 

235Pour connecter votre compte GitHub Enterprise : le sélecteur de dépôt sur [claude.ai/code](https://claude.ai/code) offre une option de connexion pour chaque instance GHES configurée, et les propriétaires peuvent également se connecter à partir de la section GitHub Enterprise des [paramètres d'administration Claude Code](https://claude.ai/admin-settings/claude-code). Ensuite, ajoutez le marketplace à nouveau. Vous pouvez également demander à un propriétaire d'ajouter le marketplace dans les paramètres de plugin de l'organisation, ce qui supprime l'exigence de connexion par utilisateur.

236 

237Sur d'autres surfaces claude.ai, une erreur « Dépôt non trouvé. S'il est privé, l'accès GitHub est requis » sur un marketplace GHES indique généralement la même connexion manquante. Connectez votre compte GitHub Enterprise via l'un des chemins ci-dessus, puis réessayez.

238 

204<h3 id="ghes-instance-not-reachable">239<h3 id="ghes-instance-not-reachable">

205 Instance GHES non accessible240 Instance GHES non accessible

206</h3>241</h3>

gitlab-ci-cd.md +30 −30

Details

24* **Implémentation automatisée** : Transformez les problèmes en code fonctionnel avec une seule commande ou mention24* **Implémentation automatisée** : Transformez les problèmes en code fonctionnel avec une seule commande ou mention

25* **Conscient du projet** : Claude suit vos directives `CLAUDE.md` et les modèles de code existants25* **Conscient du projet** : Claude suit vos directives `CLAUDE.md` et les modèles de code existants

26* **Configuration simple** : Ajoutez une tâche à `.gitlab-ci.yml` et une variable CI/CD masquée26* **Configuration simple** : Ajoutez une tâche à `.gitlab-ci.yml` et une variable CI/CD masquée

27* **Prêt pour l'entreprise** : Choisissez Claude API, Amazon Bedrock ou Google Vertex AI pour répondre aux besoins de résidence des données et d'approvisionnement27* **Prêt pour l'entreprise** : Choisissez Claude API, Amazon Bedrock ou Google Cloud's Agent Platform pour répondre aux besoins de résidence des données et d'approvisionnement

28* **Sécurisé par défaut** : S'exécute dans vos exécuteurs GitLab avec votre protection de branche et vos approbations28* **Sécurisé par défaut** : S'exécute dans vos exécuteurs GitLab avec votre protection de branche et vos approbations

29 29 

30<h2 id="how-it-works">30<h2 id="how-it-works">


382. **Abstraction du fournisseur** : Utilisez le fournisseur qui correspond à votre environnement :382. **Abstraction du fournisseur** : Utilisez le fournisseur qui correspond à votre environnement :

39 * Claude API (SaaS)39 * Claude API (SaaS)

40 * Amazon Bedrock (accès basé sur IAM, options multi-régions)40 * Amazon Bedrock (accès basé sur IAM, options multi-régions)

41 * Google Vertex AI (natif GCP, Workload Identity Federation)41 * Google Cloud's Agent Platform (natif GCP, Workload Identity Federation)

42 42 

433. **Exécution en bac à sable** : Chaque interaction s'exécute dans un conteneur avec des règles strictes de réseau et de système de fichiers. Claude Code applique des autorisations limitées à l'espace de travail pour limiter les écritures. Chaque modification passe par une MR afin que les examinateurs voient la différence et que les approbations s'appliquent toujours.433. **Exécution en bac à sable** : Chaque interaction s'exécute dans un conteneur avec des règles strictes de réseau et de système de fichiers. Claude Code applique des autorisations limitées à l'espace de travail pour limiter les écritures. Chaque modification passe par une MR afin que les examinateurs voient la différence et que les approbations s'appliquent toujours.

44 44 


108Après avoir ajouté la tâche et votre variable `ANTHROPIC_API_KEY`, testez en exécutant la tâche manuellement à partir de **CI/CD** → **Pipelines**, ou déclenchez-la à partir d'une MR pour laisser Claude proposer des mises à jour dans une branche et ouvrir une MR si nécessaire.108Après avoir ajouté la tâche et votre variable `ANTHROPIC_API_KEY`, testez en exécutant la tâche manuellement à partir de **CI/CD** → **Pipelines**, ou déclenchez-la à partir d'une MR pour laisser Claude proposer des mises à jour dans une branche et ouvrir une MR si nécessaire.

109 109 

110<Note>110<Note>

111 Pour exécuter sur Amazon Bedrock ou Google Vertex AI au lieu de Claude API, consultez la section [Utilisation avec Amazon Bedrock et Google Vertex AI](#using-with-amazon-bedrock-%26-google-vertex-ai) ci-dessous pour la configuration de l'authentification et de l'environnement.111 Pour exécuter sur Amazon Bedrock ou Google Cloud's Agent Platform au lieu de Claude API, consultez la section [Utilisation avec Amazon Bedrock et Google Cloud](#using-with-amazon-bedrock-and-google-cloud) ci-dessous pour la configuration de l'authentification et de l'environnement.

112</Note>112</Note>

113 113 

114<h3 id="manual-setup-recommended-for-production">114<h3 id="manual-setup-recommended-for-production">


119 119 

1201. **Configurer l'accès au fournisseur** :1201. **Configurer l'accès au fournisseur** :

121 * **Claude API** : Créez et stockez `ANTHROPIC_API_KEY` comme variable CI/CD masquée121 * **Claude API** : Créez et stockez `ANTHROPIC_API_KEY` comme variable CI/CD masquée

122 * **Amazon Bedrock** : **Configurer GitLab** → **AWS OIDC** et créer un rôle IAM pour Bedrock122 * **Amazon Bedrock** : **Configurer GitLab** → **AWS OIDC** et créer un rôle IAM pour Amazon Bedrock

123 * **Google Vertex AI** : **Configurer Workload Identity Federation pour GitLab** → **GCP**123 * **Google Cloud's Agent Platform** : **Configurer Workload Identity Federation pour GitLab** → **GCP**

124 124 

1252. **Ajouter les identifiants du projet pour les opérations de l'API GitLab** :1252. **Ajouter les identifiants du projet pour les opérations de l'API GitLab** :

126 * Utilisez `CI_JOB_TOKEN` par défaut, ou créez un jeton d'accès au projet avec la portée `api`126 * Utilisez `CI_JOB_TOKEN` par défaut, ou créez un jeton d'accès au projet avec la portée `api`


172 172 

173Claude localise le bogue, implémente un correctif et met à jour la branche ou ouvre une nouvelle MR.173Claude localise le bogue, implémente un correctif et met à jour la branche ou ouvre une nouvelle MR.

174 174 

175<h2 id="using-with-amazon-bedrock--google-vertex-ai">175<h2 id="using-with-amazon-bedrock-and-google-cloud">

176 Utilisation avec Amazon Bedrock et Google Vertex AI176 Utilisation avec Amazon Bedrock et Google Cloud

177</h2>177</h2>

178 178 

179Pour les environnements d'entreprise, vous pouvez exécuter Claude Code entièrement sur votre infrastructure cloud avec la même expérience développeur.179Pour les environnements d'entreprise, vous pouvez exécuter Claude Code entièrement sur votre infrastructure cloud avec la même expérience développeur.


186 186 

187 1. Un compte AWS avec accès à Amazon Bedrock pour les modèles Claude souhaités187 1. Un compte AWS avec accès à Amazon Bedrock pour les modèles Claude souhaités

188 2. GitLab configuré comme fournisseur d'identité OIDC dans AWS IAM188 2. GitLab configuré comme fournisseur d'identité OIDC dans AWS IAM

189 3. Un rôle IAM avec les autorisations Bedrock et une politique de confiance limitée à votre projet/références GitLab189 3. Un rôle IAM avec les autorisations Amazon Bedrock et une politique de confiance limitée à votre projet/références GitLab

190 4. Variables CI/CD GitLab pour l'assomption de rôle :190 4. Variables CI/CD GitLab pour l'assomption de rôle :

191 * `AWS_ROLE_TO_ASSUME` (ARN du rôle)191 * `AWS_ROLE_TO_ASSUME` (ARN du rôle)

192 * `AWS_REGION` (région Bedrock)192 * `AWS_REGION` (région Amazon Bedrock)

193 193 

194 ### Instructions de configuration194 ### Instructions de configuration

195 195 


200 1. Activez Amazon Bedrock et demandez l'accès à vos modèles Claude cibles200 1. Activez Amazon Bedrock et demandez l'accès à vos modèles Claude cibles

201 2. Créez un fournisseur OIDC IAM pour GitLab s'il n'existe pas déjà201 2. Créez un fournisseur OIDC IAM pour GitLab s'il n'existe pas déjà

202 3. Créez un rôle IAM approuvé par le fournisseur OIDC GitLab, limité à votre projet et aux références protégées202 3. Créez un rôle IAM approuvé par le fournisseur OIDC GitLab, limité à votre projet et aux références protégées

203 4. Attachez les autorisations de moindre privilège pour les API d'invocation Bedrock203 4. Attachez les autorisations de moindre privilège pour les API d'invocation Amazon Bedrock

204 204 

205 **Valeurs requises à stocker dans les variables CI/CD :**205 **Valeurs requises à stocker dans les variables CI/CD :**

206 206 


218 Utilisez l'exemple de tâche Amazon Bedrock ci-dessus pour échanger le jeton de tâche GitLab contre des identifiants AWS temporaires au moment de l'exécution.218 Utilisez l'exemple de tâche Amazon Bedrock ci-dessus pour échanger le jeton de tâche GitLab contre des identifiants AWS temporaires au moment de l'exécution.

219 </Tab>219 </Tab>

220 220 

221 <Tab title="Google Vertex AI">221 <Tab title="Google Cloud's Agent Platform">

222 ### Conditions préalables222 ### Conditions préalables

223 223 

224 Avant de configurer Claude Code avec Google Vertex AI, vous avez besoin de :224 Avant de configurer Claude Code avec Google Cloud's Agent Platform, vous avez besoin de :

225 225 

226 1. Un projet Google Cloud avec :226 1. Un projet Google Cloud avec :

227 * API Vertex AI activée227 * API Google Cloud's Agent Platform activée

228 * Workload Identity Federation configurée pour faire confiance à GitLab OIDC228 * Workload Identity Federation configurée pour faire confiance à GitLab OIDC

229 2. Un compte de service dédié avec uniquement les rôles Vertex AI requis229 2. Un compte de service dédié avec uniquement les rôles Google Cloud's Agent Platform requis

230 3. Variables CI/CD GitLab pour WIF :230 3. Variables CI/CD GitLab pour WIF :

231 * `GCP_WORKLOAD_IDENTITY_PROVIDER` (nom complet de la ressource)231 * `GCP_WORKLOAD_IDENTITY_PROVIDER` (nom complet de la ressource)

232 * `GCP_SERVICE_ACCOUNT` (e-mail du compte de service)232 * `GCP_SERVICE_ACCOUNT` (e-mail du compte de service)


237 237 

238 **Configuration requise :**238 **Configuration requise :**

239 239 

240 1. Activez l'API IAM Credentials, l'API STS et l'API Vertex AI240 1. Activez l'API IAM Credentials, l'API STS et l'API Google Cloud's Agent Platform

241 2. Créez un pool Workload Identity et un fournisseur pour GitLab OIDC241 2. Créez un pool Workload Identity et un fournisseur pour GitLab OIDC

242 3. Créez un compte de service dédié avec les rôles Vertex AI242 3. Créez un compte de service dédié avec les rôles Google Cloud's Agent Platform

243 4. Accordez au principal WIF la permission d'emprunter l'identité du compte de service243 4. Accordez au principal WIF la permission d'emprunter l'identité du compte de service

244 244 

245 **Valeurs requises à stocker dans les variables CI/CD :**245 **Valeurs requises à stocker dans les variables CI/CD :**


250 Ajoutez les variables dans Paramètres → CI/CD → Variables :250 Ajoutez les variables dans Paramètres → CI/CD → Variables :

251 251 

252 ```yaml theme={null}252 ```yaml theme={null}

253 # Pour Google Vertex AI :253 # Pour Google Cloud's Agent Platform :

254 - GCP_WORKLOAD_IDENTITY_PROVIDER254 - GCP_WORKLOAD_IDENTITY_PROVIDER

255 - GCP_SERVICE_ACCOUNT255 - GCP_SERVICE_ACCOUNT

256 - CLOUD_ML_REGION (par exemple, us-east5)256 - CLOUD_ML_REGION (par exemple, us-east5)

257 ```257 ```

258 258 

259 Utilisez l'exemple de tâche Google Vertex AI ci-dessus pour vous authentifier sans stocker de clés.259 Utilisez l'exemple de tâche Google Cloud's Agent Platform ci-dessus pour vous authentifier sans stocker de clés.

260 </Tab>260 </Tab>

261</Tabs>261</Tabs>

262 262 


305 305 

306* Amazon Bedrock activé avec accès à votre ou vos modèles Claude choisis306* Amazon Bedrock activé avec accès à votre ou vos modèles Claude choisis

307* GitLab OIDC configuré dans AWS avec un rôle qui fait confiance à votre projet et vos références GitLab307* GitLab OIDC configuré dans AWS avec un rôle qui fait confiance à votre projet et vos références GitLab

308* Rôle IAM avec autorisations Bedrock (moindre privilège recommandé)308* Rôle IAM avec autorisations Amazon Bedrock (moindre privilège recommandé)

309 309 

310**Variables CI/CD requises :**310**Variables CI/CD requises :**

311 311 

312* `AWS_ROLE_TO_ASSUME` : ARN du rôle IAM pour l'accès à Bedrock312* `AWS_ROLE_TO_ASSUME` : ARN du rôle IAM pour l'accès à Amazon Bedrock

313* `AWS_REGION` : Région Bedrock (par exemple, `us-west-2`)313* `AWS_REGION` : Région Amazon Bedrock (par exemple, `us-west-2`)

314 314 

315```yaml theme={null}315```yaml theme={null}

316claude-bedrock:316claude-bedrock:


347```347```

348 348 

349<Note>349<Note>

350 Les identifiants de modèle pour Bedrock incluent des préfixes spécifiques à la région (par exemple, `us.anthropic.claude-sonnet-4-6`). Transmettez le modèle souhaité via votre configuration de tâche ou votre invite si votre flux de travail le supporte.350 Les identifiants de modèle pour Amazon Bedrock incluent des préfixes spécifiques à la région (par exemple, `us.anthropic.claude-sonnet-4-6`). Transmettez le modèle souhaité via votre configuration de tâche ou votre invite si votre flux de travail le supporte.

351</Note>351</Note>

352 352 

353<h3 id="google-vertex-ai-job-example-workload-identity-federation">353<h3 id="agent-platform-job-example-workload-identity-federation">

354 Exemple de tâche Google Vertex AI (Workload Identity Federation)354 Exemple de tâche Agent Platform (Workload Identity Federation)

355</h3>355</h3>

356 356 

357**Conditions préalables :**357**Conditions préalables :**

358 358 

359* API Vertex AI activée dans votre projet GCP359* API Agent Platform de Google Cloud activée dans votre projet GCP

360* Workload Identity Federation configurée pour faire confiance à GitLab OIDC360* Workload Identity Federation configurée pour faire confiance à GitLab OIDC

361* Un compte de service avec les autorisations Vertex AI361* Un compte de service avec les autorisations Agent Platform de Google Cloud

362 362 

363**Variables CI/CD requises :**363**Variables CI/CD requises :**

364 364 

365* `GCP_WORKLOAD_IDENTITY_PROVIDER` : Nom complet de la ressource du fournisseur365* `GCP_WORKLOAD_IDENTITY_PROVIDER` : Nom complet de la ressource du fournisseur

366* `GCP_SERVICE_ACCOUNT` : E-mail du compte de service366* `GCP_SERVICE_ACCOUNT` : E-mail du compte de service

367* `CLOUD_ML_REGION` : Région Vertex (par exemple, `us-east5`)367* `CLOUD_ML_REGION` : Région Agent Platform de Google Cloud (par exemple, `us-east5`)

368 368 

369```yaml theme={null}369```yaml theme={null}

370claude-vertex:370claude-vertex:


490</h3>490</h3>

491 491 

492* **Pour Claude API** : Confirmez que `ANTHROPIC_API_KEY` est valide et non expiré492* **Pour Claude API** : Confirmez que `ANTHROPIC_API_KEY` est valide et non expiré

493* **Pour Bedrock/Vertex** : Vérifiez la configuration OIDC/WIF, l'emprunt d'identité de rôle et les noms secrets ; confirmez la disponibilité de la région et du modèle493* **Pour Amazon Bedrock ou Google Cloud's Agent Platform** : Vérifiez la configuration OIDC/WIF, l'emprunt d'identité de rôle et les noms secrets ; confirmez la disponibilité de la région et du modèle

494 494 

495<h2 id="advanced-configuration">495<h2 id="advanced-configuration">

496 Configuration avancée496 Configuration avancée


505* `prompt` / `prompt_file` : Fournissez les instructions en ligne (`-p`) ou via un fichier505* `prompt` / `prompt_file` : Fournissez les instructions en ligne (`-p`) ou via un fichier

506* `max_turns` : Limitez le nombre d'itérations aller-retour506* `max_turns` : Limitez le nombre d'itérations aller-retour

507* `timeout_minutes` : Limitez le temps d'exécution total507* `timeout_minutes` : Limitez le temps d'exécution total

508* `ANTHROPIC_API_KEY` : Requis pour Claude API (non utilisé pour Bedrock/Vertex)508* `ANTHROPIC_API_KEY` : Requis pour Claude API (non utilisé pour Amazon Bedrock ou Google Cloud's Agent Platform)

509* Environnement spécifique au fournisseur : `AWS_REGION`, variables de projet/région pour Vertex509* Environnement spécifique au fournisseur : `AWS_REGION`, variables de projet/région pour Google Cloud's Agent Platform

510 510 

511<Note>511<Note>

512 Les drapeaux et paramètres exacts peuvent varier selon la version de `@anthropic-ai/claude-code`. Exécutez `claude --help` dans votre tâche pour voir les options prises en charge.512 Les drapeaux et paramètres exacts peuvent varier selon la version de `@anthropic-ai/claude-code`. Exécutez `claude --help` dans votre tâche pour voir les options prises en charge.

glossary.md +3 −1

Details

262 262 

263Le comportement d'approbation de base pour la session. Basculez avec `Shift+Tab` dans la CLI ou utilisez le sélecteur de mode dans VS Code, Desktop et claude.ai. Les modes disponibles sont `default`, `acceptEdits`, `plan`, `auto`, `dontAsk` et `bypassPermissions`.263Le comportement d'approbation de base pour la session. Basculez avec `Shift+Tab` dans la CLI ou utilisez le sélecteur de mode dans VS Code, Desktop et claude.ai. Les modes disponibles sont `default`, `acceptEdits`, `plan`, `auto`, `dontAsk` et `bypassPermissions`.

264 264 

265Le mode `default` est étiqueté Manual dans la CLI et dans les extensions VS Code et JetBrains, et Claude Code accepte `manual` comme alias pour la valeur.

266 

265En savoir plus : [Choisir un mode de permission](/fr/permission-modes)267En savoir plus : [Choisir un mode de permission](/fr/permission-modes)

266 268 

267<h3 id="permission-rule">269<h3 id="permission-rule">


388 Teleport390 Teleport

389</h3>391</h3>

390 392 

391Une commande, `/teleport`, qui tire une session Claude Code cloud dans votre terminal local. Claude récupère la branche, charge l'historique des conversations et reprend à partir du dernier état de la session web. La direction inverse est `--remote`, qui envoie une tâche locale pour s'exécuter sur le web.393Une commande, `/teleport`, qui tire une session Claude Code cloud dans votre terminal local. Claude récupère la branche, charge l'historique des conversations et reprend à partir du dernier état de la session web. La direction inverse est `--cloud`, qui envoie une tâche locale pour s'exécuter sur le web.

392 394 

393En savoir plus : [From web to terminal](/fr/claude-code-on-the-web#from-web-to-terminal)395En savoir plus : [From web to terminal](/fr/claude-code-on-the-web#from-web-to-terminal)

394 396 

Details

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.3> Use this file to discover all available pages before exploring further.

4 4 

5# Claude Code sur Google Vertex AI5# Claude Code sur la Plateforme Agent de Google Cloud

6 6 

7> Découvrez comment configurer Claude Code via Google Vertex AI, y compris la configuration, la configuration IAM et la résolution des problèmes.7> Découvrez comment configurer Claude Code via la Plateforme Agent de Google Cloud, anciennement Vertex AI, y compris la configuration, la configuration IAM et la résolution des problèmes.

8 8 

9export const ContactSalesCard = ({surface}) => {9export const ContactSalesCard = ({surface}) => {

10 const utm = content => `utm_source=claude_code&utm_medium=docs&utm_content=${surface}_${content}`;10 const utm = content => `utm_source=claude_code&utm_medium=docs&utm_content=${surface}_${content}`;


82 Conditions préalables82 Conditions préalables

83</h2>83</h2>

84 84 

85Avant de configurer Claude Code avec Vertex AI, assurez-vous que vous disposez de :85Avant de configurer Claude Code avec Google Cloud's Agent Platform, anciennement Vertex AI, assurez-vous que vous disposez de :

86 86 

87* Un compte Google Cloud Platform (GCP) avec facturation activée87* Un compte Google Cloud Platform (GCP) avec facturation activée

88* Un projet GCP avec l'API Vertex AI activée88* Un projet GCP avec l'API Google Cloud's Agent Platform activée

89* Accès aux modèles Claude souhaités (par exemple, Claude Sonnet 4.6)89* Accès aux modèles Claude souhaités (par exemple, Claude Sonnet 4.6)

90* Google Cloud SDK (`gcloud`) installé et configuré90* Google Cloud SDK (`gcloud`) installé et configuré

91* Quota alloué dans la région GCP souhaitée91* Quota alloué dans la région GCP souhaitée

92 92 

93Pour vous connecter avec vos propres identifiants Vertex AI, suivez [Se connecter avec Vertex AI](#sign-in-with-vertex-ai) ci-dessous. Pour déployer Claude Code dans une équipe, utilisez les étapes de [configuration manuelle](#set-up-manually) et [épinglez vos versions de modèle](#5-pin-model-versions) avant le déploiement.93Pour vous connecter avec vos propres identifiants Google Cloud's Agent Platform, suivez [Se connecter avec Google Cloud's Agent Platform](#sign-in-with-agent-platform) ci-dessous. Pour déployer Claude Code dans une équipe, utilisez les étapes de [configuration manuelle](#set-up-manually) et [épinglez vos versions de modèle](#5-pin-model-versions) avant le déploiement.

94 94 

95<h2 id="sign-in-with-vertex-ai">95<h2 id="sign-in-with-agent-platform">

96 Se connecter avec Vertex AI96 Se connecter avec Agent Platform

97</h2>97</h2>

98 98 

99Si vous disposez d'identifiants Google Cloud et souhaitez commencer à utiliser Claude Code via Vertex AI, l'assistant de connexion vous guide à travers le processus. Vous complétez les conditions préalables du côté GCP une fois par projet ; l'assistant gère le côté Claude Code.99Si vous disposez d'identifiants Google Cloud et souhaitez commencer à utiliser Claude Code via Agent Platform de Google Cloud, l'assistant de connexion vous guide à travers le processus. Vous complétez les conditions préalables du côté GCP une fois par projet ; l'assistant gère le côté Claude Code.

100 100 

101<Note>101<Note>

102 L'assistant de configuration Vertex AI nécessite Claude Code v2.1.98 ou version ultérieure. Exécutez `claude --version` pour vérifier.102 L'assistant de configuration Agent Platform de Google Cloud nécessite Claude Code v2.1.98 ou version ultérieure. Exécutez `claude --version` pour vérifier.

103</Note>103</Note>

104 104 

105<Steps>105<Steps>

106 <Step title="Activer les modèles Claude dans votre projet GCP">106 <Step title="Activer les modèles Claude dans votre projet GCP">

107 [Activez l'API Vertex AI](#1-enable-vertex-ai-api) pour votre projet, puis demandez l'accès aux modèles Claude que vous souhaitez dans le [Vertex AI Model Garden](https://console.cloud.google.com/vertex-ai/model-garden). Consultez [Configuration IAM](#iam-configuration) pour les autorisations dont votre compte a besoin.107 [Activez l'API Agent Platform de Google Cloud](#1-enable-agent-platform-api) pour votre projet, puis demandez l'accès aux modèles Claude que vous souhaitez dans le [Model Garden d'Agent Platform de Google Cloud](https://console.cloud.google.com/vertex-ai/model-garden). Consultez [Configuration IAM](#iam-configuration) pour les autorisations dont votre compte a besoin.

108 </Step>108 </Step>

109 109 

110 <Step title="Démarrer Claude Code et choisir Vertex AI">110 <Step title="Démarrer Claude Code et choisir Agent Platform de Google Cloud">

111 Exécutez `claude`. À l'invite de connexion, sélectionnez **plateforme tierce**, puis **Google Vertex AI**.111 Exécutez `claude`. À l'invite de connexion, sélectionnez **plateforme tierce**, puis **Google Vertex AI**, l'étiquette que l'invite de connexion utilise toujours pour Agent Platform de Google Cloud.

112 </Step>112 </Step>

113 113 

114 <Step title="Suivre les invites de l'assistant">114 <Step title="Suivre les invites de l'assistant">


122 Configuration de la région122 Configuration de la région

123</h2>123</h2>

124 124 

125Claude Code prend en charge les points de terminaison Vertex AI [globaux](https://cloud.google.com/blog/products/ai-machine-learning/global-endpoint-for-claude-models-generally-available-on-vertex-ai), multi-régions et régionaux. Définissez `CLOUD_ML_REGION` sur `global`, un emplacement multi-région tel que `eu` ou `us`, ou une région spécifique telle que `us-east5`. Claude Code sélectionne le nom d'hôte Vertex AI correct pour chaque formulaire, y compris les hôtes `aiplatform.eu.rep.googleapis.com` et `aiplatform.us.rep.googleapis.com` pour les emplacements multi-régions.125Claude Code prend en charge les points de terminaison Google Cloud's Agent Platform [globaux](https://cloud.google.com/blog/products/ai-machine-learning/global-endpoint-for-claude-models-generally-available-on-vertex-ai), multi-régions et régionaux. Définissez `CLOUD_ML_REGION` sur `global`, un emplacement multi-région tel que `eu` ou `us`, ou une région spécifique telle que `us-east5`. Claude Code sélectionne le nom d'hôte Google Cloud's Agent Platform correct pour chaque formulaire, y compris les hôtes `aiplatform.eu.rep.googleapis.com` et `aiplatform.us.rep.googleapis.com` pour les emplacements multi-régions.

126 126 

127<Note>127<Note>

128 Vertex AI peut ne pas prendre en charge les modèles par défaut de Claude Code sur tous les types de points de terminaison. La disponibilité des modèles varie selon les [régions spécifiques](https://cloud.google.com/vertex-ai/generative-ai/docs/learn/locations#genai-partner-models), les emplacements multi-régions et les [points de terminaison globaux](https://cloud.google.com/vertex-ai/generative-ai/docs/partner-models/use-partner-models#supported_models). Vous devrez peut-être basculer vers un emplacement pris en charge ou spécifier un modèle pris en charge.128 Google Cloud's Agent Platform peut ne pas prendre en charge les modèles par défaut de Claude Code sur tous les types de points de terminaison. La disponibilité des modèles varie selon les [régions spécifiques](https://cloud.google.com/vertex-ai/generative-ai/docs/learn/locations#genai-partner-models), les emplacements multi-régions et les [points de terminaison globaux](https://cloud.google.com/vertex-ai/generative-ai/docs/partner-models/use-partner-models#supported_models). Vous devrez peut-être basculer vers un emplacement pris en charge ou spécifier un modèle pris en charge.

129</Note>129</Note>

130 130 

131<h2 id="set-up-manually">131<h2 id="set-up-manually">

132 Configuration manuelle132 Configuration manuelle

133</h2>133</h2>

134 134 

135Pour configurer Vertex AI via des variables d'environnement au lieu de l'assistant, par exemple dans CI ou un déploiement d'entreprise scriptée, suivez les étapes ci-dessous.135Pour configurer Google Cloud's Agent Platform via des variables d'environnement au lieu de l'assistant, par exemple dans CI ou un déploiement d'entreprise scriptée, suivez les étapes ci-dessous.

136 136 

137<h3 id="1-enable-vertex-ai-api">137<h3 id="1-enable-agent-platform-api">

138 1. Activer l'API Vertex AI138 1. Activer l'API Agent Platform

139</h3>139</h3>

140 140 

141Activez l'API Vertex AI dans votre projet GCP :141Activez l'API Agent Platform de Google Cloud dans votre projet GCP :

142 142 

143```bash theme={null}143```bash theme={null}

144# Définissez votre ID de projet144# Définissez votre ID de projet

145gcloud config set project YOUR-PROJECT-ID145gcloud config set project YOUR-PROJECT-ID

146 146 

147# Activez l'API Vertex AI147# Activez l'API Agent Platform

148gcloud services enable aiplatform.googleapis.com148gcloud services enable aiplatform.googleapis.com

149```149```

150 150 


152 2. Demander l'accès au modèle152 2. Demander l'accès au modèle

153</h3>153</h3>

154 154 

155Demandez l'accès aux modèles Claude dans Vertex AI :155Demandez l'accès aux modèles Claude dans Google Cloud's Agent Platform :

156 156 

1571. Accédez au [Vertex AI Model Garden](https://console.cloud.google.com/vertex-ai/model-garden)1571. Accédez au [Google Cloud's Agent Platform Model Garden](https://console.cloud.google.com/vertex-ai/model-garden)

1582. Recherchez les modèles ' Claude '1582. Recherchez les modèles ' Claude '

1593. Demandez l'accès aux modèles Claude souhaités (par exemple, Claude Sonnet 4.6)1593. Demandez l'accès aux modèles Claude souhaités (par exemple, Claude Sonnet 4.6)

1604. Attendez l'approbation (peut prendre 24 à 48 heures)1604. Attendez l'approbation (peut prendre 24 à 48 heures)


170Claude Code v2.1.121 ou version ultérieure prend en charge la [Fédération d'identité de charge de travail basée sur certificat X.509](https://cloud.google.com/iam/docs/workload-identity-federation-with-x509-certificates) via la même chaîne Application Default Credentials. Définissez `GOOGLE_APPLICATION_CREDENTIALS` sur le chemin de votre fichier de configuration des identifiants.170Claude Code v2.1.121 ou version ultérieure prend en charge la [Fédération d'identité de charge de travail basée sur certificat X.509](https://cloud.google.com/iam/docs/workload-identity-federation-with-x509-certificates) via la même chaîne Application Default Credentials. Définissez `GOOGLE_APPLICATION_CREDENTIALS` sur le chemin de votre fichier de configuration des identifiants.

171 171 

172<Note>172<Note>

173 Claude Code utilise `ANTHROPIC_VERTEX_PROJECT_ID` comme ID de projet pour les demandes Vertex AI. Les variables d'environnement `GCLOUD_PROJECT` et `GOOGLE_CLOUD_PROJECT` et le fichier d'identifiants référencé par `GOOGLE_APPLICATION_CREDENTIALS` ont la priorité sur celui-ci. Si aucun de ces éléments n'est défini, l'ID de projet est résolu à partir de votre configuration `gcloud` ou du compte de service attaché.173 Claude Code utilise `ANTHROPIC_VERTEX_PROJECT_ID` comme ID de projet pour les demandes Google Cloud's Agent Platform. Les variables d'environnement `GCLOUD_PROJECT` et `GOOGLE_CLOUD_PROJECT` et le fichier d'identifiants référencé par `GOOGLE_APPLICATION_CREDENTIALS` ont la priorité sur celui-ci. Si aucun de ces éléments n'est défini, l'ID de projet est résolu à partir de votre configuration `gcloud` ou du compte de service attaché.

174</Note>174</Note>

175 175 

176<h4 id="advanced-credential-configuration">176<h4 id="advanced-credential-configuration">


197Définissez les variables d'environnement suivantes :197Définissez les variables d'environnement suivantes :

198 198 

199```bash theme={null}199```bash theme={null}

200# Activez l'intégration Vertex AI200# Activez l'intégration Agent Platform

201export CLAUDE_CODE_USE_VERTEX=1201export CLAUDE_CODE_USE_VERTEX=1

202export CLOUD_ML_REGION=global202export CLOUD_ML_REGION=global

203export ANTHROPIC_VERTEX_PROJECT_ID=YOUR-PROJECT-ID203export ANTHROPIC_VERTEX_PROJECT_ID=YOUR-PROJECT-ID

204 204 

205# Optionnel : Remplacez l'URL du point de terminaison Vertex pour les points de terminaison personnalisés ou les passerelles205# Optionnel : Remplacez l'URL du point de terminaison Agent Platform pour les points de terminaison personnalisés ou les passerelles

206# export ANTHROPIC_VERTEX_BASE_URL=https://aiplatform.googleapis.com206# export ANTHROPIC_VERTEX_BASE_URL=https://aiplatform.googleapis.com

207 207 

208# Optionnel : Désactivez la mise en cache des invites si nécessaire208# Optionnel : Désactivez la mise en cache des invites si nécessaire


216export VERTEX_REGION_CLAUDE_4_6_SONNET=europe-west1216export VERTEX_REGION_CLAUDE_4_6_SONNET=europe-west1

217```217```

218 218 

219La plupart des versions de modèle ont une variable `VERTEX_REGION_CLAUDE_*` correspondante. Consultez la [référence des variables d'environnement](/fr/env-vars) pour la liste complète. Vérifiez [Vertex Model Garden](https://console.cloud.google.com/vertex-ai/model-garden) pour déterminer quels modèles prennent en charge les points de terminaison globaux par rapport aux points de terminaison régionaux uniquement.219La plupart des versions de modèle ont une variable `VERTEX_REGION_CLAUDE_*` correspondante. Consultez la [référence des variables d'environnement](/fr/env-vars) pour la liste complète. Vérifiez [Google Cloud's Agent Platform Model Garden](https://console.cloud.google.com/vertex-ai/model-garden) pour déterminer quels modèles prennent en charge les points de terminaison globaux par rapport aux points de terminaison régionaux uniquement.

220 220 

221[La mise en cache des invites](/fr/prompt-caching) est activée automatiquement. Pour la désactiver, définissez `DISABLE_PROMPT_CACHING=1`. Pour demander une TTL de cache d'1 heure au lieu de la valeur par défaut de 5 minutes, définissez `ENABLE_PROMPT_CACHING_1H=1` ; les écritures de cache avec une TTL d'1 heure sont facturées à un taux plus élevé. Pour des limites de débit accrues, contactez le support Google Cloud. Lors de l'utilisation de Vertex AI, la commande `/logout` est indisponible car l'authentification est gérée via les identifiants Google Cloud.221[La mise en cache des invites](/fr/prompt-caching) est activée automatiquement. Pour la désactiver, définissez `DISABLE_PROMPT_CACHING=1`. Pour demander une TTL de cache d'1 heure au lieu de la valeur par défaut de 5 minutes, définissez `ENABLE_PROMPT_CACHING_1H=1` ; les écritures de cache avec une TTL d'1 heure sont facturées à un taux plus élevé. Pour des limites de débit accrues, contactez le support Google Cloud. Lors de l'utilisation de Google Cloud's Agent Platform, la commande `/logout` est indisponible car l'authentification est gérée via les identifiants Google Cloud.

222 222 

223Claude Code désactive la [recherche d'outils MCP](/fr/mcp#scale-with-mcp-tool-search) par défaut sur Vertex AI, de sorte que les définitions d'outils MCP se chargent à l'avance. Vertex AI prend en charge la recherche d'outils pour Claude Sonnet 4.5 et versions ultérieures et Claude Opus 4.5 et versions ultérieures. Définissez `ENABLE_TOOL_SEARCH=true` pour l'activer sur ces modèles. Les modèles antérieurs sur Vertex AI n'acceptent pas l'en-tête bêta requis, et les demandes échouent si vous activez la recherche d'outils avec eux.223Claude Code désactive la [recherche d'outils MCP](/fr/mcp#scale-with-mcp-tool-search) par défaut sur Google Cloud's Agent Platform, de sorte que les définitions d'outils MCP se chargent à l'avance. Google Cloud's Agent Platform prend en charge la recherche d'outils pour Claude Sonnet 4.5 et versions ultérieures et Claude Opus 4.5 et versions ultérieures. Définissez `ENABLE_TOOL_SEARCH=true` pour l'activer sur ces modèles. Les modèles antérieurs sur Google Cloud's Agent Platform n'acceptent pas l'en-tête bêta requis, et les demandes échouent si vous activez la recherche d'outils avec eux.

224 224 

225<h3 id="5-pin-model-versions">225<h3 id="5-pin-model-versions">

226 5. Épingler les versions de modèle226 5. Épingler les versions de modèle

227</h3>227</h3>

228 228 

229<Warning>229<Warning>

230 Épinglez les versions de modèle spécifiques lors du déploiement pour plusieurs utilisateurs. Sans épinglage, les alias de modèle tels que `sonnet` et `opus` se résolvent à la valeur par défaut intégrée de Claude Code pour Vertex AI, qui peut être en retard par rapport à la version la plus récente et peut ne pas encore être activée dans votre projet. Claude Code [revient](#startup-model-checks) à la version précédente au démarrage lorsque la valeur par défaut n'est pas disponible, mais l'épinglage vous permet de contrôler quand vos utilisateurs passent à un nouveau modèle.230 Épinglez les versions de modèle spécifiques lors du déploiement pour plusieurs utilisateurs. Sans épinglage, les alias de modèle tels que `sonnet` et `opus` se résolvent à la valeur par défaut intégrée de Claude Code pour Google Cloud's Agent Platform, qui peut être en retard par rapport à la version la plus récente et peut ne pas encore être activée dans votre projet. Claude Code [revient](#startup-model-checks) à la version précédente au démarrage lorsque la valeur par défaut n'est pas disponible, mais l'épinglage vous permet de contrôler quand vos utilisateurs passent à un nouveau modèle.

231</Warning>231</Warning>

232 232 

233Définissez ces variables d'environnement sur des ID de modèle Vertex AI spécifiques.233Définissez ces variables d'environnement sur des ID de modèle Google Cloud's Agent Platform spécifiques.

234 234 

235Sans `ANTHROPIC_DEFAULT_OPUS_MODEL`, l'alias `opus` sur Vertex se résout à Opus 4.6. Définissez-le sur l'ID Opus 4.8 pour utiliser le dernier modèle :235Sans `ANTHROPIC_DEFAULT_OPUS_MODEL`, l'alias `opus` sur Google Cloud's Agent Platform se résout à Opus 4.6. Définissez-le sur l'ID Opus 4.8 pour utiliser le dernier modèle :

236 236 

237```bash theme={null}237```bash theme={null}

238export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'238export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'


249| Modèle principal | `claude-sonnet-4-5@20250929` |249| Modèle principal | `claude-sonnet-4-5@20250929` |

250| Modèle petit/rapide | Identique au modèle principal |250| Modèle petit/rapide | Identique au modèle principal |

251 251 

252Les tâches en arrière-plan telles que la génération de titre de session utilisent le modèle petit/rapide, normalement un modèle de classe Haiku. Sur Vertex AI, Claude Code utilise par défaut le modèle principal car Haiku peut ne pas être activé dans tous les projets ou régions. Pour utiliser Haiku pour les tâches en arrière-plan, définissez `ANTHROPIC_DEFAULT_HAIKU_MODEL` sur un ID de modèle disponible dans votre projet.252Les tâches en arrière-plan telles que la génération de titre de session utilisent le modèle petit/rapide, normalement un modèle de classe Haiku. Sur Google Cloud's Agent Platform, Claude Code utilise par défaut le modèle principal car Haiku peut ne pas être activé dans tous les projets ou régions. Pour utiliser Haiku pour les tâches en arrière-plan, définissez `ANTHROPIC_DEFAULT_HAIKU_MODEL` sur un ID de modèle disponible dans votre projet.

253 253 

254Pour personnaliser davantage les modèles :254Pour personnaliser davantage les modèles :

255 255 


262 Vérifications du modèle au démarrage262 Vérifications du modèle au démarrage

263</h2>263</h2>

264 264 

265Lorsque Claude Code démarre avec Vertex AI configuré, il vérifie que les modèles qu'il a l'intention d'utiliser sont accessibles dans votre projet. Cette vérification nécessite Claude Code v2.1.98 ou version ultérieure.265Lorsque Claude Code démarre avec Google Cloud's Agent Platform configuré, il vérifie que les modèles qu'il a l'intention d'utiliser sont accessibles dans votre projet. Cette vérification nécessite Claude Code v2.1.98 ou version ultérieure.

266 266 

267Si vous avez épinglé une version de modèle plus ancienne que la valeur par défaut actuelle de Claude Code, et que votre projet peut invoquer la version plus récente, Claude Code vous invite à mettre à jour l'épingle. L'acceptation écrit le nouvel ID de modèle dans votre [fichier de paramètres utilisateur](/fr/settings) et redémarre Claude Code. Le refus est mémorisé jusqu'au prochain changement de version par défaut.267Si vous avez épinglé une version de modèle plus ancienne que la valeur par défaut actuelle de Claude Code, et que votre projet peut invoquer la version plus récente, Claude Code vous invite à mettre à jour l'épingle. L'acceptation écrit le nouvel ID de modèle dans votre [fichier de paramètres utilisateur](/fr/settings) et redémarre Claude Code. Le refus est mémorisé jusqu'au prochain changement de version par défaut.

268 268 


280 280 

281Pour des autorisations plus restrictives, créez un rôle personnalisé avec uniquement les autorisations ci-dessus.281Pour des autorisations plus restrictives, créez un rôle personnalisé avec uniquement les autorisations ci-dessus.

282 282 

283Pour plus de détails, consultez la [documentation IAM de Vertex](https://cloud.google.com/vertex-ai/docs/general/access-control).283Pour plus de détails, consultez la [documentation IAM de Google Cloud Vertex AI](https://cloud.google.com/vertex-ai/docs/general/access-control).

284 284 

285<Note>285<Note>

286 Créez un projet GCP dédié pour Claude Code pour simplifier le suivi des coûts et le contrôle d'accès.286 Créez un projet GCP dédié pour Claude Code pour simplifier le suivi des coûts et le contrôle d'accès.


290 Fenêtre de contexte de 1M de jetons290 Fenêtre de contexte de 1M de jetons

291</h2>291</h2>

292 292 

293Claude Sonnet 5, Opus 4.6 et versions ultérieures, ainsi que Sonnet 4.6, prennent en charge la [fenêtre de contexte de 1M de jetons](https://platform.claude.com/docs/en/build-with-claude/context-windows#1m-token-context-window) sur Vertex AI. Sonnet 5 s'exécute toujours avec la fenêtre 1M, sans variante `[1m]` à sélectionner. Pour les autres modèles, Claude Code active automatiquement la fenêtre de contexte étendue lorsque vous sélectionnez une variante de modèle 1M.293Claude Sonnet 5, Opus 4.6 et versions ultérieures, ainsi que Sonnet 4.6, prennent en charge la [fenêtre de contexte de 1M de jetons](https://platform.claude.com/docs/en/build-with-claude/context-windows#1m-token-context-window) sur la plateforme Agent de Google Cloud. Sonnet 5 s'exécute toujours avec la fenêtre 1M, sans variante `[1m]` à sélectionner. Pour les autres modèles, Claude Code active automatiquement la fenêtre de contexte étendue lorsque vous sélectionnez une variante de modèle 1M.

294 294 

295L'[assistant de configuration](#sign-in-with-vertex-ai) offre une option de contexte 1M lorsqu'il épingle les modèles. Pour l'activer pour un modèle épinglé manuellement à la place, ajoutez `[1m]` à l'ID du modèle. Consultez [Épingler les modèles pour les déploiements tiers](/fr/model-config#pin-models-for-third-party-deployments) pour plus de détails.295L'[assistant de configuration](#sign-in-with-agent-platform) offre une option de contexte 1M lorsqu'il épingle les modèles. Pour l'activer pour un modèle épinglé manuellement à la place, ajoutez `[1m]` à l'ID du modèle. Consultez [Épingler les modèles pour les déploiements tiers](/fr/model-config#pin-models-for-third-party-deployments) pour plus de détails.

296 296 

297<h2 id="troubleshooting">297<h2 id="troubleshooting">

298 Résolution des problèmes298 Résolution des problèmes


325 Ressources supplémentaires325 Ressources supplémentaires

326</h2>326</h2>

327 327 

328* [Documentation Vertex AI](https://cloud.google.com/vertex-ai/docs)328* [Documentation de la plateforme Agent de Google Cloud](https://cloud.google.com/vertex-ai/docs)

329* [Tarification Vertex AI](https://cloud.google.com/vertex-ai/pricing)329* [Tarification de la plateforme Agent de Google Cloud](https://cloud.google.com/vertex-ai/pricing)

330* [Quotas et limites Vertex AI](https://cloud.google.com/vertex-ai/docs/quotas)330* [Quotas et limites de la plateforme Agent de Google Cloud](https://cloud.google.com/vertex-ai/docs/quotas)

headless.md +9 −3

Details

56| Agents personnalisés | `--agents <json>` |56| Agents personnalisés | `--agents <json>` |

57| Un plugin | `--plugin-dir <path>`, `--plugin-url <url>` |57| Un plugin | `--plugin-dir <path>`, `--plugin-url <url>` |

58 58 

59Le mode bare ignore OAuth et les lectures du trousseau. L'authentification Anthropic doit provenir de `ANTHROPIC_API_KEY` ou d'un `apiKeyHelper` dans le JSON passé à `--settings`. Bedrock, Vertex et Foundry utilisent leurs identifiants de fournisseur habituels.59Le mode bare ignore OAuth et les lectures du trousseau. L'authentification Anthropic doit provenir de `ANTHROPIC_API_KEY` ou d'un `apiKeyHelper` dans le JSON passé à `--settings`. Amazon Bedrock, Google Cloud's Agent Platform et Microsoft Foundry utilisent leurs identifiants de fournisseur habituels.

60 60 

61<Note>61<Note>

62 `--bare` est le mode recommandé pour les appels scriptés et SDK, et deviendra le mode par défaut pour `-p` dans une version future.62 `--bare` est le mode recommandé pour les appels scriptés et SDK, et deviendra le mode par défaut pour `-p` dans une version future.


136 --json-schema '{"type":"object","properties":{"functions":{"type":"array","items":{"type":"string"}}},"required":["functions"]}'136 --json-schema '{"type":"object","properties":{"functions":{"type":"array","items":{"type":"string"}}},"required":["functions"]}'

137```137```

138 138 

139Si la valeur n'est pas un JSON Schema valide, `claude` se ferme avec `Error: --json-schema is not a valid JSON Schema` suivi du diagnostic du validateur. Claude Code accepte les schémas qui utilisent le mot-clé `format`, tel que `"format": "email"`, mais traite `format` comme une annotation et ne l'applique pas. Avant v2.1.205, Claude Code ignorait silencieusement un schéma invalide et retournait du texte non structuré, et traitait tout schéma contenant `format` comme invalide.

140 

139<Tip>141<Tip>

140 Utilisez un outil comme [jq](https://jqlang.github.io/jq/) pour analyser la réponse et extraire des champs spécifiques :142 Utilisez un outil comme [jq](https://jqlang.github.io/jq/) pour analyser la réponse et extraire des champs spécifiques :

141 143 


182| `uuid` | chaîne | identifiant d'événement unique |184| `uuid` | chaîne | identifiant d'événement unique |

183| `session_id` | chaîne | session à laquelle appartient l'événement |185| `session_id` | chaîne | session à laquelle appartient l'événement |

184 186 

185L'événement `system/init` rapporte les métadonnées de session, y compris le modèle, les outils, les serveurs MCP et les plugins chargés. C'est le premier événement du flux sauf si [`CLAUDE_CODE_SYNC_PLUGIN_INSTALL`](/fr/env-vars) est défini, auquel cas les événements `plugin_install` le précèdent. Utilisez les champs de plugin pour échouer CI quand un plugin n'a pas pu être chargé :187L'événement `system/init` rapporte les métadonnées de session, y compris le modèle, les outils, les serveurs MCP et les plugins chargés. C'est le premier événement du flux sauf si [`CLAUDE_CODE_SYNC_PLUGIN_INSTALL`](/fr/env-vars) est défini, auquel cas les événements `plugin_install` le précèdent.

188 

189L'événement porte également un tableau `capabilities` optionnel de chaînes nommant les comportements de protocole que cette version de Claude Code implémente, tels que `interrupt_receipt_v1`. Vérifiez-le pour détecter les fonctionnalités au lieu de comparer les chaînes de version, et ignorez les valeurs que vous ne reconnaissez pas. Le champ nécessite Claude Code v2.1.205 ou ultérieur et est absent des versions antérieures. Consultez [`SDKSystemMessage`](/fr/agent-sdk/typescript#sdksystemmessage) pour la liste des capacités.

190 

191Utilisez les champs de plugin pour échouer CI quand un plugin n'a pas pu être chargé :

186 192 

187| Champ | Type | Description |193| Champ | Type | Description |

188| --------------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |194| --------------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |


234Le flag `--allowedTools` utilise la [syntaxe des règles de permission](/fr/settings#permission-rule-syntax). L'espace ` *` à la fin active la correspondance de préfixe, donc `Bash(git diff *)` autorise n'importe quelle commande commençant par `git diff`. L'espace avant `*` est important : sans lui, `Bash(git diff*)` correspondrait également à `git diff-index`.240Le flag `--allowedTools` utilise la [syntaxe des règles de permission](/fr/settings#permission-rule-syntax). L'espace ` *` à la fin active la correspondance de préfixe, donc `Bash(git diff *)` autorise n'importe quelle commande commençant par `git diff`. L'espace avant `*` est important : sans lui, `Bash(git diff*)` correspondrait également à `git diff-index`.

235 241 

236<Note>242<Note>

237 Les [skills](/fr/skills) invoquées par l'utilisateur et les commandes personnalisées fonctionnent en mode `-p` : incluez `/skill-name` dans la chaîne de prompt et Claude Code l'étend avant d'exécuter. Les commandes intégrées qui ouvrent un dialogue interactif, telles que `/login`, ne sont pas disponibles en mode `-p`. {/* min-version: 2.1.181 */}Pour modifier un paramètre à partir d'une invocation `-p`, passez `key=value` à `/config`, par exemple `/config thinking=false`.243 Les [skills](/fr/skills) invoquées par l'utilisateur et les commandes personnalisées fonctionnent en mode `-p` : incluez `/skill-name` dans la chaîne de prompt et Claude Code l'étend avant d'exécuter. Les commandes intégrées qui ouvrent un dialogue interactif, telles que `/login`, ne sont pas disponibles en mode `-p`. {/* min-version: 2.1.205 */}`/model`, `/effort`, `/fast`, `/color` et `/rename` acceptent la valeur comme argument, par exemple `/model sonnet`, et `/mcp` sans argument affiche un résumé textuel du statut du serveur ; ces formes nécessitent Claude Code v2.1.205 ou ultérieur et suivent les notes de disponibilité de chaque commande]\(/fr/commands#all-commands). {/* min-version: 2.1.181 */}Pour modifier un paramètre à partir d'une invocation `-p`, passez `key=value` à `/config`, par exemple `/config thinking=false`.

238</Note>244</Note>

239 245 

240<h3 id="customize-the-system-prompt">246<h3 id="customize-the-system-prompt">

hooks.md +19 −13

Details

164Les hooks sont définis dans les fichiers de paramètres JSON. La configuration a trois niveaux d'imbrication :164Les hooks sont définis dans les fichiers de paramètres JSON. La configuration a trois niveaux d'imbrication :

165 165 

1661. Choisissez un [événement de hook](#hook-events) auquel répondre, comme `PreToolUse` ou `Stop`1661. Choisissez un [événement de hook](#hook-events) auquel répondre, comme `PreToolUse` ou `Stop`

1672. Ajoutez un [groupe de matcher](#matcher-patterns) pour filtrer quand il se déclenche, comme ' uniquement pour l'outil Bash '1672. Ajoutez un [groupe de matcher](#matcher-patterns) pour filtrer quand il se déclenche, comme « uniquement pour l'outil Bash »

1683. Définissez un ou plusieurs [gestionnaires de hook](#hook-handler-fields) à exécuter lorsqu'il y a correspondance1683. Définissez un ou plusieurs [gestionnaires de hook](#hook-handler-fields) à exécuter lorsqu'il y a correspondance

169 169 

170Consultez [Comment un hook se résout](#how-a-hook-resolves) ci-dessus pour une procédure pas à pas complète avec un exemple annoté.170Consultez [Comment un hook se résout](#how-a-hook-resolves) ci-dessus pour une procédure pas à pas complète avec un exemple annoté.

171 171 

172<Note>172<Note>

173 Cette page utilise des termes spécifiques pour chaque niveau : **événement de hook** pour le point du cycle de vie, **groupe de matcher** pour le filtre et **gestionnaire de hook** pour la commande shell, le point de terminaison HTTP, l'outil MCP, le prompt ou l'agent qui s'exécute. ' Hook ' seul fait référence à la fonctionnalité générale.173 Cette page utilise des termes spécifiques pour chaque niveau : **événement de hook** pour le point du cycle de vie, **groupe de matcher** pour le filtre et **gestionnaire de hook** pour la commande shell, le point de terminaison HTTP, l'outil MCP, le prompt ou l'agent qui s'exécute. « Hook » seul fait référence à la fonctionnalité générale.

174</Note>174</Note>

175 175 

176<h3 id="hook-locations">176<h3 id="hook-locations">


280 280 

281Les traits d'union dans l'ensemble de correspondance exacte nécessitent Claude Code v2.1.195 ou ultérieur. Sur les versions antérieures, un préfixe nu avec trait d'union comme `mcp__brave-search` est évalué comme une expression régulière non ancrée et correspond à chaque outil de ce serveur. La forme `mcp__brave-search__.*` fonctionne sur chaque version.281Les traits d'union dans l'ensemble de correspondance exacte nécessitent Claude Code v2.1.195 ou ultérieur. Sur les versions antérieures, un préfixe nu avec trait d'union comme `mcp__brave-search` est évalué comme une expression régulière non ancrée et correspond à chaque outil de ce serveur. La forme `mcp__brave-search__.*` fonctionne sur chaque version.

282 282 

283Les outils d'un [serveur MCP fourni par un plugin](/fr/mcp#plugin-provided-mcp-servers) utilisent un segment de serveur limité qui inclut le nom du plugin : `mcp__plugin_<plugin-name>_<server-name>__<tool>`. Un matcher écrit contre la clé de serveur nue ne se déclenche jamais pour ces outils. Pour un plugin nommé `my-plugin` qui regroupe un serveur sous la clé `db`, un outil `query` apparaît comme `mcp__plugin_my-plugin_db__query`, donc le matcher pour chaque outil de ce serveur est `mcp__plugin_my-plugin_db__.*`. Utilisez le même nom d'outil limité dans le champ [`if`](#common-fields) d'un gestionnaire. Consultez [Serveurs MCP fournis par un plugin](/fr/mcp#plugin-provided-mcp-servers) pour savoir comment le nom limité est construit.

284 

283Cet exemple enregistre toutes les opérations du serveur memory et valide les opérations d'écriture de n'importe quel serveur MCP :285Cet exemple enregistre toutes les opérations du serveur memory et valide les opérations d'écriture de n'importe quel serveur MCP :

284 286 

285```json theme={null}287```json theme={null}


456En plus des [champs communs](#common-fields), les hooks de l'outil MCP acceptent ces champs :458En plus des [champs communs](#common-fields), les hooks de l'outil MCP acceptent ces champs :

457 459 

458| Champ | Requis | Description |460| Champ | Requis | Description |

459| :------- | :----- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |461| :------- | :----- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

460| `server` | oui | Nom d'un serveur MCP configuré. Le serveur doit déjà être connecté ; le hook ne déclenche jamais un flux OAuth ou de connexion |462| `server` | oui | Nom d'un serveur MCP configuré. Pour un [serveur fourni par un plugin](/fr/mcp#plugin-provided-mcp-servers), c'est le nom limité `plugin:<plugin-name>:<server-name>`, comme `plugin:my-plugin:db`, pas la clé de serveur nue. Le serveur doit déjà être connecté ; le hook ne déclenche jamais un flux OAuth ou de connexion |

461| `tool` | oui | Nom de l'outil à appeler sur ce serveur |463| `tool` | oui | Nom de l'outil à appeler sur ce serveur |

462| `input` | non | Arguments passés à l'outil. Les valeurs de chaîne supportent la substitution `${path}` de l'[entrée JSON](#hook-input-and-output) du hook, comme `"${tool_input.file_path}"` |464| `input` | non | Arguments passés à l'outil. Les valeurs de chaîne supportent la substitution `${path}` de l'[entrée JSON](#hook-input-and-output) du hook, comme `"${tool_input.file_path}"` |

463 465 


638| :---------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |640| :---------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

639| `session_id` | Identifiant de session actuel |641| `session_id` | Identifiant de session actuel |

640| `prompt_id` | UUID identifiant le prompt utilisateur actuellement traité. Correspond à l'[attribut `prompt.id` sur les événements OpenTelemetry](/fr/monitoring-usage#event-correlation-attributes), afin que vous puissiez corréler la sortie du hook avec la télémétrie pour un seul prompt. Absent jusqu'à la première entrée utilisateur. {/* min-version: 2.1.196 */}Nécessite Claude Code v2.1.196 ou ultérieur |642| `prompt_id` | UUID identifiant le prompt utilisateur actuellement traité. Correspond à l'[attribut `prompt.id` sur les événements OpenTelemetry](/fr/monitoring-usage#event-correlation-attributes), afin que vous puissiez corréler la sortie du hook avec la télémétrie pour un seul prompt. Absent jusqu'à la première entrée utilisateur. {/* min-version: 2.1.196 */}Nécessite Claude Code v2.1.196 ou ultérieur |

641| `transcript_path` | Chemin vers le JSON de conversation |643| `transcript_path` | Chemin vers le JSON de conversation. Le fichier de transcription est écrit de manière asynchrone et peut être en retard par rapport à la conversation en mémoire, il se peut donc qu'il n'inclue pas encore les messages les plus récents du tour actuel lorsqu'un hook se déclenche. Les hooks qui ont besoin du texte final de l'assistant du tour actuel doivent utiliser `last_assistant_message` sur [Stop](#stop) et [SubagentStop](#subagentstop) au lieu de lire la transcription |

642| `cwd` | Répertoire de travail courant lorsque le hook est invoqué |644| `cwd` | Répertoire de travail courant lorsque le hook est invoqué |

643| `permission_mode` | [Mode de permission](/fr/permissions#permission-modes) actuel : `"default"`, `"plan"`, `"acceptEdits"`, `"auto"`, `"dontAsk"` ou `"bypassPermissions"`. Tous les événements ne reçoivent pas ce champ : consultez l'exemple JSON de chaque événement ci-dessous pour vérifier |645| `permission_mode` | [Mode de permission](/fr/permissions#permission-modes) actuel : `"default"`, `"plan"`, `"acceptEdits"`, `"auto"`, `"dontAsk"` ou `"bypassPermissions"`. Le mode étiqueté **Manuel** arrive comme `"default"`, jamais comme `"manual"`, afin que les scripts qui correspondent à `"default"` continuent de fonctionner. Tous les événements ne reçoivent pas ce champ. Consultez l'exemple JSON de chaque [événement de hook](#hook-events) |

644| `effort` | Objet avec un champ `level` contenant le [niveau d'effort](/fr/model-config#adjust-effort-level) actif pour le tour : `"low"`, `"medium"`, `"high"`, `"xhigh"` ou `"max"`. Si l'effort demandé du modèle dépasse ce que le modèle actuel supporte, c'est le niveau réduit que le modèle a réellement utilisé. Ultracode n'est pas un niveau distinct et est signalé comme `"xhigh"`. L'objet correspond au champ `effort` de la [ligne de statut](/fr/statusline#available-data). Présent pour les événements qui se déclenchent dans un contexte d'utilisation d'outil, tels que `PreToolUse`, `PostToolUse`, `Stop` et `SubagentStop`, lorsque le modèle actuel supporte le paramètre d'effort. Le niveau est également disponible pour les commandes de hook et l'outil Bash en tant que variable d'environnement `$CLAUDE_EFFORT`. |646| `effort` | Objet avec un champ `level` contenant le [niveau d'effort](/fr/model-config#adjust-effort-level) actif pour le tour : `"low"`, `"medium"`, `"high"`, `"xhigh"` ou `"max"`. Si l'effort demandé du modèle dépasse ce que le modèle actuel supporte, c'est le niveau réduit que le modèle a réellement utilisé. Ultracode n'est pas un niveau distinct et est signalé comme `"xhigh"`. L'objet correspond au champ `effort` de la [ligne de statut](/fr/statusline#available-data). Présent pour les événements qui se déclenchent dans un contexte d'utilisation d'outil, tels que `PreToolUse`, `PostToolUse`, `Stop` et `SubagentStop`, lorsque le modèle actuel supporte le paramètre d'effort. Le niveau est également disponible pour les commandes de hook et l'outil Bash en tant que variable d'environnement `$CLAUDE_EFFORT`. |

645| `hook_event_name` | Nom de l'événement qui s'est déclenché |647| `hook_event_name` | Nom de l'événement qui s'est déclenché |

646 648 


1591 ExitPlanMode1593 ExitPlanMode

1592</h5>1594</h5>

1593 1595 

1594Présente un plan et demande à l'utilisateur de l'approuver avant que Claude ne quitte le [mode plan](/fr/permission-modes#analyze-before-you-edit-with-plan-mode). Claude écrit le plan dans un fichier sur le disque avant d'appeler l'outil, donc l'`tool_input` littéral du modèle ne porte que `allowedPrompts`. Claude Code injecte le contenu du plan et le chemin du fichier avant de transmettre l'entrée aux hooks.1596Présente un plan et demande à l'utilisateur de l'approuver avant que Claude ne quitte le [mode plan](/fr/permission-modes#analyze-before-you-edit-with-plan-mode). Claude écrit le plan dans un fichier sur le disque avant d'appeler l'outil, donc l'`tool_input` littéral du modèle est généralement vide. Claude Code injecte le contenu du plan et le chemin du fichier avant de transmettre l'entrée aux hooks.

1595 1597 

1596| Champ | Type | Exemple | Description |1598| Champ | Type | Exemple | Description |

1597| :--------------- | :----- | :------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------- |1599| :--------------- | :----- | :------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

1598| `plan` | string | `"## Refactor auth\n1. Extract..."` | Contenu du plan en Markdown. Injecté à partir du fichier de plan sur le disque |1600| `plan` | string | `"## Refactor auth\n1. Extract..."` | Contenu du plan en Markdown. Injecté à partir du fichier de plan sur le disque |

1599| `planFilePath` | string | `"/Users/.../plans/refactor-auth.md"` | Chemin vers le fichier de plan. Injecté |1601| `planFilePath` | string | `"/Users/.../plans/refactor-auth.md"` | Chemin vers le fichier de plan. Injecté |

1600| `allowedPrompts` | array | `[{"tool": "Bash", "prompt": "run tests"}]` | Optionnel. Permissions basées sur les prompts que Claude demande pour implémenter le plan, chacune avec un nom `tool` et un `prompt` décrivant la catégorie d'action |1602| `allowedPrompts` | array | `[{"tool": "Bash", "prompt": "run tests"}]` | {/* min-version: 2.1.205 */}Dépréciée. Claude Code accepte le champ mais l'ignore. Avant v2.1.205, il portait les permissions basées sur les prompts que Claude demandait pour implémenter le plan |

1601 1603 

1602Dans `PostToolUse`, `tool_response` est un objet avec les champs `plan` et `filePath` contenant le plan approuvé, plus les drapeaux d'état internes. Lisez `tool_response.plan` pour le contenu du plan plutôt que de relire le fichier depuis le disque.1604Dans `PostToolUse`, `tool_response` est un objet avec les champs `plan` et `filePath` contenant le plan approuvé, plus les drapeaux d'état internes. Lisez `tool_response.plan` pour le contenu du plan plutôt que de relire le fichier depuis le disque.

1603 1605 


1757Le champ de sortie `updatedPermissions` et le champ d'[entrée `permission_suggestions`](#permissionrequest-input) utilisent tous deux le même tableau d'objets d'entrée. Chaque entrée a un `type` qui détermine ses autres champs, et une `destination` qui contrôle où la modification est écrite.1759Le champ de sortie `updatedPermissions` et le champ d'[entrée `permission_suggestions`](#permissionrequest-input) utilisent tous deux le même tableau d'objets d'entrée. Chaque entrée a un `type` qui détermine ses autres champs, et une `destination` qui contrôle où la modification est écrite.

1758 1760 

1759| `type` | Champs | Effet |1761| `type` | Champs | Effet |

1760| :------------------ | :--------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |1762| :------------------ | :--------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

1761| `addRules` | `rules`, `behavior`, `destination` | Ajoute des règles de permission. `rules` est un tableau d'objets `{toolName, ruleContent?}`. Omettez `ruleContent` pour correspondre à l'outil entier. `behavior` est `"allow"`, `"deny"` ou `"ask"` |1763| `addRules` | `rules`, `behavior`, `destination` | Ajoute des règles de permission. `rules` est un tableau d'objets `{toolName, ruleContent?}`. Omettez `ruleContent` pour correspondre à l'outil entier. `behavior` est `"allow"`, `"deny"` ou `"ask"` |

1762| `replaceRules` | `rules`, `behavior`, `destination` | Remplace toutes les règles du `behavior` donné à la `destination` par les `rules` fournies |1764| `replaceRules` | `rules`, `behavior`, `destination` | Remplace toutes les règles du `behavior` donné à la `destination` par les `rules` fournies |

1763| `removeRules` | `rules`, `behavior`, `destination` | Supprime les règles correspondantes du `behavior` donné |1765| `removeRules` | `rules`, `behavior`, `destination` | Supprime les règles correspondantes du `behavior` donné |

1764| `setMode` | `mode`, `destination` | Change le mode de permission. Les modes valides sont `default`, `auto`, `acceptEdits`, `dontAsk`, `bypassPermissions` et `plan` |1766| `setMode` | `mode`, `destination` | Change le mode de permission. Les modes valides sont `default`, `auto`, `acceptEdits`, `dontAsk`, `bypassPermissions`, `plan` et {/* min-version: 2.1.200 */}`manual` comme alias pour `default`. L'alias `manual` nécessite Claude Code v2.1.200 ou ultérieur |

1765| `addDirectories` | `directories`, `destination` | Ajoute des répertoires de travail. `directories` est un tableau de chaînes de chemin |1767| `addDirectories` | `directories`, `destination` | Ajoute des répertoires de travail. `directories` est un tableau de chaînes de chemin |

1766| `removeDirectories` | `directories`, `destination` | Supprime les répertoires de travail |1768| `removeDirectories` | `directories`, `destination` | Supprime les répertoires de travail |

1767 1769 


2651 2653 

2652Parce que le hook remplace le comportement par défaut entièrement, [`.worktreeinclude`](/fr/worktrees#copy-gitignored-files-into-worktrees) n'est pas traité. Si vous avez besoin de copier les fichiers de configuration locaux comme `.env` dans le nouveau worktree, faites-le à l'intérieur de votre script de hook.2654Parce que le hook remplace le comportement par défaut entièrement, [`.worktreeinclude`](/fr/worktrees#copy-gitignored-files-into-worktrees) n'est pas traité. Si vous avez besoin de copier les fichiers de configuration locaux comme `.env` dans le nouveau worktree, faites-le à l'intérieur de votre script de hook.

2653 2655 

2654Le hook doit retourner le chemin absolu du répertoire du worktree créé. Claude Code utilise ce chemin comme répertoire de travail pour la session isolée. Les hooks de commande l'impriment sur stdout ; les hooks HTTP le retournent via `hookSpecificOutput.worktreePath`.2656Le hook doit retourner le chemin absolu du répertoire du worktree créé. Claude Code utilise ce chemin comme répertoire de travail pour la session isolée. Consultez [Sortie WorktreeCreate](#worktreecreate-output) pour savoir comment chaque type de hook retourne le chemin.

2655 2657 

2656Cet exemple crée une copie de travail SVN et imprime le chemin pour que Claude Code l'utilise. Remplacez l'URL du référentiel par la vôtre :2658Cet exemple crée une copie de travail SVN et imprime le chemin pour que Claude Code l'utilise. Remplacez l'URL du référentiel par la vôtre :

2657 2659 


2696 2698 

2697Les hooks WorktreeCreate n'utilisent pas le modèle de décision autoriser/bloquer standard. Au lieu de cela, le succès ou l'échec du hook détermine le résultat. Le hook doit retourner le chemin absolu du répertoire du worktree créé :2699Les hooks WorktreeCreate n'utilisent pas le modèle de décision autoriser/bloquer standard. Au lieu de cela, le succès ou l'échec du hook détermine le résultat. Le hook doit retourner le chemin absolu du répertoire du worktree créé :

2698 2700 

2699* **Hooks de commande** (`type: "command"`) : imprimez le chemin sur stdout.2701* **Hooks de commande** (`type: "command"`) : imprimez le chemin comme la dernière ligne non-vide de stdout. Claude Code supprime les codes d'échappement ANSI avant de lire cette ligne, donc les bannières de démarrage du shell imprimées avant votre `echo` sont ignorées. Redirigez toute autre sortie du hook vers stderr.

2700* **Hooks HTTP** (`type: "http"`) : retournez `{ "hookSpecificOutput": { "hookEventName": "WorktreeCreate", "worktreePath": "/absolute/path" } }` dans le corps de la réponse.2702* **Hooks HTTP** (`type: "http"`) : retournez `{ "hookSpecificOutput": { "hookEventName": "WorktreeCreate", "worktreePath": "/absolute/path" } }` dans le corps de la réponse.

2701 2703 

2702Si le hook échoue ou ne produit aucun chemin, la création du worktree échoue avec une erreur.2704Si le hook échoue ou ne produit aucun chemin, la création du worktree échoue avec une erreur.

2703 2705 

2706Claude Code résout un chemin relatif par rapport au répertoire dans lequel le hook s'est exécuté. Si le chemin résultant n'est pas un répertoire dans lequel Claude Code peut entrer, la session imprime une erreur nommant le chemin et quitte avec le code 1. Avant v2.1.205, un chemin relatif ou un chemin qui n'existait pas sur le disque plantait la session au démarrage, et avec `-p` il s'arrêtait pendant environ 30 secondes avant de quitter avec le code 0.

2707 

2704<h3 id="worktreeremove">2708<h3 id="worktreeremove">

2705 WorktreeRemove2709 WorktreeRemove

2706</h3>2710</h3>


3222 3226 

3223Après la sortie du processus en arrière-plan, si le hook a produit une réponse JSON avec un champ `additionalContext`, ce contenu est livré à Claude comme contexte au tour de conversation suivant. Un champ `systemMessage` vous est montré, pas à Claude.3227Après la sortie du processus en arrière-plan, si le hook a produit une réponse JSON avec un champ `additionalContext`, ce contenu est livré à Claude comme contexte au tour de conversation suivant. Un champ `systemMessage` vous est montré, pas à Claude.

3224 3228 

3229Claude Code valide que la réponse JSON respecte le même [schéma de sortie](#json-output) que les hooks synchrones, et supprime tout champ dont la valeur a le mauvais type, comme un `systemMessage` qui n'est pas une chaîne de caractères, au lieu de le livrer. Exécutez avec `--debug` pour voir un avertissement nommant chaque champ supprimé. Avant la v2.1.202, une sortie JSON malformée d'un hook asynchrone pouvait faire planter la session, et le plantage s'est reproduit chaque fois que la session a été reprise.

3230 

3225Les notifications d'achèvement des hooks asynchrones sont supprimées par défaut. Pour les voir, activez le mode verbeux avec `Ctrl+O` ou démarrez Claude Code avec `--verbose`.3231Les notifications d'achèvement des hooks asynchrones sont supprimées par défaut. Pour les voir, activez le mode verbeux avec `Ctrl+O` ou démarrez Claude Code avec `--verbose`.

3226 3232 

3227<h3 id="run-tests-after-file-changes">3233<h3 id="run-tests-after-file-changes">

hooks-guide.md +1 −1

Details

695 </Tab>695 </Tab>

696 696 

697 <Tab title="Correspondre aux outils MCP">697 <Tab title="Correspondre aux outils MCP">

698 Les outils MCP utilisent une convention de nommage différente des outils intégrés : `mcp__<server>__<tool>`, où `<server>` est le nom du serveur MCP et `<tool>` est l'outil qu'il fournit. Par exemple, `mcp__github__search_repositories` ou `mcp__filesystem__read_file`. Utilisez un matcher regex pour cibler tous les outils d'un serveur spécifique, ou correspondre entre les serveurs avec un modèle comme `mcp__.*__write.*`. Consultez [Correspondre aux outils MCP](/fr/hooks#match-mcp-tools) dans la référence pour la liste complète des exemples.698 Les outils MCP utilisent une convention de nommage différente des outils intégrés : `mcp__<server>__<tool>`, où `<server>` est le nom du serveur MCP et `<tool>` est l'outil qu'il fournit. Par exemple, `mcp__github__search_repositories` ou `mcp__filesystem__read_file`. Les outils d'un [serveur fourni par plugin](/fr/mcp#plugin-provided-mcp-servers) utilisent un segment de serveur délimité à la place, comme `mcp__plugin_my-plugin_db__query`. Utilisez un matcher regex pour cibler tous les outils d'un serveur spécifique, ou correspondre entre les serveurs avec un modèle comme `mcp__.*__write.*`. Consultez [Correspondre aux outils MCP](/fr/hooks#match-mcp-tools) dans la référence pour la liste complète des exemples.

699 699 

700 La commande ci-dessous extrait le nom de l'outil de l'entrée JSON du hook avec `jq` et l'écrit sur stderr. L'écriture sur stderr garde stdout propre pour la sortie JSON et envoie le message au [journal de débogage](/fr/hooks#debug-hooks) :700 La commande ci-dessous extrait le nom de l'outil de l'entrée JSON du hook avec `jq` et l'écrit sur stderr. L'écriture sur stderr garde stdout propre pour la sortie JSON et envoie le message au [journal de débogage](/fr/hooks#debug-hooks) :

701 701 

Details

186 186 

187Appuyez sur `Shift+Tab` pour parcourir les modes de permission :187Appuyez sur `Shift+Tab` pour parcourir les modes de permission :

188 188 

189* **Par défaut** : Claude demande avant les éditions de fichiers et les commandes shell189* **Manual** : Claude demande avant les éditions de fichiers et les commandes shell

190* **Auto-accepter les éditions** : Claude édite les fichiers et exécute les commandes courantes du système de fichiers comme `mkdir` et `mv` sans demander, demande toujours pour les autres commandes190* **Accept edits** : Claude édite les fichiers et exécute les commandes courantes du système de fichiers comme `mkdir` et `mv` sans demander, demande toujours pour les autres commandes

191* **Plan Mode** : Claude explore et propose un plan sans éditer vos fichiers source ; les invites de permission s'appliquent toujours comme en mode par défaut191* **Plan** : Claude explore et propose un plan sans éditer vos fichiers source ; les invites de permission s'appliquent toujours comme en mode Manual

192* **Auto mode** : Claude évalue toutes les actions avec des vérifications de sécurité en arrière-plan. Actuellement une préversion de recherche192* **Auto** : Claude évalue toutes les actions avec des vérifications de sécurité en arrière-plan. Actuellement une préversion de recherche

193 193 

194Vous pouvez également autoriser des commandes spécifiques dans `.claude/settings.json` afin que Claude ne demande pas à chaque fois. C'est utile pour les commandes de confiance comme `npm test` ou `git status`. Les paramètres peuvent être scoped à partir des politiques à l'échelle de l'organisation jusqu'aux préférences personnelles. Consultez [Permissions](/fr/permissions) pour plus de détails.194Vous pouvez également autoriser des commandes spécifiques dans `.claude/settings.json` afin que Claude ne demande pas à chaque fois. C'est utile pour les commandes de confiance comme `npm test` ou `git status`. Les paramètres peuvent être scoped à partir des politiques à l'échelle de l'organisation jusqu'aux préférences personnelles. Consultez [Permissions](/fr/permissions) pour plus de détails.

195 195 


210Les commandes intégrées vous guident également à travers la configuration :210Les commandes intégrées vous guident également à travers la configuration :

211 211 

212* `/init` vous guide à travers la création d'un CLAUDE.md pour votre projet212* `/init` vous guide à travers la création d'un CLAUDE.md pour votre projet

213* `/doctor` diagnostique les problèmes courants avec votre installation213* `/doctor` exécute une vérification de configuration qui diagnostique les problèmes d'installation et de configuration et peut les corriger

214 214 

215<h3 id="it’s-a-conversation">215<h3 id="it’s-a-conversation">

216 C'est une conversation216 C'est une conversation

Details

40| `Ctrl+T` | Basculer la liste des tâches de Claude | Afficher ou masquer [la liste des tâches de Claude](#task-list) dans la zone d'état. Ceci n'est pas la vue des tâches en arrière-plan ; utilisez [`/tasks`](/fr/commands) pour voir les shells et sous-agents en cours d'exécution |40| `Ctrl+T` | Basculer la liste des tâches de Claude | Afficher ou masquer [la liste des tâches de Claude](#task-list) dans la zone d'état. Ceci n'est pas la vue des tâches en arrière-plan ; utilisez [`/tasks`](/fr/commands) pour voir les shells et sous-agents en cours d'exécution |

41| `Flèches gauche/droite` | Parcourir les onglets de dialogue | Naviguez entre les onglets dans les dialogues de permission et les menus |41| `Flèches gauche/droite` | Parcourir les onglets de dialogue | Naviguez entre les onglets dans les dialogues de permission et les menus |

42| `Flèches haut/bas` ou `Ctrl+P`/`Ctrl+N` | Déplacer le curseur ou naviguer dans l'historique des commandes | Lorsque l'entrée s'étend sur plus d'une ligne visuelle, qu'elle soit enveloppée ou multiligne, déplace d'abord le curseur dans l'invite. Une fois que le curseur est sur la première ou la dernière ligne visuelle, appuyer à nouveau navigue dans l'historique des commandes. {/* min-version: 2.1.169 */}À partir de la v2.1.169, l'entrée monolignes enveloppée se comporte de la même manière que l'entrée multiligne |42| `Flèches haut/bas` ou `Ctrl+P`/`Ctrl+N` | Déplacer le curseur ou naviguer dans l'historique des commandes | Lorsque l'entrée s'étend sur plus d'une ligne visuelle, qu'elle soit enveloppée ou multiligne, déplace d'abord le curseur dans l'invite. Une fois que le curseur est sur la première ou la dernière ligne visuelle, appuyer à nouveau navigue dans l'historique des commandes. {/* min-version: 2.1.169 */}À partir de la v2.1.169, l'entrée monolignes enveloppée se comporte de la même manière que l'entrée multiligne |

43| `Esc` | Interrompre Claude | Arrêtez la réponse actuelle ou l'appel d'outil en cours de tour afin que vous puissiez rediriger. Claude conserve le travail effectué jusqu'à présent |43| `Esc` | Interrompre Claude, ou fermer un dialogue | Arrêtez la réponse actuelle ou l'appel d'outil en cours de tour afin que vous puissiez rediriger. Claude conserve le travail effectué jusqu'à présent. Lorsqu'un dialogue tel qu'une invite de permission est ouvert, `Esc` ferme le dialogue plutôt que d'interrompre Claude. {/* min-version: 2.1.202 */}Avant la v2.1.202, `Esc` sur certains dialogues interrompait Claude et laissait le dialogue ouvert |

44| `Esc` + `Esc` | Effacer le brouillon d'entrée, ou rembobiner | Lorsque l'entrée d'invite contient du texte, double `Esc` l'efface et enregistre le brouillon dans l'historique afin que `Haut` le rappelle. Lorsque l'entrée est vide, double `Esc` ouvre le [menu de rembobinage](/fr/checkpointing) pour restaurer ou résumer le code et la conversation à partir d'un point antérieur |44| `Esc` + `Esc` | Effacer le brouillon d'entrée, ou rembobiner | Lorsque l'entrée d'invite contient du texte, double `Esc` l'efface et enregistre le brouillon dans l'historique afin que `Haut` le rappelle. Lorsque l'entrée est vide, double `Esc` ouvre le [menu de rembobinage](/fr/checkpointing) pour restaurer ou résumer le code et la conversation à partir d'un point antérieur |

45| `Shift+Tab` ou `Alt+M` (certaines configurations) | Basculer les modes de permission | Basculer entre `default`, `acceptEdits`, `plan` et tous les modes que vous avez activés, comme `auto` ou `bypassPermissions`. Consultez [modes de permission](/fr/permission-modes). |45| `Shift+Tab` ou `Alt+M` (certaines configurations) | Basculer les modes de permission | Basculer entre `default` (étiqueté Manual dans l'indicateur de mode), `acceptEdits`, `plan` et tous les modes que vous avez activés, comme `auto` ou `bypassPermissions`. Consultez [modes de permission](/fr/permission-modes). |

46| `Option+P` (macOS) ou `Alt+P` (Windows/Linux) | Changer de modèle | Changez de modèles sans effacer votre invite |46| `Option+P` (macOS) ou `Alt+P` (Windows/Linux) | Changer de modèle | Changez de modèles sans effacer votre invite |

47| `Option+T` (macOS) ou `Alt+T` (Windows/Linux) | Basculer la réflexion étendue | Activez ou désactivez le mode de réflexion étendue. N'a aucun effet sur Fable 5, qui utilise toujours la réflexion étendue. {/* min-version: 2.1.132 */}À partir de la v2.1.132, ce raccourci fonctionne sur macOS sans configurer Option en tant que Meta |47| `Option+T` (macOS) ou `Alt+T` (Windows/Linux) | Basculer la réflexion étendue | Activez ou désactivez le mode de réflexion étendue. N'a aucun effet sur Fable 5, qui utilise toujours la réflexion étendue. {/* min-version: 2.1.132 */}À partir de la v2.1.132, ce raccourci fonctionne sur macOS sans configurer Option en tant que Meta |

48| `Option+O` (macOS) ou `Alt+O` (Windows/Linux) | Basculer le mode rapide | Activez ou désactivez le [mode rapide](/fr/fast-mode) |48| `Option+O` (macOS) ou `Alt+O` (Windows/Linux) | Basculer le mode rapide | Activez ou désactivez le [mode rapide](/fr/fast-mode) |


270 270 

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

272 272 

273Accepter une correspondance ou annuler la recherche prend effet immédiatement, même si Claude Code charge toujours l'historique. Avant la v2.1.202, accepter ou annuler pendant ce chargement pouvait signaler une erreur interne.

274 

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

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

275</h2>277</h2>

keybindings.md +12 −13

Details

71| `Select` | Composants génériques de sélection/liste |71| `Select` | Composants génériques de sélection/liste |

72| `Plugin` | Dialogue du plugin (parcourir, découvrir, gérer) |72| `Plugin` | Dialogue du plugin (parcourir, découvrir, gérer) |

73| `Scroll` | Défilement de la conversation et sélection de texte en mode plein écran |73| `Scroll` | Défilement de la conversation et sélection de texte en mode plein écran |

74| `Doctor` | Écran de diagnostics `/doctor` |74 

75{/* max-version: 2.1.204 */}Avant v2.1.205, un contexte `Doctor` et une action `doctor:fix` existaient pour l'écran de diagnostics `/doctor`.

75 76 

76<h2 id="available-actions">77<h2 id="available-actions">

77 Actions disponibles78 Actions disponibles


356| `select:accept` | Entrée, Espace | Modifier le paramètre sélectionné ou ouvrir son sous-menu |357| `select:accept` | Entrée, Espace | Modifier le paramètre sélectionné ou ouvrir son sous-menu |

357| `confirm:no` | Échappement | Fermer le panneau. Les modifications sont déjà enregistrées |358| `confirm:no` | Échappement | Fermer le panneau. Les modifications sont déjà enregistrées |

358 359 

359<h3 id="doctor-actions">

360 Actions du docteur

361</h3>

362 

363Actions disponibles dans le contexte `Doctor` :

364 

365| Action | Par défaut | Description |

366| :----------- | :--------- | :----------------------------------------------------------------------------------------------------------------------------------- |

367| `doctor:fix` | F | Envoyer le rapport de diagnostics à Claude pour corriger les problèmes signalés. Actif uniquement lorsque des problèmes sont trouvés |

368 

369<h3 id="voice-actions">360<h3 id="voice-actions">

370 Actions vocales361 Actions vocales

371</h3>362</h3>


477}468}

478```469```

479 470 

480Cela fonctionne également pour les liaisons d'accords. Délier tous les accords qui partagent un préfixe libère ce préfixe pour une utilisation comme liaison à touche unique :471Cela fonctionne également pour les liaisons d'accords. Délier tous les accords qui partagent un préfixe libère ce préfixe pour une utilisation comme liaison à touche unique. Un accord dans n'importe quel contexte actif conserve son préfixe réservé, vous devez donc délier chaque accord dans le contexte qui le définit.

472 

473La famille `Ctrl+X` par défaut s'étend sur deux contextes : `ctrl+x ctrl+k` et `ctrl+x ctrl+e` dans `Chat`, et `ctrl+x ctrl+b` dans `Task`. Pour récupérer `ctrl+x` lui-même comme liaison à touche unique, déliez tous les éléments suivants :

481 474 

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

483{476{

484 "bindings": [477 "bindings": [

478 {

479 "context": "Task",

480 "bindings": {

481 "ctrl+x ctrl+b": null

482 }

483 },

485 {484 {

486 "context": "Chat",485 "context": "Chat",

487 "bindings": {486 "bindings": {


546* Conflits de multiplexeur de terminal545* Conflits de multiplexeur de terminal

547* Liaisons en double dans le même contexte546* Liaisons en double dans le même contexte

548 547 

549Exécutez `/doctor` pour voir les avertissements de liaison de touches.548Claude Code signale les avertissements lors du chargement du fichier et écrit chacun d'eux dans le journal de débogage. Démarrez Claude Code avec [`--debug`](/fr/cli-reference#cli-flags) pour voir les détails.

Details

209 Application de bureau209 Application de bureau

210</h3>210</h3>

211 211 

212L'application de bureau lit le routage de passerelle à partir d'une [configuration distribuée par l'administrateur](https://claude.com/docs/cowork/3p/gateway), pas à partir de `ANTHROPIC_BASE_URL` ou `settings.json`. Si votre organisation l'a distribuée, l'application de bureau route via la passerelle sans configuration de votre côté ; sinon, utilisez la CLI de terminal ou l'extension VS Code pour les sessions de passerelle. Les administrateurs distribuent la configuration comme décrit dans le [déploiement organisationnel](/fr/llm-gateway-rollout#distribute-through-managed-settings).212L'application de bureau lit le routage de passerelle à partir d'une [configuration distribuée par l'administrateur](https://claude.com/docs/third-party/claude-desktop/gateway), pas à partir de `ANTHROPIC_BASE_URL` ou `settings.json`. Si votre organisation l'a distribuée, l'application de bureau route via la passerelle sans configuration de votre côté ; sinon, utilisez la CLI de terminal ou l'extension VS Code pour les sessions de passerelle. Les administrateurs distribuent la configuration comme décrit dans le [déploiement organisationnel](/fr/llm-gateway-rollout#distribute-through-managed-settings).

213 213 

214Si l'application de bureau affiche `Gateway was unreachable`, l'application n'a pas pu atteindre l'URL de base configurée au démarrage ; vérifiez l'URL et le chemin réseau avec le [test curl ci-dessus](#verify-the-connection).214Si l'application de bureau affiche `Gateway was unreachable`, l'application n'a pas pu atteindre l'URL de base configurée au démarrage ; vérifiez l'URL et le chemin réseau avec le [test curl ci-dessus](#verify-the-connection).

215 215 


231 anthropic_api_key: ${{ secrets.GATEWAY_API_KEY }}231 anthropic_api_key: ${{ secrets.GATEWAY_API_KEY }}

232```232```

233 233 

234Pour une passerelle bearer-token, passez le même secret comme entrée `anthropic_api_key` et `ANTHROPIC_AUTH_TOKEN` dans le bloc `env` du workflow. L'action nécessite `anthropic_api_key`, `CLAUDE_CODE_OAUTH_TOKEN`, ou la fédération d'identité de charge de travail avant de lancer Claude Code, et elle ne lit pas `ANTHROPIC_AUTH_TOKEN`, de sorte que l'entrée satisfait cette vérification de lancement tandis que la variable d'environnement met la clé dans l'en-tête `Authorization` que la passerelle lit. La copie dans `x-api-key` est ignorée :234Pour une passerelle bearer-token, passez le même secret deux fois : comme entrée `anthropic_api_key` et comme `ANTHROPIC_AUTH_TOKEN` dans le bloc `env` du workflow. L'action nécessite `anthropic_api_key`, `CLAUDE_CODE_OAUTH_TOKEN`, ou la fédération d'identité de charge de travail avant de lancer Claude Code, et elle ne lit pas `ANTHROPIC_AUTH_TOKEN`, de sorte que l'entrée est là uniquement pour satisfaire cette vérification de lancement. La variable d'environnement est ce qui met la clé dans l'en-tête `Authorization` que la passerelle lit ; la copie dans `x-api-key` est ignorée :

235 235 

236```yaml theme={null}236```yaml theme={null}

237env:237env:


287 287 

288[Remote Control](/fr/remote-control) et [la dictée vocale](/fr/voice-dictation) dépendent tous deux d'une identité claude.ai : Remote Control pour appairer une session en direct avec votre compte, et la dictée vocale pour atteindre le point de terminaison de transcription claude.ai. Ils ne sont pas disponibles tandis que `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN`, ou un `apiKeyHelper` est actif. {/* min-version: 2.1.196 */}À partir de la v2.1.196, Remote Control est également désactivé tandis que `ANTHROPIC_BASE_URL` pointe vers un hôte non-Anthropic, de sorte que la connexion avec claude.ai n'est pas suffisante en soi.288[Remote Control](/fr/remote-control) et [la dictée vocale](/fr/voice-dictation) dépendent tous deux d'une identité claude.ai : Remote Control pour appairer une session en direct avec votre compte, et la dictée vocale pour atteindre le point de terminaison de transcription claude.ai. Ils ne sont pas disponibles tandis que `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN`, ou un `apiKeyHelper` est actif. {/* min-version: 2.1.196 */}À partir de la v2.1.196, Remote Control est également désactivé tandis que `ANTHROPIC_BASE_URL` pointe vers un hôte non-Anthropic, de sorte que la connexion avec claude.ai n'est pas suffisante en soi.

289 289 

290Pour restaurer l'une ou l'autre fonctionnalité, connectez-vous avec claude.ai et désactivez les variables de passerelle qu'il vérifie. `/doctor` nomme la variable d'identifiant à désactiver.290Pour restaurer l'une ou l'autre fonctionnalité, connectez-vous avec claude.ai et désactivez les variables de passerelle que la fonctionnalité vérifie. La section Remote Control de `claude doctor` nomme la variable d'identifiant à désactiver.

291 291 

292* Dictée vocale : désactivez l'identifiant de passerelle292* Dictée vocale : désactivez l'identifiant de passerelle

293* Remote Control : désactivez l'identifiant de passerelle et `ANTHROPIC_BASE_URL`293* Remote Control : désactivez l'identifiant de passerelle et `ANTHROPIC_BASE_URL`


393 Router vers un fournisseur cloud via une passerelle393 Router vers un fournisseur cloud via une passerelle

394</h3>394</h3>

395 395 

396Ces configurations pointent Claude Code vers une passerelle via une variable d'URL de base spécifique au fournisseur à la place de `ANTHROPIC_BASE_URL`. Les passerelles Bedrock et Agent Platform acceptent les formats de demande natifs de ces fournisseurs ; les passerelles Foundry et Claude Platform sur AWS acceptent le format Anthropic Messages et diffèrent uniquement par la variable d'URL de base qui les atteint.396Ces configurations pointent Claude Code vers une passerelle via une variable d'URL de base spécifique au fournisseur à la place de `ANTHROPIC_BASE_URL`. Les passerelles Amazon Bedrock et Google Cloud's Agent Platform acceptent les formats de demande natifs de ces fournisseurs ; les passerelles Microsoft Foundry et Claude Platform sur AWS acceptent le format Anthropic Messages et diffèrent uniquement par la variable d'URL de base qui les atteint.

397 397 

398Utilisez-en une uniquement si votre équipe de passerelle a spécifiquement nommé Bedrock, Agent Platform, Foundry, ou Claude Platform sur AWS. Si la [demande de vérification](#verify-the-connection) ci-dessus a retourné JSON, vous pouvez ignorer cette section.398Utilisez-en une uniquement si votre équipe de passerelle a spécifiquement nommé Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, ou Claude Platform sur AWS. Si la [demande de vérification](#verify-the-connection) ci-dessus a retourné JSON, vous pouvez ignorer cette section.

399 399 

400Définissez le bloc pour le fournisseur que votre équipe de passerelle a nommé. Les variables skip-auth disent à Claude Code de ne pas signer les demandes avec les identifiants du fournisseur, puisque la passerelle les détient. Si la passerelle a besoin de son propre jeton, ajoutez `ANTHROPIC_AUTH_TOKEN` après le bloc, sauf pour Foundry, qui utilise `ANTHROPIC_FOUNDRY_API_KEY` comme montré.400Définissez le bloc pour le fournisseur que votre équipe de passerelle a nommé. Les variables skip-auth disent à Claude Code de ne pas signer les demandes avec les identifiants du fournisseur, puisque la passerelle les détient. Si la passerelle a besoin de son propre jeton, ajoutez `ANTHROPIC_AUTH_TOKEN` après le bloc, sauf pour Microsoft Foundry, qui utilise `ANTHROPIC_FOUNDRY_API_KEY` comme montré. {/* min-version: 2.1.203 */}Une passerelle Microsoft Foundry qui s'attend à un jeton porteur peut utiliser [`ANTHROPIC_FOUNDRY_AUTH_TOKEN`](/fr/env-vars) à la place ; elle prend la priorité sur `ANTHROPIC_FOUNDRY_API_KEY` quand les deux sont définis. `ANTHROPIC_FOUNDRY_AUTH_TOKEN` nécessite Claude Code v2.1.203 ou ultérieur.

401 401 

402<h4 id="amazon-bedrock">402<h4 id="amazon-bedrock">

403 Amazon Bedrock403 Amazon Bedrock


451 Microsoft Foundry451 Microsoft Foundry

452</h4>452</h4>

453 453 

454Mettez l'identifiant de la passerelle dans `ANTHROPIC_FOUNDRY_API_KEY` ; il est envoyé à la passerelle comme en-tête `x-api-key`. `CLAUDE_CODE_SKIP_FOUNDRY_AUTH` ne s'applique pas ici : sans clé API, le client Foundry échoue chaque demande avant qu'elle ne quitte la machine.454Mettez l'identifiant de la passerelle dans `ANTHROPIC_FOUNDRY_API_KEY` ; il est envoyé à la passerelle comme en-tête `x-api-key`. {/* min-version: 2.1.203 */}Une passerelle qui s'attend à un jeton porteur peut prendre [`ANTHROPIC_FOUNDRY_AUTH_TOKEN`](/fr/env-vars) à la place. Claude Code envoie cette valeur comme en-tête `Authorization: Bearer`, et elle prend la priorité sur `ANTHROPIC_FOUNDRY_API_KEY` quand les deux sont définis. Nécessite Claude Code v2.1.203 ou ultérieur.

455 

456Pour une passerelle qui injecte son propre en-tête `Authorization`, définissez `CLAUDE_CODE_SKIP_FOUNDRY_AUTH=1` et laissez les deux variables d'identifiant non définies. Claude Code envoie alors les demandes sans identifiant Azure et préserve l'en-tête `Authorization` que vous fournissez, par exemple via `ANTHROPIC_CUSTOM_HEADERS`. {/* min-version: 2.1.203 */}Avant v2.1.203, `CLAUDE_CODE_SKIP_FOUNDRY_AUTH` sans clé API laissait le client Microsoft Foundry incapable d'envoyer des demandes.

455 457 

456<Tabs>458<Tabs>

457 <Tab title="Bash ou Zsh">459 <Tab title="Bash ou Zsh">

Details

34 Formats API34 Formats API

35</h2>35</h2>

36 36 

37Une passerelle doit exposer au moins l'un des formats API suivants aux clients Claude Code. Le format que Claude Code utilise est déterminé par la configuration du client : la variable dans la colonne Sélectionné par du tableau ci-dessous pointe Claude Code vers votre passerelle dans ce format. Agent Platform est le point de terminaison Claude de Google Cloud, anciennement Vertex AI ; ses noms de variables conservent l'orthographe `VERTEX`.37Une passerelle doit exposer au moins l'un des formats API suivants aux clients Claude Code. Le format que Claude Code utilise est déterminé par la configuration du client : la variable dans la colonne Sélectionné par du tableau ci-dessous pointe Claude Code vers votre passerelle dans ce format. Google Cloud's Agent Platform est le point de terminaison Claude de Google Cloud, anciennement Vertex AI ; ses noms de variables conservent l'orthographe `VERTEX`.

38 38 

39| Format | Sélectionné par | Points de terminaison | Transmettre inchangé |39| Format | Sélectionné par | Points de terminaison | Transmettre inchangé |

40| :------------------------ | :------------------------------------------------------------ | :------------------------------------------------------------------------ | :--------------------------------------------------------------------------------------------------------------- |40| :--------------------------------------- | :------------------------------------------------------------ | :------------------------------------------------------------------------ | :--------------------------------------------------------------------------------------------------------------- |

41| Messages Anthropic | `ANTHROPIC_BASE_URL` | `/v1/messages`, `/v1/messages/count_tokens` (optionnel) | En-têtes de requête `anthropic-beta` et `anthropic-version` |41| Messages Anthropic | `ANTHROPIC_BASE_URL` | `/v1/messages`, `/v1/messages/count_tokens` (optionnel) | En-têtes de requête `anthropic-beta` et `anthropic-version` |

42| Bedrock InvokeModel | `ANTHROPIC_BEDROCK_BASE_URL` avec `CLAUDE_CODE_USE_BEDROCK=1` | `/model/{model}/invoke`, `/model/{model}/invoke-with-response-stream` | Champs de corps de requête `anthropic_beta` et `anthropic_version` |42| Amazon Bedrock InvokeModel | `ANTHROPIC_BEDROCK_BASE_URL` avec `CLAUDE_CODE_USE_BEDROCK=1` | `/model/{model}/invoke`, `/model/{model}/invoke-with-response-stream` | Champs de corps de requête `anthropic_beta` et `anthropic_version` |

43| 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 de corps de requête `anthropic_version` |43| 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 de corps de requête `anthropic_version` |

44 44 

45<h3 id="foundry-and-claude-platform-on-aws">45<h3 id="foundry-and-claude-platform-on-aws">

46 Foundry et Claude Platform on AWS46 Foundry et Claude Platform on AWS


52 Points de terminaison optionnels et trafic de démarrage52 Points de terminaison optionnels et trafic de démarrage

53</h3>53</h3>

54 54 

55Les points de terminaison de comptage de jetons sont les seuls optionnels : lorsqu'ils sont absents, Claude Code estime l'utilisation du contexte localement. Les requêtes d'inférence sont envoyées à `/v1/messages?beta=true`, donc faites correspondre le chemin, pas l'URL complète. La méthode Agent Platform ajoute des suffixes au chemin du modèle de l'éditeur, comme dans `/projects/{project}/locations/{location}/publishers/anthropic/models/{model}:streamRawPredict`.55Les points de terminaison de comptage de jetons sont les seuls optionnels : lorsqu'ils sont absents, Claude Code estime l'utilisation du contexte localement. Les requêtes d'inférence sont envoyées à `/v1/messages?beta=true`, donc faites correspondre le chemin, pas l'URL complète. La méthode Google Cloud's Agent Platform ajoute des suffixes au chemin du modèle de l'éditeur, comme dans `/projects/{project}/locations/{location}/publishers/anthropic/models/{model}:streamRawPredict`.

56 56 

57Une passerelle voit également du trafic de démarrage au meilleur effort qu'elle peut rejeter sans rien casser : une sonde de connectivité `HEAD /`, et sur les passerelles au format Bedrock une requête `GET /inference-profiles?type=SYSTEM_DEFINED`.57Une passerelle voit également du trafic de démarrage au meilleur effort qu'elle peut rejeter sans rien casser : une sonde de connectivité `HEAD /`, et sur les passerelles au format Amazon Bedrock une requête `GET /inference-profiles?type=SYSTEM_DEFINED`.

58 58 

59<h3 id="streaming">59<h3 id="streaming">

60 Streaming60 Streaming


68 68 

69Le format que le client utilise détermine ce que votre passerelle reçoit. Le mode de défaillance courant est une incompatibilité entre le format que le client envoie à votre passerelle et le format que le fournisseur amont derrière elle accepte.69Le format que le client utilise détermine ce que votre passerelle reçoit. Le mode de défaillance courant est une incompatibilité entre le format que le client envoie à votre passerelle et le format que le fournisseur amont derrière elle accepte.

70 70 

71* Lorsque le client utilise le format Bedrock ou Agent Platform, Claude Code envoie uniquement le sous-ensemble de son ensemble de capacités complet que ces fournisseurs acceptent71* Lorsque le client utilise le format Amazon Bedrock ou Google Cloud's Agent Platform, Claude Code envoie uniquement le sous-ensemble de son ensemble de capacités complet que ces fournisseurs acceptent

72* Lorsque le client utilise le format Messages Anthropic, Claude Code envoie l'ensemble complet, même si votre passerelle transmet à un amont Bedrock ou Agent Platform72* Lorsque le client utilise le format Messages Anthropic, Claude Code envoie l'ensemble complet, même si votre passerelle transmet à un amont Amazon Bedrock ou Google Cloud's Agent Platform

73 73 

74Combler cette différence est le travail de votre passerelle. [Transmission des fonctionnalités](#feature-pass-through) décrit ce qui se casse lorsqu'elle ne le fait pas.74Combler cette différence est le travail de votre passerelle. [Transmission des fonctionnalités](#feature-pass-through) décrit ce qui se casse lorsqu'elle ne le fait pas.

75 75 


82| En-tête | Description |82| En-tête | Description |

83| :------------------------------ | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |83| :------------------------------ | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

84| `Authorization`, `x-api-key` | L'identifiant de passerelle du développeur, dans un ou les deux en-têtes selon la [variable d'identifiant](/fr/llm-gateway-connect#set-the-credential-variable) qu'il définit |84| `Authorization`, `x-api-key` | L'identifiant de passerelle du développeur, dans un ou les deux en-têtes selon la [variable d'identifiant](/fr/llm-gateway-connect#set-the-credential-variable) qu'il définit |

85| `anthropic-version` | Version de l'API, actuellement `2023-06-01`. Les requêtes au format Bedrock et Agent Platform 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 |85| `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 |

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

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

88| `x-claude-code-agent-id` | Identifiant du [sous-agent](/fr/sub-agents) qui a émis la requête, présent uniquement sur les requêtes d'un agent que Claude Code a généré dans la session. Utilisez-le avec l'ID de session pour attribuer le coût aux agents parallèles |88| `x-claude-code-agent-id` | Identifiant du [sous-agent](/fr/sub-agents) qui a émis la requête, présent uniquement sur les requêtes d'un agent que Claude Code a généré dans la session. Utilisez-le avec l'ID de session pour attribuer le coût aux agents parallèles |


100 100 

101Lors de la transmission à un amont au format Anthropic, transmettez les en-têtes de requête `anthropic-*` et les champs de corps de requête inchangés plutôt que de mettre en liste blanche ceux que vous voyez aujourd'hui. Une passerelle épinglée à une liste observée supprime l'en-tête ou le champ de la capacité suivante et la casse à la version qui l'introduit.101Lors de la transmission à un amont au format Anthropic, transmettez les en-têtes de requête `anthropic-*` et les champs de corps de requête inchangés plutôt que de mettre en liste blanche ceux que vous voyez aujourd'hui. Une passerelle épinglée à une liste observée supprime l'en-tête ou le champ de la capacité suivante et la casse à la version qui l'introduit.

102 102 

103L'exception est un amont non-Anthropic tel que Bedrock ou Agent Platform, où combler la différence de schéma est le travail de la passerelle ; consultez [transmission des fonctionnalités](#feature-pass-through).103L'exception est un amont non-Anthropic tel qu'Amazon Bedrock ou Agent Platform de Google Cloud, où combler la différence de schéma est le travail de la passerelle ; consultez [transmission des fonctionnalités](#feature-pass-through).

104 104 

105<h2 id="system-prompt-attribution-block">105<h2 id="system-prompt-attribution-block">

106 Bloc d'attribution du message système106 Bloc d'attribution du message système


129Le streaming d'outils à grain fin est l'une des valeurs par défaut de connexion directe : il est désactivé par défaut chaque fois que les requêtes sont routées via une URL de base personnalisée, et une passerelle le reçoit lorsque les développeurs définissent [`CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING=1`](/fr/env-vars).129Le streaming d'outils à grain fin est l'une des valeurs par défaut de connexion directe : il est désactivé par défaut chaque fois que les requêtes sont routées via une URL de base personnalisée, et une passerelle le reçoit lorsque les développeurs définissent [`CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING=1`](/fr/env-vars).

130 130 

131| Fonctionnalité | Paire en-tête et corps | Symptôme lorsque cassé | Correction |131| Fonctionnalité | Paire en-tête et corps | Symptôme lorsque cassé | Correction |

132| :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------- |132| :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------- |

133| [Raisonnement adaptatif](/fr/model-config#adjust-effort-level) | Pas d'en-tête bêta. Claude Code envoie `thinking: {"type": "adaptive"}` pour Claude 4.6 et versions ultérieures, et traite les noms de modèles qu'il ne reconnaît pas, tels que les alias de passerelle, comme des modèles actuels qui reçoivent le champ | `400` nommant le champ `thinking` ou la balise `adaptive` lorsque la version du modèle amont ne l'accepte pas | Mettez à niveau l'amont. Sur Opus 4.6 et Sonnet 4.6, les développeurs peuvent définir `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1` à la place |133| [Raisonnement adaptatif](/fr/model-config#adjust-effort-level) | Pas d'en-tête bêta. Claude Code envoie `thinking: {"type": "adaptive"}` pour Claude 4.6 et versions ultérieures, et traite les noms de modèles qu'il ne reconnaît pas, tels que les alias de passerelle, comme des modèles actuels qui reçoivent le champ | `400` nommant le champ `thinking` ou la balise `adaptive` lorsque la version du modèle amont ne l'accepte pas | Mettez à niveau l'amont. Sur Opus 4.6 et Sonnet 4.6, les développeurs peuvent définir `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1` à la place |

134| [Gestion du contexte](https://platform.claude.com/docs/en/build-with-claude/context-management) | L'en-tête bêta de gestion du contexte s'associe au champ de corps `context_management` | `400` avec `Extra inputs are not permitted`. Courant lorsqu'une passerelle accepte les requêtes au format Anthropic mais les transmet à Bedrock | Transmettez les deux, ou [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](/fr/env-vars) |134| [Gestion du contexte](https://platform.claude.com/docs/en/build-with-claude/context-management) | L'en-tête bêta de gestion du contexte s'associe au champ de corps `context_management` | `400` avec `Extra inputs are not permitted`. Courant lorsqu'une passerelle accepte les requêtes au format Anthropic mais les transmet à Amazon Bedrock | Transmettez les deux, ou [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](/fr/env-vars) |

135| [Contexte étendu](https://platform.claude.com/docs/en/build-with-claude/context-windows#1m-token-context-window) et [pensée entrelacée](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#interleaved-thinking) | En-têtes bêta uniquement, pas de champ de corps | Silencieusement indisponible lorsque l'en-tête est supprimé ; l'amont ne voit jamais la demande de capacité | Transmettez `anthropic-beta` verbatim |135| [Contexte étendu](https://platform.claude.com/docs/en/build-with-claude/context-windows#1m-token-context-window) et [pensée entrelacée](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#interleaved-thinking) | En-têtes bêta uniquement, pas de champ de corps | Silencieusement indisponible lorsque l'en-tête est supprimé ; l'amont ne voit jamais la demande de capacité | Transmettez `anthropic-beta` verbatim |

136| Champs d'outil bêta | Les en-têtes bêta liés aux outils s'associent aux champs de schéma d'outil tels que `strict` et `defer_loading` | `400` nommant le champ de schéma d'outil non reconnu lorsque le corps passe sans son en-tête | Transmettez les deux, ou `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` |136| Champs d'outil bêta | Les en-têtes bêta liés aux outils s'associent aux champs de schéma d'outil tels que `strict` et `defer_loading` | `400` nommant le champ de schéma d'outil non reconnu lorsque le corps passe sans son en-tête | Transmettez les deux, ou `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` |

137| [Effort](https://platform.claude.com/docs/en/build-with-claude/effort) et [sorties structurées](https://platform.claude.com/docs/en/build-with-claude/structured-outputs) | Le champ de corps `output_config` porte les paramètres d'effort, de format de sortie structurée et de budget de tâche ; chacun s'associe à son propre en-tête bêta | `400` nommant `output_config`, souvent `Extra inputs are not permitted`, sur les amonts Bedrock et Agent Platform | Transmettez le champ et ses en-têtes ensemble |137| [Effort](https://platform.claude.com/docs/en/build-with-claude/effort) et [sorties structurées](https://platform.claude.com/docs/en/build-with-claude/structured-outputs) | Le champ de corps `output_config` porte les paramètres d'effort, de format de sortie structurée et de budget de tâche ; chacun s'associe à son propre en-tête bêta | `400` nommant `output_config`, souvent `Extra inputs are not permitted`, sur les amonts Amazon Bedrock et Agent Platform de Google Cloud | Transmettez le champ et ses en-têtes ensemble |

138| [Comptage des jetons](https://platform.claude.com/docs/en/build-with-claude/token-counting) | Pas d'appairage bêta ; utilise le point de terminaison `count_tokens` | Claude Code revient à l'estimation de l'utilisation du contexte localement | Exposez le point de terminaison si vous voulez des comptages exacts |138| [Comptage des jetons](https://platform.claude.com/docs/en/build-with-claude/token-counting) | Pas d'appairage bêta ; utilise le point de terminaison `count_tokens` | Claude Code revient à l'estimation de l'utilisation du contexte localement | Exposez le point de terminaison si vous voulez des comptages exacts |

139 139 

140Les [variables](/fr/model-config) `ANTHROPIC_DEFAULT_*_MODEL_SUPPORTED_CAPABILITIES` déclarent les capacités du modèle uniquement dans les configurations du fournisseur : `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_VERTEX`, `CLAUDE_CODE_USE_FOUNDRY`, et [`CLAUDE_CODE_USE_MANTLE`](/fr/amazon-bedrock#use-the-mantle-endpoint). Elles n'ont aucun effet derrière une passerelle `ANTHROPIC_BASE_URL`.140Les [variables](/fr/model-config) `ANTHROPIC_DEFAULT_*_MODEL_SUPPORTED_CAPABILITIES` déclarent les capacités du modèle uniquement dans les configurations du fournisseur : `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_VERTEX`, `CLAUDE_CODE_USE_FOUNDRY`, et [`CLAUDE_CODE_USE_MANTLE`](/fr/amazon-bedrock#use-the-mantle-endpoint). Elles n'ont aucun effet derrière une passerelle `ANTHROPIC_BASE_URL`.

Details

214 214 

215Certains environnements ont besoin d'une livraison séparée :215Certains environnements ont besoin d'une livraison séparée :

216 216 

217* L'application de bureau lit le routage de la passerelle uniquement à partir de sa configuration d'inférence tierce livrée par MDM ; déployez ce fichier aux côtés des paramètres gérés pour que les sessions de bureau routent également via la passerelle. Consultez la [documentation de configuration tierce du bureau](https://claude.com/docs/cowork/3p/configuration) et la [documentation de passerelle du bureau](https://claude.com/docs/cowork/3p/gateway)217* L'application de bureau lit le routage de la passerelle uniquement à partir de sa configuration d'inférence tierce livrée par MDM ; déployez ce fichier aux côtés des paramètres gérés pour que les sessions de bureau routent également via la passerelle. Consultez la [documentation de configuration tierce du bureau](https://claude.com/docs/third-party/claude-desktop/configuration) et la [documentation de passerelle du bureau](https://claude.com/docs/third-party/claude-desktop/gateway)

218* Les exécuteurs CI ont besoin de `ANTHROPIC_BASE_URL` et de l'identifiant définis dans l'[environnement de l'exécuteur](/fr/llm-gateway-connect#configure-each-surface)218* Les exécuteurs CI ont besoin de `ANTHROPIC_BASE_URL` et de l'identifiant définis dans l'[environnement de l'exécuteur](/fr/llm-gateway-connect#configure-each-surface)

219* WSL sur les machines Windows gérées lit les paramètres gérés Windows uniquement quand [`wslInheritsWindowsSettings`](/fr/settings#available-settings) est `true`219* WSL sur les machines Windows gérées lit les paramètres gérés Windows uniquement quand [`wslInheritsWindowsSettings`](/fr/settings#available-settings) est `true`

220 220 

mcp.md +34 −15

Details

85 85 

86Lors de la configuration des serveurs MCP via JSON dans `.mcp.json`, `~/.claude.json`, ou `claude mcp add-json`, le champ `type` accepte `streamable-http` comme alias pour `http`. La spécification MCP utilise le nom `streamable-http` pour ce transport, donc les configurations copiées à partir de la documentation du serveur fonctionnent sans modification.86Lors de la configuration des serveurs MCP via JSON dans `.mcp.json`, `~/.claude.json`, ou `claude mcp add-json`, le champ `type` accepte `streamable-http` comme alias pour `http`. La spécification MCP utilise le nom `streamable-http` pour ce transport, donc les configurations copiées à partir de la documentation du serveur fonctionnent sans modification.

87 87 

88Une entrée JSON qui a une `url` mais pas de `type` est une erreur de configuration, car Claude Code lit une entrée sans `type` comme un serveur stdio. Claude Code ignore ce serveur et signale `MCP server "<name>" has a "url" but no "type"; add "type": "http" (or "sse" / "ws") to this entry`. Avant la v2.1.202, Claude Code signalait cette mauvaise configuration comme `command: expected string, received undefined`.

89 

88<h3 id="option-2-add-a-remote-sse-server">90<h3 id="option-2-add-a-remote-sse-server">

89 Option 2 : Ajouter un serveur SSE distant91 Option 2 : Ajouter un serveur SSE distant

90</h3>92</h3>


113 115 

114Claude Code définit `CLAUDE_PROJECT_DIR` dans l'environnement du serveur généré à la racine du projet, afin que votre serveur puisse résoudre les chemins relatifs au projet sans dépendre du répertoire de travail. C'est le même répertoire que les hooks reçoivent dans leur variable `CLAUDE_PROJECT_DIR`. Lisez-le depuis l'intérieur de votre processus serveur, par exemple `process.env.CLAUDE_PROJECT_DIR` en Node ou `os.environ["CLAUDE_PROJECT_DIR"]` en Python.116Claude Code définit `CLAUDE_PROJECT_DIR` dans l'environnement du serveur généré à la racine du projet, afin que votre serveur puisse résoudre les chemins relatifs au projet sans dépendre du répertoire de travail. C'est le même répertoire que les hooks reçoivent dans leur variable `CLAUDE_PROJECT_DIR`. Lisez-le depuis l'intérieur de votre processus serveur, par exemple `process.env.CLAUDE_PROJECT_DIR` en Node ou `os.environ["CLAUDE_PROJECT_DIR"]` en Python.

115 117 

116Votre serveur peut également appeler la demande MCP `roots/list`, qui retourne le répertoire à partir duquel Claude Code a été lancé.118`CLAUDE_PROJECT_DIR` est la racine du projet stable et ne change pas lorsque vous ajoutez ou supprimez des répertoires de travail en cours de session. Un serveur qui limite son propre accès au système de fichiers à un ensemble de répertoires autorisés devrait implémenter la demande MCP `roots/list` à la place. Claude Code répond à `roots/list` avec le répertoire de lancement de la session plus chaque [répertoire de travail supplémentaire](/fr/permissions#working-directories) que vous avez accordé avec `--add-dir`, `/add-dir`, ou le paramètre `additionalDirectories`. Claude Code envoie `notifications/roots/list_changed` lorsque cet ensemble change. Avant la v2.1.203, `roots/list` retournait uniquement le répertoire de lancement et Claude Code n'envoyait pas `notifications/roots/list_changed`.

117 119 

118Cette variable est définie dans l'environnement du serveur, pas dans l'environnement propre de Claude Code, donc la référencer via l'expansion `${VAR}` dans un fichier `.mcp.json` de portée projet ou utilisateur `command` ou `args` nécessite une valeur par défaut telle que `${CLAUDE_PROJECT_DIR:-.}`. Les configurations MCP fournies par les plugins remplacent `${CLAUDE_PROJECT_DIR}` directement et n'ont pas besoin de la valeur par défaut.120Cette variable est définie dans l'environnement du serveur, pas dans l'environnement propre de Claude Code, donc la référencer via l'expansion `${VAR}` dans un fichier `.mcp.json` de portée projet ou utilisateur `command` ou `args` nécessite une valeur par défaut telle que `${CLAUDE_PROJECT_DIR:-.}`. Les configurations MCP fournies par les plugins remplacent `${CLAUDE_PROJECT_DIR}` directement et n'ont pas besoin de la valeur par défaut.

119 121 


191 193 

192Le panneau `/mcp` affiche le nombre d'outils à côté de chaque serveur connecté et signale les serveurs qui annoncent la capacité des outils mais n'exposent aucun outil.194Le panneau `/mcp` affiche le nombre d'outils à côté de chaque serveur connecté et signale les serveurs qui annoncent la capacité des outils mais n'exposent aucun outil.

193 195 

194Si votre demande a besoin d'outils d'un serveur qui se connecte toujours en arrière-plan, Claude attend que ce serveur se connecte avant de continuer. Avec la [recherche d'outils](#scale-with-mcp-tool-search) activée, qui est l'option par défaut, l'attente se produit à l'intérieur de l'appel `ToolSearch`. Dans les configurations sans recherche d'outils, telles que Vertex AI, une `ANTHROPIC_BASE_URL` personnalisée, ou `ENABLE_TOOL_SEARCH=false`, Claude utilise plutôt l'outil `WaitForMcpServers`.196Si votre demande a besoin d'outils d'un serveur qui se connecte toujours en arrière-plan, Claude attend que ce serveur se connecte avant de continuer. Avec la [recherche d'outils](#scale-with-mcp-tool-search) activée, qui est l'option par défaut, l'attente se produit à l'intérieur de l'appel `ToolSearch`. Dans les configurations sans recherche d'outils, telles que la plateforme Agent de Google Cloud, une `ANTHROPIC_BASE_URL` personnalisée, ou `ENABLE_TOOL_SEARCH=false`, Claude utilise plutôt l'outil `WaitForMcpServers`.

197 

198Certains noms de serveur sont réservés aux serveurs intégrés de Claude Code : `workspace`, `claude-in-chrome`, `computer-use`, `Claude Preview`, et `Claude Browser`. Si votre configuration définit un serveur avec un nom réservé, Claude Code le saute au chargement et affiche un avertissement vous demandant de le renommer. `claude mcp add` rejette un nom réservé avec une erreur.

195 199 

196Le nom du serveur `workspace` est réservé à un usage interne. Si votre configuration définit un serveur avec ce nom, Claude Code le saute au chargement et affiche un avertissement vous demandant de le renommer.200`Claude Preview` et `Claude Browser` nomment tous deux le serveur intégré que le [volet d'aperçu de l'application de bureau Claude Code](/fr/desktop#preview-your-app) utilise. Avant la v2.1.205, `Claude Browser` n'était pas réservé, donc un serveur configuré par l'utilisateur pouvait s'enregistrer sous ce nom.

197 201 

198<h3 id="dynamic-tool-updates">202<h3 id="dynamic-tool-updates">

199 Mises à jour dynamiques des outils203 Mises à jour dynamiques des outils


209 213 

210Le même backoff s'applique lorsqu'un serveur HTTP ou SSE échoue sa connexion initiale au démarrage. À partir de la v2.1.121, Claude Code réessaie la connexion initiale jusqu'à trois fois sur les erreurs transitoires telles qu'une réponse 5xx, une connexion refusée ou un délai d'expiration, puis marque le serveur comme échoué s'il ne peut toujours pas se connecter. Les erreurs d'authentification et les erreurs de non-trouvé ne sont pas réessayées car elles nécessitent une modification de la configuration pour être résolues.214Le même backoff s'applique lorsqu'un serveur HTTP ou SSE échoue sa connexion initiale au démarrage. À partir de la v2.1.121, Claude Code réessaie la connexion initiale jusqu'à trois fois sur les erreurs transitoires telles qu'une réponse 5xx, une connexion refusée ou un délai d'expiration, puis marque le serveur comme échoué s'il ne peut toujours pas se connecter. Les erreurs d'authentification et les erreurs de non-trouvé ne sont pas réessayées car elles nécessitent une modification de la configuration pour être résolues.

211 215 

216Lorsqu'un serveur configuré échoue à se connecter, Claude Code indique à Claude quel serveur a échoué et son erreur de connexion, y compris dans les résultats `ToolSearch` qui ne trouvent aucun outil correspondant, afin que Claude signale l'échec de la connexion dans sa réponse. Nécessite la [recherche d'outils](#scale-with-mcp-tool-search), qui est activée par défaut. Dans les configurations sans recherche d'outils, telles qu'une `ANTHROPIC_BASE_URL` personnalisée, `ENABLE_TOOL_SEARCH=false`, ou un modèle Haiku, et sur Amazon Bedrock, la plateforme Agent de Google Cloud, et Microsoft Foundry, Claude Code ne signale pas les échecs de connexion du serveur à Claude. Avant la v2.1.205, Claude Code ne transmettait pas les erreurs de connexion à Claude, et Claude pouvait répondre comme si les outils du serveur échoué n'avaient jamais été configurés.

217 

212À partir de la v2.1.191, les demandes de découverte de capacités qui s'exécutent après une connexion réussie, telles que `tools/list`, `prompts/list`, et `resources/list`, réessaient également les erreurs réseau transitoires et les erreurs du serveur jusqu'à trois fois avec un backoff court. Les erreurs d'authentification, les réponses 4xx et les délais d'expiration des demandes ne sont pas réessayés.218À partir de la v2.1.191, les demandes de découverte de capacités qui s'exécutent après une connexion réussie, telles que `tools/list`, `prompts/list`, et `resources/list`, réessaient également les erreurs réseau transitoires et les erreurs du serveur jusqu'à trois fois avec un backoff court. Les erreurs d'authentification, les réponses 4xx et les délais d'expiration des demandes ne sont pas réessayés.

213 219 

214<h3 id="push-messages-with-channels">220<h3 id="push-messages-with-channels">


220<Tip>226<Tip>

221 Conseils :227 Conseils :

222 228 

223 * Utilisez le drapeau `--scope` pour spécifier où la configuration est stockée :229 * Utilisez le drapeau `-s` ou `--scope` pour spécifier où la configuration est stockée :

224 * `local` (par défaut) : Disponible uniquement pour vous dans le projet actuel. Les versions antérieures appelaient cette portée `project`230 * `local` (par défaut) : Disponible uniquement pour vous dans le projet actuel. Les versions antérieures appelaient cette portée `project`

225 * `project` : Partagé avec tous les membres du projet via le fichier `.mcp.json`231 * `project` : Partagé avec tous les membres du projet via le fichier `.mcp.json`

226 * `user` : Disponible pour vous dans tous les projets. Les versions antérieures appelaient cette portée `global`232 * `user` : Disponible pour vous dans tous les projets. Les versions antérieures appelaient cette portée `global`

227 * Définissez les variables d'environnement avec les drapeaux `--env` (par exemple, `--env KEY=value`)233 * Définissez les variables d'environnement avec les drapeaux `-e` ou `--env` (par exemple, `-e KEY=value`)

234 * Les drapeaux `--transport` et `--header` acceptent également les formes courtes `-t` et `-H`

228 * Configurez le délai d'expiration du démarrage du serveur MCP en utilisant la variable d'environnement `MCP_TIMEOUT` (par exemple, `MCP_TIMEOUT=10000 claude` définit un délai d'expiration de 10 secondes)235 * Configurez le délai d'expiration du démarrage du serveur MCP en utilisant la variable d'environnement `MCP_TIMEOUT` (par exemple, `MCP_TIMEOUT=10000 claude` définit un délai d'expiration de 10 secondes)

229 * Définissez un délai d'expiration d'exécution d'outil par serveur en ajoutant un champ `timeout` en millisecondes à l'entrée `.mcp.json` de ce serveur, par exemple `"timeout": 600000` pour dix minutes. Cela remplace la variable d'environnement `MCP_TOOL_TIMEOUT` pour ce serveur uniquement236 * Définissez un délai d'expiration d'exécution d'outil par serveur en ajoutant un champ `timeout` en millisecondes à l'entrée `.mcp.json` de ce serveur, par exemple `"timeout": 600000` pour dix minutes. Cela remplace la variable d'environnement `MCP_TOOL_TIMEOUT` pour ce serveur uniquement

230 * Claude Code affichera un avertissement lorsque la sortie de l'outil MCP dépasse 10 000 jetons. Pour augmenter cette limite, définissez la variable d'environnement `MAX_MCP_OUTPUT_TOKENS` (par exemple, `MAX_MCP_OUTPUT_TOKENS=50000`)237 * Claude Code affichera un avertissement lorsque la sortie de l'outil MCP dépasse 10 000 jetons. Pour augmenter cette limite, définissez la variable d'environnement `MAX_MCP_OUTPUT_TOKENS` (par exemple, `MAX_MCP_OUTPUT_TOKENS=50000`)

231 * Utilisez `/mcp` pour vous authentifier auprès des serveurs distants qui nécessitent une authentification OAuth 2.0238 * Utilisez `/mcp` pour vous authentifier auprès des serveurs distants qui nécessitent une authentification OAuth 2.0

232</Tip>239</Tip>

233 240 

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

242 

243Un `timeout` par serveur d'au moins 1000 agit également comme un plancher sur le délai d'expiration d'inactivité décrit ci-dessous : Claude Code n'interrompt jamais les appels d'outils de ce serveur pour inactivité plus tôt que le `timeout` par serveur. Nécessite Claude Code v2.1.203 ou ultérieur.

244 

245Pour les serveurs HTTP et SSE, le budget du premier octet par requête de récupération a un minimum de 60 secondes.

235 246 

236À partir de la v2.1.187, un appel d'outil à un serveur HTTP, SSE, WebSocket distant, ou un [connecteur claude.ai](#use-mcp-servers-from-claude-ai) qui n'envoie aucune réponse et aucune notification de progression pendant 5 minutes s'interrompt avec une erreur au lieu d'attendre la limite en temps réel. Définissez la variable d'environnement [`CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT`](/fr/env-vars) en millisecondes pour modifier la fenêtre d'inactivité, ou définissez-la à `0` pour désactiver la vérification. Les serveurs Stdio sont des processus locaux et ne sont pas soumis au délai d'expiration d'inactivité.247Un appel d'outil à un serveur MCP qui n'envoie aucune réponse et aucune notification de progression pendant la fenêtre d'inactivité s'interrompt avec une erreur au lieu d'attendre la limite en temps réel. Le délai d'expiration d'inactivité nécessite Claude Code v2.1.187 ou ultérieur. {/* min-version: 2.1.203 */}Il s'applique à tous les types de serveurs sauf les serveurs IDE et les serveurs en processus du SDK. La fenêtre d'inactivité par défaut est de cinq minutes pour les serveurs HTTP, SSE, WebSocket, et [connecteur claude.ai](#use-mcp-servers-from-claude-ai), et de 30 minutes pour les serveurs stdio. Avant la v2.1.203, les serveurs stdio étaient exempts du délai d'expiration d'inactivité.

248 

249Définissez la variable d'environnement [`CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT`](/fr/env-vars) en millisecondes pour modifier la fenêtre d'inactivité, ou définissez-la à `0` pour désactiver la vérification.

237 250 

238<h3 id="plugin-provided-mcp-servers">251<h3 id="plugin-provided-mcp-servers">

239 Serveurs MCP fournis par les plugins252 Serveurs MCP fournis par les plugins


304mcp__plugin_my-plugin_database-tools__query317mcp__plugin_my-plugin_database-tools__query

305```318```

306 319 

307Utilisez ce nom complet lors du référencement de l'outil dans les [règles de permission](/fr/permissions), la liste `allowed-tools` d'une compétence, ou le [champ `tools` d'un sous-agent](/fr/sub-agents#available-tools).320Utilisez ce nom complet lors du référencement de l'outil dans les [règles de permission](/fr/permissions), la liste `allowed-tools` d'une compétence, le [champ `tools` d'un sous-agent](/fr/sub-agents#available-tools), ou un [correspondant de hook](/fr/hooks#match-mcp-tools). Un correspondant de hook écrit contre la clé du serveur nu, tel que `mcp__database-tools__.*`, ne se déclenche jamais pour un serveur groupé par un plugin.

321 

322Le serveur lui-même s'enregistre sous le nom délimité `plugin:<plugin-name>:<server-name>`, tel que `plugin:my-plugin:database-tools`. Utilisez ce nom où un nom de serveur configuré est attendu, tel que le [champ `server` d'un hook `mcp_tool`](/fr/hooks#mcp-tool-hook-fields).

308 323 

309**Avantages des serveurs MCP du plugin** :324**Avantages des serveurs MCP du plugin** :

310 325 


858 </Step>873 </Step>

859</Steps>874</Steps>

860 875 

876Les noms de serveurs ajoutés via les commandes `claude mcp` ne peuvent contenir que des lettres, des chiffres, des tirets et des traits de soulignement. Claude Desktop n'applique pas cette restriction, donc un serveur Claude Desktop dont le nom contient un autre caractère, comme un espace, ne peut pas être importé. L'importation signale chaque nom qu'elle rejette et importe toujours les autres serveurs que vous avez sélectionnés. Avant la v2.1.205, le premier nom invalide arrêtait l'importation et aucun des serveurs sélectionnés n'était ajouté.

877 

861<Tip>878<Tip>

862 Conseils :879 Conseils :

863 880 

864 * Cette fonctionnalité ne fonctionne que sur macOS et Windows Subsystem for Linux (WSL)881 * Cette fonctionnalité ne fonctionne que sur macOS et Windows Subsystem for Linux (WSL)

865 * Elle lit le fichier de configuration de Claude Desktop à partir de son emplacement standard sur ces plates-formes882 * Elle lit le fichier de configuration de Claude Desktop à partir de son emplacement standard sur ces plates-formes

866 * Utilisez le drapeau `--scope user` pour ajouter les serveurs à votre configuration utilisateur883 * Utilisez le drapeau `--scope user` pour ajouter les serveurs à votre configuration utilisateur

867 * Les serveurs importés auront les mêmes noms que dans Claude Desktop884 * Les serveurs importés conservent les mêmes noms que dans Claude Desktop lorsque le nom ne contient que des lettres, des chiffres, des tirets et des traits de soulignement. Claude Code signale un serveur dont le nom contient un autre caractère et l'ignore

868 * Si des serveurs portant les mêmes noms existent déjà, ils recevront un suffixe numérique (par exemple, `server_1`)885 * Si des serveurs portant les mêmes noms existent déjà, ils recevront un suffixe numérique (par exemple, `server_1`)

869</Tip>886</Tip>

870 887 


896 913 

897À partir de la v2.1.161, les connecteurs auxquels vous ne vous êtes jamais connecté sont réduits derrière une ligne `Show unused connectors` à la fin de la section claude.ai, de sorte qu'une liste fournie par l'organisation ne remplit pas le panneau. Sélectionnez la ligne pour les développer. Un connecteur auquel vous vous êtes connecté précédemment reste visible même s'il nécessite actuellement une réauthentification.914À partir de la v2.1.161, les connecteurs auxquels vous ne vous êtes jamais connecté sont réduits derrière une ligne `Show unused connectors` à la fin de la section claude.ai, de sorte qu'une liste fournie par l'organisation ne remplit pas le panneau. Sélectionnez la ligne pour les développer. Un connecteur auquel vous vous êtes connecté précédemment reste visible même s'il nécessite actuellement une réauthentification.

898 915 

899Les connecteurs de claude.ai sont récupérés uniquement lorsque votre [méthode d'authentification](/fr/authentication#authentication-precedence) active est votre abonnement claude.ai. Ils ne sont pas chargés lorsque `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN`, `apiKeyHelper`, ou un fournisseur tiers tel que Bedrock ou Vertex est actif, même si vous avez précédemment exécuté `/login`. Si `/mcp` ne répertorie pas un connecteur que vous avez ajouté, exécutez `/status` pour confirmer quelle méthode d'authentification est active, désactivez cette variable d'environnement ou supprimez le paramètre `apiKeyHelper`, puis exécutez `/login` pour sélectionner votre compte claude.ai.916Les connecteurs de claude.ai sont récupérés uniquement lorsque votre [méthode d'authentification](/fr/authentication#authentication-precedence) active est votre abonnement claude.ai. Ils ne sont pas chargés lorsque `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN`, `apiKeyHelper`, ou un fournisseur tiers tel que Amazon Bedrock ou Google Cloud's Agent Platform est actif, même si vous avez précédemment exécuté `/login`.

917 

918Si `/mcp` ne répertorie pas un connecteur que vous avez ajouté, exécutez `/status` pour confirmer quelle méthode d'authentification est active, désactivez cette variable d'environnement ou supprimez le paramètre `apiKeyHelper`, puis exécutez `/login` pour sélectionner votre compte claude.ai.

900 919 

901Un serveur que vous avez ajouté dans Claude Code prend [précédence](#scope-hierarchy-and-precedence) sur un connecteur claude.ai qui pointe vers la même URL. Quand cela se produit, `/mcp` répertorie le connecteur comme masqué et montre comment supprimer le doublon si vous préférez utiliser le connecteur.920Un serveur que vous avez ajouté dans Claude Code prend [précédence](#scope-hierarchy-and-precedence) sur un connecteur claude.ai qui pointe vers la même URL. Quand cela se produit, `/mcp` répertorie le connecteur comme masqué et montre comment supprimer le doublon si vous préférez utiliser le connecteur.

902 921 


1172 Configurer la recherche d'outils1191 Configurer la recherche d'outils

1173</h3>1192</h3>

1174 1193 

1175La recherche d'outils est activée par défaut : les outils MCP sont différés et découverts à la demande. Claude Code la désactive par défaut sur Vertex AI. Elle est également désactivée lorsque `ANTHROPIC_BASE_URL` pointe vers un hôte non-propriétaire, car la plupart des proxies ne transfèrent pas les blocs `tool_reference`. Définissez `ENABLE_TOOL_SEARCH` explicitement pour remplacer l'un ou l'autre des mécanismes de secours.1194La recherche d'outils est activée par défaut : les outils MCP sont différés et découverts à la demande. Claude Code la désactive par défaut sur la plateforme Agent de Google Cloud. Elle est également désactivée lorsque `ANTHROPIC_BASE_URL` pointe vers un hôte non-propriétaire, car la plupart des proxies ne transfèrent pas les blocs `tool_reference`. Définissez `ENABLE_TOOL_SEARCH` explicitement pour remplacer l'un ou l'autre des mécanismes de secours.

1176 1195 

1177La recherche d'outils nécessite un modèle qui supporte les blocs `tool_reference`. Les modèles Haiku ne le supportent pas. Sur Vertex AI, la recherche d'outils est supportée pour Claude Sonnet 4.5 et ultérieur et Claude Opus 4.5 et ultérieur.1196La recherche d'outils nécessite un modèle qui supporte les blocs `tool_reference`. Les modèles Haiku ne le supportent pas. Sur la plateforme Agent de Google Cloud, la recherche d'outils est supportée pour Claude Sonnet 4.5 et ultérieur et Claude Opus 4.5 et ultérieur.

1178 1197 

1179Contrôlez le comportement de la recherche d'outils avec la variable d'environnement `ENABLE_TOOL_SEARCH` :1198Contrôlez le comportement de la recherche d'outils avec la variable d'environnement `ENABLE_TOOL_SEARCH` :

1180 1199 

1181| Valeur | Comportement |1200| Valeur | Comportement |

1182| :----------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |1201| :----------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

1183| (non défini) | Tous les outils MCP différés et chargés à la demande. Revient au chargement à l'avance sur Vertex AI ou lorsque `ANTHROPIC_BASE_URL` est un hôte non-propriétaire |1202| (non défini) | Tous les outils MCP différés et chargés à la demande. Revient au chargement à l'avance sur la plateforme Agent de Google Cloud ou lorsque `ANTHROPIC_BASE_URL` est un hôte non-propriétaire |

1184| `true` | Tous les outils MCP différés. Claude Code envoie l'en-tête bêta même sur Vertex AI et via les proxies. Les demandes échouent sur les modèles Vertex AI antérieurs à Sonnet 4.5 ou Opus 4.5, ou sur les proxies qui ne supportent pas les blocs `tool_reference` |1203| `true` | Tous les outils MCP différés. Claude Code envoie l'en-tête bêta même sur la plateforme Agent de Google Cloud et via les proxies. Les demandes échouent sur les modèles de la plateforme Agent de Google Cloud antérieurs à Sonnet 4.5 ou Opus 4.5, ou sur les proxies qui ne supportent pas les blocs `tool_reference` |

1185| `auto` | Mode seuil : les outils se chargent à l'avance s'ils s'ajustent dans 10 % de la fenêtre de contexte, différés sinon |1204| `auto` | Mode seuil : les outils se chargent à l'avance s'ils s'ajustent dans 10 % de la fenêtre de contexte, différés sinon |

1186| `auto:N` | Mode seuil avec un pourcentage personnalisé, où `N` est 0-100. Par exemple, `auto:5` pour 5 % |1205| `auto:N` | Mode seuil avec un pourcentage personnalisé, où `N` est 0-100. Par exemple, `auto:5` pour 5 % |

1187| `false` | Tous les outils MCP chargés à l'avance, pas de différé |1206| `false` | Tous les outils MCP chargés à l'avance, pas de différé |

Details

315 Claude Code n'a trouvé aucun serveur pour le répertoire actuel. Les causes les plus courantes :315 Claude Code n'a trouvé aucun serveur pour le répertoire actuel. Les causes les plus courantes :

316 316 

317 * Vous avez exécuté `claude mcp add` à partir d'un projet différent. Les serveurs à portée locale sont liés au projet où vous les avez ajoutés : la racine du référentiel, ou le répertoire exact si vous n'étiez pas dans un référentiel git. Rajoutez le serveur à partir du projet dans lequel vous êtes maintenant, ou ajoutez-le avec `--scope user` pour qu'il ne soit pas lié à un projet.317 * Vous avez exécuté `claude mcp add` à partir d'un projet différent. Les serveurs à portée locale sont liés au projet où vous les avez ajoutés : la racine du référentiel, ou le répertoire exact si vous n'étiez pas dans un référentiel git. Rajoutez le serveur à partir du projet dans lequel vous êtes maintenant, ou ajoutez-le avec `--scope user` pour qu'il ne soit pas lié à un projet.

318 * Vous avez modifié un fichier de configuration au mauvais chemin. Les fichiers corrects sont `~/.claude.json` et `<project>/.mcp.json`. Claude Code ne lit pas les chemins tels que `~/.claude/config/mcp.json`, `~/.claude/mcp.json` ou `%APPDATA%\Claude\mcp.json`.318 * Vous avez modifié un fichier de configuration au mauvais chemin. Les fichiers corrects sont `~/.claude.json` et `<project>/.mcp.json`. Claude Code ne lit pas les chemins tels que `~/.claude/.mcp.json`, `~/.claude/config/mcp.json`, `~/.claude/mcp.json`, ou `%APPDATA%\Claude\mcp.json`. Pour les serveurs à portée utilisateur, exécutez `claude mcp add --scope user`, qui écrit dans la clé `mcpServers` dans `~/.claude.json` ; pour les serveurs à portée projet, modifiez `.mcp.json` à la racine du projet.

319 </Accordion>319 </Accordion>

320 320 

321 <Accordion title="Status shows Failed to connect or Connection error">321 <Accordion title="Status shows Failed to connect or Connection error">

Details

113 2) Configurer les identifiants Azure113 2) Configurer les identifiants Azure

114</h3>114</h3>

115 115 

116Claude Code prend en charge deux méthodes d'authentification pour Microsoft Foundry. Choisissez la méthode qui correspond le mieux à vos exigences de sécurité.116Claude Code prend en charge trois méthodes d'authentification pour Microsoft Foundry. Choisissez la méthode qui correspond le mieux à vos exigences de sécurité.

117 117 

118**Option A : Authentification par clé API**118**Option A : Authentification par clé API**

119 119 


128 128 

129**Option B : Authentification Microsoft Entra ID**129**Option B : Authentification Microsoft Entra ID**

130 130 

131Lorsque `ANTHROPIC_FOUNDRY_API_KEY` n'est pas défini, Claude Code utilise automatiquement la [chaîne d'identifiants par défaut](https://learn.microsoft.com/en-us/azure/developer/javascript/sdk/authentication/credential-chains#defaultazurecredential-overview) du SDK Azure.131Lorsque ni `ANTHROPIC_FOUNDRY_API_KEY` ni `ANTHROPIC_FOUNDRY_AUTH_TOKEN` ne sont définis, Claude Code utilise automatiquement la [chaîne d'identifiants par défaut](https://learn.microsoft.com/en-us/azure/developer/javascript/sdk/authentication/credential-chains#defaultazurecredential-overview) du SDK Azure.

132Cela prend en charge une variété de méthodes pour authentifier les charges de travail locales et distantes.132Cela prend en charge une variété de méthodes pour authentifier les charges de travail locales et distantes.

133 133 

134Dans les environnements locaux, vous pouvez généralement utiliser Azure CLI :134Dans les environnements locaux, vous pouvez généralement utiliser Azure CLI :


137az login137az login

138```138```

139 139 

140**Option C : Authentification par jeton porteur**

141 

142{/* min-version: 2.1.203 */}Claude Code envoie la valeur de `ANTHROPIC_FOUNDRY_AUTH_TOKEN` sur chaque demande en tant qu'en-tête `Authorization: Bearer`. Utilisez cette option lorsqu'un autre processus, tel qu'une application hôte ou un script de connexion, a déjà obtenu un jeton d'accès pour vous. Nécessite Claude Code v2.1.203 ou version ultérieure.

143 

144Définissez la variable sur un jeton porteur émis par Microsoft Entra ID pour votre ressource :

145 

146```bash theme={null}

147export ANTHROPIC_FOUNDRY_AUTH_TOKEN=your-entra-access-token

148```

149 

150`ANTHROPIC_FOUNDRY_AUTH_TOKEN` a la priorité sur `ANTHROPIC_FOUNDRY_API_KEY` et sur la chaîne d'identifiants par défaut.

151 

140<Note>152<Note>

141 Lors de l'utilisation de Microsoft Foundry, la commande `/logout` n'est pas disponible car l'authentification est gérée via les identifiants Azure.153 Lors de l'utilisation de Microsoft Foundry, la commande `/logout` n'est pas disponible car l'authentification est gérée via les identifiants Azure.

142</Note>154</Note>


162</h3>174</h3>

163 175 

164<Warning>176<Warning>

165 Épinglez des versions de modèle spécifiques pour chaque déploiement. Sans épinglage, les alias de modèle tels que `sonnet` et `opus` se résolvent à la valeur par défaut intégrée de Claude Code pour Foundry, qui peut être en retard par rapport à la version la plus récente et peut ne pas encore être disponible dans votre compte. Foundry n'a pas de vérification de modèle au démarrage, donc les demandes échouent lorsque la valeur par défaut n'est pas disponible. Lorsque vous créez des déploiements Azure, sélectionnez une version de modèle spécifique plutôt que « mise à jour automatique vers la dernière version ».177 Épinglez des versions de modèle spécifiques pour chaque déploiement. Sans épinglage, les alias de modèle tels que `sonnet` et `opus` se résolvent à la valeur par défaut intégrée de Claude Code pour Microsoft Foundry, qui peut être en retard par rapport à la version la plus récente et peut ne pas encore être disponible dans votre compte. Microsoft Foundry n'a pas de vérification de modèle au démarrage, donc les demandes échouent lorsque la valeur par défaut n'est pas disponible. Lorsque vous créez des déploiements Azure, sélectionnez une version de modèle spécifique plutôt que « mise à jour automatique vers la dernière version ».

166</Warning>178</Warning>

167 179 

168Définissez les variables de modèle pour correspondre aux noms de déploiement que vous avez créés à l'étape 1.180Définissez les variables de modèle pour correspondre aux noms de déploiement que vous avez créés à l'étape 1.

169 181 

170Sans `ANTHROPIC_DEFAULT_OPUS_MODEL`, l'alias `opus` sur Foundry se résout en Opus 4.6. Définissez-le sur l'ID Opus 4.8 pour utiliser le modèle le plus récent :182Sans `ANTHROPIC_DEFAULT_OPUS_MODEL`, l'alias `opus` sur Microsoft Foundry se résout en Opus 4.6. Définissez-le sur l'ID Opus 4.8 pour utiliser le modèle le plus récent :

171 183 

172```bash theme={null}184```bash theme={null}

173export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'185export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'


175export ANTHROPIC_DEFAULT_HAIKU_MODEL='claude-haiku-4-5'187export ANTHROPIC_DEFAULT_HAIKU_MODEL='claude-haiku-4-5'

176```188```

177 189 

178Les tâches en arrière-plan telles que la génération de titres de session utilisent le modèle petit/rapide, normalement un modèle de classe Haiku. Sur Foundry, Claude Code utilise par défaut le modèle principal car tous les comptes n'ont pas de déploiement Haiku. Pour utiliser Haiku pour les tâches en arrière-plan, définissez `ANTHROPIC_DEFAULT_HAIKU_MODEL` sur un déploiement Haiku disponible dans votre compte, comme indiqué ci-dessus.190Les tâches en arrière-plan telles que la génération de titres de session utilisent le modèle petit/rapide, normalement un modèle de classe Haiku. Sur Microsoft Foundry, Claude Code utilise par défaut le modèle principal car tous les comptes n'ont pas de déploiement Haiku. Pour utiliser Haiku pour les tâches en arrière-plan, définissez `ANTHROPIC_DEFAULT_HAIKU_MODEL` sur un déploiement Haiku disponible dans votre compte, comme indiqué ci-dessus.

179 191 

180Pour les ID de modèle actuels et hérités, consultez [Aperçu des modèles](https://platform.claude.com/docs/en/about-claude/models/overview). Consultez [Configuration des modèles](/fr/model-config#pin-models-for-third-party-deployments) pour la liste complète des variables d'environnement.192Pour les ID de modèle actuels et hérités, consultez [Aperçu des modèles](https://platform.claude.com/docs/en/about-claude/models/overview). Consultez [Configuration des modèles](/fr/model-config#pin-models-for-third-party-deployments) pour la liste complète des variables d'environnement.

181 193 


195claude207claude

196```208```

197 209 

198Claude Code lit `CLAUDE_CODE_USE_FOUNDRY` et les autres variables Foundry à partir de l'environnement et se connecte à votre ressource Azure à la première invite. Contrairement à Bedrock et Vertex AI, Foundry n'a pas d'assistant de configuration interactif, donc les variables d'environnement des étapes 3 et 4 sont le seul chemin de configuration.210Claude Code lit `CLAUDE_CODE_USE_FOUNDRY` et les autres variables Microsoft Foundry à partir de l'environnement et se connecte à votre ressource Azure à la première invite. Contrairement à Amazon Bedrock et à Google Cloud's Agent Platform, Microsoft Foundry n'a pas d'assistant de configuration interactif, donc les variables d'environnement des étapes 3 et 4 sont le seul chemin de configuration.

199 211 

200<h2 id="azure-rbac-configuration">212<h2 id="azure-rbac-configuration">

201 Configuration Azure RBAC213 Configuration Azure RBAC

model-config.md +79 −31

Details

15* Un **alias de modèle**15* Un **alias de modèle**

16* Un **nom de modèle**16* Un **nom de modèle**

17 * API Anthropic : un **[nom de modèle](https://platform.claude.com/docs/fr/about-claude/models/overview)** complet17 * API Anthropic : un **[nom de modèle](https://platform.claude.com/docs/fr/about-claude/models/overview)** complet

18 * Bedrock : un ARN de profil d'inférence18 * Amazon Bedrock : un ARN de profil d'inférence

19 * Foundry : un nom de déploiement19 * Microsoft Foundry : un nom de déploiement

20 * Vertex : un nom de version20 * Plateforme Agent de Google Cloud : un nom de version

21 21 

22<Note>22<Note>

23 `ANTHROPIC_BASE_URL` change l'endroit où les demandes sont envoyées, et non le modèle qui y répond. Pour acheminer Claude via une passerelle LLM, consultez la [passerelle LLM](/fr/llm-gateway).23 `ANTHROPIC_BASE_URL` change l'endroit où les demandes sont envoyées, et non le modèle qui y répond. Pour acheminer Claude via une passerelle LLM, consultez la [passerelle LLM](/fr/llm-gateway).


41| **`opus[1m]`** | Utilise Opus avec une [fenêtre de contexte de 1 million de tokens](https://platform.claude.com/docs/fr/build-with-claude/context-windows#1m-token-context-window) pour les sessions longues |41| **`opus[1m]`** | Utilise Opus avec une [fenêtre de contexte de 1 million de tokens](https://platform.claude.com/docs/fr/build-with-claude/context-windows#1m-token-context-window) pour les sessions longues |

42| **`opusplan`** | Mode spécial qui utilise `opus` pendant le mode plan, puis bascule vers `sonnet` pour l'exécution |42| **`opusplan`** | Mode spécial qui utilise `opus` pendant le mode plan, puis bascule vers `sonnet` pour l'exécution |

43 43 

44Sur l'API Anthropic, `opus` se résout en Opus 4.8 et `sonnet` se résout en Sonnet 5. Sur [Claude Platform on AWS](/fr/claude-platform-on-aws), `opus` se résout en Opus 4.7 et `sonnet` se résout en Sonnet 4.6. Sur Bedrock, Vertex et Foundry, `opus` se résout en Opus 4.6 et `sonnet` se résout en Sonnet 4.5 ; les modèles plus récents sont disponibles sur ces fournisseurs en sélectionnant le nom de modèle complet explicitement ou en définissant `ANTHROPIC_DEFAULT_OPUS_MODEL` ou `ANTHROPIC_DEFAULT_SONNET_MODEL`.44Sur l'API Anthropic, `opus` se résout en Opus 4.8 et `sonnet` se résout en Sonnet 5. Sur [Claude Platform on AWS](/fr/claude-platform-on-aws), `opus` se résout en Opus 4.7 et `sonnet` se résout en Sonnet 4.6. Sur Amazon Bedrock, Plateforme Agent de Google Cloud et Microsoft Foundry, `opus` se résout en Opus 4.6 et `sonnet` se résout en Sonnet 4.5 ; les modèles plus récents sont disponibles sur ces fournisseurs en sélectionnant le nom de modèle complet explicitement ou en définissant `ANTHROPIC_DEFAULT_OPUS_MODEL` ou `ANTHROPIC_DEFAULT_SONNET_MODEL`.

45 45 

46Les alias pointent vers la version recommandée pour votre fournisseur et se mettent à jour au fil du temps. Pour épingler une version spécifique, utilisez le nom de modèle complet (par exemple, `claude-opus-4-8`) ou définissez la variable d'environnement correspondante comme `ANTHROPIC_DEFAULT_OPUS_MODEL`.46Les alias pointent vers la version recommandée pour votre fournisseur et se mettent à jour au fil du temps. Pour épingler une version spécifique, utilisez le nom de modèle complet (par exemple, `claude-opus-4-8`) ou définissez la variable d'environnement correspondante comme `ANTHROPIC_DEFAULT_OPUS_MODEL`.

47 47 


84* `Enter` : basculer le modèle et enregistrer comme valeur par défaut84* `Enter` : basculer le modèle et enregistrer comme valeur par défaut

85* `s` : basculer le modèle pour cette session uniquement85* `s` : basculer le modèle pour cette session uniquement

86 86 

87Taper `/model <name>` directement se comporte comme `Enter`. Les paramètres du projet et gérés ont toujours la priorité et se réappliquent au prochain lancement. {/* min-version: 2.1.196 */}Un [modèle par défaut de l'organisation](#organization-default-model) que votre administrateur a configuré pour remplacer la sélection de l'utilisateur se réapplique également au prochain lancement.87Taper `/model <name>` directement se comporte comme `Enter`. {/* min-version: 2.1.205 */}Un modèle défini avec `/model` en [mode non interactif](/fr/headless), avec l'indicateur `-p`, s'applique uniquement à la session actuelle et n'est pas enregistré comme valeur par défaut. Les paramètres du projet et gérés ont toujours la priorité et se réappliquent au prochain lancement. {/* min-version: 2.1.196 */}Un [modèle par défaut de l'organisation](#organization-default-model) que votre administrateur a configuré pour remplacer la sélection de l'utilisateur se réapplique également au prochain lancement.

88 88 

89Dans les versions v2.1.144 à v2.1.152, `/model` s'appliquait uniquement à la session actuelle et `d` dans le sélecteur enregistrait une valeur par défaut.89Dans les versions v2.1.144 à v2.1.152, `/model` s'appliquait uniquement à la session actuelle et `d` dans le sélecteur enregistrait une valeur par défaut.

90 90 


96 96 

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

98 98 

99Lorsqu'un changement de modèle est demandé via la méthode `setModel()` du [SDK Agent](/fr/agent-sdk/overview) ou par une application telle que l'[application de bureau](/fr/desktop) qui exécute le CLI Claude Code pour vous, Claude Code vérifie que la chaîne est celle qu'il reconnaît avant de l'enregistrer. Cette vérification nécessite Claude Code v2.1.200 ou version ultérieure. Sur l'API Anthropic, Claude Code reconnaît :

100 

101* un alias de modèle

102* une entrée du sélecteur `/model`

103* tout nom qui commence par `claude-`

104* une valeur que vous avez configurée vous-même comme [option de modèle personnalisé](#add-a-custom-model-option) ou dans [`modelOverrides`](#override-model-ids-per-version)

105 

106Claude Code rejette une chaîne non reconnue avec `Model "<name>" is not a recognized model id.` et la session conserve son modèle actuel, au lieu d'enregistrer la chaîne et d'échouer à la prochaine demande. Consultez la [référence d'erreur](/fr/errors#model-is-not-a-recognized-model-id) pour les étapes de récupération.

107 

108La vérification s'exécute uniquement sur l'API Anthropic. Sur Amazon Bedrock, Plateforme Agent de Google Cloud, Microsoft Foundry, [Claude Platform on AWS](/fr/claude-platform-on-aws), et derrière une [passerelle LLM](/fr/llm-gateway) ou une `ANTHROPIC_BASE_URL` personnalisée, votre fournisseur ou passerelle définit les noms de modèle, donc Claude Code transmet toute chaîne sans la vérifier. La vérification ne couvre pas non plus l'indicateur `--model`, la variable d'environnement `ANTHROPIC_MODEL`, ou le paramètre `model` ; une valeur mal orthographiée là produit [There's an issue with the selected model](/fr/errors#there%E2%80%99s-an-issue-with-the-selected-model) à la première demande à la place.

109 

99Lorsque 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 la v2.1.182, le même avertissement est écrit dans stderr en [mode non interactif](/fr/headless) 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](/fr/sub-agents). 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](/fr/headless#get-structured-output) à la place.110Lorsque 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 la v2.1.182, le même avertissement est écrit dans stderr en [mode non interactif](/fr/headless) 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](/fr/sub-agents). 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](/fr/headless#get-structured-output) à la place.

100 111 

101Exemple d'utilisation :112Exemple d'utilisation :


135* **Modèle de conseiller** : le paramètre [`advisorModel`](/fr/advisor) configuré et le drapeau `--advisor`146* **Modèle de conseiller** : le paramètre [`advisorModel`](/fr/advisor) configuré et le drapeau `--advisor`

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

137 148 

138Le basculement vers un modèle bloqué avec `/model` est rejeté avec une erreur, tandis qu'un drapeau `--model` bloqué, une valeur `ANTHROPIC_MODEL`, ou une valeur de paramètre `model` est remplacée au démarrage par un avertissement nommant à la fois les modèles demandés et substitués, et la session démarre sur le modèle par défaut. Un remplacement de sous-agent, de compétence ou de commande bloqué revient au modèle hérité ou par défaut plutôt que d'échouer la demande ; un paramètre `advisorModel` bloqué désactive le conseiller pour la session, tandis qu'une valeur de drapeau `--advisor` bloquée quitte avec une erreur au lancement. Les modèles exclus sont masqués du sélecteur `/model`. {/* min-version: 2.1.199 */}À partir de la v2.1.199, un ID de modèle complet dans la liste qui n'a pas de ligne de sélecteur intégrée, comme une version antérieure que la liste épingle, apparaît dans le sélecteur `/model` comme sa propre ligne étiquetée. Sur les versions antérieures, un tel ID n'est sélectionnable qu'en tapant `/model <id>`.149Sur l'API Anthropic et [Claude Platform sur AWS](/fr/claude-platform-on-aws), un alias de famille de modèles, `opus`, `sonnet`, `haiku`, ou `fable`, se résout à la version la plus récente de sa famille que la liste d'autorisation permet. Lorsque la liste d'autorisation épingle des versions spécifiques, par exemple `["sonnet", "claude-opus-4-6"]`, à la fois `/model opus` et `--model opus` sélectionnent Claude Opus 4.6, la version Opus la plus récente autorisée, et affichent un avis nommant à la fois les modèles demandés et substitués. Avant la v2.1.205, un alias dont la version la plus récente était en dehors de la liste était rejeté ou remplacé comme toute autre sélection bloquée, même lorsque la liste permettait une version antérieure.

150 

151Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, et [Mantle](/fr/amazon-bedrock#use-the-mantle-endpoint) utilisent des ID de déploiement spécifiques au fournisseur plutôt que des ID de modèle Anthropic, de sorte qu'un alias bloqué là suit le comportement de rejet et de remplacement ci-dessous.

152 

153Claude Code gère toute autre sélection bloquée selon l'endroit où le modèle a été défini :

154 

155* **`/model`** : le basculement est rejeté avec une erreur

156* **Drapeau `--model`, `ANTHROPIC_MODEL`, ou paramètre `model`** : la valeur est remplacée au démarrage par un avertissement nommant à la fois les modèles demandés et substitués, et la session démarre sur le modèle par défaut

157* **Remplacement de sous-agent, de compétence ou de commande** : le remplacement revient au modèle hérité ou par défaut plutôt que d'échouer la demande

158* **Paramètre `advisorModel`** : le conseiller est désactivé pour la session

159* **Drapeau `--advisor`** : Claude Code quitte avec une erreur au lancement

160 

161Les modèles exclus sont masqués du sélecteur `/model`. {/* min-version: 2.1.199 */}Un ID de modèle complet dans la liste qui n'a pas de ligne de sélecteur intégrée, comme une version antérieure que la liste épingle, apparaît dans le sélecteur `/model` comme sa propre ligne étiquetée. Avant la v2.1.199, un tel ID n'était sélectionnable qu'en tapant `/model <id>`.

162 

163Les changements de modèle que Claude Code effectue en votre nom sont vérifiés de la même manière :

139 164 

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

166* **Mises à niveau en mode plan** : sur l'API Anthropic et Claude Platform sur AWS, une mise à niveau telle que [`opusplan`](#opusplan-model-setting) vers un modèle exclu utilise la version la plus récente autorisée de la famille de mise à niveau. Sur les fournisseurs avec des ID de modèle spécifiques au fournisseur, et lorsqu'aucune version n'est autorisée, la mise à niveau est ignorée et la planification continue sur le modèle de la session

167* **[Repli automatique de modèle](#automatic-model-fallback)** : un repli dont la cible est exclue ne s'exécute pas, de sorte que la demande signalée se termine par un refus

168* **[Mode rapide](/fr/fast-mode)** : l'activation du mode rapide est refusée lorsque le modèle sur lequel la session s'exécuterait ensuite est en dehors de la liste d'autorisation

141 169 

142```json theme={null}170```json theme={null}

143{171{


158 186 

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

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

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

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

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

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


167 Comportement du modèle par défaut195 Comportement du modèle par défaut

168</h3>196</h3>

169 197 

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

171 199 

172Un tableau `availableModels` vide n'engage jamais l'application du modèle par défaut : avec `availableModels: []`, les sélections de modèle nommées sont bloquées mais le modèle Par défaut pour le type de compte reste utilisable indépendamment de `enforceAvailableModels`.200Un tableau `availableModels` vide n'engage jamais l'application du modèle par défaut : avec `availableModels: []`, les sélections de modèle nommées sont bloquées mais le modèle Par défaut pour le type de compte reste utilisable indépendamment de `enforceAvailableModels`.

173 201 


194 Contrôler le modèle sur lequel les utilisateurs s'exécutent222 Contrôler le modèle sur lequel les utilisateurs s'exécutent

195</h3>223</h3>

196 224 

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

198 226 

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

200 228 


244 272 

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

246 274 

275Un [alias de famille de modèles](#restrict-model-selection) tel que `opus` se résout à la version la plus récente de sa famille que l'organisation permet, avec le même avis de substitution. `/model <alias>` est rejeté uniquement lorsque chaque version de sa famille est restreinte ; un alias défini avec `--model`, `ANTHROPIC_MODEL`, ou le paramètre `model` est toujours remplacé au démarrage dans ce cas. Avant la v2.1.205, un alias de famille était substitué ou rejeté en fonction de sa version la plus récente seule, même lorsqu'une version antérieure était autorisée.

276 

247Les restrictions s'appliquent au niveau de l'organisation ou par rôle :277Les restrictions s'appliquent au niveau de l'organisation ou par rôle :

248 278 

249* La désactivation d'un modèle au niveau de l'organisation le supprime pour chaque membre.279* La désactivation d'un modèle au niveau de l'organisation le supprime pour chaque membre.


251* Les modèles Haiku sont toujours disponibles et ne peuvent pas être désactivés, de sorte que chaque membre conserve au moins un modèle utilisable.281* Les modèles Haiku sont toujours disponibles et ne peuvent pas être désactivés, de sorte que chaque membre conserve au moins un modèle utilisable.

252* Un changement d'accès prend effet sur les nouvelles demandes dans environ une minute ; le sélecteur `/model` le reflète la prochaine fois qu'une session démarre.282* Un changement d'accès prend effet sur les nouvelles demandes dans environ une minute ; le sélecteur `/model` le reflète la prochaine fois qu'une session démarre.

253 283 

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

255 285 

256<h2 id="organization-default-model">286<h2 id="organization-default-model">

257 Modèle par défaut de l'organisation287 Modèle par défaut de l'organisation


310* **Max, Team Premium, Enterprise pay-as-you-go, et API Anthropic** : par défaut Opus 4.8340* **Max, Team Premium, Enterprise pay-as-you-go, et API Anthropic** : par défaut Opus 4.8

311* **Claude Platform sur AWS** : par défaut Opus 4.7341* **Claude Platform sur AWS** : par défaut Opus 4.7

312* **Pro, Team Standard, et sièges d'abonnement Enterprise** : par défaut Sonnet 5342* **Pro, Team Standard, et sièges d'abonnement Enterprise** : par défaut Sonnet 5

313* **Bedrock, Vertex, et Foundry** : par défaut Sonnet 4.5343* **Amazon Bedrock, Google Cloud's Agent Platform, et Microsoft Foundry** : par défaut Sonnet 4.5

314 344 

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

316 346 


333 363 

334La phase Opus en mode plan utilise la même fenêtre de contexte que le paramètre de modèle `opus`. Sur les niveaux d'abonnement où Opus est [automatiquement mis à niveau vers un contexte 1M](#extended-context), `opusplan` reçoit la mise à niveau en mode plan également. Pour forcer un contexte 1M pour les deux phases lorsque vous n'êtes pas sur un niveau de mise à niveau automatique, définissez le modèle sur `opusplan[1m]`.364La phase Opus en mode plan utilise la même fenêtre de contexte que le paramètre de modèle `opus`. Sur les niveaux d'abonnement où Opus est [automatiquement mis à niveau vers un contexte 1M](#extended-context), `opusplan` reçoit la mise à niveau en mode plan également. Pour forcer un contexte 1M pour les deux phases lorsque vous n'êtes pas sur un niveau de mise à niveau automatique, définissez le modèle sur `opusplan[1m]`.

335 365 

336Lorsque [`availableModels`](#restrict-model-selection) exclut Opus, `opusplan` reste sur Sonnet en mode plan au lieu de basculer. De même, une session Haiku qui se mettrait normalement à niveau vers Sonnet en mode plan reste sur Haiku lorsque Sonnet est exclu.366Lorsque [`availableModels`](#restrict-model-selection) exclut le nouvel Opus mais permet une version antérieure, par exemple `["sonnet", "claude-opus-4-6"]`, `opusplan` utilise le nouvel Opus autorisé pour la planification et reste sur Sonnet uniquement lorsque chaque Opus est exclu. Une session Haiku qui se mettrait normalement à niveau vers Sonnet en mode plan utilise de même le nouvel Sonnet autorisé, et reste sur Haiku uniquement lorsque chaque Sonnet est exclu. Avant v2.1.205, le mode plan restait sur le modèle de la session chaque fois que la version la plus récente de la famille de mise à niveau était exclue, même lorsque la liste d'autorisation permettait une version antérieure.

367 

368La substitution d'une version antérieure autorisée s'applique sur l'API Anthropic et [Claude Platform sur AWS](/fr/claude-platform-on-aws). Sur Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry et Mantle, dont les déploiements utilisent des ID de modèle spécifiques au fournisseur, le mode plan reste sur le modèle de la session chaque fois que le modèle de mise à niveau est exclu.

337 369 

338Pour une approche hybride où Claude décide en cours de tâche quand consulter un deuxième modèle plutôt que de basculer à la limite du plan, voir l'[outil advisor](/fr/advisor).370Pour une approche hybride où Claude décide en cours de tâche quand consulter un deuxième modèle plutôt que de basculer à la limite du plan, voir l'[outil advisor](/fr/advisor).

339 371 


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

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

401 433 

402<h4 id="enable-fallback-on-bedrock-vertex-ai-and-foundry">434<h4 id="enable-fallback-on-bedrock-agent-platform-and-foundry">

403 Activer le basculement sur Bedrock, Vertex AI et Foundry435 Activer le basculement sur Bedrock, Agent Platform et Foundry

404</h4>436</h4>

405 437 

406Sur [Amazon Bedrock](/fr/amazon-bedrock), [Google Vertex AI](/fr/google-vertex-ai) et [Microsoft Foundry](/fr/microsoft-foundry), les ID de modèle sont spécifiques au fournisseur, de sorte que le basculement automatique ne fonctionne que lorsque Claude Code peut identifier les deux modèles impliqués :438Sur [Amazon Bedrock](/fr/amazon-bedrock), [Google Cloud's Agent Platform](/fr/google-vertex-ai) et [Microsoft Foundry](/fr/microsoft-foundry), les ID de modèle sont spécifiques au fournisseur, de sorte que le basculement automatique ne fonctionne que lorsque Claude Code peut identifier les deux modèles impliqués :

407 439 

408* Claude Code doit reconnaître le modèle actuel comme Fable 5 : l'ID de modèle contient `claude-fable-5`, correspond à la valeur de `ANTHROPIC_DEFAULT_FABLE_MODEL`, ou est mappé avec [`modelOverrides`](#override-model-ids-per-version).440* Claude Code doit reconnaître le modèle actuel comme Fable 5 : l'ID de modèle contient `claude-fable-5`, correspond à la valeur de `ANTHROPIC_DEFAULT_FABLE_MODEL`, ou est mappé avec [`modelOverrides`](#override-model-ids-per-version).

409* La cible de basculement doit se résoudre en un modèle Opus : la valeur de `ANTHROPIC_DEFAULT_OPUS_MODEL` si définie, sinon une entrée Opus 4.8 dans la liste des modèles du fournisseur.441* La cible de basculement doit se résoudre en un modèle Opus : la valeur de `ANTHROPIC_DEFAULT_OPUS_MODEL` si définie, sinon une entrée Opus 4.8 dans la liste des modèles du fournisseur.


436 468 

437L'effort par défaut est `high` sur Fable 5, Sonnet 5, Opus 4.8, Opus 4.6 et Sonnet 4.6, et `xhigh` sur Opus 4.7.469L'effort par défaut est `high` sur Fable 5, Sonnet 5, Opus 4.8, Opus 4.6 et Sonnet 4.6, et `xhigh` sur Opus 4.7.

438 470 

439Lorsque vous exécutez Fable 5, Opus 4.8 ou Opus 4.7 pour la première fois, Claude Code applique l'effort par défaut de ce modèle même si vous aviez précédemment défini un niveau différent pour un autre modèle : `high` sur Fable 5 et Opus 4.8, et `xhigh` sur Opus 4.7. Exécutez `/effort` à nouveau pour choisir un niveau différent après le changement.471Lorsque vous exécutez Fable 5, Opus 4.8 ou Opus 4.7 pour la première fois, Claude Code applique l'effort par défaut de ce modèle même si vous aviez précédemment défini un niveau différent pour un autre modèle : `high` sur Fable 5 et Opus 4.8, et `xhigh` sur Opus 4.7. Exécutez `/effort` à nouveau pour choisir un niveau différent après le changement. Cet effort par défaut est conservé entre les sessions jusqu'à ce que vous fassiez un choix d'effort explicite, comme exécuter `/effort` dans une session interactive ou lancer avec `--effort`.

472 

473`low`, `medium`, `high` et `xhigh` persistent entre les sessions lorsque vous les définissez dans une session interactive. {/* min-version: 2.1.205 */}Un niveau défini avec `/effort` en [mode non interactif](/fr/headless), avec le drapeau `-p`, s'applique à la session actuelle uniquement et n'est pas enregistré comme votre valeur par défaut. Un `/effort` non interactif ne peut pas non plus libérer la retenue de la valeur par défaut du modèle ci-dessus : sur Fable 5, Opus 4.8 et Opus 4.7, il signale `Not applied` et la session reste à l'effort par défaut du modèle, donc passez `--effort` au lancement à la place. `max` fournit le raisonnement le plus profond sans contrainte sur les dépenses en tokens et s'applique à la session actuelle uniquement, sauf lorsqu'il est défini via la variable d'environnement `CLAUDE_CODE_EFFORT_LEVEL`.

474 

475Le menu `/effort` offre également `ultracode`. Ultracode est un paramètre de Claude Code plutôt qu'un niveau d'effort du modèle : il envoie `xhigh` au modèle et a également Claude orchestrer les [flux de travail dynamiques](/fr/workflows) pour les tâches substantielles. Il s'applique à la session actuelle uniquement.

476 

477Vous pouvez activer ultracode par l'une des méthodes suivantes :

440 478 

441`low`, `medium`, `high` et `xhigh` persistent entre les sessions. `max` fournit le raisonnement le plus profond sans contrainte sur les dépenses en tokens et s'applique à la session actuelle uniquement, sauf lorsqu'il est défini via la variable d'environnement `CLAUDE_CODE_EFFORT_LEVEL`.479* **`/effort`** : exécutez `/effort ultracode`, ou sélectionnez-le dans le menu

480* **Drapeau `--effort`** : lancez avec `claude --effort ultracode`, qui démarre la session avec un effort `xhigh` et ultracode activé

481* **`--settings` ou une demande de contrôle du SDK Agent** : passez `"ultracode": true`. Une demande [`applyFlagSettings()`](/fr/agent-sdk/typescript#applyflagsettings) accepte également `effortLevel: "ultracode"`

442 482 

443Le menu `/effort` offre également `ultracode`. Ultracode est un paramètre de Claude Code plutôt qu'un niveau d'effort du modèle : il envoie `xhigh` au modèle et a également Claude orchestrer les [flux de travail dynamiques](/fr/workflows) pour les tâches substantielles. Il s'applique à la session actuelle uniquement. Définissez-le via `/effort`, ou passez `"ultracode": true` via `--settings` ou une demande de contrôle du SDK Agent. Il ne fait pas partie du paramètre `effortLevel`, du drapeau `--effort` ou de `CLAUDE_CODE_EFFORT_LEVEL`.483Passer `ultracode` au drapeau `--effort` ou à la valeur `effortLevel` du SDK Agent nécessite Claude Code v2.1.203 ou ultérieur. Avant v2.1.203, `--effort ultracode` affichait `Unknown --effort value 'ultracode'` et la session démarrait avec l'effort par défaut.

484 

485Le paramètre `effortLevel` persisté et la variable d'environnement `CLAUDE_CODE_EFFORT_LEVEL` n'acceptent pas `ultracode`.

486 

487Lorsque ultracode n'est pas disponible, par exemple lorsque les [flux de travail sont désactivés](/fr/workflows#turn-workflows-off), `--effort ultracode` définit uniquement l'effort `xhigh`.

444 488 

445<h4 id="choose-an-effort-level">489<h4 id="choose-an-effort-level">

446 Choisir un niveau d'effort490 Choisir un niveau d'effort


597 Épingler les modèles pour les déploiements tiers641 Épingler les modèles pour les déploiements tiers

598</h3>642</h3>

599 643 

600Lors du déploiement de Claude Code via [Bedrock](/fr/amazon-bedrock), [Vertex AI](/fr/google-vertex-ai), [Foundry](/fr/microsoft-foundry) ou [Claude Platform on AWS](/fr/claude-platform-on-aws), épinglez les versions de modèle avant de les déployer auprès des utilisateurs.644Lors du déploiement de Claude Code via [Amazon Bedrock](/fr/amazon-bedrock), [Google Cloud's Agent Platform](/fr/google-vertex-ai), [Microsoft Foundry](/fr/microsoft-foundry), ou [Claude Platform on AWS](/fr/claude-platform-on-aws), épinglez les versions de modèle avant de les déployer auprès des utilisateurs.

601 645 

602Sans épinglage, Claude Code utilise les alias de modèle tels que `fable`, `opus`, `sonnet` et `haiku` qui se résolvent à un ID de modèle par défaut intégré pour chaque fournisseur. Ce défaut peut être en retard par rapport à la dernière version d'Anthropic, et le modèle auquel il pointe peut ne pas encore être activé dans le compte d'un utilisateur. Lorsque le défaut n'est pas disponible, les utilisateurs de Bedrock et Vertex AI voient un avis et reviennent à la version précédente pour cette session, tandis que les utilisateurs de Foundry voient des erreurs car Foundry n'a pas de vérification de démarrage équivalente.646Sans épinglage, Claude Code utilise les alias de modèle tels que `fable`, `opus`, `sonnet` et `haiku` qui se résolvent à un ID de modèle par défaut intégré pour chaque fournisseur. Ce défaut peut être en retard par rapport à la dernière version d'Anthropic, et le modèle auquel il pointe peut ne pas encore être activé dans le compte d'un utilisateur. Lorsque le défaut n'est pas disponible, les utilisateurs d'Amazon Bedrock et de Google Cloud's Agent Platform voient un avis et reviennent à la version précédente pour cette session, tandis que les utilisateurs de Microsoft Foundry voient des erreurs car Microsoft Foundry n'a pas de vérification de démarrage équivalente.

603 647 

604<Warning>648<Warning>

605 Définissez les variables d'environnement de modèle sur des ID de version spécifiques dans le cadre de votre configuration initiale. L'épinglage vous permet de contrôler quand vos utilisateurs passent à un nouveau modèle.649 Définissez les variables d'environnement de modèle sur des ID de version spécifiques dans le cadre de votre configuration initiale. L'épinglage vous permet de contrôler quand vos utilisateurs passent à un nouveau modèle.


608Utilisez les variables d'environnement suivantes avec des ID de modèle spécifiques à la version pour votre fournisseur :652Utilisez les variables d'environnement suivantes avec des ID de modèle spécifiques à la version pour votre fournisseur :

609 653 

610| Fournisseur | Exemple |654| Fournisseur | Exemple |

611| :---------- | :------------------------------------------------------------------- |655| :---------------------------- | :------------------------------------------------------------------- |

612| Bedrock | `export ANTHROPIC_DEFAULT_OPUS_MODEL='us.anthropic.claude-opus-4-8'` |656| Amazon Bedrock | `export ANTHROPIC_DEFAULT_OPUS_MODEL='us.anthropic.claude-opus-4-8'` |

613| Vertex AI | `export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'` |657| Google Cloud's Agent Platform | `export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'` |

614| Foundry | `export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'` |658| Microsoft Foundry | `export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'` |

615 659 

616Appliquez le même modèle pour `ANTHROPIC_DEFAULT_FABLE_MODEL`, `ANTHROPIC_DEFAULT_SONNET_MODEL` et `ANTHROPIC_DEFAULT_HAIKU_MODEL`. Pour les ID de modèle actuels et hérités sur tous les fournisseurs, voir [Aperçu des modèles](https://platform.claude.com/docs/en/about-claude/models/overview). Pour mettre à niveau les utilisateurs vers une nouvelle version de modèle, mettez à jour ces variables d'environnement et redéployez.660Appliquez le même modèle pour `ANTHROPIC_DEFAULT_FABLE_MODEL`, `ANTHROPIC_DEFAULT_SONNET_MODEL` et `ANTHROPIC_DEFAULT_HAIKU_MODEL`. Pour les ID de modèle actuels et hérités sur tous les fournisseurs, voir [Aperçu des modèles](https://platform.claude.com/docs/en/about-claude/models/overview). Pour mettre à niveau les utilisateurs vers une nouvelle version de modèle, mettez à jour ces variables d'environnement et redéployez.

617 661 


625 669 

626* Claude Code supprime le suffixe avant d'envoyer l'ID du modèle à votre fournisseur.670* Claude Code supprime le suffixe avant d'envoyer l'ID du modèle à votre fournisseur.

627* N'ajoutez `[1m]` que lorsque le modèle sous-jacent [prend en charge le contexte 1M](https://platform.claude.com/docs/en/build-with-claude/context-windows#1m-token-context-window).671* N'ajoutez `[1m]` que lorsque le modèle sous-jacent [prend en charge le contexte 1M](https://platform.claude.com/docs/en/build-with-claude/context-windows#1m-token-context-window).

628* Le suffixe est lu par variable, et non par modèle. Sur Bedrock, Vertex et Foundry, un ID de modèle sans `[1m]` dans une variable utilise le contexte 200K même si une autre variable définit le même modèle avec le suffixe. Sonnet 5 s'exécute toujours avec la fenêtre 1M sur ces fournisseurs et n'a jamais besoin du suffixe.672* Le suffixe est lu par variable, et non par modèle. Sur Amazon Bedrock, Google Cloud's Agent Platform et Microsoft Foundry, un ID de modèle sans `[1m]` dans une variable utilise le contexte 200K même si une autre variable définit le même modèle avec le suffixe. Sonnet 5 s'exécute toujours avec la fenêtre 1M sur ces fournisseurs et n'a jamais besoin du suffixe.

629 673 

630<Note>674<Note>

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


637 681 

638Lorsque vous épinglez un modèle sur un fournisseur tiers, l'ID spécifique au fournisseur apparaît tel quel dans le sélecteur `/model` et Claude Code peut ne pas reconnaître les fonctionnalités que le modèle prend en charge. Vous pouvez remplacer le nom d'affichage et déclarer les capacités avec des variables d'environnement complémentaires pour chaque modèle épinglé.682Lorsque vous épinglez un modèle sur un fournisseur tiers, l'ID spécifique au fournisseur apparaît tel quel dans le sélecteur `/model` et Claude Code peut ne pas reconnaître les fonctionnalités que le modèle prend en charge. Vous pouvez remplacer le nom d'affichage et déclarer les capacités avec des variables d'environnement complémentaires pour chaque modèle épinglé.

639 683 

640Ces variables prennent effet sur les fournisseurs tiers tels que Bedrock, Vertex AI et Foundry. Les variables `_NAME` et `_DESCRIPTION` prennent également effet lorsque `ANTHROPIC_BASE_URL` pointe vers une [passerelle LLM](/fr/llm-gateway). Elles n'ont aucun effet lors de la connexion directe à `api.anthropic.com`.684Ces variables prennent effet sur les fournisseurs tiers tels qu'Amazon Bedrock, Google Cloud's Agent Platform et Microsoft Foundry. Les variables `_NAME` et `_DESCRIPTION` prennent également effet lorsque `ANTHROPIC_BASE_URL` pointe vers une [passerelle LLM](/fr/llm-gateway). Elles n'ont aucun effet lors de la connexion directe à `api.anthropic.com`.

641 685 

642| Variable d'environnement | Description |686| Variable d'environnement | Description |

643| ----------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |687| ----------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |


647 691 

648Les mêmes suffixes `_NAME`, `_DESCRIPTION` et `_SUPPORTED_CAPABILITIES` sont disponibles pour `ANTHROPIC_DEFAULT_SONNET_MODEL`, `ANTHROPIC_DEFAULT_HAIKU_MODEL`, `ANTHROPIC_DEFAULT_FABLE_MODEL` et `ANTHROPIC_CUSTOM_MODEL_OPTION`.692Les mêmes suffixes `_NAME`, `_DESCRIPTION` et `_SUPPORTED_CAPABILITIES` sont disponibles pour `ANTHROPIC_DEFAULT_SONNET_MODEL`, `ANTHROPIC_DEFAULT_HAIKU_MODEL`, `ANTHROPIC_DEFAULT_FABLE_MODEL` et `ANTHROPIC_CUSTOM_MODEL_OPTION`.

649 693 

650Claude Code active les fonctionnalités comme les [niveaux d'effort](#adjust-effort-level) et la [réflexion étendue](#extended-thinking) en faisant correspondre l'ID du modèle à des modèles connus. Les ID spécifiques au fournisseur tels que les ARN Bedrock ou les noms de déploiement personnalisés ne correspondent souvent pas à ces modèles, laissant les fonctionnalités prises en charge désactivées. Définissez `_SUPPORTED_CAPABILITIES` pour indiquer à Claude Code les fonctionnalités que le modèle prend réellement en charge :694Claude Code active les fonctionnalités comme les [niveaux d'effort](#adjust-effort-level) et la [réflexion étendue](#extended-thinking) en faisant correspondre l'ID du modèle à des modèles connus. Les ID spécifiques au fournisseur tels que les ARN Amazon Bedrock ou les noms de déploiement personnalisés ne correspondent souvent pas à ces modèles, laissant les fonctionnalités prises en charge désactivées. Définissez `_SUPPORTED_CAPABILITIES` pour indiquer à Claude Code les fonctionnalités que le modèle prend réellement en charge :

651 695 

652| Valeur de capacité | Active |696| Valeur de capacité | Active |

653| ---------------------- | ----------------------------------------------------------------------------------------------------- |697| ---------------------- | ----------------------------------------------------------------------------------------------------- |


660 704 

661Lorsque `_SUPPORTED_CAPABILITIES` est défini, les capacités listées sont activées et les capacités non listées sont désactivées pour le modèle épinglé correspondant. Lorsque la variable n'est pas définie, Claude Code revient à la détection intégrée basée sur l'ID du modèle.705Lorsque `_SUPPORTED_CAPABILITIES` est défini, les capacités listées sont activées et les capacités non listées sont désactivées pour le modèle épinglé correspondant. Lorsque la variable n'est pas définie, Claude Code revient à la détection intégrée basée sur l'ID du modèle.

662 706 

663Cet exemple épingle Opus à un ARN de modèle personnalisé Bedrock, définit un nom convivial et déclare ses capacités :707Cet exemple épingle Opus à un ARN de modèle personnalisé Amazon Bedrock, définit un nom convivial et déclare ses capacités :

664 708 

665```bash theme={null}709```bash theme={null}

666export ANTHROPIC_DEFAULT_OPUS_MODEL='arn:aws:bedrock:us-east-1:123456789012:custom-model/abc'710export ANTHROPIC_DEFAULT_OPUS_MODEL='arn:aws:bedrock:us-east-1:123456789012:custom-model/abc'


677 721 

678`modelOverrides` mappe les ID de modèle Anthropic individuels aux chaînes spécifiques au fournisseur que Claude Code envoie à l'API de votre fournisseur. Lorsqu'un utilisateur sélectionne un modèle mappé dans le sélecteur `/model`, Claude Code utilise votre valeur configurée au lieu de la valeur par défaut intégrée.722`modelOverrides` mappe les ID de modèle Anthropic individuels aux chaînes spécifiques au fournisseur que Claude Code envoie à l'API de votre fournisseur. Lorsqu'un utilisateur sélectionne un modèle mappé dans le sélecteur `/model`, Claude Code utilise votre valeur configurée au lieu de la valeur par défaut intégrée.

679 723 

680Cela permet aux administrateurs d'entreprise d'acheminer chaque version de modèle vers un ARN de profil d'inférence Bedrock spécifique, un nom de version Vertex AI ou un nom de déploiement Foundry pour la gouvernance, l'allocation des coûts ou l'acheminement régional.724Cela permet aux administrateurs d'entreprise d'acheminer chaque version de modèle vers un ARN de profil d'inférence Amazon Bedrock spécifique, un nom de version Google Cloud's Agent Platform ou un nom de déploiement Microsoft Foundry pour la gouvernance, l'allocation des coûts ou l'acheminement régional.

681 725 

682Définissez `modelOverrides` dans votre [fichier de paramètres](/fr/settings#settings-files) :726Définissez `modelOverrides` dans votre [fichier de paramètres](/fr/settings#settings-files) :

683 727 


693 737 

694Les clés doivent être des ID de modèle Anthropic tels que listés dans l'[Aperçu des modèles](https://platform.claude.com/docs/en/about-claude/models/overview). Pour les ID de modèle datés, incluez le suffixe de date exactement tel qu'il apparaît là. Les clés inconnues sont ignorées.738Les clés doivent être des ID de modèle Anthropic tels que listés dans l'[Aperçu des modèles](https://platform.claude.com/docs/en/about-claude/models/overview). Pour les ID de modèle datés, incluez le suffixe de date exactement tel qu'il apparaît là. Les clés inconnues sont ignorées.

695 739 

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

741 

742{/* min-version: 2.1.200 */}Les remplacements s'appliquent également lorsque vous transmettez un ID de modèle Anthropic directement via `--model`, la variable d'environnement `ANTHROPIC_MODEL`, ou une variable d'environnement `ANTHROPIC_DEFAULT_*_MODEL`. Sur Amazon Bedrock, Google Cloud's Agent Platform et [Mantle](/fr/amazon-bedrock#use-the-mantle-endpoint), un ID de modèle Anthropic sans entrée `modelOverrides` se résout au même ID spécifique au fournisseur que la ligne du sélecteur `/model` pour cette version, lorsque le fournisseur prend en charge cette version. Mantle prend en charge un sous-ensemble de versions. Pour un ID de modèle Anthropic en dehors de ce sous-ensemble, Claude Code envoie l'ID brut à Mantle sans le mapper, sauf si une entrée `modelOverrides` le couvre. Avant v2.1.200, `--model` et les valeurs des variables d'environnement atteignaient le fournisseur telles quelles sans passer par la carte de remplacement.

697 743 

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

699 745 

746{/* min-version: 2.1.200 */}Lorsque `availableModels` est défini dans les [paramètres gérés](/fr/settings#settings-files), seuls les `modelOverrides` de cette source gérée s'appliquent à un ID de modèle Anthropic transmis directement via `--model` ou les variables d'environnement ci-dessus. Claude Code ignore les remplacements dans les paramètres utilisateur ou projet pour ces ID, et ne résout jamais un ID que la liste gérée exclut via `modelOverrides` à partir de n'importe quelle source de paramètres. Cette restriction de source gérée nécessite Claude Code v2.1.200 ou ultérieur. Voir [Restreindre la sélection de modèle](#restrict-model-selection) pour savoir comment les ID bloqués sont gérés.

747 

700<h3 id="prompt-caching-configuration">748<h3 id="prompt-caching-configuration">

701 Configuration de la mise en cache des invites749 Configuration de la mise en cache des invites

702</h3>750</h3>

Details

191**`claude_code.llm_request`**191**`claude_code.llm_request`**

192 192 

193| Attribut | Description | Contrôlé par |193| Attribut | Description | Contrôlé par |

194| -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- | ------------ |194| -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------- |

195| `model` | Identifiant du modèle | |195| `model` | Identifiant du modèle | |

196| `gen_ai.system` | Toujours `anthropic`. Convention sémantique GenAI OpenTelemetry | |196| `gen_ai.system` | Toujours `anthropic`. Convention sémantique GenAI OpenTelemetry | |

197| `gen_ai.request.model` | Même valeur que `model`. Convention sémantique GenAI OpenTelemetry | |197| `gen_ai.request.model` | Même valeur que `model`. Convention sémantique GenAI OpenTelemetry | |

198| `query_source` | Sous-système qui a émis la demande, tel que `repl_main_thread` ou un nom de sous-agent | |198| `query_source` | Sous-système qui a émis la demande, tel que `repl_main_thread` ou un nom de sous-agent | |

199| `agent_id` | Identifiant du sous-agent ou du coéquipier qui a émis la demande. Absent dans la session principale | |199| `agent_id` | Identifiant du sous-agent ou du coéquipier qui a émis la demande. Absent dans la session principale | |

200| `parent_agent_id` | Identifiant de l'agent qui a généré celui-ci. Absent pour la session principale et pour les agents générés directement à partir de celle-ci | |200| `parent_agent_id` | Identifiant de l'agent qui a généré celui-ci. Absent pour la session principale et pour les agents générés directement à partir de celle-ci | |

201| `workflow.run_id` | Identifiant d'exécution de l'exécution de l'outil [Workflow](/fr/workflows), préfixé `wf_`. Absent pour les agents non générés par un workflow | |

202| `workflow.name` | Nom du workflow qui a généré cet agent. Les noms créés par l'utilisateur sont remplacés par `custom` sauf si la porte est définie | `OTEL_LOG_TOOL_DETAILS` |

201| `speed` | `fast` ou `normal` | |203| `speed` | `fast` ou `normal` | |

202| `llm_request.context` | `interaction`, `tool`, ou `standalone` selon l'intervalle parent | |204| `llm_request.context` | `interaction`, `tool`, ou `standalone` selon l'intervalle parent | |

203| `duration_ms` | Durée murale incluant les tentatives | |205| `duration_ms` | Durée murale incluant les tentatives | |


228| `result_tokens` | Taille approximative en jetons du résultat de l'outil | |230| `result_tokens` | Taille approximative en jetons du résultat de l'outil | |

229| `agent_id` | Identifiant du sous-agent ou du coéquipier qui a exécuté l'outil. Absent dans la session principale | |231| `agent_id` | Identifiant du sous-agent ou du coéquipier qui a exécuté l'outil. Absent dans la session principale | |

230| `parent_agent_id` | Identifiant de l'agent qui a généré celui-ci. Absent pour la session principale et pour les agents générés directement à partir de celle-ci | |232| `parent_agent_id` | Identifiant de l'agent qui a généré celui-ci. Absent pour la session principale et pour les agents générés directement à partir de celle-ci | |

233| `workflow.run_id` | Identifiant d'exécution de l'exécution de l'outil Workflow qui a généré cet agent, préfixé `wf_`. Absent pour les agents non générés par un workflow | |

234| `workflow.name` | Nom du workflow qui a généré cet agent. Les noms créés par l'utilisateur sont remplacés par `custom` sauf si la porte est définie | `OTEL_LOG_TOOL_DETAILS` |

231| `tool_use_id` | L'ID du bloc `tool_use` du modèle pour cet appel. Correspond au `tool_use_id` sur les événements [tool\_result](#tool-result-event) et [tool\_decision](#tool-decision-event) et dans les charges utiles de hooks, afin que vous puissiez joindre l'intervalle à ces enregistrements | |235| `tool_use_id` | L'ID du bloc `tool_use` du modèle pour cet appel. Correspond au `tool_use_id` sur les événements [tool\_result](#tool-result-event) et [tool\_decision](#tool-decision-event) et dans les charges utiles de hooks, afin que vous puissiez joindre l'intervalle à ces enregistrements | |

232| `gen_ai.tool.call.id` | Même valeur que `tool_use_id`. Convention sémantique GenAI OpenTelemetry | |236| `gen_ai.tool.call.id` | Même valeur que `tool_use_id`. Convention sémantique GenAI OpenTelemetry | |

233| `file_path` | Chemin de fichier cible pour les outils Read, Edit et Write | `OTEL_LOG_TOOL_DETAILS` |237| `file_path` | Chemin de fichier cible pour les outils Read, Edit et Write | `OTEL_LOG_TOOL_DETAILS` |


309 313 

310Si le script d'aide échoue ou imprime une sortie qui ne répond pas à ces exigences, Claude Code signale l'erreur dans :314Si le script d'aide échoue ou imprime une sortie qui ne répond pas à ces exigences, Claude Code signale l'erreur dans :

311 315 

312* La sortie `/doctor`316* La sortie `/status`

313* Le journal de débogage, lors de l'exécution avec [`--debug`](/fr/cli-reference#cli-flags) ou après l'exécution de `/debug` dans la session317* Le journal de débogage, lors de l'exécution avec [`--debug`](/fr/cli-reference#cli-flags) ou après l'exécution de `/debug` dans la session

314* stderr, dans les sessions non interactives démarrées avec `-p`318* stderr, dans les sessions non interactives démarrées avec `-p`

315 319 


443 447 

444* `prompt.id` : UUID corrélant une invite utilisateur avec tous les événements suivants jusqu'à l'invite suivante. Voir [Attributs de corrélation d'événements](#event-correlation-attributes).448* `prompt.id` : UUID corrélant une invite utilisateur avec tous les événements suivants jusqu'à l'invite suivante. Voir [Attributs de corrélation d'événements](#event-correlation-attributes).

445* `workspace.host_paths` : répertoires d'espace de travail hôte sélectionnés dans l'application de bureau, sous forme de tableau de chaînes449* `workspace.host_paths` : répertoires d'espace de travail hôte sélectionnés dans l'application de bureau, sous forme de tableau de chaînes

450* `workflow.run_id` : identifiant d'exécution, préfixé `wf_`, sur les événements d'API et d'outil émis par les agents qui appartiennent à une exécution d'outil [Workflow](/fr/workflows). Le filtrage des événements par un `workflow.run_id` reconstruit les demandes d'API et les résultats d'outil de cette exécution. L'identifiant couvre les agents que le script de flux de travail génère et tous les agents que ceux-ci génèrent à leur tour, tels que les invocations de compétences. Il correspond à l'identifiant d'exécution signalé dans le résultat de l'outil Workflow. Absent sur tous les autres événements. {/* min-version: 2.1.202 */}Nécessite Claude Code v2.1.202 ou ultérieur

451* `workflow.name` : nom du flux de travail, le `meta.name` de son script, émis aux côtés de `workflow.run_id`. Les noms de flux de travail intégrés apparaissent textuellement lorsque l'exécution exécute le script intégré non modifié. Les noms créés par l'utilisateur, y compris les copies modifiées de scripts intégrés, sont remplacés par `custom` sauf si `OTEL_LOG_TOOL_DETAILS=1` est défini. {/* min-version: 2.1.202 */}Nécessite Claude Code v2.1.202 ou ultérieur

446 452 

447<h3 id="metrics">453<h3 id="metrics">

448 Métriques454 Métriques


884 Événement d'erreur interne890 Événement d'erreur interne

885</h4>891</h4>

886 892 

887Enregistré lorsque Claude Code détecte une erreur interne inattendue. Seul le nom de la classe d'erreur et un code de style errno sont enregistrés. Le message d'erreur et la trace de pile ne sont jamais inclus. Cet événement n'est pas émis lors de l'exécution sur Bedrock, Vertex ou Foundry, ou lorsque `DISABLE_ERROR_REPORTING` est défini.893Enregistré lorsque Claude Code détecte une erreur interne inattendue. Seul le nom de la classe d'erreur et un code de style errno sont enregistrés. Le message d'erreur et la trace de pile ne sont jamais inclus. Cet événement n'est pas émis lors de l'exécution sur Amazon Bedrock, Google Cloud's Agent Platform, ou Microsoft Foundry, ou lorsque `DISABLE_ERROR_REPORTING` est défini.

888 894 

889**Nom de l'événement** : `claude_code.internal_error`895**Nom de l'événement** : `claude_code.internal_error`

890 896 


1163* Attribuer les dépenses à des compétences, des plugins ou des types de sous-agents spécifiques via les attributs `skill.name`, `plugin.name`, et `agent.name`1169* Attribuer les dépenses à des compétences, des plugins ou des types de sous-agents spécifiques via les attributs `skill.name`, `plugin.name`, et `agent.name`

1164 1170 

1165<Note>1171<Note>

1166 Les métriques de coûts sont des approximations. Pour les données de facturation officielles, consultez votre fournisseur d'API (Claude Console, Amazon Bedrock ou Google Cloud Vertex).1172 Les métriques de coûts sont des approximations. Pour les données de facturation officielles, consultez votre fournisseur d'API (Claude Console, Amazon Bedrock ou Google Cloud's Agent Platform).

1167</Note>1173</Note>

1168 1174 

1169<h3 id="alerting-and-segmentation">1175<h3 id="alerting-and-segmentation">


1219 1225 

1220Les appels d'outils MCP, les commandes Bash et les éditions de fichiers sont donc attribués au développeur qui a démarré la session. Claude Code n'agit pas sous un compte de service distinct ; l'identité enregistrée sur chaque événement est le propre compte Claude du développeur, ou l'identité IdP du développeur sur une session de [passerelle d'applications Claude](/fr/claude-apps-gateway).1226Les appels d'outils MCP, les commandes Bash et les éditions de fichiers sont donc attribués au développeur qui a démarré la session. Claude Code n'agit pas sous un compte de service distinct ; l'identité enregistrée sur chaque événement est le propre compte Claude du développeur, ou l'identité IdP du développeur sur une session de [passerelle d'applications Claude](/fr/claude-apps-gateway).

1221 1227 

1222Lorsque Claude Code s'authentifie avec une clé API directe, ou contre Bedrock, Vertex AI ou Microsoft Foundry, il n'y a pas de compte Claude dans la session et seuls `user.id` et `session.id` sont remplis. Dans ces déploiements, attachez l'identité utilisateur vous-même avec `OTEL_RESOURCE_ATTRIBUTES`, défini par utilisateur via le fichier [paramètres gérés](#administrator-configuration) ou un wrapper de lancement. Les sessions de passerelle d'applications Claude n'ont besoin d'aucune de ces opérations : le CLI horodate l'identité IdP automatiquement, comme décrit dans [Attributs standard](#standard-attributes).1228Lorsque Claude Code s'authentifie avec une clé API directe, ou contre Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry, il n'y a pas de compte Claude dans la session et seuls `user.id` et `session.id` sont remplis. Dans ces déploiements, attachez l'identité utilisateur vous-même avec `OTEL_RESOURCE_ATTRIBUTES`, défini par utilisateur via le fichier [paramètres gérés](#administrator-configuration) ou un wrapper de lancement. Les sessions de passerelle d'applications Claude n'ont besoin d'aucune de ces opérations : le CLI horodate l'identité IdP automatiquement, comme décrit dans [Attributs standard](#standard-attributes).

1223 1229 

1224```bash theme={null}1230```bash theme={null}

1225export OTEL_RESOURCE_ATTRIBUTES="enduser.id=jdoe@example.com,enduser.directory_id=S-1-5-21-..."1231export OTEL_RESOURCE_ATTRIBUTES="enduser.id=jdoe@example.com,enduser.directory_id=S-1-5-21-..."


1354 Surveiller Claude Code sur Amazon Bedrock1360 Surveiller Claude Code sur Amazon Bedrock

1355</h2>1361</h2>

1356 1362 

1357Pour des conseils détaillés sur la surveillance de l'utilisation de Claude Code pour Amazon Bedrock, consultez [Implémentation de la surveillance de Claude Code (Bedrock)](https://github.com/aws-solutions-library-samples/guidance-for-claude-code-with-amazon-bedrock/blob/main/assets/docs/MONITORING.md).1363Pour des conseils détaillés sur la surveillance de l'utilisation de Claude Code pour Amazon Bedrock, consultez [Implémentation de la surveillance de Claude Code (Amazon Bedrock)](https://github.com/aws-solutions-library-samples/guidance-for-claude-code-with-amazon-bedrock/blob/main/assets/docs/MONITORING.md).

Details

110export CLAUDE_CODE_CLIENT_KEY_PASSPHRASE="your-passphrase"110export CLAUDE_CODE_CLIENT_KEY_PASSPHRASE="your-passphrase"

111```111```

112 112 

113Claude Code lit les fichiers de certificat et de clé au démarrage et les relit chaque fois qu'il applique les paramètres, y compris lorsque les paramètres changent au cours d'une session. Pour faire tourner le certificat et la clé, remplacez les fichiers aux mêmes chemins.

114 

113<h2 id="network-access-requirements">115<h2 id="network-access-requirements">

114 Exigences d'accès réseau116 Exigences d'accès réseau

115</h2>117</h2>


131 133 

132Claude Code envoie également une télémétrie opérationnelle facultative par défaut, que vous pouvez désactiver avec des variables d'environnement. Consultez [Services de télémétrie](/fr/data-usage#telemetry-services) pour savoir comment la désactiver avant de finaliser votre liste d'autorisation.134Claude Code envoie également une télémétrie opérationnelle facultative par défaut, que vous pouvez désactiver avec des variables d'environnement. Consultez [Services de télémétrie](/fr/data-usage#telemetry-services) pour savoir comment la désactiver avant de finaliser votre liste d'autorisation.

133 135 

134Lors de l'utilisation d'[Amazon Bedrock](/fr/amazon-bedrock), de [Google Vertex AI](/fr/google-vertex-ai), de [Microsoft Foundry](/fr/microsoft-foundry), ou d'une session de [passerelle d'applications Claude](/fr/claude-apps-gateway) connectée, le trafic du modèle et l'authentification vont vers votre fournisseur ou passerelle au lieu de `api.anthropic.com`, `claude.ai`, ou `platform.claude.com`. L'outil WebFetch appelle toujours `api.anthropic.com` pour sa [vérification de sécurité du domaine](/fr/data-usage#webfetch-domain-safety-check) sauf si vous définissez `skipWebFetchPreflight: true` dans les [paramètres](/fr/settings).136Lors de l'utilisation d'[Amazon Bedrock](/fr/amazon-bedrock), de [Google Cloud's Agent Platform](/fr/google-vertex-ai), de [Microsoft Foundry](/fr/microsoft-foundry), ou d'une session de [passerelle d'applications Claude](/fr/claude-apps-gateway) connectée, le trafic du modèle et l'authentification vont vers votre fournisseur ou passerelle au lieu de `api.anthropic.com`, `claude.ai`, ou `platform.claude.com`. L'outil WebFetch appelle toujours `api.anthropic.com` pour sa [vérification de sécurité du domaine](/fr/data-usage#webfetch-domain-safety-check) sauf si vous définissez `skipWebFetchPreflight: true` dans les [paramètres](/fr/settings).

135 137 

136[Claude Code sur le web](/fr/claude-code-on-the-web) et [Code Review](/fr/code-review) se connectent à vos référentiels à partir de l'infrastructure gérée par Anthropic. Si votre organisation GitHub Enterprise Cloud restreint l'accès par adresse IP, activez [l'héritage de la liste d'autorisation IP pour les applications GitHub installées](https://docs.github.com/en/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization#allowing-access-by-github-apps). L'application GitHub Claude enregistre ses plages d'adresses IP, donc l'activation de ce paramètre permet l'accès sans configuration manuelle. Pour [ajouter les plages à votre liste d'autorisation manuellement](https://docs.github.com/en/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization#adding-an-allowed-ip-address) à la place, ou pour configurer d'autres pare-feu, consultez les [adresses IP de l'API Anthropic](https://platform.claude.com/docs/en/api/ip-addresses).138[Claude Code sur le web](/fr/claude-code-on-the-web) et [Code Review](/fr/code-review) se connectent à vos référentiels à partir de l'infrastructure gérée par Anthropic. Si votre organisation GitHub Enterprise Cloud restreint l'accès par adresse IP, activez [l'héritage de la liste d'autorisation IP pour les applications GitHub installées](https://docs.github.com/en/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization#allowing-access-by-github-apps). L'application GitHub Claude enregistre ses plages d'adresses IP, donc l'activation de ce paramètre permet l'accès sans configuration manuelle. Pour [ajouter les plages à votre liste d'autorisation manuellement](https://docs.github.com/en/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization#adding-an-allowed-ip-address) à la place, ou pour configurer d'autres pare-feu, consultez les [adresses IP de l'API Anthropic](https://platform.claude.com/docs/en/api/ip-addresses).

137 139 

overview.md +2 −2

Details

12 Commencer12 Commencer

13</h2>13</h2>

14 14 

15Choisissez votre environnement pour commencer. La plupart des surfaces nécessitent un [abonnement Claude](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=overview_pricing) ou un compte [Anthropic Console](https://console.anthropic.com/). Le CLI Terminal et VS Code prennent également en charge les [fournisseurs tiers](/fr/third-party-integrations).15Claude Code s'exécute sur plusieurs surfaces : le terminal, les extensions IDE, une application de bureau et le web. Choisissez l'une des options dans les onglets ci-dessous pour commencer. La plupart des surfaces nécessitent un [abonnement Claude](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=overview_pricing) ou un compte [Anthropic Console](https://console.anthropic.com/). Le CLI Terminal et VS Code prennent également en charge les [fournisseurs tiers](/fr/third-party-integrations).

16 16 

17<Tabs>17<Tabs>

18 <Tab title="Terminal">18 <Tab title="Terminal">


221 Utiliser Claude Code partout221 Utiliser Claude Code partout

222</h2>222</h2>

223 223 

224Chaque surface se connecte au même moteur Claude Code sous-jacent, donc vos fichiers CLAUDE.md, paramètres et serveurs MCP fonctionnent sur tous.224Chaque [surface](/fr/glossary#surface) se connecte au même moteur Claude Code sous-jacent, donc vos fichiers CLAUDE.md, paramètres et serveurs MCP fonctionnent sur tous.

225 225 

226Au-delà des environnements [Terminal](/fr/quickstart), [VS Code](/fr/vs-code), [JetBrains](/fr/jetbrains), [Desktop](/fr/desktop) et [Web](/fr/claude-code-on-the-web) ci-dessus, Claude Code s'intègre avec les flux de travail CI/CD, chat et navigateur :226Au-delà des environnements [Terminal](/fr/quickstart), [VS Code](/fr/vs-code), [JetBrains](/fr/jetbrains), [Desktop](/fr/desktop) et [Web](/fr/claude-code-on-the-web) ci-dessus, Claude Code s'intègre avec les flux de travail CI/CD, chat et navigateur :

227 227 

Details

6 6 

7> Contrôlez si Claude demande avant de modifier les fichiers ou d'exécuter des commandes. Changez de mode avec Maj+Tab dans le CLI ou utilisez le sélecteur de mode dans VS Code, Desktop et claude.ai.7> Contrôlez si Claude demande avant de modifier les fichiers ou d'exécuter des commandes. Changez de mode avec Maj+Tab dans le CLI ou utilisez le sélecteur de mode dans VS Code, Desktop et claude.ai.

8 8 

9Quand Claude veut modifier un fichier, exécuter une commande shell ou effectuer une demande réseau, il s'arrête et vous demande d'approuver l'action. Les modes de permission contrôlent la fréquence de cette pause. Le mode que vous choisissez façonne le flux d'une session : le mode par défaut vous permet d'examiner chaque action au fur et à mesure, tandis que les modes plus souples permettent à Claude de travailler dans des étapes plus longues et ininterrompues et de faire un rapport quand c'est terminé. Choisissez une supervision plus importante pour les travaux sensibles, ou moins d'interruptions quand vous faites confiance à la direction.9Quand Claude veut modifier un fichier, exécuter une commande shell ou effectuer une demande réseau, il s'arrête et vous demande d'approuver l'action. Les modes de permission contrôlent la fréquence de cette pause. Le mode que vous choisissez façonne le flux d'une session : le mode manuel vous permet d'examiner chaque action au fur et à mesure, tandis que les modes plus souples permettent à Claude de travailler dans des étapes plus longues et ininterrompues et de faire un rapport quand c'est terminé. Choisissez une supervision plus importante pour les travaux sensibles, ou moins d'interruptions quand vous faites confiance à la direction.

10 10 

11<h2 id="available-modes">11<h2 id="available-modes">

12 Modes disponibles12 Modes disponibles


16 16 

17| Mode | Ce qui s'exécute sans demander | Idéal pour |17| Mode | Ce qui s'exécute sans demander | Idéal pour |

18| :------------------------------------------------------------------ | :--------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------- |18| :------------------------------------------------------------------ | :--------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------- |

19| `default` | Lectures uniquement | Démarrage, travaux sensibles |19| `default` | Lectures uniquement. Étiqueté **Manuel** dans l'extension CLI et IDE | Démarrage, travaux sensibles |

20| [`acceptEdits`](#auto-approve-file-edits-with-acceptedits-mode) | Lectures, modifications de fichiers et commandes courantes du système de fichiers (`mkdir`, `touch`, `mv`, `cp`, etc.) | Itération sur le code que vous examinez |20| [`acceptEdits`](#auto-approve-file-edits-with-acceptedits-mode) | Lectures, modifications de fichiers et commandes courantes du système de fichiers (`mkdir`, `touch`, `mv`, `cp`, etc.) | Itération sur le code que vous examinez |

21| [`plan`](#analyze-before-you-edit-with-plan-mode) | Lectures uniquement | Explorer une base de code avant de la modifier |21| [`plan`](#analyze-before-you-edit-with-plan-mode) | Lectures uniquement | Explorer une base de code avant de la modifier |

22| [`auto`](#eliminate-prompts-with-auto-mode) | Tout, avec des vérifications de sécurité en arrière-plan | Tâches longues, réduction de la fatigue des invites |22| [`auto`](#eliminate-prompts-with-auto-mode) | Tout, avec des vérifications de sécurité en arrière-plan | Tâches longues, réduction de la fatigue des invites |

23| [`dontAsk`](#allow-only-pre-approved-tools-with-dontask-mode) | Uniquement les outils pré-approuvés | CI verrouillé et scripts |23| [`dontAsk`](#allow-only-pre-approved-tools-with-dontask-mode) | Uniquement les outils pré-approuvés | CI verrouillé et scripts |

24| [`bypassPermissions`](#skip-all-checks-with-bypasspermissions-mode) | Tout | Conteneurs et machines virtuelles isolés uniquement |24| [`bypassPermissions`](#skip-all-checks-with-bypasspermissions-mode) | Tout | Conteneurs et machines virtuelles isolés uniquement |

25 25 

26Le mode qui examine chaque action s'appelle **Manuel** dans l'interface CLI, dans `claude --help`, et dans les extensions VS Code et JetBrains. Sa valeur de configuration est `default`, ce que les hooks et les intégrations SDK utilisent. L'interface CLI accepte `manual` comme alias partout où vous tapez la valeur, par exemple `claude --permission-mode manual` ou `"defaultMode": "manual"`. L'étiquette Manuel et l'alias `manual` nécessitent Claude Code v2.1.200 ou ultérieur.

27 

26Dans tous les modes sauf `bypassPermissions`, les écritures dans les [chemins protégés](#protected-paths) ne sont jamais auto-approuvées, protégeant l'état du dépôt et la configuration propre de Claude contre la corruption accidentelle.28Dans tous les modes sauf `bypassPermissions`, les écritures dans les [chemins protégés](#protected-paths) ne sont jamais auto-approuvées, protégeant l'état du dépôt et la configuration propre de Claude contre la corruption accidentelle.

27 29 

28Les modes définissent la ligne de base. Superposez les [règles de permission](/fr/permissions#manage-permissions) sur le dessus pour pré-approuver ou bloquer des outils spécifiques. Les règles de refus et les règles de demande explicite s'appliquent dans tous les modes, y compris `bypassPermissions`. Les règles d'autorisation n'ont aucun effet dans ce mode car tout le reste est déjà approuvé.30Les modes définissent la ligne de base. Superposez les [règles de permission](/fr/permissions#manage-permissions) sur le dessus pour pré-approuver ou bloquer des outils spécifiques. Les règles de refus et les règles de demande explicite s'appliquent dans tous les modes, y compris `bypassPermissions`. Les règles d'autorisation n'ont aucun effet dans ce mode car tout le reste est déjà approuvé.


35 37 

36<Tabs>38<Tabs>

37 <Tab title="CLI">39 <Tab title="CLI">

38 **Pendant une session** : appuyez sur `Maj+Tab` pour parcourir `default` → `acceptEdits` → `plan`. Le mode actuel apparaît dans la barre d'état. Tous les modes ne sont pas dans le cycle par défaut :40 **Pendant une session** : appuyez sur `Maj+Tab` pour parcourir `default` → `acceptEdits` → `plan`. Le mode actuel apparaît dans la barre d'état. {/* min-version: 2.1.203 */}Le mode manuel, `default` dans ce cycle, affiche un badge gris `⏸ manual mode on`. Avant v2.1.203, la barre d'état n'affichait aucun badge en mode manuel.

41 

42 Tous les modes ne sont pas dans le cycle par défaut :

39 43 

40 * `auto` : apparaît quand votre compte répond aux [exigences du mode auto](#eliminate-prompts-with-auto-mode) ; le parcours vers auto bascule les modes sans invite de confirmation44 * `auto` : apparaît quand votre compte répond aux [exigences du mode auto](#eliminate-prompts-with-auto-mode) ; le parcours vers auto bascule les modes sans invite de confirmation

41 * `bypassPermissions` : apparaît après que vous ayez démarré avec `--permission-mode bypassPermissions`, `--dangerously-skip-permissions`, ou `--allow-dangerously-skip-permissions` ; la variante `--allow-` ajoute le mode au cycle sans l'activer45 * `bypassPermissions` : apparaît après que vous ayez démarré avec `--permission-mode bypassPermissions`, `--dangerously-skip-permissions`, ou `--allow-dangerously-skip-permissions` ; la variante `--allow-` ajoute le mode au cycle sans l'activer


70 L'indicateur de mode affiche ces étiquettes, mappées au mode auquel chacune s'applique :74 L'indicateur de mode affiche ces étiquettes, mappées au mode auquel chacune s'applique :

71 75 

72 | Étiquette UI | Mode |76 | Étiquette UI | Mode |

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

74 | Demander avant les modifications | `default` |78 | Manuel | `default` |

75 | Modifier automatiquement | `acceptEdits` |79 | Modifier automatiquement | `acceptEdits` |

76 | Mode de planification | `plan` |80 | Mode de planification | `plan` |

77 | Mode auto | `auto` |81 | Mode auto | `auto` |

78 | Ignorer les permissions | `bypassPermissions` |82 | Ignorer les permissions | `bypassPermissions` |

79 83 

84 Avant v2.1.205, l'extension étiquetait `plan` comme Plan mode et `auto` comme Auto mode.

85 

80 Le mode auto apparaît dans l'indicateur de mode quand votre compte répond à chaque exigence listée dans la [section mode auto](#eliminate-prompts-with-auto-mode). Le paramètre `claudeCode.initialPermissionMode` n'accepte pas `auto`. Pour démarrer en mode auto par défaut, définissez `defaultMode` dans vos [paramètres utilisateur](/fr/settings#settings-files) à la place. Claude Code ignore `defaultMode: "auto"` dans les paramètres de projet et locaux.86 Le mode auto apparaît dans l'indicateur de mode quand votre compte répond à chaque exigence listée dans la [section mode auto](#eliminate-prompts-with-auto-mode). Le paramètre `claudeCode.initialPermissionMode` n'accepte pas `auto`. Pour démarrer en mode auto par défaut, définissez `defaultMode` dans vos [paramètres utilisateur](/fr/settings#settings-files) à la place. Claude Code ignore `defaultMode: "auto"` dans les paramètres de projet et locaux.

81 87 

82 Ignorer les permissions nécessite le bouton **Autoriser l'ignorance dangereuse des permissions** dans les paramètres de l'extension avant qu'il n'apparaisse dans l'indicateur de mode.88 Ignorer les permissions nécessite le bouton **Autoriser l'ignorance dangereuse des permissions** dans les paramètres de l'extension avant qu'il n'apparaisse dans l'indicateur de mode.


95 <Tab title="Web and mobile">101 <Tab title="Web and mobile">

96 Utilisez le menu déroulant de mode à côté de la boîte d'invite sur [claude.ai/code](https://claude.ai/code) ou dans l'application mobile. Les invites de permission apparaissent dans claude.ai pour approbation. Les modes qui apparaissent dépendent de l'endroit où la session s'exécute :102 Utilisez le menu déroulant de mode à côté de la boîte d'invite sur [claude.ai/code](https://claude.ai/code) ou dans l'application mobile. Les invites de permission apparaissent dans claude.ai pour approbation. Les modes qui apparaissent dépendent de l'endroit où la session s'exécute :

97 103 

98 * **Sessions cloud** sur [Claude Code sur le web](/fr/claude-code-on-the-web) : Accepter les modifications, Mode de planification et Mode auto. Accepter les modifications correspond au mode `default` : l'environnement cloud pré-approuve les modifications de fichiers indépendamment du mode, donc le menu déroulant affiche Accepter les modifications au lieu de Demander les permissions. `defaultMode: "acceptEdits"` à partir des paramètres est toujours respecté. Le mode auto n'apparaît que quand votre organisation l'autorise et que le modèle sélectionné le supporte. Ignorer les permissions n'est pas disponible.104 * **Sessions cloud** sur [Claude Code sur le web](/fr/claude-code-on-the-web) : Accepter les modifications, Mode de planification et Mode auto. Accepter les modifications correspond au mode `default` : l'environnement cloud pré-approuve les modifications de fichiers indépendamment du mode, donc le menu déroulant affiche Accepter les modifications au lieu de Manuel. Les sessions cloud respectent toujours `defaultMode: "acceptEdits"` à partir des paramètres. Le mode auto n'apparaît que quand votre organisation l'autorise et que le modèle sélectionné le supporte. Ignorer les permissions n'est pas disponible.

99 * **Sessions [Contrôle à distance](/fr/remote-control)** sur votre machine locale : Demander les permissions, Accepter automatiquement les modifications et Mode de planification. Auto et Ignorer les permissions ne sont pas disponibles.105 * **Sessions [Contrôle à distance](/fr/remote-control)** sur votre machine locale : Manuel, Accepter les modifications et Mode de planification. Vous ne pouvez pas sélectionner Auto ou Ignorer les permissions depuis l'application. {/* min-version: 2.1.202 */}Le menu déroulant affiche le mode dans lequel se trouve la session locale, y compris un mode défini depuis le terminal, et se met à jour quand le mode change dans l'application ou dans le terminal. La seule exception est Ignorer les permissions : la session ne signale jamais ce mode à claude.ai, donc basculer vers celui-ci depuis le terminal ne change pas ce que le menu déroulant affiche. Avant v2.1.202, les sessions connectées avec `/remote-control` ou `claude --remote-control` ne signalaient pas du tout leur mode, donc claude.ai et l'application mobile pouvaient afficher un mode dans lequel la session n'était pas. L'incohérence affectait uniquement l'étiquette : Claude Code a généré les invites de permission à partir du mode réel de la session, et elles ont toujours été affichées dans l'application pour approbation.

100 106 

101 Pour le Contrôle à distance, vous pouvez également définir le mode de démarrage lors du lancement de l'hôte :107 Pour le Contrôle à distance, vous pouvez également définir le mode de démarrage lors du lancement de l'hôte :

102 108 


116 122 

117Quand l'[outil PowerShell](/fr/tools-reference#powershell-tool) est activé, le mode `acceptEdits` approuve également automatiquement `Set-Content`, `Add-Content`, `Clear-Content` et `Remove-Item` sur les chemins dans la portée, ainsi que leurs alias courants. Les mêmes règles de portée et de chemins protégés s'appliquent.123Quand l'[outil PowerShell](/fr/tools-reference#powershell-tool) est activé, le mode `acceptEdits` approuve également automatiquement `Set-Content`, `Add-Content`, `Clear-Content` et `Remove-Item` sur les chemins dans la portée, ainsi que leurs alias courants. Les mêmes règles de portée et de chemins protégés s'appliquent.

118 124 

119Utilisez `acceptEdits` quand vous voulez examiner les modifications dans votre éditeur ou via `git diff` après coup plutôt que d'approuver chaque modification en ligne. Appuyez sur `Maj+Tab` une fois depuis le mode par défaut pour l'entrer, ou démarrez directement avec :125Utilisez `acceptEdits` quand vous voulez examiner les modifications dans votre éditeur ou via `git diff` après coup plutôt que d'approuver chaque modification en ligne.

126 

127Appuyez sur `Maj+Tab` une fois depuis le mode Manuel pour l'entrer, ou démarrez directement avec :

120 128 

121```bash theme={null}129```bash theme={null}

122claude --permission-mode acceptEdits130claude --permission-mode acceptEdits


188 196 

189* **Plan** : Tous les plans.197* **Plan** : Tous les plans.

190* **Propriétaire** : sur Team et Enterprise, un Propriétaire doit l'activer dans les [paramètres d'administration Claude Code](https://claude.ai/admin-settings/claude-code) avant que les utilisateurs puissent l'activer. Les administrateurs peuvent également le verrouiller en définissant `permissions.disableAutoMode` sur `"disable"` dans les [paramètres gérés](/fr/permissions#managed-settings).198* **Propriétaire** : sur Team et Enterprise, un Propriétaire doit l'activer dans les [paramètres d'administration Claude Code](https://claude.ai/admin-settings/claude-code) avant que les utilisateurs puissent l'activer. Les administrateurs peuvent également le verrouiller en définissant `permissions.disableAutoMode` sur `"disable"` dans les [paramètres gérés](/fr/permissions#managed-settings).

191* **Modèle** : sur l'API Anthropic, Claude Opus 4.6 ou ultérieur, ou Sonnet 4.6 ou ultérieur. Sur Amazon Bedrock, Google Cloud Vertex AI, Microsoft Foundry et les sessions de [passerelle d'applications Claude](/fr/claude-apps-gateway) signées, uniquement Claude Sonnet 5, Opus 4.7 et Opus 4.8. Les modèles plus anciens, y compris Sonnet 4.5, Opus 4.5, Haiku et les modèles claude-3, ne sont pas supportés sur aucun fournisseur.199* **Modèle** : sur l'API Anthropic, Claude Opus 4.6 ou ultérieur, ou Sonnet 4.6 ou ultérieur. Sur Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry et les sessions de [passerelle d'applications Claude](/fr/claude-apps-gateway) signées, uniquement Claude Sonnet 5, Opus 4.7 et Opus 4.8. Les modèles plus anciens, y compris Sonnet 4.5, Opus 4.5, Haiku et les modèles claude-3, ne sont pas supportés sur aucun fournisseur.

192* **Fournisseur** : disponible par défaut sur l'API Anthropic. Sur Amazon Bedrock, Google Cloud Vertex AI, Microsoft Foundry et les sessions de passerelle d'applications Claude signées, le mode auto est désactivé jusqu'à ce que vous [définissiez `CLAUDE_CODE_ENABLE_AUTO_MODE`](#enable-auto-mode-on-bedrock-vertex-ai-or-foundry).200* **Fournisseur** : disponible par défaut sur l'API Anthropic. Sur Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry et les sessions de passerelle d'applications Claude signées, le mode auto est désactivé jusqu'à ce que vous [définissiez `CLAUDE_CODE_ENABLE_AUTO_MODE`](#enable-auto-mode-on-bedrock-agent-platform-or-foundry).

193 201 

194Si Claude Code signale le mode auto comme indisponible, l'une de ces exigences n'est pas remplie ; ce n'est pas une panne transitoire. Un message séparé qui nomme un modèle et dit que le mode auto « ne peut pas déterminer la sécurité » d'une action est une panne transitoire du classificateur ; consultez la [référence d'erreur](/fr/errors#auto-mode-cannot-determine-the-safety-of-an-action).202Si Claude Code signale le mode auto comme indisponible, l'une de ces exigences n'est pas remplie ; ce n'est pas une panne transitoire. Un message séparé qui nomme un modèle et dit que le mode auto « ne peut pas déterminer la sécurité » d'une action est une panne transitoire du classificateur ; consultez la [référence d'erreur](/fr/errors#auto-mode-cannot-determine-the-safety-of-an-action).

195 203 

196Si vous définissez `defaultMode: "auto"` dans les [paramètres](/fr/settings#available-settings) et que la session démarre en mode `default` sans erreur, le paramètre se trouve probablement dans `.claude/settings.json` ou `.claude/settings.local.json`. Claude Code v2.1.142 et ultérieur ignorent `auto` de ces fichiers afin qu'un dépôt ne puisse pas s'accorder le mode auto. Déplacez-le vers `~/.claude/settings.json`.204Si vous définissez `defaultMode: "auto"` dans les [paramètres](/fr/settings#available-settings) et que la session démarre en mode `default` sans erreur, le paramètre se trouve probablement dans `.claude/settings.json` ou `.claude/settings.local.json`. Claude Code v2.1.142 et ultérieur ignorent `auto` de ces fichiers afin qu'un dépôt ne puisse pas s'accorder le mode auto. Déplacez-le vers `~/.claude/settings.json`.

197 205 

198<h3 id="enable-auto-mode-on-bedrock-vertex-ai-or-foundry">206<h3 id="enable-auto-mode-on-bedrock-agent-platform-or-foundry">

199 Activer le mode auto sur Bedrock, Vertex AI ou Foundry207 Activer le mode auto sur Bedrock, Agent Platform ou Foundry

200</h3>208</h3>

201 209 

202Sur [Amazon Bedrock](/fr/amazon-bedrock), [Google Cloud Vertex AI](/fr/google-vertex-ai), [Microsoft Foundry](/fr/microsoft-foundry) et les sessions de [passerelle d'applications Claude](/fr/claude-apps-gateway) signées, le mode auto n'apparaît pas dans le cycle `Shift+Tab` jusqu'à ce que `CLAUDE_CODE_ENABLE_AUTO_MODE` soit défini sur `1`. La variable fonctionne dans Claude Code v2.1.158 et ultérieur. Seuls Claude Sonnet 5, Opus 4.7 et Opus 4.8 sont supportés sur ces fournisseurs.210Sur [Amazon Bedrock](/fr/amazon-bedrock), [Google Cloud's Agent Platform](/fr/google-vertex-ai), [Microsoft Foundry](/fr/microsoft-foundry) et les sessions de [passerelle d'applications Claude](/fr/claude-apps-gateway) signées, le mode auto n'apparaît pas dans le cycle `Shift+Tab` jusqu'à ce que `CLAUDE_CODE_ENABLE_AUTO_MODE` soit défini sur `1`. La variable fonctionne dans Claude Code v2.1.158 et ultérieur. Seuls Claude Sonnet 5, Opus 4.7 et Opus 4.8 sont supportés sur ces fournisseurs.

203 211 

204Pour l'activer pour un développeur, ajoutez la variable au bloc `env` dans `~/.claude/settings.json` :212Pour l'activer pour un développeur, ajoutez la variable au bloc `env` dans `~/.claude/settings.json` :

205 213 


223 Ce que le classificateur bloque par défaut231 Ce que le classificateur bloque par défaut

224</h3>232</h3>

225 233 

226Le classificateur fait confiance à votre répertoire de travail et aux télécommandes configurées de votre dépôt. Tout le reste est traité comme externe jusqu'à ce que vous [configuriez l'infrastructure de confiance](/fr/auto-mode-config).234Le classificateur fait confiance à votre répertoire de travail et aux télécommandes configurées pour celui-ci quand la session a commencé. {/* min-version: 2.1.200 */}Une télécommande ajoutée ou reorientée pendant la session avec `git remote add` ou `git remote set-url` n'est pas de confiance, et tout le reste est traité comme externe jusqu'à ce que vous [configuriez l'infrastructure de confiance](/fr/auto-mode-config). Avant v2.1.200, les télécommandes ajoutées en milieu de session étaient également de confiance.

227 235 

228**Bloqué par défaut** :236**Bloqué par défaut** :

229 237 


234* Octroi de permissions IAM ou de dépôt242* Octroi de permissions IAM ou de dépôt

235* Modification de l'infrastructure partagée243* Modification de l'infrastructure partagée

236* Destruction irréversible de fichiers qui existaient avant la session244* Destruction irréversible de fichiers qui existaient avant la session

237* Forçage ou poussée directe vers `main`245* Force push

246* {/* min-version: 2.1.203 */}Poussée vers la branche par défaut du dépôt quand la poussée porte du contenu sensible tel que des secrets ou des données personnelles ou confiées, porte des modifications dissimulées ou mal décrites par rapport à ce que vous avez demandé, porte du contenu porté ou d'abord lu de l'extérieur du dépôt, ou contourne une demande de tirage, un examen ou une vérification que vous avez demandés. Une poussée simple vers la branche par défaut n'est pas bloquée en elle-même, et l'effacement d'une poussée signalée nécessite de nommer le contenu signalé ou l'examen contourné, pas seulement la poussée. Le classificateur est une couche : les [règles `permissions.deny`](/fr/permissions#manage-permissions) s'appliquent dans tous les modes et peuvent bloquer les poussées vers la branche par défaut directement, et la protection de branche du dépôt distant s'applique toujours. Avant v2.1.203, toute poussée directe vers la branche par défaut était bloquée

238* {/* min-version: 2.1.182 */}`git reset --hard`, `git checkout -- .`, `git restore .`, `git clean -fd`, `git stash drop`, ou `git stash clear`, que le classificateur présume élimineraient les modifications non validées247* {/* min-version: 2.1.182 */}`git reset --hard`, `git checkout -- .`, `git restore .`, `git clean -fd`, `git stash drop`, ou `git stash clear`, que le classificateur présume élimineraient les modifications non validées

239* `git commit --amend` quand le commit à HEAD n'a pas été créé dans cette session248* `git commit --amend` quand le commit à HEAD n'a pas été créé dans cette session

240* {/* min-version: 2.1.198 */}À partir de v2.1.198, `git commit --amend` quand le commit à HEAD a déjà été poussé. Une réécriture de message uniquement n'est pas bloquée : `--amend -m` sans rien de nouvellement préparé, sur un commit que Claude a créé pendant cette session249* {/* min-version: 2.1.198 */}À partir de v2.1.198, `git commit --amend` quand le commit à HEAD a déjà été poussé. Une réécriture de message uniquement n'est pas bloquée : `--amend -m` sans rien de nouvellement préparé, sur un commit que Claude a créé pendant cette session


251* Création de ressources Kubernetes qui s'exécutent sur chaque nœud ou interceptent le trafic du cluster, comme les DaemonSets et les webhooks d'admission260* Création de ressources Kubernetes qui s'exécutent sur chaque nœud ou interceptent le trafic du cluster, comme les DaemonSets et les webhooks d'admission

252* Shells interactifs ou port-forwards vers une cible distante sensible261* Shells interactifs ou port-forwards vers une cible distante sensible

253* Ouverture d'un tunnel ou d'un shell inverse qui rend un service local accessible depuis l'internet public262* Ouverture d'un tunnel ou d'un shell inverse qui rend un service local accessible depuis l'internet public

254* Impression d'une identifiant ou d'un jeton en direct dans la transcription ou un fichier263* Impression d'un identifiant ou d'un jeton en direct dans la transcription ou un fichier

255* Accès à un emplacement listé comme emplacement de données sensibles dans votre [environnement](/fr/auto-mode-config#define-trusted-infrastructure), ou copie de données hors de celui-ci. {/* min-version: 2.1.198 */}À partir de v2.1.198, cela bloque également l'envoi de données d'un emplacement à un public que l'entrée exclut264* Accès à un emplacement listé comme emplacement de données sensibles dans votre [environnement](/fr/auto-mode-config#define-trusted-infrastructure), ou copie de données hors de celui-ci. {/* min-version: 2.1.198 */}À partir de v2.1.198, cela bloque également l'envoi de données d'un emplacement à un public que l'entrée exclut

256* Routage d'une installation de paquet autour de votre registre de paquets interne vers un registre public. {/* min-version: 2.1.198 */}À partir de v2.1.198, cela s'applique également quand vous avez dit à Claude qu'un registre interne ou un miroir existe dans la conversation, pas seulement quand un est listé dans votre environnement265* Routage d'une installation de paquet autour de votre registre de paquets interne vers un registre public. {/* min-version: 2.1.198 */}À partir de v2.1.198, cela s'applique également quand vous avez dit à Claude qu'un registre interne ou un miroir existe dans la conversation, pas seulement quand un est listé dans votre environnement

257* Exécution d'une commande avec un drapeau qui désarme une garde de sécurité, comme `--insecure`266* Exécution d'une commande avec un drapeau qui désarme une garde de sécurité, comme `--insecure`


261Claude Code v2.1.198 et ultérieur bloquent également ceci par défaut :270Claude Code v2.1.198 et ultérieur bloquent également ceci par défaut :

262 271 

263* Suppression de fichiers dans `/tmp`, `$TMPDIR`, ou un autre répertoire partagé de scratch ou de cache par caractère générique, glob, ou filtre d'âge plutôt que par un chemin nommé spécifique272* Suppression de fichiers dans `/tmp`, `$TMPDIR`, ou un autre répertoire partagé de scratch ou de cache par caractère générique, glob, ou filtre d'âge plutôt que par un chemin nommé spécifique

264* Inclusion de détails sensibles dans le contenu envoyé, téléchargé, publié ou écrit à d'autres personnes ou systèmes partagés, quand votre propre message n'a pas autorisé ces détails pour ce destinataire273* Inclusion de détails sensibles dans le contenu envoyé, téléchargé, publié ou écrit à d'autres personnes ou systèmes partagés, quand votre propre message n'a pas autorisé ces détails pour ce destinataire. {/* min-version: 2.1.200 */}Les corps de PR et de problème, les messages de commit et les commentaires comptent comme ce type de contenu sortant quand le dépôt est en dehors de la limite de confiance ou public, y compris les dépôts publics de votre propre organisation ; les chemins de fichiers internes, les noms de code, les données de réponse API en direct telles que les e-mails ou les identifiants de compte, et les identifiants d'infrastructure comptent comme des détails sensibles. La portée PR, problème et message de commit nécessite Claude Code v2.1.200 ou ultérieur. {/* min-version: 2.1.203 */}Les données personnelles en direct d'une réponse API dans un corps de PR ou de problème, comme une adresse e-mail, un identifiant de compte ou d'organisation, ou une métrique d'utilisation, vous obligent à nommer ces détails et le destinataire indépendamment de la visibilité du dépôt ou de la limite de confiance. Cette vérification nécessite Claude Code v2.1.203 ou ultérieur

265* Envoi de frappes au volet tmux de Claude Code lui-même pour piloter sa propre interface, que le classificateur traite comme Claude changeant ses propres permissions ou surveillance274* Envoi de frappes au volet tmux de Claude Code lui-même pour piloter sa propre interface, que le classificateur traite comme Claude changeant ses propres permissions ou surveillance

266 275 

276Claude Code v2.1.200 et ultérieur bloquent également ceci par défaut :

277 

278* Commentaire, suppression ou passage en force d'un test ou d'une assertion qui protège le comportement de sécurité, comme l'authentification, le contrôle d'accès, la validation des entrées ou le sandboxing

279* Suppression ou démantèlement d'une ressource avec état que Claude n'a pas créée dans la session, quand aucune règle de suppression plus spécifique ne s'applique et vous n'avez pas nommé cette ressource

280* Reorientation d'une URL de base API, d'un point de terminaison proxy, d'un récepteur webhook ou d'un miroir de registre vers un hôte tiers qui ne correspond pas à la tâche, y compris dans les fichiers d'exemple comme `.env.example`

281* Modification de la destination des poussées avec `git remote set-url` ou `git remote add`, sauf si vous avez nommé la nouvelle télécommande

282* Poussée de secrets ou de données personnelles ou confiées vers un dépôt connu pour être public, ou poussée de matériel confidentiel là-bas qui ne fait pas partie du travail propre de ce dépôt. {/* min-version: 2.1.203 */}Un dépôt de dotfiles est la seule exception pour les données personnelles ou confiées, et le contenu d'un dépôt privé atteignant n'importe quelle surface publique est bloqué de la même manière ; les deux raffinements nécessitent Claude Code v2.1.203 ou ultérieur. Avant v2.1.203, les données personnelles étaient groupées avec le matériel confidentiel et bloquées uniquement quand elles ne faisaient pas partie du travail propre de ce dépôt. Quand la visibilité d'un dépôt n'est pas établie, le classificateur ne bloque pas sur cela seul ; il juge le contenu par rapport aux autres règles à la place

283* Ouverture d'une demande de tirage contre un dépôt ou une organisation différente, forking avec `gh repo fork`, ou poussée vers un dépôt tiers, sauf si vous avez nommé cette cible externe

284 

285Claude Code v2.1.203 et ultérieur bloquent également ceci par défaut :

286 

287* Contenu 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, une poussée, un texte de PR ou de problème, un gist ou un paste, ou une publication de paquet, sauf si vous avez nommé à la fois la source et la destination. Les transcriptions de session et les journaux de conversation, les dossiers de points de configuration et d'identifiants tels que les clés SSH, les identifiants cloud, les profils de navigateur et l'historique du shell, et les exports de données utilisateur comptent tous, et le dépôt étant privé ne l'efface pas

288 

289Claude Code v2.1.205 et ultérieur bloquent également ceci par défaut :

290 

291* É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. Une transcription est un état de session que Claude Code écrit, pas un fichier de travail, et une entrée falsifiée atteint chaque vérification ultérieure une fois que vous reprenez la session, donc le mode auto bloque ces écritures en tant que défense en profondeur. La lecture d'une transcription n'est pas bloquée

292* Une suppression forcée récursive telle que `rm -rf "$VAR"` ou `Remove-Item -Recurse -Force $dir` dont la cible est une variable shell, ou un glob enraciné à celle-ci, qui n'est assignée nulle part dans la conversation que le classificateur voit. La valeur provenait uniquement de la 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 classificateur lit la conversation plutôt que la sortie de commande par conception, donc il bloque l'appel au lieu de deviner la cible. Le blocage s'efface 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 la cible le classificateur peut résoudre ne sont pas affectées

293 

267**Autorisé par défaut** :294**Autorisé par défaut** :

268 295 

269* Opérations de fichiers locaux dans votre répertoire de travail296* Opérations de fichiers locaux dans votre répertoire de travail


337 2. Pendant que le sous-agent s'exécute, chacune de ses actions passe par le classificateur avec les mêmes règles que la session parent, et tout `permissionMode` dans le frontmatter du sous-agent est ignoré.364 2. Pendant que le sous-agent s'exécute, chacune de ses actions passe par le classificateur avec les mêmes règles que la session parent, et tout `permissionMode` dans le frontmatter du sous-agent est ignoré.

338 3. Quand le sous-agent se termine, le classificateur examine son historique d'action complet ; si cette vérification de retour signale une préoccupation, un avertissement de sécurité est ajouté aux résultats du sous-agent.365 3. Quand le sous-agent se termine, le classificateur examine son historique d'action complet ; si cette vérification de retour signale une préoccupation, un avertissement de sécurité est ajouté aux résultats du sous-agent.

339 366 

367 {/* min-version: 2.1.178 */}}

340 L'étape 1 nécessite Claude Code v2.1.178 ou ultérieur. Les versions antérieures appliquaient le classificateur aux étapes 2 et 3, mais n'évaluaient pas la description de la tâche avant le démarrage du sous-agent.368 L'étape 1 nécessite Claude Code v2.1.178 ou ultérieur. Les versions antérieures appliquaient le classificateur aux étapes 2 et 3, mais n'évaluaient pas la description de la tâche avant le démarrage du sous-agent.

341 </Accordion>369 </Accordion>

342 370 

permissions.md +30 −4

Details

47Claude Code prend en charge plusieurs modes d'autorisation qui contrôlent la façon dont il approuve les appels d'outils. Consultez [Modes d'autorisation](/fr/permission-modes) pour savoir quand utiliser chacun. Définissez le `defaultMode` dans vos [fichiers de paramètres](/fr/settings#settings-files) :47Claude Code prend en charge plusieurs modes d'autorisation qui contrôlent la façon dont il approuve les appels d'outils. Consultez [Modes d'autorisation](/fr/permission-modes) pour savoir quand utiliser chacun. Définissez le `defaultMode` dans vos [fichiers de paramètres](/fr/settings#settings-files) :

48 48 

49| Mode | Description |49| Mode | Description |

50| :------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |50| :------------------ | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

51| `default` | Comportement standard : demande une autorisation à la première utilisation de chaque outil |51| `default` | Comportement standard : demande une autorisation à la première utilisation de chaque outil. {/* min-version: 2.1.200 */}Étiqueté Manuel dans l'interface de ligne de commande et les extensions VS Code et JetBrains, et Claude Code accepte `manual` comme alias. L'étiquette et l'alias nécessitent Claude Code v2.1.200 ou version ultérieure |

52| `acceptEdits` | Accepte automatiquement les éditions de fichiers et les commandes courantes du système de fichiers telles que `mkdir`, `touch`, `mv` et `cp` pour les chemins du répertoire de travail ou `additionalDirectories` |52| `acceptEdits` | Accepte automatiquement les éditions de fichiers et les commandes courantes du système de fichiers telles que `mkdir`, `touch`, `mv` et `cp` pour les chemins du répertoire de travail ou `additionalDirectories` |

53| `plan` | Plan Mode : Claude lit les fichiers et exécute les commandes shell en lecture seule pour explorer mais n'édite pas vos fichiers source |53| `plan` | Claude lit les fichiers et exécute les commandes shell en lecture seule pour explorer mais n'édite pas vos fichiers source. Étiqueté Plan dans l'interface de ligne de commande et l'extension VS Code |

54| `auto` | Approuve automatiquement les appels d'outils avec des vérifications de sécurité en arrière-plan qui vérifient que les actions s'alignent avec votre demande. Actuellement un aperçu de recherche |54| `auto` | Approuve automatiquement les appels d'outils avec des vérifications de sécurité en arrière-plan qui vérifient que les actions s'alignent avec votre demande. Actuellement un aperçu de recherche |

55| `dontAsk` | Refuse automatiquement les outils sauf s'ils sont pré-approuvés via `/permissions` ou les règles `permissions.allow` |55| `dontAsk` | Refuse automatiquement les outils sauf s'ils sont pré-approuvés via `/permissions` ou les règles `permissions.allow` |

56| `bypassPermissions` | Ignore les invites d'autorisation, sauf celles forcées par les règles `ask` explicites. Les suppressions ciblant la racine du système de fichiers ou le répertoire personnel, comme `rm -rf /` et `rm -rf ~`, demandent toujours comme disjoncteur de sécurité |56| `bypassPermissions` | Ignore les invites d'autorisation, sauf celles forcées par les règles `ask` explicites. Les suppressions ciblant la racine du système de fichiers ou le répertoire personnel, comme `rm -rf /` et `rm -rf ~`, demandent toujours comme disjoncteur de sécurité |


215 215 

216Les modèles glob non cités sont autorisés pour les commandes dont chaque drapeau est en lecture seule, donc `ls *.ts` et `wc -l src/*.py` s'exécutent sans invite. Les commandes avec des drapeaux capables d'écriture ou d'exécution, tels que `find`, `sort`, `sed` et `git`, demandent toujours lorsqu'un glob non cité est présent car le glob pourrait s'étendre à un drapeau comme `-delete`.216Les modèles glob non cités sont autorisés pour les commandes dont chaque drapeau est en lecture seule, donc `ls *.ts` et `wc -l src/*.py` s'exécutent sans invite. Les commandes avec des drapeaux capables d'écriture ou d'exécution, tels que `find`, `sort`, `sed` et `git`, demandent toujours lorsqu'un glob non cité est présent car le glob pourrait s'étendre à un drapeau comme `-delete`.

217 217 

218Un `cd` dans un chemin à l'intérieur de votre répertoire de travail ou d'un [répertoire supplémentaire](#working-directories) est également en lecture seule. Une commande composée comme `cd packages/api && ls` s'exécute sans invite lorsque chaque partie se qualifie seule. La combinaison de `cd` avec `git` dans une seule commande composée demande toujours, indépendamment du répertoire cible.218Un `cd` dans un chemin à l'intérieur de votre répertoire de travail ou d'un [répertoire supplémentaire](#working-directories) est également en lecture seule. Une commande composée comme `cd packages/api && ls` s'exécute sans invite lorsque chaque partie se qualifie seule. La combinaison de `cd` avec `git` dans une seule commande composée demande toujours lorsque le `cd` change dans un répertoire différent, car exécuter `git` dans un nouveau répertoire peut exécuter les hooks de ce répertoire. Un `cd` dont la cible se résout au répertoire de travail courant est une non-opération et ne déclenche pas cette invite.

219 219 

220<Warning>220<Warning>

221 Les modèles d'autorisation Bash qui tentent de contraindre les arguments de commande sont fragiles. Par exemple, `Bash(curl http://github.com/ *)` a l'intention de restreindre curl aux URL GitHub, mais ne correspondra pas aux variations comme :221 Les modèles d'autorisation Bash qui tentent de contraindre les arguments de commande sont fragiles. Par exemple, `Bash(curl http://github.com/ *)` a l'intention de restreindre curl aux URL GitHub, mais ne correspondra pas aux variations comme :


313 Dans les modèles gitignore, `*` correspond aux fichiers dans un seul segment de chemin et peut apparaître à n'importe quelle position du modèle, tandis que `**` correspond sur les répertoires. Pour autoriser tous les accès aux fichiers, utilisez simplement le nom de l'outil sans parenthèses : `Read`, `Edit` ou `Write`.313 Dans les modèles gitignore, `*` correspond aux fichiers dans un seul segment de chemin et peut apparaître à n'importe quelle position du modèle, tandis que `**` correspond sur les répertoires. Pour autoriser tous les accès aux fichiers, utilisez simplement le nom de l'outil sans parenthèses : `Read`, `Edit` ou `Write`.

314</Note>314</Note>

315 315 

316Lorsque vous approuvez un chemin de fichier avec « Oui, ne pas demander à nouveau », Claude Code échappe les caractères de modèle gitignore dans ce chemin, tels que `[`, `]` et `*`, afin que la règle générée ne corresponde qu'au chemin littéral que vous avez approuvé. Les règles que vous écrivez vous-même ne sont pas échappées. Avant la v2.1.202, Claude Code enregistrait le chemin non échappé, donc une règle générée pour un répertoire nommé `[2024-06] Reports` pouvait échouer à correspondre à son propre chemin ou correspondre à des répertoires frères non intentionnels.

317 

316Lorsque Claude accède à un lien symbolique, les règles d'autorisation vérifient deux chemins : le lien symbolique lui-même et le fichier vers lequel il se résout. Les règles d'autorisation et de refus traitent cette paire différemment : les règles d'autorisation reviennent à vous inviter, tandis que les règles de refus bloquent carrément.318Lorsque Claude accède à un lien symbolique, les règles d'autorisation vérifient deux chemins : le lien symbolique lui-même et le fichier vers lequel il se résout. Les règles d'autorisation et de refus traitent cette paire différemment : les règles d'autorisation reviennent à vous inviter, tandis que les règles de refus bloquent carrément.

317 319 

318* **Règles d'autorisation** : s'appliquent uniquement lorsque le chemin du lien symbolique et sa cible correspondent tous les deux. Un lien symbolique à l'intérieur d'un répertoire autorisé qui pointe vers l'extérieur vous invite toujours.320* **Règles d'autorisation** : s'appliquent uniquement lorsque le chemin du lien symbolique et sa cible correspondent tous les deux. Un lien symbolique à l'intérieur d'un répertoire autorisé qui pointe vers l'extérieur vous invite toujours.


505 507 

506Les hôtes d'intégration peuvent fournir une politique gérée supplémentaire via l'option SDK `managedSettings` lorsque [`parentSettingsBehavior`](/fr/settings#settings-precedence) est défini sur `"merge"` ; les valeurs de l'intégrateur peuvent renforcer la politique mais pas l'assouplir.508Les hôtes d'intégration peuvent fournir une politique gérée supplémentaire via l'option SDK `managedSettings` lorsque [`parentSettingsBehavior`](/fr/settings#settings-precedence) est défini sur `"merge"` ; les valeurs de l'intégrateur peuvent renforcer la politique mais pas l'assouplir.

507 509 

510<h2 id="project-allow-rules-and-workspace-trust">

511 Règles d'autorisation de projet et confiance de l'espace de travail

512</h2>

513 

514Les règles `permissions.allow` et les entrées `permissions.additionalDirectories` dans le fichier `.claude/settings.json` d'un projet accordent des capacités, donc Claude Code les applique uniquement après que vous acceptiez la [boîte de dialogue de confiance de l'espace de travail](/fr/security#additional-safeguards) pour cet espace de travail. Jusqu'à ce moment, Claude Code lit les règles mais ne les applique pas. La boîte de dialogue de confiance répertorie les règles d'autorisation et les répertoires supplémentaires que le dossier accorderait afin que vous puissiez les examiner avant d'accepter. Les règles `deny` et `ask` ne sont pas affectées, car elles ne font que restreindre.

515 

516Claude Code enregistre la confiance par espace de travail, en utilisant comme clé la racine du référentiel git ou, en dehors d'un référentiel, le répertoire à partir duquel vous avez démarré Claude Code. Lorsque vous démarrez dans votre répertoire personnel, la confiance est conservée pour la session actuelle uniquement et n'est pas écrite sur le disque ; consultez la note sur les [protections supplémentaires](/fr/security#additional-safeguards). Faire confiance à un répertoire parent n'applique pas les règles d'autorisation d'un projet imbriqué.

517 

518`.claude/settings.local.json` est votre propre fichier, donc la vérification de confiance de l'espace de travail ne s'applique généralement pas à celui-ci. Lorsqu'un référentiel aurait pu fournir le fichier, par exemple lorsqu'il est validé dans git ou que `.claude` est un lien symbolique, ses règles d'autorisation et répertoires supplémentaires passent par la vérification de confiance comme les paramètres du projet.

519 

520Les règles d'autorisation et les répertoires supplémentaires dans `.claude/settings.local.json` s'appliquent également sans confiance de l'espace de travail dans deux cas :

521 

522* Le répertoire à partir duquel vous avez démarré Claude Code ne se trouve pas à l'intérieur d'un référentiel git.

523* La session s'exécute dans votre répertoire de configuration personnel : votre répertoire personnel ou tout répertoire dont vous avez défini le sous-répertoire `.claude` comme [`CLAUDE_CONFIG_DIR`](/fr/env-vars).

524 

525Dans les deux cas, le fichier est un fichier que vous avez créé plutôt qu'un fichier qu'un référentiel aurait pu fournir, et un `.claude/settings.local.json` validé dans le référentiel nécessite toujours la confiance de l'espace de travail. Les versions 2.1.196 à 2.1.199 traitaient le fichier comme fourni par le référentiel dans ces espaces de travail, ignoraient ses règles d'autorisation et imprimaient un avertissement [`this workspace has not been trusted`](/fr/errors#workspace-has-not-been-trusted) sur stderr. Les deux exceptions ci-dessus correspondent à la v2.1.195 et antérieures et ont été restaurées dans la v2.1.200.

526 

527Également à partir de la v2.1.200, un espace de travail dont les règles d'autorisation ou les répertoires supplémentaires ne sont toujours pas appliqués, mais qui n'a jamais montré la boîte de dialogue de confiance parce qu'un répertoire parent était déjà approuvé, affiche la boîte de dialogue la prochaine fois que vous démarrez Claude Code là-bas de manière interactive. La boîte de dialogue offre deux choix :

528 

529* **Oui, j'approuve ce dossier** : enregistre la confiance pour cet espace de travail et applique les règles dans la même session.

530* **Non, continuer sans ces permissions** : continue de fonctionner avec ces règles ignorées. La boîte de dialogue réapparaît dans la session suivante.

531 

532En [mode non interactif](/fr/headless) avec `-p`, aucune boîte de dialogue n'apparaît et les règles restent ignorées.

533 

508<h2 id="example-configurations">534<h2 id="example-configurations">

509 Exemples de configurations535 Exemples de configurations

510</h2>536</h2>

platforms.md +1 −1

Details

23| [Web](/fr/claude-code-on-the-web) | Tâches longues qui ne nécessitent pas beaucoup de direction, ou travail qui devrait continuer quand vous êtes hors ligne | Cloud géré par Anthropic, continue après votre déconnexion |23| [Web](/fr/claude-code-on-the-web) | Tâches longues qui ne nécessitent pas beaucoup de direction, ou travail qui devrait continuer quand vous êtes hors ligne | Cloud géré par Anthropic, continue après votre déconnexion |

24| Mobile | Démarrer et surveiller les tâches loin de votre ordinateur | Sessions cloud depuis l'application Claude pour iOS et Android, [Remote Control](/fr/remote-control) pour les sessions locales, [Dispatch](/fr/desktop#sessions-from-dispatch) vers Desktop sur Pro et Max |24| Mobile | Démarrer et surveiller les tâches loin de votre ordinateur | Sessions cloud depuis l'application Claude pour iOS et Android, [Remote Control](/fr/remote-control) pour les sessions locales, [Dispatch](/fr/desktop#sessions-from-dispatch) vers Desktop sur Pro et Max |

25 25 

26Le CLI est la surface la plus complète pour le travail natif en terminal : les scripts et l'Agent SDK sont exclusifs au CLI. Les fournisseurs tiers fonctionnent également dans [VS Code](/fr/vs-code#use-third-party-providers). Les déploiements [Desktop](/fr/desktop) d'entreprise prennent en charge Vertex AI et les fournisseurs de passerelle ; pour Bedrock ou Foundry, utilisez le CLI ou VS Code, ou la [Cowork on 3P research preview](https://claude.com/docs/cowork/3p/overview), qui exécute l'onglet Code sur ces fournisseurs. Desktop et les extensions IDE échangent certaines fonctionnalités exclusives au CLI contre un examen visuel et une intégration plus étroite de l'éditeur. Le web s'exécute dans le cloud d'Anthropic, donc les tâches continuent après votre déconnexion. Mobile est un client léger dans ces mêmes sessions cloud ou dans une session locale via Remote Control, et peut envoyer des tâches à Desktop avec Dispatch.26Le CLI est la surface la plus complète pour le travail natif en terminal : les scripts et l'Agent SDK sont exclusifs au CLI. Les fournisseurs tiers fonctionnent également dans [VS Code](/fr/vs-code#use-third-party-providers). Les déploiements [Desktop](/fr/desktop) d'entreprise prennent en charge Google Cloud's Agent Platform et les fournisseurs de passerelle ; pour Amazon Bedrock ou Microsoft Foundry, utilisez le CLI ou VS Code, ou [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview), qui exécute l'onglet Code sur ces fournisseurs. Desktop et les extensions IDE échangent certaines fonctionnalités exclusives au CLI contre un examen visuel et une intégration plus étroite de l'éditeur. Le web s'exécute dans le cloud d'Anthropic, donc les tâches continuent après votre déconnexion. Mobile est un client léger dans ces mêmes sessions cloud ou dans une session locale via Remote Control, et peut envoyer des tâches à Desktop avec Dispatch.

27 27 

28Vous pouvez mélanger les surfaces sur le même projet. La configuration, la mémoire du projet et les serveurs MCP sont partagés entre les surfaces locales.28Vous pouvez mélanger les surfaces sur le même projet. La configuration, la mémoire du projet et les serveurs MCP sont partagés entre les surfaces locales.

29 29 

Details

125| `~2.1` | `~3.0` | L'installation du plugin B échoue avec `range-conflict`. Le plugin A et la dépendance restent comme ils étaient. |125| `~2.1` | `~3.0` | L'installation du plugin B échoue avec `range-conflict`. Le plugin A et la dépendance restent comme ils étaient. |

126| `=2.1.0` | aucun | La dépendance reste à `2.1.0`. La mise à jour automatique ignore les versions plus récentes tant que le plugin A est installé. |126| `=2.1.0` | aucun | La dépendance reste à `2.1.0`. La mise à jour automatique ignore les versions plus récentes tant que le plugin A est installé. |

127 127 

128La mise à jour automatique récupère une dépendance contrainte à la balise git la plus élevée qui satisfait la plage de chaque plugin installé, plutôt qu'à la dernière version du marketplace, de sorte que la dépendance continue à recevoir des mises à jour dans sa plage autorisée. Si aucune balise ne satisfait toutes les plages, la mise à jour est ignorée et l'ignorance apparaît dans `/doctor` et l'onglet Erreurs de `/plugin`, en nommant le plugin contraignant.128La mise à jour automatique récupère une dépendance contrainte à la balise git la plus élevée qui satisfait la plage de chaque plugin installé, plutôt qu'à la dernière version du marketplace, de sorte que la dépendance continue à recevoir des mises à jour dans sa plage autorisée. Si aucune balise ne satisfait toutes les plages, la mise à jour automatique ignore cette dépendance et répertorie l'ignorance dans l'onglet Erreurs de `/plugin`, en nommant le plugin contraignant.

129 129 

130Lorsque vous désinstallez le dernier plugin qui contraint une dépendance, la dépendance n'est plus maintenue et reprend le suivi de son entrée marketplace lors de la prochaine mise à jour.130Lorsque vous désinstallez le dernier plugin qui contraint une dépendance, la dépendance n'est plus maintenue et reprend le suivi de son entrée marketplace lors de la prochaine mise à jour.

131 131 


181 Résoudre les erreurs de dépendance181 Résoudre les erreurs de dépendance

182</h2>182</h2>

183 183 

184Les problèmes de dépendance apparaissent dans `claude plugin list`, dans l'interface `/plugin`, et dans `/doctor`. Le plugin affecté est désactivé jusqu'à ce que vous résolviez l'erreur. Les erreurs les plus courantes et leurs corrections sont listées ci-dessous.184Les problèmes de dépendance apparaissent dans `claude plugin list` et dans l'interface `/plugin`. Claude Code désactive le plugin affecté jusqu'à ce que vous résolviez l'erreur. Le tableau ci-dessous liste les erreurs les plus courantes et comment les résoudre.

185 185 

186| Erreur | Signification | Comment résoudre |186| Erreur | Signification | Comment résoudre |

187| :------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |187| :------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

Details

170| `plugins` | array | Liste des plugins disponibles | Voir ci-dessous |170| `plugins` | array | Liste des plugins disponibles | Voir ci-dessous |

171 171 

172<Note>172<Note>

173 **Noms réservés** : Les noms de place de marché suivants sont réservés à l'usage officiel d'Anthropic et ne peuvent pas être utilisés par les places de marché tierces : `claude-code-marketplace`, `claude-code-plugins`, `claude-plugins-official`, `claude-plugins-community`, `claude-community`, `anthropic-marketplace`, `anthropic-plugins`, `agent-skills`, `anthropic-agent-skills`, `knowledge-work-plugins`, `life-sciences`, `claude-for-legal`, `claude-for-financial-services`, `financial-services-plugins`. Les noms qui usurpent l'identité de places de marché officielles, comme `official-claude-plugins` ou `anthropic-tools-v2`, sont également bloqués.173 **Noms réservés** : les noms de place de marché suivants sont réservés à l'usage officiel d'Anthropic et ne peuvent pas être utilisés par les places de marché tierces : `claude-code-marketplace`, `claude-code-plugins`, `claude-plugins-official`, `claude-plugins-community`, `claude-community`, `anthropic-marketplace`, `anthropic-plugins`, `agent-skills`, `anthropic-agent-skills`, `knowledge-work-plugins`, `life-sciences`, `claude-for-legal`, `claude-for-financial-services`, `financial-services-plugins`, `first-party-plugins`, `healthcare`. Les noms qui usurpent l'identité de places de marché officielles, comme `official-claude-plugins` ou `anthropic-plugins-v2`, sont également bloqués. La réservation de ces noms empêche une place de marché tierce de se présenter comme une source publiée par Anthropic.

174 

175 Claude Code revérifie les noms réservés chaque fois qu'il charge une place de marché, pas seulement lorsque vous en ajoutez une. Une place de marché qui a été enregistrée sous l'un de ces noms avant que le nom ne soit réservé cesse de se charger et signale qu'elle est [enregistrée à partir d'une source non fiable](/fr/errors#marketplace-is-registered-from-an-untrusted-source). Supprimez cette place de marché et rajoutez-la à partir de la source officielle d'Anthropic. Une place de marché tierce affectée par un nom nouvellement réservé se charge à nouveau dès que vous la rajoutez sous un nom différent. Avant la v2.1.205, `first-party-plugins` et `healthcare` n'étaient pas réservés, et une place de marché déjà enregistrée sous un nom réservé continuait à se charger.

174</Note>176</Note>

175 177 

176<h3 id="owner-fields">178<h3 id="owner-fields">

plugins.md +2 −0

Details

203 203 

204<Warning>204<Warning>

205 **Erreur courante** : Ne mettez pas `commands/`, `agents/`, `skills/` ou `hooks/` à l'intérieur du répertoire `.claude-plugin/`. Seul `plugin.json` va à l'intérieur de `.claude-plugin/`. Tous les autres répertoires doivent être au niveau racine du plugin.205 **Erreur courante** : Ne mettez pas `commands/`, `agents/`, `skills/` ou `hooks/` à l'intérieur du répertoire `.claude-plugin/`. Seul `plugin.json` va à l'intérieur de `.claude-plugin/`. Tous les autres répertoires doivent être au niveau racine du plugin.

206 

207 La racine du plugin est le répertoire propre du plugin individuel : celui qui contient `.claude-plugin/plugin.json`. Ce n'est jamais `~/.claude/`. Par exemple, Claude Code ne lit pas un `.mcp.json` placé à `~/.claude/.mcp.json`.

206</Warning>208</Warning>

207 209 

208| Répertoire | Emplacement | Objectif |210| Répertoire | Emplacement | Objectif |

Details

159* `prompt` : évaluer une invite avec un LLM (utilise l'espace réservé `$ARGUMENTS` pour le contexte)159* `prompt` : évaluer une invite avec un LLM (utilise l'espace réservé `$ARGUMENTS` pour le contexte)

160* `agent` : exécuter un vérificateur agentic avec des outils pour les tâches de vérification complexes160* `agent` : exécuter un vérificateur agentic avec des outils pour les tâches de vérification complexes

161 161 

162Les hooks qui ciblent le [serveur MCP groupé](#mcp-servers) du plugin lui-même doivent utiliser ses noms délimités. Les correspondances d'outils et les champs `if` prennent le nom d'outil délimité `mcp__plugin_<plugin-name>_<server-name>__<tool>`, et le champ `server` d'un hook `mcp_tool` prend `plugin:<plugin-name>:<server-name>`. Une correspondance écrite contre la clé du serveur nu ne se déclenche jamais. Consultez [Correspondre les outils MCP](/fr/hooks#match-mcp-tools) et [Serveurs MCP fournis par les plugins](/fr/mcp#plugin-provided-mcp-servers).

163 

162<h3 id="mcp-servers">164<h3 id="mcp-servers">

163 Serveurs MCP165 Serveurs MCP

164</h3>166</h3>


266| `settings` | Paramètres transmis via `workspace/didChangeConfiguration` |268| `settings` | Paramètres transmis via `workspace/didChangeConfiguration` |

267| `workspaceFolder` | Chemin du dossier de l'espace de travail pour le serveur |269| `workspaceFolder` | Chemin du dossier de l'espace de travail pour le serveur |

268| `startupTimeout` | Temps maximum d'attente du démarrage du serveur (millisecondes) |270| `startupTimeout` | Temps maximum d'attente du démarrage du serveur (millisecondes) |

271| `shutdownTimeout` | Temps maximum d'attente de l'arrêt gracieux (millisecondes). Quand le délai d'attente s'écoule, Claude Code termine le processus du serveur. Quand non défini, aucun délai d'attente ne s'applique |

272| `restartOnCrash` | Indique s'il faut redémarrer le serveur après un plantage. Par défaut `true`. Définissez sur `false` pour laisser un serveur planté arrêté au lieu de le redémarrer |

269| `maxRestarts` | Nombre maximum de tentatives de redémarrage avant d'abandonner |273| `maxRestarts` | Nombre maximum de tentatives de redémarrage avant d'abandonner |

270| `diagnostics` | Indique s'il faut pousser les diagnostics dans le contexte de Claude après les modifications (par défaut `true`). Définissez sur `false` pour conserver la navigation de code mais supprimer l'injection automatique de diagnostics. |274| `diagnostics` | Indique s'il faut pousser les diagnostics dans le contexte de Claude après les modifications (par défaut `true`). Définissez sur `false` pour conserver la navigation de code mais supprimer l'injection automatique de diagnostics. |

271 275 

276`restartOnCrash` et `shutdownTimeout` nécessitent Claude Code v2.1.205 ou ultérieur. Avant v2.1.205, le schéma de configuration acceptait les deux options mais définir l'une ou l'autre causait à Claude Code de sauter ce serveur LSP entièrement au démarrage, avec la raison visible uniquement dans la sortie `claude --debug`.

277 

278**Plusieurs serveurs pour la même extension** : quand plus d'un serveur LSP activé déclare la même extension de fichier dans `extensionToLanguage`, que les serveurs proviennent d'un plugin ou de différents plugins, le premier serveur enregistré gère les fichiers avec cette extension et les autres ne démarrent jamais. L'interface `/plugin` affiche un avertissement nommant le plugin dont le serveur est actif.

279 

280**Serveurs qui échouent à initialiser** : Claude Code saute un serveur dont la configuration est invalide, par exemple un serveur manquant `command` ou `extensionToLanguage`, et les autres serveurs configurés démarrent toujours. Exécutez `claude --debug` pour voir pourquoi un serveur a été sauté.

281 

282Un serveur sauté ne réclame pas ses extensions de fichier, donc un autre serveur valide qui déclare la même extension, du même plugin ou d'un plugin différent, gère toujours ces fichiers. Avant v2.1.205, un serveur qui échouait à initialiser réclamait toujours ses extensions et bloquait un autre serveur valide pour la même extension.

283 

272<Warning>284<Warning>

273 **Vous devez installer le binaire du serveur de langage séparément.** Les plugins LSP configurent comment Claude Code se connecte à un serveur de langage, mais ils n'incluent pas le serveur lui-même. Si vous voyez `Executable not found in $PATH` dans l'onglet Erreurs de `/plugin`, installez le binaire requis pour votre langage.285 **Vous devez installer le binaire du serveur de langage séparément.** Les plugins LSP configurent comment Claude Code se connecte à un serveur de langage, mais ils n'incluent pas le serveur lui-même. Si vous voyez `Executable not found in $PATH` dans l'onglet Erreurs de `/plugin`, installez le binaire requis pour votre langage.

274</Warning>286</Warning>


635* **S'ajoute au répertoire par défaut** : `skills`. Le répertoire par défaut `skills/` est toujours analysé, et les répertoires listés dans `skills` sont chargés à côté de lui. Exception : pour une [entrée de marketplace dont la `source` se résout à la racine de la marketplace](/fr/plugin-marketplaces#advanced-plugin-entries), déclarer des sous-répertoires spécifiques remplace l'analyse par défaut `skills/`647* **S'ajoute au répertoire par défaut** : `skills`. Le répertoire par défaut `skills/` est toujours analysé, et les répertoires listés dans `skills` sont chargés à côté de lui. Exception : pour une [entrée de marketplace dont la `source` se résout à la racine de la marketplace](/fr/plugin-marketplaces#advanced-plugin-entries), déclarer des sous-répertoires spécifiques remplace l'analyse par défaut `skills/`

636* **Règles de fusion propres** : [hooks](#hooks), [Serveurs MCP](#mcp-servers), et [Serveurs LSP](#lsp-servers). Consultez chaque section pour savoir comment plusieurs sources se combinent648* **Règles de fusion propres** : [hooks](#hooks), [Serveurs MCP](#mcp-servers), et [Serveurs LSP](#lsp-servers). Consultez chaque section pour savoir comment plusieurs sources se combinent

637 649 

638Quand un plugin a à la fois un dossier par défaut et la clé de manifeste correspondante, Claude Code v2.1.140 et versions ultérieures signale le dossier ignoré dans `/doctor`, `claude plugin list`, et la vue de détail `/plugin`. Le plugin se charge toujours en utilisant les chemins du manifeste. Aucun avertissement n'est affiché quand la clé de manifeste pointe dans le dossier par défaut, par exemple `"commands": ["./commands/deploy.md"]`, car le dossier est adressé explicitement dans ce cas.650Quand un plugin a à la fois un dossier par défaut et la clé de manifeste correspondante, Claude Code v2.1.140 et versions ultérieures signale le dossier ignoré dans `claude plugin list` et la vue de détail `/plugin`. Le plugin se charge toujours en utilisant les chemins du manifeste. Aucun avertissement n'est affiché quand la clé de manifeste pointe dans le dossier par défaut, par exemple `"commands": ["./commands/deploy.md"]`, car le dossier est adressé explicitement dans ce cas.

639 651 

640Pour tous les champs de chemin :652Pour tous les champs de chemin :

641 653 


673 685 

674**`${CLAUDE_PLUGIN_DATA}`** : un répertoire persistant pour l'état du plugin qui survit aux mises à jour. Utilisez ceci pour les dépendances installées telles que `node_modules` ou les environnements virtuels Python, le code généré, les caches et tous les autres fichiers qui doivent persister entre les versions du plugin. Le répertoire est créé automatiquement la première fois que cette variable est référencée.686**`${CLAUDE_PLUGIN_DATA}`** : un répertoire persistant pour l'état du plugin qui survit aux mises à jour. Utilisez ceci pour les dépendances installées telles que `node_modules` ou les environnements virtuels Python, le code généré, les caches et tous les autres fichiers qui doivent persister entre les versions du plugin. Le répertoire est créé automatiquement la première fois que cette variable est référencée.

675 687 

676**`${CLAUDE_PROJECT_DIR}`** : la racine du projet. C'est le même répertoire que les hooks reçoivent dans leur variable `CLAUDE_PROJECT_DIR`. Utilisez ceci pour référencer les scripts ou fichiers de configuration locaux au projet. Enveloppez entre guillemets pour gérer les chemins avec des espaces, par exemple `"${CLAUDE_PROJECT_DIR}/scripts/server.sh"`. Les serveurs MCP peuvent également appeler la requête MCP `roots/list`, qui retourne le répertoire à partir duquel Claude Code a été lancé.688**`${CLAUDE_PROJECT_DIR}`** : la racine du projet. C'est le même répertoire que les hooks reçoivent dans leur variable `CLAUDE_PROJECT_DIR`. Utilisez ceci pour référencer les scripts ou fichiers de configuration locaux au projet. Enveloppez entre guillemets pour gérer les chemins avec des espaces, par exemple `"${CLAUDE_PROJECT_DIR}/scripts/server.sh"`.

689 

690Les serveurs MCP peuvent également appeler la requête `roots/list` pour lire les répertoires de travail de la session à l'exécution. Consultez [ce que `roots/list` retourne et quand Claude Code notifie le serveur des modifications](/fr/mcp#option-3-add-a-local-stdio-server).

677 691 

678```json theme={null}692```json theme={null}

679{693{

Details

50Le caching se produit côté serveur, dans l'infrastructure qui sert votre modèle. L'endroit où cela se trouve dépend de la façon dont vous vous authentifiez :50Le caching se produit côté serveur, dans l'infrastructure qui sert votre modèle. L'endroit où cela se trouve dépend de la façon dont vous vous authentifiez :

51 51 

52* **Clé API, abonnement Claude, ou [Claude Platform on AWS](/fr/claude-platform-on-aws)** : le cache vit dans l'infrastructure d'Anthropic, accessible via l'[API Claude](https://platform.claude.com/docs)52* **Clé API, abonnement Claude, ou [Claude Platform on AWS](/fr/claude-platform-on-aws)** : le cache vit dans l'infrastructure d'Anthropic, accessible via l'[API Claude](https://platform.claude.com/docs)

53* **Bedrock ou Vertex AI** : le cache vit dans l'infrastructure de service de votre fournisseur cloud53* **Amazon Bedrock ou Google Cloud's Agent Platform** : le cache vit dans l'infrastructure de service de votre fournisseur cloud

54* **Foundry** : les requêtes sont acheminées vers l'infrastructure d'Anthropic54* **Microsoft Foundry** : les requêtes sont acheminées vers l'infrastructure d'Anthropic

55* **`ANTHROPIC_BASE_URL` personnalisé ou [passerelle LLM](/fr/llm-gateway)** : le cache vit là où vos requêtes sont transférées, et le fonctionnement du caching dépend de la passerelle55* **`ANTHROPIC_BASE_URL` personnalisé ou [passerelle LLM](/fr/llm-gateway)** : le cache vit là où vos requêtes sont transférées, et le fonctionnement du caching dépend de la passerelle

56 56 

57Pour ce que chaque fournisseur stocke et traite, voir [utilisation des données](/fr/data-usage). Où que le cache vive, les entrées expirent après une période d'inactivité, et [Durée de vie du cache](#cache-lifetime) ci-dessous couvre le TTL et comment l'étendre.57Pour ce que chaque fournisseur stocke et traite, voir [utilisation des données](/fr/data-usage). Où que le cache vive, les entrées expirent après une période d'inactivité, et [Durée de vie du cache](#cache-lifetime) ci-dessous couvre le TTL et comment l'étendre.


235 Sur une clé API ou un fournisseur tiers235 Sur une clé API ou un fournisseur tiers

236</h3>236</h3>

237 237 

238Sur une clé API, Bedrock, Vertex, Foundry, ou Claude Platform on AWS, vous payez les tarifs par jeton, donc le TTL reste aux cinq minutes moins chers par défaut. Pour opter pour le [TTL d'une heure](https://platform.claude.com/docs/fr/build-with-claude/prompt-caching#1-hour-cache-duration), définissez `ENABLE_PROMPT_CACHING_1H=1`.238Sur une clé API, Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, ou Claude Platform on AWS, vous payez les tarifs par jeton, donc le TTL reste aux cinq minutes moins chers par défaut. Pour opter pour le [TTL d'une heure](https://platform.claude.com/docs/fr/build-with-claude/prompt-caching#1-hour-cache-duration), définissez `ENABLE_PROMPT_CACHING_1H=1`.

239 239 

240Sur Bedrock, le support du prompt caching, la longueur minimale du préfixe cacheable, et la disponibilité du TTL d'une heure varient tous selon le modèle. Si les comptages de jetons de cache restent à zéro, vérifiez les [modèles, régions et limites pris en charge](https://docs.aws.amazon.com/bedrock/latest/userguide/prompt-caching.html#prompt-caching-models) dans la documentation Bedrock.240Sur Amazon Bedrock, le support du prompt caching, la longueur minimale du préfixe cacheable, et la disponibilité du TTL d'une heure varient tous selon le modèle. Si les comptages de jetons de cache restent à zéro, vérifiez les [modèles, régions et limites pris en charge](https://docs.aws.amazon.com/bedrock/latest/userguide/prompt-caching.html#prompt-caching-models) dans la documentation Amazon Bedrock.

241 241 

242<h3 id="override-the-ttl">242<h3 id="override-the-ttl">

243 Remplacer le TTL243 Remplacer le TTL

quickstart.md +1 −1

Details

105 105 

106* [Claude Pro, Max, Team ou Enterprise](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=quickstart_login) (recommandé)106* [Claude Pro, Max, Team ou Enterprise](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=quickstart_login) (recommandé)

107* [Claude Console](https://console.anthropic.com/) (accès API avec crédits prépayés). Lors de la première connexion, un espace de travail « Claude Code » est automatiquement créé dans la Console pour un suivi centralisé des coûts.107* [Claude Console](https://console.anthropic.com/) (accès API avec crédits prépayés). Lors de la première connexion, un espace de travail « Claude Code » est automatiquement créé dans la Console pour un suivi centralisé des coûts.

108* [Amazon Bedrock, Google Vertex AI ou Microsoft Foundry](/fr/third-party-integrations) (fournisseurs cloud d'entreprise)108* [Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry](/fr/third-party-integrations) (fournisseurs cloud d'entreprise)

109* Une passerelle [Claude apps gateway](/fr/claude-apps-gateway) auto-hébergée, si votre organisation en exécute une : votre administrateur préconfigure l'URL de la passerelle, et `/login` ouvre directement l'écran **Cloud gateway** pour que vous vous connectiez avec l'authentification unique d'entreprise109* Une passerelle [Claude apps gateway](/fr/claude-apps-gateway) auto-hébergée, si votre organisation en exécute une : votre administrateur préconfigure l'URL de la passerelle, et `/login` ouvre directement l'écran **Cloud gateway** pour que vous vous connectiez avec l'authentification unique d'entreprise

110 110 

111Une fois connecté, vos identifiants sont stockés et vous n'aurez pas besoin de vous reconnecter.111Une fois connecté, vos identifiants sont stockés et vous n'aurez pas besoin de vous reconnecter.

Details

16 16 

17* **Utiliser votre environnement local complet à distance** : votre système de fichiers, [serveurs MCP](/fr/mcp), outils et configuration de projet restent tous disponibles, et taper `@` complète automatiquement les chemins de fichiers de votre projet local17* **Utiliser votre environnement local complet à distance** : votre système de fichiers, [serveurs MCP](/fr/mcp), outils et configuration de projet restent tous disponibles, et taper `@` complète automatiquement les chemins de fichiers de votre projet local

18* **Travailler depuis les deux surfaces à la fois** : la conversation reste synchronisée sur tous les appareils connectés, vous pouvez donc envoyer des messages depuis votre terminal, navigateur et téléphone de manière interchangeable18* **Travailler depuis les deux surfaces à la fois** : la conversation reste synchronisée sur tous les appareils connectés, vous pouvez donc envoyer des messages depuis votre terminal, navigateur et téléphone de manière interchangeable

19* **Envoyer des images et des fichiers depuis votre téléphone ou navigateur** : lorsque vous ajoutez une pièce jointe dans l'application Claude ou sur claude.ai/code, Claude Code la télécharge sur votre machine et la transmet à Claude en tant que référence de fichier `@`, avec ou sans légende. {/* min-version: 2.1.202 */}Avant la v2.1.202, Claude Code pouvait supprimer une pièce jointe envoyée sans légende avant qu'elle n'atteigne la session.

19* **Survivre aux interruptions** : si votre ordinateur portable s'endort ou votre réseau tombe en panne, la session se reconnecte automatiquement lorsque votre machine revient en ligne20* **Survivre aux interruptions** : si votre ordinateur portable s'endort ou votre réseau tombe en panne, la session se reconnecte automatiquement lorsque votre machine revient en ligne

20 21 

21Contrairement à [Claude Code sur le web](/fr/claude-code-on-the-web), qui s'exécute sur l'infrastructure cloud, les sessions Remote Control s'exécutent directement sur votre machine et interagissent avec votre système de fichiers local. Les interfaces web et mobile ne sont qu'une fenêtre dans cette session locale.22Contrairement à [Claude Code sur le web](/fr/claude-code-on-the-web), qui s'exécute sur l'infrastructure cloud, les sessions Remote Control s'exécutent directement sur votre machine et interagissent avec votre système de fichiers local. Les interfaces web et mobile ne sont qu'une fenêtre dans cette session locale.


34 35 

35* **Abonnement** : disponible sur les plans Pro, Max, Team et Enterprise. Les clés API ne sont pas prises en charge. Sur Team et Enterprise, un propriétaire doit d'abord activer le bouton Remote Control dans les [paramètres d'administration Claude Code](https://claude.ai/admin-settings/claude-code).36* **Abonnement** : disponible sur les plans Pro, Max, Team et Enterprise. Les clés API ne sont pas prises en charge. Sur Team et Enterprise, un propriétaire doit d'abord activer le bouton Remote Control dans les [paramètres d'administration Claude Code](https://claude.ai/admin-settings/claude-code).

36* **Authentification** : exécutez `claude` et utilisez `/login` pour vous connecter via claude.ai si vous ne l'avez pas déjà fait.37* **Authentification** : exécutez `claude` et utilisez `/login` pour vous connecter via claude.ai si vous ne l'avez pas déjà fait.

37* **Point de terminaison API** : non disponible sur Amazon Bedrock, Google Vertex AI ou Microsoft Foundry. {/* min-version: 2.1.196 */}À partir de la v2.1.196, Remote Control est également désactivé lorsque [`ANTHROPIC_BASE_URL`](/fr/env-vars) pointe vers un hôte autre que `api.anthropic.com`, tel qu'une [passerelle LLM](/fr/llm-gateway) ou un proxy. Déconfigurez la variable pour utiliser Remote Control.38* **Point de terminaison API** : non disponible sur Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry. {/* min-version: 2.1.196 */}À partir de la v2.1.196, Remote Control est également désactivé lorsque [`ANTHROPIC_BASE_URL`](/fr/env-vars) pointe vers un hôte autre que `api.anthropic.com`, tel qu'une [passerelle LLM](/fr/llm-gateway) ou un proxy. Déconfigurez la variable pour utiliser Remote Control.

38* **Confiance de l'espace de travail** : exécutez `claude` dans votre répertoire de projet au moins une fois pour accepter la boîte de dialogue de confiance de l'espace de travail.39* **Confiance de l'espace de travail** : exécutez `claude` dans votre répertoire de projet au moins une fois pour accepter la boîte de dialogue de confiance de l'espace de travail.

39 40 

40<h2 id="start-a-remote-control-session">41<h2 id="start-a-remote-control-session">


59 | ----------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |60 | ----------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

60 | `--name "My Project"` | Définissez un titre de session personnalisé visible dans la liste des sessions sur claude.ai/code. |61 | `--name "My Project"` | Définissez un titre de session personnalisé visible dans la liste des sessions sur claude.ai/code. |

61 | `--remote-control-session-name-prefix <prefix>` | Préfixe pour les noms de session générés automatiquement lorsqu'aucun nom explicite n'est défini. Par défaut, le nom d'hôte de votre machine, produisant des noms comme `myhost-graceful-unicorn`. Définissez `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` pour le même effet. |62 | `--remote-control-session-name-prefix <prefix>` | Préfixe pour les noms de session générés automatiquement lorsqu'aucun nom explicite n'est défini. Par défaut, le nom d'hôte de votre machine, produisant des noms comme `myhost-graceful-unicorn`. Définissez `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` pour le même effet. |

63 | `-c`, `--continue` | {/* min-version: 2.1.200 */}Reprendre la session Remote Control la plus récente démarrée à partir de ce répertoire au lieu d'en créer une nouvelle. Ne peut pas être combiné avec `--session-id`, `--spawn`, `--capacity`, ou `--create-session-in-dir`. Nécessite Claude Code v2.1.200 ou version ultérieure ; les versions antérieures rejettent le drapeau comme argument inconnu. |

64 | `--session-id <id>` | {/* min-version: 2.1.200 */}Reprendre une session Remote Control spécifique par son ID. Ne peut pas être combiné avec `--continue`, `--spawn`, `--capacity`, ou `--create-session-in-dir`. Nécessite Claude Code v2.1.200 ou version ultérieure ; les versions antérieures rejettent le drapeau comme argument inconnu. |

62 | `--spawn <mode>` | Comment le serveur crée les sessions.<br />• `same-dir` (par défaut) : toutes les sessions partagent le répertoire de travail actuel, elles peuvent donc entrer en conflit si elles modifient les mêmes fichiers.<br />• `worktree` : chaque session à la demande obtient sa propre [git worktree](/fr/worktrees). Nécessite un référentiel git.<br />• `session` : mode session unique. Sert exactement une session et rejette les connexions supplémentaires. Défini au démarrage uniquement.<br />Appuyez sur `w` à l'exécution pour basculer entre `same-dir` et `worktree`. |65 | `--spawn <mode>` | Comment le serveur crée les sessions.<br />• `same-dir` (par défaut) : toutes les sessions partagent le répertoire de travail actuel, elles peuvent donc entrer en conflit si elles modifient les mêmes fichiers.<br />• `worktree` : chaque session à la demande obtient sa propre [git worktree](/fr/worktrees). Nécessite un référentiel git.<br />• `session` : mode session unique. Sert exactement une session et rejette les connexions supplémentaires. Défini au démarrage uniquement.<br />Appuyez sur `w` à l'exécution pour basculer entre `same-dir` et `worktree`. |

63 | `--capacity <N>` | Nombre maximum de sessions concurrentes. La valeur par défaut est 32. Ne peut pas être utilisé avec `--spawn=session`. |66 | `--capacity <N>` | Nombre maximum de sessions concurrentes. La valeur par défaut est 32. Ne peut pas être utilisé avec `--spawn=session`. |

67 | `--[no-]create-session-in-dir` | Pré-créer une session dans le répertoire actuel au démarrage du serveur, afin que vous ayez un endroit où taper immédiatement. En mode `worktree`, cette session reste dans le répertoire actuel tandis que les sessions à la demande obtiennent des worktrees isolés. Activé par défaut ; passez `--no-create-session-in-dir` pour démarrer sans aucune. |

64 | `--verbose` | Afficher les journaux de connexion et de session détaillés. |68 | `--verbose` | Afficher les journaux de connexion et de session détaillés. |

65 | `--sandbox` / `--no-sandbox` | Activer ou désactiver le [sandboxing](/fr/sandboxing) pour l'isolation du système de fichiers et du réseau. Désactivé par défaut. |69 | `--sandbox` / `--no-sandbox` | Activer ou désactiver le [sandboxing](/fr/sandboxing) pour l'isolation du système de fichiers et du réseau. Désactivé par défaut. |

66 </Tab>70 </Tab>


149 Activer Remote Control pour toutes les sessions153 Activer Remote Control pour toutes les sessions

150</h3>154</h3>

151 155 

152Remote Control ne s'active que lorsque vous exécutez explicitement `claude remote-control`, `claude --remote-control`, ou `/remote-control`, sauf si l'auto-connexion est activée. Pour l'activer automatiquement pour chaque session interactive, exécutez `/config` dans Claude Code et définissez **Enable Remote Control for all sessions** sur `true`. Définissez-le sur `false` pour ne jamais l'auto-connecter, ou laissez-le non défini pour suivre la valeur par défaut de votre organisation. Dans l'application Desktop, vous pouvez également basculer ceci depuis **Settings → Claude Code → Enable remote control by default**.156Remote Control ne s'active que lorsque vous exécutez explicitement `claude remote-control`, `claude --remote-control`, ou `/remote-control`, sauf si l'auto-connexion est activée. Pour l'activer automatiquement pour chaque session interactive, exécutez `/config` dans Claude Code et définissez **Enable Remote Control for all sessions** sur `true`. Définissez-le sur `false` pour ne jamais l'auto-connecter, ou laissez-le non défini pour suivre la valeur par défaut de votre organisation. Dans l'application Desktop, vous pouvez également basculer ceci depuis **Settings → Claude Code → Enable remote control by default**. {/* min-version: 2.1.203 */}Dans l'[extension VS Code](/fr/vs-code#use-the-prompt-box), le même bouton bascule apparaît comme **Enable Remote Control for all sessions** dans la section Paramètres du menu de commande ; nécessite Claude Code v2.1.203 ou version ultérieure.

153 157 

154Avec ce paramètre activé, chaque processus Claude Code interactif enregistre une session distante. Si vous exécutez plusieurs instances, chacune obtient son propre environnement et sa propre session. Pour exécuter plusieurs sessions concurrentes à partir d'un seul processus, utilisez plutôt le [mode serveur](#start-a-remote-control-session).158Avec ce paramètre activé, chaque processus Claude Code interactif enregistre une session distante. Si vous exécutez plusieurs instances, chacune obtient son propre environnement et sa propre session. Pour exécuter plusieurs sessions concurrentes à partir d'un seul processus, utilisez plutôt le [mode serveur](#start-a-remote-control-session).

155 159 


280* **Le processus local doit continuer à s'exécuter** : Remote Control s'exécute en tant que processus local. Si vous fermez le terminal, quittez VS Code, ou arrêtez autrement le processus `claude`, la session se termine.284* **Le processus local doit continuer à s'exécuter** : Remote Control s'exécute en tant que processus local. Si vous fermez le terminal, quittez VS Code, ou arrêtez autrement le processus `claude`, la session se termine.

281* **Panne réseau prolongée** : si votre machine est allumée mais incapable d'atteindre le réseau pendant plus de dix minutes environ, la session expire et le processus se termine. Exécutez `claude remote-control` à nouveau pour démarrer une nouvelle session.285* **Panne réseau prolongée** : si votre machine est allumée mais incapable d'atteindre le réseau pendant plus de dix minutes environ, la session expire et le processus se termine. Exécutez `claude remote-control` à nouveau pour démarrer une nouvelle session.

282* **Ultraplan déconnecte Remote Control** : le démarrage d'une session [ultraplan](/fr/ultraplan) déconnecte toute session Remote Control active car les deux fonctionnalités occupent l'interface claude.ai/code et une seule peut être connectée à la fois.286* **Ultraplan déconnecte Remote Control** : le démarrage d'une session [ultraplan](/fr/ultraplan) déconnecte toute session Remote Control active car les deux fonctionnalités occupent l'interface claude.ai/code et une seule peut être connectée à la fois.

283* **Certaines commandes sont locales uniquement** : les commandes qui ouvrent un sélecteur interactif dans le terminal, telles que `/plugin` ou `/resume`, fonctionnent uniquement à partir de la CLI locale. Les commandes suivantes fonctionnent à partir du mobile et du web :287* **Certaines commandes sont locales uniquement** : les commandes qui s'exécutent uniquement dans l'interface du terminal, telles que `/plugin` ou `/resume`, fonctionnent uniquement à partir de la CLI locale, que vous transmettiez un argument ou non. Les commandes suivantes fonctionnent à partir du mobile et du web :

284 * Commandes de sortie textuelle : `/compact`, `/clear`, `/context`, `/usage`, `/exit`, `/usage-credits`, `/recap`, `/reload-plugins`288 * Commandes de sortie textuelle : `/compact`, `/clear`, `/context`, `/usage`, `/exit`, `/usage-credits`, `/recap`, `/reload-plugins`

289 * `/model`, `/effort`, `/fast`, `/color`, et `/rename` : transmettez la valeur en tant qu'argument, par exemple `/model sonnet` ou `/effort high`. À partir du mobile et du web, `/model` et `/effort` prennent l'argument à la place du sélecteur du terminal ou du curseur.

285 * {/* min-version: 2.1.166 */}`/mcp`, à partir de la v2.1.166 : retourne un résumé textuel de l'état du serveur au lieu d'ouvrir le sélecteur, et accepte les [sous-commandes](/fr/commands#all-commands) `reconnect`, `enable`, et `disable`. Contrairement à la CLI locale, `/mcp reconnect` sans nom de serveur reconnecte tous les serveurs qui ont échoué ou nécessitent une authentification.290 * {/* min-version: 2.1.166 */}`/mcp`, à partir de la v2.1.166 : retourne un résumé textuel de l'état du serveur au lieu d'ouvrir le sélecteur, et accepte les [sous-commandes](/fr/commands#all-commands) `reconnect`, `enable`, et `disable`. Contrairement à la CLI locale, `/mcp reconnect` sans nom de serveur reconnecte tous les serveurs qui ont échoué ou nécessitent une authentification.

286 * {/* min-version: 2.1.181 */}`/config`, à partir de la v2.1.181 : passez `key=value` pour définir un paramètre, ou exécutez-le sans argument pour lister les clés que vous pouvez définir.291 * {/* min-version: 2.1.181 */}`/config`, à partir de la v2.1.181 : transmettez `key=value` pour définir un paramètre, ou exécutez-le sans argument pour lister les clés que vous pouvez définir.

287 292 

288<h2 id="troubleshooting">293<h2 id="troubleshooting">

289 Dépannage294 Dépannage


323 « Remote Control is only available when using Claude via api.anthropic.com »328 « Remote Control is only available when using Claude via api.anthropic.com »

324</h3>329</h3>

325 330 

326La session ne communique pas directement avec l'API Anthropic, il n'y a donc pas de backend claude.ai pour l'associer. Cela se produit sur Amazon Bedrock, Google Vertex AI et Microsoft Foundry. {/* min-version: 2.1.196 */}À partir de la v2.1.196, cela se produit également lorsque [`ANTHROPIC_BASE_URL`](/fr/env-vars) pointe vers un hôte autre que `api.anthropic.com`, comme une [passerelle LLM](/fr/llm-gateway) ou un proxy, même si vous vous connectez avec claude.ai. Désactivez `ANTHROPIC_BASE_URL` et redémarrez la session pour utiliser Remote Control.331La session ne communique pas directement avec l'API Anthropic, il n'y a donc pas de backend claude.ai pour l'associer. Cela se produit sur Amazon Bedrock, Google Cloud's Agent Platform et Microsoft Foundry. {/* min-version: 2.1.196 */}À partir de la v2.1.196, cela se produit également lorsque [`ANTHROPIC_BASE_URL`](/fr/env-vars) pointe vers un hôte autre que `api.anthropic.com`, comme une [passerelle LLM](/fr/llm-gateway) ou un proxy, même si vous vous connectez avec claude.ai. Désactivez `ANTHROPIC_BASE_URL` et redémarrez la session pour utiliser Remote Control.

327 332 

328<h3 id="remote-control-is-disabled-by-your-organization’s-policy">333<h3 id="remote-control-is-disabled-by-your-organization’s-policy">

329 « Remote Control is disabled by your organization's policy »334 « Remote Control is disabled by your organization's policy »


352* Problème de réseau ou de proxy : un pare-feu ou un proxy peut bloquer la requête HTTPS sortante. Remote Control nécessite l'accès à l'API Anthropic sur le port 443.357* Problème de réseau ou de proxy : un pare-feu ou un proxy peut bloquer la requête HTTPS sortante. Remote Control nécessite l'accès à l'API Anthropic sur le port 443.

353* Échec de la création de session : si vous voyez également `Session creation failed — see debug log`, l'échec s'est produit plus tôt dans la configuration. Vérifiez que votre abonnement est actif.358* Échec de la création de session : si vous voyez également `Session creation failed — see debug log`, l'échec s'est produit plus tôt dans la configuration. Vérifiez que votre abonnement est actif.

354 359 

360<h3 id="couldn’t-reconnect-to-your-remote-control-session">

361 « Couldn't reconnect to your Remote Control session »

362</h3>

363 

364Lorsque vous reprenez une conversation avec `claude --resume` ou `claude --continue`, Claude Code se reconnecte à la session Remote Control enregistrée dans cette conversation. Ce message signifie que la reconnexion a échoué pour une raison qui peut être temporaire, comme une interruption réseau ou une erreur serveur, donc Claude Code ne peut pas confirmer si la session distante existe toujours. Lorsque le serveur confirme que la session précédente n'existe plus, Claude Code crée une nouvelle session Remote Control sans afficher ce message.

365 

366Votre session locale continue de s'exécuter sans Remote Control. Exécutez `/remote-control` pour réessayer la connexion, ou démarrez Claude Code sans `--resume` pour créer une nouvelle session Remote Control.

367 

368{/* min-version: 2.1.200 */}Avant la v2.1.200, un échec de reconnexion créait une nouvelle session Remote Control au lieu d'afficher ce message, ce qui laissait des sessions supplémentaires dans la liste des sessions sur claude.ai/code.

369 

355<h3 id="your-organization-requires-trusted-devices-for-remote-control-but-this-device-is-not-enrolled">370<h3 id="your-organization-requires-trusted-devices-for-remote-control-but-this-device-is-not-enrolled">

356 « Your organization requires Trusted Devices for Remote Control, but this device is not enrolled »371 « Your organization requires Trusted Devices for Remote Control, but this device is not enrolled »

357</h3>372</h3>

routines.md +1 −1

Details

416 416 

417L'interface de ligne de commande masque `/schedule` lorsque l'une de ses exigences n'est pas satisfaite, de sorte que le menu de commande affiche `Aucune commande ne correspond à "/schedule"` pendant que vous tapez, et la soumettre retourne `Commande inconnue : /schedule`. La cause est généralement l'une des suivantes :417L'interface de ligne de commande masque `/schedule` lorsque l'une de ses exigences n'est pas satisfaite, de sorte que le menu de commande affiche `Aucune commande ne correspond à "/schedule"` pendant que vous tapez, et la soumettre retourne `Commande inconnue : /schedule`. La cause est généralement l'une des suivantes :

418 418 

419* Vous êtes authentifié avec une clé API Console ou un fournisseur cloud tel que Bedrock, Vertex ou Foundry. `/schedule` nécessite une connexion par abonnement claude.ai. Si `ANTHROPIC_API_KEY` ou `ANTHROPIC_AUTH_TOKEN` est défini dans votre shell, ou si `apiKeyHelper` est défini dans `settings.json`, supprimez-le d'abord, car ces paramètres ont la priorité sur une connexion claude.ai419* Vous êtes authentifié avec une clé API Console ou un fournisseur cloud tel qu'Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry. `/schedule` nécessite une connexion par abonnement claude.ai. Si `ANTHROPIC_API_KEY` ou `ANTHROPIC_AUTH_TOKEN` est défini dans votre shell, ou si `apiKeyHelper` est défini dans `settings.json`, supprimez-le d'abord, car ces paramètres ont la priorité sur une connexion claude.ai

420* `DISABLE_TELEMETRY`, `DO_NOT_TRACK`, `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` ou `DISABLE_GROWTHBOOK` est défini dans votre environnement shell ou dans le bloc `env` d'un [fichier `settings.json`](/fr/settings#available-settings). Ces paramètres désactivent la récupération des drapeaux de fonctionnalités, dont `/schedule` dépend420* `DISABLE_TELEMETRY`, `DO_NOT_TRACK`, `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` ou `DISABLE_GROWTHBOOK` est défini dans votre environnement shell ou dans le bloc `env` d'un [fichier `settings.json`](/fr/settings#available-settings). Ces paramètres désactivent la récupération des drapeaux de fonctionnalités, dont `/schedule` dépend

421* Vous êtes dans une session Claude Code sur le web. Gérez les routines à partir de l'[interface web](https://claude.ai/code/routines) à la place421* Vous êtes dans une session Claude Code sur le web. Gérez les routines à partir de l'[interface web](https://claude.ai/code/routines) à la place

422* {/* min-version: 2.1.81 */}Votre interface de ligne de commande est antérieure à la v2.1.81. Exécutez `claude update`422* {/* min-version: 2.1.81 */}Votre interface de ligne de commande est antérieure à la v2.1.81. Exécutez `claude update`

sandboxing.md +1 −1

Details

237 237 

238Avec `mask`, la commande sandboxée voit une valeur sentinelle par session au lieu de la vraie. Lorsqu'une requête quitte le sandbox pour l'un des `injectHosts` de l'identifiant, le [proxy sandbox](#network-isolation) remplace la sentinelle par la vraie valeur. La commande et tout ce qu'elle enregistre ne détiennent jamais l'identifiant réel, mais ses requêtes s'authentifient toujours.238Avec `mask`, la commande sandboxée voit une valeur sentinelle par session au lieu de la vraie. Lorsqu'une requête quitte le sandbox pour l'un des `injectHosts` de l'identifiant, le [proxy sandbox](#network-isolation) remplace la sentinelle par la vraie valeur. La commande et tout ce qu'elle enregistre ne détiennent jamais l'identifiant réel, mais ses requêtes s'authentifient toujours.

239 239 

240Le proxy substitue l'identifiant à l'intérieur du contenu des requêtes, donc il doit les voir. Définissez [`network.tlsTerminate`](/fr/settings#sandbox-settings) pour que le proxy termine HTTPS lui-même. Sans cela, le masquage échoue fermé : la commande voit toujours seulement la sentinelle, mais la sentinelle atteint le serveur inchangée et l'authentification échoue. Claude Code signale cette mauvaise configuration au démarrage et dans `/doctor`.240Le proxy substitue l'identifiant à l'intérieur du contenu des requêtes, donc il doit les voir. Définissez [`network.tlsTerminate`](/fr/settings#sandbox-settings) pour que le proxy termine TLS lui-même. Sans cela, le masquage échoue fermé : la commande voit toujours seulement la sentinelle, mais la sentinelle atteint le serveur inchangée et l'authentification échoue. Claude Code signale cette mauvaise configuration au démarrage.

241 241 

242L'exemple ci-dessous masque deux tokens. `GH_TOKEN` est substitué uniquement sur les requêtes à `api.github.com`, tandis que `NPM_TOKEN` n'a pas de `injectHosts` et est substitué sur les requêtes à chaque hôte dans `network.allowedDomains`. Chaque entrée `injectHosts` doit elle-même être couverte par `network.allowedDomains`.242L'exemple ci-dessous masque deux tokens. `GH_TOKEN` est substitué uniquement sur les requêtes à `api.github.com`, tandis que `NPM_TOKEN` n'a pas de `injectHosts` et est substitué sur les requêtes à chaque hôte dans `network.allowedDomains`. Chaque entrée `injectHosts` doit elle-même être couverte par `network.allowedDomains`.

243 243 

Details

86Une boucle planifiée dynamiquement apparaît dans votre [liste de tâches planifiées](#manage-scheduled-tasks) comme n'importe quelle autre tâche, vous pouvez donc la lister ou l'annuler de la même manière. Les [règles de gigue](#jitter) ne s'appliquent pas à elle, mais l'[expiration de sept jours](#seven-day-expiry) s'applique : la boucle se termine automatiquement sept jours après son démarrage.86Une boucle planifiée dynamiquement apparaît dans votre [liste de tâches planifiées](#manage-scheduled-tasks) comme n'importe quelle autre tâche, vous pouvez donc la lister ou l'annuler de la même manière. Les [règles de gigue](#jitter) ne s'appliquent pas à elle, mais l'[expiration de sept jours](#seven-day-expiry) s'applique : la boucle se termine automatiquement sept jours après son démarrage.

87 87 

88<Note>88<Note>

89 Sur Bedrock, Vertex AI et Microsoft Foundry, un prompt sans intervalle s'exécute selon un calendrier fixe de 10 minutes à la place.89 Sur Amazon Bedrock, Google Cloud's Agent Platform et Microsoft Foundry, un prompt sans intervalle s'exécute selon un calendrier fixe de 10 minutes à la place.

90</Note>90</Note>

91 91 

92<h3 id="run-the-built-in-maintenance-prompt">92<h3 id="run-the-built-in-maintenance-prompt">


108Un `/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).108Un `/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).

109 109 

110<Note>110<Note>

111 Sur Bedrock, Vertex AI et Microsoft Foundry, `/loop` sans prompt imprime le message d'utilisation à la place de l'exécution du prompt de maintenance.111 Sur Amazon Bedrock, Google Cloud's Agent Platform et Microsoft Foundry, `/loop` sans prompt imprime le message d'utilisation à la place de l'exécution du prompt de maintenance.

112</Note>112</Note>

113 113 

114<h3 id="customize-the-default-prompt-with-loop-md">114<h3 id="customize-the-default-prompt-with-loop-md">


136Les modifications apportées à `loop.md` prennent effet à la prochaine itération, vous pouvez donc affiner les instructions pendant qu'une boucle s'exécute. Quand aucun `loop.md` n'existe dans l'un ou l'autre emplacement, la boucle revient au prompt de maintenance intégré. Gardez le fichier concis : le contenu au-delà de 25 000 octets est tronqué.136Les modifications apportées à `loop.md` prennent effet à la prochaine itération, vous pouvez donc affiner les instructions pendant qu'une boucle s'exécute. Quand aucun `loop.md` n'existe dans l'un ou l'autre emplacement, la boucle revient au prompt de maintenance intégré. Gardez le fichier concis : le contenu au-delà de 25 000 octets est tronqué.

137 137 

138<Note>138<Note>

139 Sur Bedrock, Vertex AI et Microsoft Foundry, `loop.md` n'est pas lu et `/loop` sans prompt imprime le message d'utilisation à la place.139 Sur Amazon Bedrock, Google Cloud's Agent Platform et Microsoft Foundry, `loop.md` n'est pas lu et `/loop` sans prompt imprime le message d'utilisation à la place.

140</Note>140</Note>

141 141 

142<h3 id="stop-a-loop">142<h3 id="stop-a-loop">


145 145 

146Pour arrêter un `/loop` pendant qu'il attend la prochaine itération, appuyez sur `Esc`. Cela efface le réveil en attente afin que la boucle ne se déclenche pas à nouveau. Les tâches que vous avez planifiées en [demandant directement à Claude](#manage-scheduled-tasks) ne sont pas affectées par `Esc` et restent en place jusqu'à ce que vous les supprimiez.146Pour arrêter un `/loop` pendant qu'il attend la prochaine itération, appuyez sur `Esc`. Cela efface le réveil en attente afin que la boucle ne se déclenche pas à nouveau. Les tâches que vous avez planifiées en [demandant directement à Claude](#manage-scheduled-tasks) ne sont pas affectées par `Esc` et restent en place jusqu'à ce que vous les supprimiez.

147 147 

148En [mode autonome](#let-claude-choose-the-interval), Claude peut également terminer la boucle de lui-même en ne planifiant pas le prochain réveil une fois que la tâche est manifestement terminée. Les boucles selon un intervalle fixe continuent de s'exécuter jusqu'à ce que vous les arrêtiez ou que [sept jours s'écoulent](#seven-day-expiry).148En [mode autonome](#let-claude-choose-the-interval), Claude peut également terminer la boucle de lui-même une fois que la tâche est terminée. Claude appelle l'[outil `ScheduleWakeup`](/fr/tools-reference) avec `stop: true`, ce qui annule le réveil en attente immédiatement. Si une itération se termine sans reprogrammer ni arrêter, Claude Code planifie un réveil de secours environ 20 minutes plus tard et termine la boucle quand cette itération ne reprogramme pas non plus. Avant la v2.1.202, ne pas reprogrammer était le seul moyen pour Claude de terminer une boucle de lui-même.

149 

150Les boucles selon un intervalle fixe continuent de s'exécuter jusqu'à ce que vous les arrêtiez ou que [sept jours s'écoulent](#seven-day-expiry).

149 151 

150<h2 id="set-a-one-time-reminder">152<h2 id="set-a-one-time-reminder">

151 Définir un rappel ponctuel153 Définir un rappel ponctuel

Details

219/plugin uninstall security-guidance@claude-plugins-official219/plugin uninstall security-guidance@claude-plugins-official

220```220```

221 221 

222Si le plugin a été activé via le `.claude/settings.json` d'un projet, le désactiver à partir de `/plugin` écrit un remplacement dans votre `.claude/settings.local.json` plutôt que de modifier le fichier vérifié, de sorte que le plugin reste désactivé pour vous tandis que vos coéquipiers ne sont pas affectés. S'il a été activé via [les paramètres gérés](/fr/admin-setup), seul un administrateur peut le désactiver.222Si le plugin a été activé via le `.claude/settings.json` d'un projet, le désactiver à partir de `/plugin` écrit un remplacement dans votre `.claude/settings.local.json` plutôt que de modifier le fichier vérifié, de sorte que le plugin reste désactivé pour vous tandis que vos coéquipiers ne sont pas affectés. Le même dialogue propose également de désinstaller le plugin pour tout le monde en le supprimant du `.claude/settings.json` partagé ; cette option nécessite Claude Code v2.1.203 ou version ultérieure. S'il a été activé via [les paramètres gérés](/fr/admin-setup), seul un administrateur peut le désactiver.

223 223 

224<h2 id="how-the-plugin-integrates-with-claude-code">224<h2 id="how-the-plugin-integrates-with-claude-code">

225 Comment le plugin s'intègre avec Claude Code225 Comment le plugin s'intègre avec Claude Code

Details

255Les paramètres gérés par le serveur ne sont pas disponibles lors de l'utilisation de fournisseurs de modèles tiers :255Les paramètres gérés par le serveur ne sont pas disponibles lors de l'utilisation de fournisseurs de modèles tiers :

256 256 

257* Amazon Bedrock257* Amazon Bedrock

258* Google Vertex AI258* Google Cloud's Agent Platform

259* Microsoft Foundry259* Microsoft Foundry

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

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

262 262 

263Pour les déploiements Bedrock, Vertex AI et Foundry, une [passerelle d'applications Claude](/fr/claude-apps-gateway) auto-hébergée fournit la livraison équivalente des paramètres gérés à distance : les clients signés à la passerelle récupèrent les paramètres gérés auprès de la passerelle au lieu de `api.anthropic.com`. La sémantique des défaillances diffère au démarrage : un client de passerelle qui ne peut pas atteindre la passerelle se termine avec une erreur au lieu de revenir aux paramètres en cache, tandis que l'actualisation en arrière-plan horaire est fail-open sur les deux canaux.263Pour les déploiements Amazon Bedrock, Google Cloud's Agent Platform et Microsoft Foundry, une [passerelle d'applications Claude](/fr/claude-apps-gateway) auto-hébergée fournit la livraison équivalente des paramètres gérés à distance : les clients signés à la passerelle récupèrent les paramètres gérés auprès de la passerelle au lieu de `api.anthropic.com`. La sémantique des défaillances diffère au démarrage : un client de passerelle qui ne peut pas atteindre la passerelle se termine avec une erreur au lieu de revenir aux paramètres en cache, tandis que l'actualisation en arrière-plan horaire est fail-open sur les deux canaux.

264 264 

265<h2 id="audit-logging">265<h2 id="audit-logging">

266 Journalisation d'audit266 Journalisation d'audit

settings.md +20 −15

Details

95* Les **paramètres de projet** sont enregistrés dans votre répertoire de projet :95* Les **paramètres de projet** sont enregistrés dans votre répertoire de projet :

96 * `.claude/settings.json` pour les paramètres qui sont vérifiés dans le contrôle de source et partagés avec votre équipe96 * `.claude/settings.json` pour les paramètres qui sont vérifiés dans le contrôle de source et partagés avec votre équipe

97 * `.claude/settings.local.json` pour les paramètres qui ne sont pas vérifiés, utiles pour les préférences personnelles et l'expérimentation. Quand Claude Code crée `.claude/settings.local.json`, il configure git pour ignorer le fichier. Si vous créez le fichier vous-même, ajoutez-le à votre gitignore manuellement.97 * `.claude/settings.local.json` pour les paramètres qui ne sont pas vérifiés, utiles pour les préférences personnelles et l'expérimentation. Quand Claude Code crée `.claude/settings.local.json`, il configure git pour ignorer le fichier. Si vous créez le fichier vous-même, ajoutez-le à votre gitignore manuellement.

98 

99 Parce que ce fichier est le vôtre plutôt que celui du référentiel, ses règles de permission `allow` prennent effet sans l'étape de [confiance de l'espace de travail](/fr/permissions#project-allow-rules-and-workspace-trust) que les règles allow de `.claude/settings.json` nécessitent. Si le référentiel fournit le fichier, par exemple en le validant, la confiance de l'espace de travail s'applique toujours.

98* **Paramètres gérés** : Pour les organisations qui ont besoin d'un contrôle centralisé, Claude Code supporte plusieurs mécanismes de livraison pour les paramètres gérés. Tous utilisent le même format JSON et ne peuvent pas être contournés par les paramètres utilisateur ou de projet :100* **Paramètres gérés** : Pour les organisations qui ont besoin d'un contrôle centralisé, Claude Code supporte plusieurs mécanismes de livraison pour les paramètres gérés. Tous utilisent le même format JSON et ne peuvent pas être contournés par les paramètres utilisateur ou de projet :

99 101 

100 * **Paramètres gérés par le serveur** : livrés à distance au moment de la connexion, soit à partir des serveurs d'Anthropic via la console d'administration claude.ai, soit à partir d'une [passerelle d'applications Claude](/fr/claude-apps-gateway) auto-hébergée. Voir [paramètres gérés par le serveur](/fr/server-managed-settings).102 * **Paramètres gérés par le serveur** : livrés à distance au moment de la connexion, soit à partir des serveurs d'Anthropic via la console d'administration claude.ai, soit à partir d'une [passerelle d'applications Claude](/fr/claude-apps-gateway) auto-hébergée. Voir [paramètres gérés par le serveur](/fr/server-managed-settings).


213`settings.json` supporte un certain nombre d'options :215`settings.json` supporte un certain nombre d'options :

214 216 

215| Clé | Description | Exemple |217| Clé | Description | Exemple |

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

217| `advisorModel` | {/* min-version: 2.1.98 */}Modèle pour l'[outil advisor](/fr/advisor) côté serveur. Accepte un alias de modèle tel que `"opus"`, `"sonnet"`, ou `"fable"` ({/* min-version: 2.1.170 */}v2.1.170+), ou un ID de modèle complet. Écrit automatiquement quand vous exécutez `/advisor`. Non défini pour désactiver l'advisor. Nécessite Claude Code v2.1.98 ou ultérieur | `"opus"` |219| `advisorModel` | {/* min-version: 2.1.98 */}Modèle pour l'[outil advisor](/fr/advisor) côté serveur. Accepte un alias de modèle tel que `"opus"`, `"sonnet"`, ou `"fable"` ({/* min-version: 2.1.170 */}v2.1.170+), ou un ID de modèle complet. Écrit automatiquement quand vous exécutez `/advisor`. Non défini pour désactiver l'advisor. Nécessite Claude Code v2.1.98 ou ultérieur | `"opus"` |

218| `agent` | Exécuter le thread principal en tant que subagent nommé, et définir l'agent par défaut pour les sessions envoyées à partir de `claude agents`. Applique l'invite système, les restrictions d'outils et le modèle de ce subagent. Voir [Invoquer les subagents explicitement](/fr/sub-agents#invoke-subagents-explicitly) | `"code-reviewer"` |220| `agent` | Exécuter le thread principal en tant que subagent nommé, et définir l'agent par défaut pour les sessions envoyées à partir de `claude agents`. Applique l'invite système, les restrictions d'outils et le modèle de ce subagent. Voir [Invoquer les subagents explicitement](/fr/sub-agents#invoke-subagents-explicitly) | `"code-reviewer"` |

219| `agentPushNotifEnabled` | {/* min-version: 2.1.119 */}**Par défaut** : `false`. Quand le [Contrôle à distance](/fr/remote-control) est connecté, autoriser Claude à envoyer des notifications push proactives à votre téléphone, par exemple quand une tâche longue se termine. Apparaît dans `/config` comme **Push when Claude decides**. Voir [Notifications push mobiles](/fr/remote-control#mobile-push-notifications). Nécessite Claude Code v2.1.119 ou ultérieur | `true` |221| `agentPushNotifEnabled` | {/* min-version: 2.1.119 */}**Par défaut** : `false`. Quand le [Contrôle à distance](/fr/remote-control) est connecté, autoriser Claude à envoyer des notifications push proactives à votre téléphone, par exemple quand une tâche longue se termine. Apparaît dans `/config` comme **Push when Claude decides**. Voir [Notifications push mobiles](/fr/remote-control#mobile-push-notifications). Nécessite Claude Code v2.1.119 ou ultérieur | `true` |


226| `allowManagedPermissionRulesOnly` | (Paramètres gérés uniquement) Empêcher les paramètres utilisateur et projet de définir les règles de permission `allow`, `ask`, ou `deny`. Seules les règles dans les paramètres gérés s'appliquent. Voir [Paramètres gérés uniquement](/fr/permissions#managed-only-settings) | `true` |228| `allowManagedPermissionRulesOnly` | (Paramètres gérés uniquement) Empêcher les paramètres utilisateur et projet de définir les règles de permission `allow`, `ask`, ou `deny`. Seules les règles dans les paramètres gérés s'appliquent. Voir [Paramètres gérés uniquement](/fr/permissions#managed-only-settings) | `true` |

227| `alwaysThinkingEnabled` | Activer la [réflexion étendue](/fr/model-config#extended-thinking) par défaut pour toutes les sessions. Généralement configuré via la commande `/config` plutôt que d'éditer directement. Pour forcer la réflexion désactivée indépendamment de ce paramètre, définissez [`MAX_THINKING_TOKENS=0`](/fr/env-vars) dans `env`, qui désactive la réflexion sur l'API Anthropic sauf sur Fable 5, qui ne peut pas avoir la réflexion désactivée. Sur les [fournisseurs tiers](/fr/third-party-integrations), cela omet le paramètre `thinking` à la place, et les modèles de raisonnement adaptatif peuvent toujours réfléchir | `true` |229| `alwaysThinkingEnabled` | Activer la [réflexion étendue](/fr/model-config#extended-thinking) par défaut pour toutes les sessions. Généralement configuré via la commande `/config` plutôt que d'éditer directement. Pour forcer la réflexion désactivée indépendamment de ce paramètre, définissez [`MAX_THINKING_TOKENS=0`](/fr/env-vars) dans `env`, qui désactive la réflexion sur l'API Anthropic sauf sur Fable 5, qui ne peut pas avoir la réflexion désactivée. Sur les [fournisseurs tiers](/fr/third-party-integrations), cela omet le paramètre `thinking` à la place, et les modèles de raisonnement adaptatif peuvent toujours réfléchir | `true` |

228| `apiKeyHelper` | Commande personnalisée, à exécuter via le shell système (`/bin/sh` sur macOS et Linux, `cmd` sur Windows), pour générer une valeur d'authentification. Cette valeur sera envoyée comme en-têtes `X-Api-Key` et `Authorization: Bearer` pour les demandes de modèle. Définissez l'intervalle d'actualisation avec [`CLAUDE_CODE_API_KEY_HELPER_TTL_MS`](/fr/env-vars) | `/bin/generate_temp_api_key.sh` |230| `apiKeyHelper` | Commande personnalisée, à exécuter via le shell système (`/bin/sh` sur macOS et Linux, `cmd` sur Windows), pour générer une valeur d'authentification. Cette valeur sera envoyée comme en-têtes `X-Api-Key` et `Authorization: Bearer` pour les demandes de modèle. Définissez l'intervalle d'actualisation avec [`CLAUDE_CODE_API_KEY_HELPER_TTL_MS`](/fr/env-vars) | `/bin/generate_temp_api_key.sh` |

231| `askUserQuestionTimeout` | {/* min-version: 2.1.200 */}**Par défaut** : `"never"`. Temps d'inactivité avant qu'une boîte de dialogue [`AskUserQuestion`](/fr/tools-reference) sans réponse ne continue automatiquement avec les options que vous aviez déjà sélectionnées. Accepte `"60s"`, `"5m"`, `"10m"`, ou `"never"`. Avec la valeur par défaut, les questions attendent que vous y répondiez. Apparaît dans `/config` comme **Question auto-continue timeout**, qui écrit cette clé dans les paramètres utilisateur. Non lu à partir des paramètres de projet ou locaux. Nécessite Claude Code v2.1.200 ou ultérieur | `"5m"` |

229| `attribution` | Personnalisez l'attribution pour les commits git et les pull requests. Voir [Paramètres d'attribution](#attribution-settings) | `{"commit": "🤖 Generated with Claude Code", "pr": ""}` |232| `attribution` | Personnalisez l'attribution pour les commits git et les pull requests. Voir [Paramètres d'attribution](#attribution-settings) | `{"commit": "🤖 Generated with Claude Code", "pr": ""}` |

230| `autoCompactEnabled` | {/* min-version: 2.1.119 */}**Par défaut** : `true`. Compacter automatiquement la conversation quand le contexte approche la limite. Apparaît dans `/config` comme **Auto-compact**. Pour désactiver via une variable d'environnement, définissez [`DISABLE_AUTO_COMPACT`](/fr/env-vars) dans `env` | `false` |233| `autoCompactEnabled` | {/* min-version: 2.1.119 */}**Par défaut** : `true`. Compacter automatiquement la conversation quand le contexte approche la limite. Apparaît dans `/config` comme **Auto-compact**. Pour désactiver via une variable d'environnement, définissez [`DISABLE_AUTO_COMPACT`](/fr/env-vars) dans `env` | `false` |

231| `autoMemoryDirectory` | Répertoire personnalisé pour le stockage de la [mémoire automatique](/fr/memory#storage-location). Accepte un chemin absolu ou un chemin préfixé par `~/`. À partir des paramètres de projet ou locaux, ceci n'est honoré qu'après que vous acceptiez la boîte de dialogue de confiance de l'espace de travail, car un référentiel cloné peut fournir ce fichier | `"~/my-memory-dir"` |234| `autoMemoryDirectory` | Répertoire personnalisé pour le stockage de la [mémoire automatique](/fr/memory#storage-location). Accepte un chemin absolu ou un chemin préfixé par `~/`. À partir des paramètres de projet ou locaux, ceci n'est honoré qu'après que vous acceptiez la boîte de dialogue de confiance de l'espace de travail, car un référentiel cloné peut fournir ce fichier | `"~/my-memory-dir"` |


240| `awsCredentialExport` | Script personnalisé qui génère du JSON avec les identifiants AWS (voir [configuration avancée des identifiants](/fr/amazon-bedrock#advanced-credential-configuration)) | `/bin/generate_aws_grant.sh` |243| `awsCredentialExport` | Script personnalisé qui génère du JSON avec les identifiants AWS (voir [configuration avancée des identifiants](/fr/amazon-bedrock#advanced-credential-configuration)) | `/bin/generate_aws_grant.sh` |

241| `axScreenReader` | {/* min-version: 2.1.181 */}Rendre une sortie accessible aux lecteurs d'écran : texte plat sans bordures décoratives ou animations. Le mode lecteur d'écran utilise toujours le moteur de rendu classique, donc le paramètre `tui` n'a aucun effet pendant qu'il est actif. La variable d'environnement [`CLAUDE_AX_SCREEN_READER`](/fr/env-vars) et l'indicateur [`--ax-screen-reader`](/fr/cli-reference#cli-flags) ont la priorité. Nécessite Claude Code v2.1.181 ou ultérieur | `true` |244| `axScreenReader` | {/* min-version: 2.1.181 */}Rendre une sortie accessible aux lecteurs d'écran : texte plat sans bordures décoratives ou animations. Le mode lecteur d'écran utilise toujours le moteur de rendu classique, donc le paramètre `tui` n'a aucun effet pendant qu'il est actif. La variable d'environnement [`CLAUDE_AX_SCREEN_READER`](/fr/env-vars) et l'indicateur [`--ax-screen-reader`](/fr/cli-reference#cli-flags) ont la priorité. Nécessite Claude Code v2.1.181 ou ultérieur | `true` |

242| `blockedMarketplaces` | (Paramètres gérés uniquement) Liste noire des sources de marketplace. Appliquée lors de l'ajout de marketplace et lors de l'installation, la mise à jour, l'actualisation et la mise à jour automatique du plugin, donc une marketplace ajoutée avant que la politique soit définie ne peut pas être utilisée pour récupérer les plugins. Les sources bloquées sont vérifiées avant le téléchargement, donc elles ne touchent jamais le système de fichiers. Voir [Restrictions de marketplace gérées](/fr/plugin-marketplaces#managed-marketplace-restrictions) | `[{ "source": "github", "repo": "untrusted/plugins" }]` |245| `blockedMarketplaces` | (Paramètres gérés uniquement) Liste noire des sources de marketplace. Appliquée lors de l'ajout de marketplace et lors de l'installation, la mise à jour, l'actualisation et la mise à jour automatique du plugin, donc une marketplace ajoutée avant que la politique soit définie ne peut pas être utilisée pour récupérer les plugins. Les sources bloquées sont vérifiées avant le téléchargement, donc elles ne touchent jamais le système de fichiers. Voir [Restrictions de marketplace gérées](/fr/plugin-marketplaces#managed-marketplace-restrictions) | `[{ "source": "github", "repo": "untrusted/plugins" }]` |

246| `browserExternalPageTools` | (Paramètres gérés uniquement) Définir à `"disabled"` pour empêcher Claude d'utiliser des outils pour lire ou agir sur des pages externes dans le [volet Browser](/fr/desktop#browse-external-sites) de l'application de bureau. Les utilisateurs peuvent toujours naviguer vers des sites externes eux-mêmes, et les aperçus du serveur de développement local ne sont pas affectés | `"disabled"` |

243| `channelsEnabled` | (Paramètres gérés uniquement) Autoriser les [channels](/fr/channels) pour l'organisation. Sur les plans Claude.ai Team et Enterprise, les channels sont bloqués quand ceci est non défini ou `false`. Pour les comptes [Anthropic Console](/fr/authentication#claude-console-authentication) utilisant l'authentification par clé API, les channels sont autorisés par défaut sauf si votre organisation déploie des paramètres gérés, auquel cas cette clé doit être définie à `true` | `true` |247| `channelsEnabled` | (Paramètres gérés uniquement) Autoriser les [channels](/fr/channels) pour l'organisation. Sur les plans Claude.ai Team et Enterprise, les channels sont bloqués quand ceci est non défini ou `false`. Pour les comptes [Anthropic Console](/fr/authentication#claude-console-authentication) utilisant l'authentification par clé API, les channels sont autorisés par défaut sauf si votre organisation déploie des paramètres gérés, auquel cas cette clé doit être définie à `true` | `true` |

244| `claudeMd` | (Paramètres gérés uniquement) Instructions de style CLAUDE.md injectées comme mémoire gérée par l'organisation. Honoré uniquement quand défini dans les paramètres gérés ou de politique et ignoré dans les paramètres utilisateur, projet et locaux. Voir [CLAUDE.md à l'échelle de l'organisation](/fr/memory#deploy-organization-wide-claude-md) | `"Always run make lint before committing."` |248| `claudeMd` | (Paramètres gérés uniquement) Instructions de style CLAUDE.md injectées comme mémoire gérée par l'organisation. Honoré uniquement quand défini dans les paramètres gérés ou de politique et ignoré dans les paramètres utilisateur, projet et locaux. Voir [CLAUDE.md à l'échelle de l'organisation](/fr/memory#deploy-organization-wide-claude-md) | `"Always run make lint before committing."` |

245| `claudeMdExcludes` | Modèles Glob ou chemins absolus des fichiers `CLAUDE.md` à ignorer lors du chargement de la [mémoire](/fr/memory). Les modèles correspondent aux chemins de fichier absolus. S'applique uniquement à la mémoire utilisateur, projet et locale ; les fichiers de politique gérée ne peuvent pas être exclus | `["**/vendor/**/CLAUDE.md"]` |249| `claudeMdExcludes` | Modèles Glob ou chemins absolus des fichiers `CLAUDE.md` à ignorer lors du chargement de la [mémoire](/fr/memory). Les modèles correspondent aux chemins de fichier absolus. S'applique uniquement à la mémoire utilisateur, projet et locale ; les fichiers de politique gérée ne peuvent pas être exclus | `["**/vendor/**/CLAUDE.md"]` |

246| `cleanupPeriodDays` | **Par défaut** : `30` jours, minimum `1`. Les sessions inactives pendant plus longtemps que cette période sont supprimées au démarrage. Définir à `0` est rejeté avec une erreur de validation. Contrôle également le seuil d'âge pour la suppression automatique des [worktrees de subagent orphelins](/fr/worktrees#clean-up-worktrees) au démarrage. Pour désactiver complètement les écritures de transcript, définissez la variable d'environnement [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/fr/env-vars), ou en mode non interactif (`-p`) utilisez l'indicateur `--no-session-persistence` ou l'option SDK `persistSession: false`. | `20` |250| `cleanupPeriodDays` | **Par défaut** : `30` jours, minimum `1`. Claude Code supprime les [fichiers de session et autres données d'application](/fr/claude-directory#cleaned-up-automatically) plus anciens que cette période au démarrage. Définir à `0` échoue avec une erreur de validation. Le même seuil d'âge s'applique à la suppression automatique des [worktrees de subagent orphelins](/fr/worktrees#clean-up-worktrees) au démarrage. {/* min-version: 2.1.203 */}Si Claude Code ne peut pas lire ou analyser un fichier de paramètres, il met en pause le balayage de nettoyage de rétention et affiche un avertissement dans `/status` jusqu'à ce que vous corrigiez le fichier, sauf si les [paramètres gérés](/fr/server-managed-settings) fournissent `cleanupPeriodDays`, auquel cas le balayage s'exécute à la valeur gérée. Avant v2.1.203, le nettoyage s'exécutait à la valeur par défaut de 30 jours dans cet état et pouvait supprimer les transcripts qu'un `cleanupPeriodDays` plus long était censé conserver ; les fichiers plus récents que 30 jours n'ont jamais été supprimés. Pour désactiver complètement les écritures de transcript, définissez la variable d'environnement [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/fr/env-vars). En mode non interactif, passez `--no-session-persistence` aux côtés de `-p` ou définissez `persistSession: false` dans l'Agent SDK. | `20` |

247| `companyAnnouncements` | Annonce à afficher aux utilisateurs au démarrage. Si plusieurs annonces sont fournies, elles seront affichées aléatoirement. | `["Welcome to Acme Corp! Review our code guidelines at docs.acme.com"]` |251| `companyAnnouncements` | Annonce à afficher aux utilisateurs au démarrage. Si plusieurs annonces sont fournies, elles seront affichées aléatoirement. | `["Welcome to Acme Corp! Review our code guidelines at docs.acme.com"]` |

248| `defaultShell` | **Par défaut** : `"bash"`, ou `"powershell"` sur Windows quand Bash n'est pas disponible. Shell par défaut pour les commandes `!` de la boîte d'entrée. Accepte `"bash"` ou `"powershell"`. Définir à `"powershell"` achemine les commandes `!` interactives via PowerShell sur Windows. Nécessite `CLAUDE_CODE_USE_POWERSHELL_TOOL=1`. Voir [Outil PowerShell](/fr/tools-reference#powershell-tool) | `"powershell"` |252| `defaultShell` | **Par défaut** : `"bash"`, ou `"powershell"` sur Windows quand Bash n'est pas disponible. Shell par défaut pour les commandes `!` de la boîte d'entrée. Accepte `"bash"` ou `"powershell"`. Définir à `"powershell"` achemine les commandes `!` interactives via PowerShell sur Windows. Nécessite `CLAUDE_CODE_USE_POWERSHELL_TOOL=1`. Voir [Outil PowerShell](/fr/tools-reference#powershell-tool) | `"powershell"` |

249| `deniedMcpServers` | Quand défini dans managed-settings.json, liste noire des MCP servers qui sont explicitement bloqués. S'applique à toutes les portées y compris les servers gérés. La liste noire a la priorité sur la liste blanche. Voir [Configuration MCP gérée](/fr/managed-mcp) | `[{ "serverName": "filesystem" }]` |253| `deniedMcpServers` | Quand défini dans managed-settings.json, liste noire des MCP servers qui sont explicitement bloqués. S'applique à toutes les portées y compris les servers gérés. La liste noire a la priorité sur la liste blanche. Voir [Configuration MCP gérée](/fr/managed-mcp) | `[{ "serverName": "filesystem" }]` |


251| `disableAllHooks` | Désactiver tous les [hooks](/fr/hooks) et toute [ligne d'état](/fr/statusline) personnalisée | `true` |255| `disableAllHooks` | Désactiver tous les [hooks](/fr/hooks) et toute [ligne d'état](/fr/statusline) personnalisée | `true` |

252| `disableArtifact` | Définir à `true` pour désactiver l'outil [Artifact](/fr/artifacts), qui publie la sortie de session en tant que page web privée sur claude.ai. Équivalent à définir `CLAUDE_CODE_DISABLE_ARTIFACT` à `1` | `true` |256| `disableArtifact` | Définir à `true` pour désactiver l'outil [Artifact](/fr/artifacts), qui publie la sortie de session en tant que page web privée sur claude.ai. Équivalent à définir `CLAUDE_CODE_DISABLE_ARTIFACT` à `1` | `true` |

253| `disableAutoMode` | Définir à `"disable"` pour empêcher l'activation du [mode auto](/fr/permission-modes#eliminate-prompts-with-auto-mode). Supprime `auto` du cycle `Shift+Tab` et rejette `--permission-mode auto` au démarrage. Très utile dans les [paramètres gérés](/fr/permissions#managed-settings) où les utilisateurs ne peuvent pas le contourner | `"disable"` |257| `disableAutoMode` | Définir à `"disable"` pour empêcher l'activation du [mode auto](/fr/permission-modes#eliminate-prompts-with-auto-mode). Supprime `auto` du cycle `Shift+Tab` et rejette `--permission-mode auto` au démarrage. Très utile dans les [paramètres gérés](/fr/permissions#managed-settings) où les utilisateurs ne peuvent pas le contourner | `"disable"` |

254| `disableBundledSkills` | Définir à `true` pour désactiver les [skills](/fr/skills) et workflows qui sont livrés avec Claude Code : les skills bundlés et workflows sont supprimés entièrement, tandis que les commandes slash intégrées comme `/init` restent tapables mais sont masquées au modèle. Les skills des plugins, `.claude/skills/`, et `.claude/commands/` ne sont pas affectés. Équivalent à définir `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` à `1` | `true` |258| `disableBundledSkills` | Définir à `true` pour désactiver les [skills](/fr/skills) et workflows qui sont livrés avec Claude Code : les skills bundlés et workflows sont supprimés entièrement, tandis que les commandes slash intégrées comme `/init` restent tapables mais sont masquées au modèle. `/doctor` reste tapable comme les commandes intégrées ; masquez-le avec [`DISABLE_DOCTOR_COMMAND`](/fr/env-vars) à la place. Les skills des plugins, `.claude/skills/`, et `.claude/commands/` ne sont pas affectés. Équivalent à définir `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` à `1` | `true` |

255| `disableClaudeAiConnectors` | {/* min-version: 2.1.182 */}Désactiver les [connecteurs MCP claude.ai](/fr/mcp#use-mcp-servers-from-claude-ai) pour qu'ils ne soient pas auto-récupérés ou connectés. Définir dans n'importe quelle portée de paramètres. `true` dans n'importe quelle source a la priorité, donc un `.claude/settings.json` de projet coché peut exclure un référentiel des connecteurs cloud, mais un `false` au niveau du projet ne peut pas remplacer un `true` au niveau utilisateur ou de politique. Les servers passés explicitement via `--mcp-config` ne sont pas affectés. Pour refuser les connecteurs individuels au lieu de tous, utilisez [`deniedMcpServers`](/fr/managed-mcp). Nécessite Claude Code v2.1.182 ou ultérieur | `true` |259| `disableClaudeAiConnectors` | {/* min-version: 2.1.182 */}Désactiver les [connecteurs MCP claude.ai](/fr/mcp#use-mcp-servers-from-claude-ai) pour qu'ils ne soient pas auto-récupérés ou connectés. Définir dans n'importe quelle portée de paramètres. `true` dans n'importe quelle source a la priorité, donc un `.claude/settings.json` de projet coché peut exclure un référentiel des connecteurs cloud, mais un `false` au niveau du projet ne peut pas remplacer un `true` au niveau utilisateur ou de politique. Les servers passés explicitement via `--mcp-config` ne sont pas affectés. Pour refuser les connecteurs individuels au lieu de tous, utilisez [`deniedMcpServers`](/fr/managed-mcp). Nécessite Claude Code v2.1.182 ou ultérieur | `true` |

256| `disableDeepLinkRegistration` | Définir à `"disable"` pour empêcher Claude Code d'enregistrer le gestionnaire de protocole `claude-cli://` auprès du système d'exploitation au démarrage. Les [liens profonds](/fr/deep-links) permettent aux outils externes d'ouvrir une session Claude Code avec une invite pré-remplie. Utile dans les environnements où l'enregistrement du gestionnaire de protocole est restreint ou géré séparément | `"disable"` |260| `disableDeepLinkRegistration` | Définir à `"disable"` pour empêcher Claude Code d'enregistrer le gestionnaire de protocole `claude-cli://` auprès du système d'exploitation au démarrage. Les [liens profonds](/fr/deep-links) permettent aux outils externes d'ouvrir une session Claude Code avec une invite pré-remplie. Utile dans les environnements où l'enregistrement du gestionnaire de protocole est restreint ou géré séparément | `"disable"` |

257| `disabledMcpjsonServers` | Liste des MCP servers spécifiques à partir des fichiers `.mcp.json` à rejeter | `["filesystem"]` |261| `disabledMcpjsonServers` | Liste des MCP servers spécifiques à partir des fichiers `.mcp.json` à rejeter | `["filesystem"]` |


304| `showClearContextOnPlanAccept` | **Par défaut** : `false`. Afficher l'option « effacer le contexte » sur l'écran d'acceptation du plan. Définir à `true` pour restaurer l'option | `true` |308| `showClearContextOnPlanAccept` | **Par défaut** : `false`. Afficher l'option « effacer le contexte » sur l'écran d'acceptation du plan. Définir à `true` pour restaurer l'option | `true` |

305| `showThinkingSummaries` | **Par défaut** : `false`. Afficher les résumés de [réflexion étendue](/fr/model-config#extended-thinking) dans les sessions interactives. Quand non défini ou `false`, les blocs de réflexion sont redactés par l'API et affichés comme un stub réduit. La redaction change uniquement ce que vous voyez, pas ce que le modèle génère : pour réduire les dépenses de réflexion, [réduisez le budget ou désactivez la réflexion](/fr/model-config#extended-thinking) à la place. Ce paramètre n'a aucun effet en mode non interactif (`-p`), l'Agent SDK, ou les extensions IDE telles que VS Code | `true` |309| `showThinkingSummaries` | **Par défaut** : `false`. Afficher les résumés de [réflexion étendue](/fr/model-config#extended-thinking) dans les sessions interactives. Quand non défini ou `false`, les blocs de réflexion sont redactés par l'API et affichés comme un stub réduit. La redaction change uniquement ce que vous voyez, pas ce que le modèle génère : pour réduire les dépenses de réflexion, [réduisez le budget ou désactivez la réflexion](/fr/model-config#extended-thinking) à la place. Ce paramètre n'a aucun effet en mode non interactif (`-p`), l'Agent SDK, ou les extensions IDE telles que VS Code | `true` |

306| `showTurnDuration` | **Par défaut** : `true`. Afficher les messages de durée de tour après les réponses, par exemple « Cooked for 1m 6s ». Apparaît dans `/config` comme **Show turn duration** | `false` |310| `showTurnDuration` | **Par défaut** : `true`. Afficher les messages de durée de tour après les réponses, par exemple « Cooked for 1m 6s ». Apparaît dans `/config` comme **Show turn duration** | `false` |

307| `skillListingBudgetFraction` | {/* min-version: 2.1.105 */}**Par défaut** : `0.01` (1 %). Fraction de la fenêtre de contexte du modèle réservée à l'[énumération des skills](/fr/skills#skill-descriptions-are-cut-short) que Claude voit à chaque tour. Quand l'énumération dépasse le budget, les descriptions pour les skills les moins utilisés sont réduites à des noms seuls pour que Claude puisse toujours les invoquer mais ne verra pas pourquoi. Augmentez pour garder plus de descriptions visibles au prix de plus de contexte par tour. `/doctor` affiche le nombre de troncatures actuel et quels skills sont affectés. Nécessite Claude Code v2.1.105 ou ultérieur | `0.02` |311| `skillListingBudgetFraction` | {/* min-version: 2.1.105 */}**Par défaut** : `0.01`. Fraction de la fenêtre de contexte du modèle réservée à l'[énumération des skills](/fr/skills#skill-descriptions-are-cut-short) que Claude voit à chaque tour. Quand l'énumération dépasse le budget, les descriptions pour les skills les moins utilisés sont réduites à des noms seuls pour que Claude puisse toujours les invoquer mais ne verra pas pourquoi. Augmentez pour garder plus de descriptions visibles au prix de plus de contexte par tour. `/doctor` affiche le nombre de troncatures actuel et quels skills sont affectés. Nécessite Claude Code v2.1.105 ou ultérieur | `0.02` |

308| `skillListingMaxDescChars` | {/* min-version: 2.1.105 */}**Par défaut** : `1536`. Limite de caractères par skill sur le texte combiné `description` et `when_to_use` dans l'[énumération des skills](/fr/skills#skill-descriptions-are-cut-short) que Claude voit à chaque tour. Le texte plus long que ceci est tronqué. Augmentez pour garder les longues descriptions intactes au prix de plus de contexte par tour ; diminuez pour adapter plus de skills sous [`skillListingBudgetFraction`](#available-settings). Nécessite Claude Code v2.1.105 ou ultérieur | `2048` |312| `skillListingMaxDescChars` | {/* min-version: 2.1.105 */}**Par défaut** : `1536`. Limite de caractères par skill sur le texte combiné `description` et `when_to_use` dans l'[énumération des skills](/fr/skills#skill-descriptions-are-cut-short) que Claude voit à chaque tour. Le texte plus long que ceci est tronqué. Augmentez pour garder les longues descriptions intactes au prix de plus de contexte par tour ; diminuez pour adapter plus de skills sous [`skillListingBudgetFraction`](#available-settings). Nécessite Claude Code v2.1.105 ou ultérieur | `2048` |

309| `skillOverrides` | {/* min-version: 2.1.129 */}Remplacements de visibilité par skill indexés par nom de skill. La valeur est `"on"`, `"name-only"`, `"user-invocable-only"`, ou `"off"`. Vous permet de masquer ou de réduire un skill sans éditer son SKILL.md. Ne s'applique pas aux skills de plugin, qui sont gérés via `/plugin`. Le menu `/skills` écrit ceux-ci dans `.claude/settings.local.json`. Voir [Remplacer la visibilité du skill à partir des paramètres](/fr/skills#override-skill-visibility-from-settings). Nécessite Claude Code v2.1.129 ou ultérieur | `{"legacy-context": "name-only", "deploy": "off"}` |313| `skillOverrides` | {/* min-version: 2.1.129 */}Remplacements de visibilité par skill indexés par nom de skill. La valeur est `"on"`, `"name-only"`, `"user-invocable-only"`, ou `"off"`. Vous permet de masquer ou de réduire un skill sans éditer son SKILL.md. Ne s'applique pas aux skills de plugin, qui sont gérés via `/plugin`. Le menu `/skills` écrit ceux-ci dans `.claude/settings.local.json`. Voir [Remplacer la visibilité du skill à partir des paramètres](/fr/skills#override-skill-visibility-from-settings). Nécessite Claude Code v2.1.129 ou ultérieur | `{"legacy-context": "name-only", "deploy": "off"}` |

310| `skipWebFetchPreflight` | Ignorer la [vérification de sécurité du domaine WebFetch](/fr/data-usage#webfetch-domain-safety-check) qui envoie chaque nom d'hôte demandé à `api.anthropic.com` avant la récupération. Définir à `true` dans les environnements qui bloquent le trafic vers Anthropic, tels que les déploiements Bedrock, Vertex AI, ou Foundry avec une sortie restrictive. Quand ignorée, WebFetch tente n'importe quelle URL sans consulter la liste de blocage | `true` |314| `skipWebFetchPreflight` | Ignorer la [vérification de sécurité du domaine WebFetch](/fr/data-usage#webfetch-domain-safety-check) qui envoie chaque nom d'hôte demandé à `api.anthropic.com` avant la récupération. Définir à `true` dans les environnements qui bloquent le trafic vers Anthropic, tels que les déploiements Bedrock, Vertex, ou Foundry avec une sortie restrictive. Quand ignorée, WebFetch tente n'importe quelle URL sans consulter la liste de blocage | `true` |

311| `spinnerTipsEnabled` | **Par défaut** : `true`. Afficher les conseils dans le spinner pendant que Claude travaille. Définir à `false` pour désactiver les conseils | `false` |315| `spinnerTipsEnabled` | **Par défaut** : `true`. Afficher les conseils dans le spinner pendant que Claude travaille. Définir à `false` pour désactiver les conseils | `false` |

312| `spinnerTipsOverride` | Remplacer les conseils du spinner par des chaînes personnalisées. `tips` : tableau de chaînes de conseil. `excludeDefault` : si `true`, afficher uniquement les conseils personnalisés ; si `false` ou absent, les conseils personnalisés sont fusionnés avec les conseils intégrés | `{ "excludeDefault": true, "tips": ["Use our internal tool X"] }` |316| `spinnerTipsOverride` | Remplacer les conseils du spinner par des chaînes personnalisées. `tips` : tableau de chaînes de conseil. `excludeDefault` : si `true`, afficher uniquement les conseils personnalisés ; si `false` ou absent, les conseils personnalisés sont fusionnés avec les conseils intégrés | `{ "excludeDefault": true, "tips": ["Use our internal tool X"] }` |

313| `spinnerVerbs` | Personnalisez les verbes d'action affichés pendant qu'un tour est en cours. Définir `mode` à `"replace"` pour utiliser uniquement vos verbes, ou `"append"` pour les ajouter aux valeurs par défaut | `{"mode": "append", "verbs": ["Pondering", "Crafting"]}` |317| `spinnerVerbs` | Personnalisez les verbes d'action affichés pendant qu'un tour est en cours. Définir `mode` à `"replace"` pour utiliser uniquement vos verbes, ou `"append"` pour les ajouter aux valeurs par défaut | `{"mode": "append", "verbs": ["Pondering", "Crafting"]}` |


316| `strictKnownMarketplaces` | (Paramètres gérés uniquement) Liste blanche des sources de marketplace de plugins. Non défini = pas de restrictions, tableau vide = verrouillage. Appliquée lors de l'ajout de marketplace et lors de l'installation, la mise à jour, l'actualisation et la mise à jour automatique du plugin, donc une marketplace ajoutée avant que la politique soit définie ne peut pas être utilisée pour récupérer les plugins. Voir [Restrictions de marketplace gérées](/fr/plugin-marketplaces#managed-marketplace-restrictions) | `[{ "source": "github", "repo": "acme-corp/plugins" }]` |320| `strictKnownMarketplaces` | (Paramètres gérés uniquement) Liste blanche des sources de marketplace de plugins. Non défini = pas de restrictions, tableau vide = verrouillage. Appliquée lors de l'ajout de marketplace et lors de l'installation, la mise à jour, l'actualisation et la mise à jour automatique du plugin, donc une marketplace ajoutée avant que la politique soit définie ne peut pas être utilisée pour récupérer les plugins. Voir [Restrictions de marketplace gérées](/fr/plugin-marketplaces#managed-marketplace-restrictions) | `[{ "source": "github", "repo": "acme-corp/plugins" }]` |

317| `strictPluginOnlyCustomization` | (Paramètres gérés uniquement) Bloquer les skills, agents, hooks, et MCP servers à partir des sources utilisateur et projet, pour qu'ils ne puissent provenir que des plugins ou des paramètres gérés. `true` verrouille les quatre surfaces ; un tableau verrouille uniquement les nommés. Voir [`strictPluginOnlyCustomization`](#strictpluginonlycustomization) | `["skills", "hooks"]` |321| `strictPluginOnlyCustomization` | (Paramètres gérés uniquement) Bloquer les skills, agents, hooks, et MCP servers à partir des sources utilisateur et projet, pour qu'ils ne puissent provenir que des plugins ou des paramètres gérés. `true` verrouille les quatre surfaces ; un tableau verrouille uniquement les nommés. Voir [`strictPluginOnlyCustomization`](#strictpluginonlycustomization) | `["skills", "hooks"]` |

318| `syntaxHighlightingDisabled` | Désactiver la coloration syntaxique dans les diffs, les blocs de code, et les aperçus de fichiers | `true` |322| `syntaxHighlightingDisabled` | Désactiver la coloration syntaxique dans les diffs, les blocs de code, et les aperçus de fichiers | `true` |

319| `teammateMode` | **Par défaut** : `in-process`. Comment les coéquipiers de l'[équipe d'agents](/fr/agent-teams) s'affichent : `in-process`, `auto` (choisit les volets divisés dans tmux ou iTerm2, en processus sinon), `tmux` (volets divisés utilisant tmux ou iTerm2, détectés à partir de votre terminal), ou {/* min-version: 2.1.186 */}`iterm2` (volets divisés natifs iTerm2 via la CLI `it2`, ajouté dans v2.1.186). La valeur par défaut a changé de `auto` dans v2.1.179. `--teammate-mode` remplace ceci pour une session. Voir [choisir un mode d'affichage](/fr/agent-teams#choose-a-display-mode) | `"auto"` |323| `teammateMode` | **Par défaut** : `in-process`. Comment les coéquipiers de l'[équipe d'agents](/fr/agent-teams) s'affichent : `in-process`, `auto` (choisit les volets divisés dans tmux ou iTerm2, en processus sinon), `tmux` (volets divisés utilisant tmux ou iTerm2, détectés à partir de votre terminal), ou {/* min-version: 2.1.186 */}}`iterm2` (volets divisés natifs iTerm2 via la CLI `it2`, ajouté dans v2.1.186). La valeur par défaut a changé de `auto` dans v2.1.179. `--teammate-mode` remplace ceci pour une session. Voir [choisir un mode d'affichage](/fr/agent-teams#choose-a-display-mode) | `"auto"` |

320| `terminalProgressBarEnabled` | **Par défaut** : `true`. Afficher la barre de progression du terminal dans les terminaux supportés : ConEmu, Ghostty 1.2.0+, et iTerm2 3.6.6+. Apparaît dans `/config` comme **Terminal progress bar** | `false` |324| `terminalProgressBarEnabled` | **Par défaut** : `true`. Afficher la barre de progression du terminal dans les terminaux supportés : ConEmu, Ghostty 1.2.0+, et iTerm2 3.6.6+. Apparaît dans `/config` comme **Terminal progress bar** | `false` |

321| `theme` | {/* min-version: 2.1.119 */}**Par défaut** : `"dark"`. Thème de couleur pour l'interface : `"auto"`, `"dark"`, `"light"`, `"dark-daltonized"`, `"light-daltonized"`, `"dark-ansi"`, `"light-ansi"`, ou une référence de thème personnalisé tel que `"custom:<slug>"` ou `"custom:<plugin-name>:<slug>"`. Voir [Créer un thème personnalisé](/fr/terminal-config#create-a-custom-theme). Apparaît dans `/config` comme **Theme** | `"dark"` |325| `theme` | {/* min-version: 2.1.119 */}**Par défaut** : `"dark"`. Thème de couleur pour l'interface : `"auto"`, `"dark"`, `"light"`, `"dark-daltonized"`, `"light-daltonized"`, `"dark-ansi"`, `"light-ansi"`, ou une référence de thème personnalisé tel que `"custom:<slug>"` ou `"custom:<plugin-name>:<slug>"`. Voir [Créer un thème personnalisé](/fr/terminal-config#create-a-custom-theme). Apparaît dans `/config` comme **Theme** | `"dark"` |

322| `tui` | Moteur de rendu de l'interface utilisateur du terminal. Utilisez `"fullscreen"` pour le moteur de rendu [alt-screen](/fr/fullscreen) sans scintillement avec défilement virtualisé. Utilisez `"default"` pour le moteur de rendu classique d'écran principal. Définir via `/tui`. Vous pouvez également définir la variable d'environnement [`CLAUDE_CODE_NO_FLICKER`](/fr/env-vars). Les sessions de fond ouvertes à partir de la [vue d'agent](/fr/agent-view) utilisent toujours le moteur de rendu fullscreen indépendamment de ce paramètre | `"fullscreen"` |326| `tui` | Moteur de rendu de l'interface utilisateur du terminal. Utilisez `"fullscreen"` pour le moteur de rendu [alt-screen](/fr/fullscreen) sans scintillement avec défilement virtualisé. Utilisez `"default"` pour le moteur de rendu classique d'écran principal. Définir via `/tui`. Vous pouvez également définir la variable d'environnement [`CLAUDE_CODE_NO_FLICKER`](/fr/env-vars). Les sessions de fond ouvertes à partir de la [vue d'agent](/fr/agent-view) utilisent toujours le moteur de rendu fullscreen indépendamment de ce paramètre | `"fullscreen"` |

323| `ultracode` | Activer [ultracode](/fr/workflows#let-claude-decide-with-ultracode) pour la session. Session uniquement et non lu à partir de `settings.json`. Définir via `/effort ultracode`, `--settings`, ou une demande de contrôle Agent SDK | `true` |327| `ultracode` | Activer [ultracode](/fr/workflows#let-claude-decide-with-ultracode) pour la session actuelle. Cette clé n'est pas lue à partir de `settings.json`. Définir via `/effort ultracode`, `--settings`, ou une demande de contrôle Agent SDK. {/* min-version: 2.1.203 */}Pour démarrer une session avec ultracode déjà activé, lancez avec `claude --effort ultracode`, qui nécessite Claude Code v2.1.203 ou ultérieur | `true` |

324| `useAutoModeDuringPlan` | **Par défaut** : `true`. Si le mode plan utilise la sémantique du mode auto quand le mode auto est disponible. Non lu à partir des paramètres de projet partagés. Apparaît dans `/config` comme « Utiliser le mode auto pendant le plan » | `false` |328| `useAutoModeDuringPlan` | **Par défaut** : `true`. Si le mode plan utilise la sémantique du mode auto quand le mode auto est disponible. Non lu à partir des paramètres de projet partagés. Apparaît dans `/config` comme « Utiliser le mode auto pendant le plan » | `false` |

325| `verbose` | {/* min-version: 2.1.119 */}**Par défaut** : `false`. Afficher la sortie complète de l'outil au lieu des résumés tronqués. Apparaît dans `/config` comme **Verbose output**. L'indicateur `--verbose` remplace ceci pour une session | `true` |329| `verbose` | {/* min-version: 2.1.119 */}**Par défaut** : `false`. Afficher la sortie complète de l'outil au lieu des résumés tronqués. Apparaît dans `/config` comme **Verbose output**. L'indicateur `--verbose` remplace ceci pour une session | `true` |

326| `viewMode` | Mode d'affichage de transcript par défaut au démarrage : `"default"`, `"verbose"`, ou `"focus"`. Remplace la sélection sticky `/focus` quand défini. L'indicateur `--verbose` remplace ceci pour une session | `"verbose"` |330| `viewMode` | Mode d'affichage de transcript par défaut au démarrage : `"default"`, `"verbose"`, ou `"focus"`. Remplace la sélection sticky `/focus` quand défini. L'indicateur `--verbose` remplace ceci pour une session | `"verbose"` |


341</Note>345</Note>

342 346 

343| Clé | Description | Exemple |347| Clé | Description | Exemple |

344| :------------------------ | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------- |348| :------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :--------- |

345| `autoConnectIde` | **Par défaut** : `false`. Se connecter automatiquement à un IDE en cours d'exécution quand Claude Code démarre à partir d'un terminal externe. Apparaît dans `/config` comme **Auto-connect to IDE (external terminal)** lors de l'exécution en dehors d'un terminal VS Code ou JetBrains. La variable d'environnement [`CLAUDE_CODE_AUTO_CONNECT_IDE`](/fr/env-vars) remplace ceci quand elle est définie | `true` |349| `autoConnectIde` | **Par défaut** : `false`. Se connecter automatiquement à un IDE en cours d'exécution quand Claude Code démarre à partir d'un terminal externe. Apparaît dans `/config` comme **Auto-connect to IDE (external terminal)** lors de l'exécution en dehors d'un terminal VS Code ou JetBrains. La variable d'environnement [`CLAUDE_CODE_AUTO_CONNECT_IDE`](/fr/env-vars) remplace ceci quand elle est définie | `true` |

346| `autoInstallIdeExtension` | **Par défaut** : `true`. Installer automatiquement l'extension Claude Code IDE lors de l'exécution à partir d'un terminal VS Code. Apparaît dans `/config` comme **Auto-install IDE extension** lors de l'exécution dans un terminal VS Code ou JetBrains. Vous pouvez également définir la variable d'environnement [`CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL`](/fr/env-vars) à `1` | `false` |350| `autoInstallIdeExtension` | **Par défaut** : `true`. Installer automatiquement l'extension Claude Code IDE lors de l'exécution à partir d'un terminal VS Code. Apparaît dans `/config` comme **Auto-install IDE extension** lors de l'exécution dans un terminal VS Code ou JetBrains. Vous pouvez également définir la variable d'environnement [`CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL`](/fr/env-vars) à `1` | `false` |

347| `externalEditorContext` | **Par défaut** : `false`. Ajouter la réponse précédente de Claude comme contexte commenté avec `#` quand vous ouvrez l'éditeur externe avec `Ctrl+G`. Apparaît dans `/config` comme **Show last response in external editor** | `true` |351| `externalEditorContext` | **Par défaut** : `false`. Ajouter la réponse précédente de Claude comme contexte commenté avec `#` quand vous ouvrez l'éditeur externe avec `Ctrl+G`. Apparaît dans `/config` comme **Show last response in external editor** | `true` |

348| `teammateDefaultModel` | Modèle par défaut pour les coéquipiers de l'[équipe d'agents](/fr/agent-teams) quand l'invite de génération ne spécifie pas un. Définir à un alias de modèle tel que `"sonnet"`, ou `null` pour hériter de la sélection `/model` actuelle du leader. Apparaît dans `/config` comme **Default teammate model** | `"sonnet"` |352| `teammateDefaultModel` | Modèle par défaut pour les coéquipiers de l'[équipe d'agents](/fr/agent-teams) quand l'invite de génération ne spécifie pas un. Définir à un alias de modèle tel que `"sonnet"`, ou `null` pour hériter de la sélection `/model` actuelle du leader. Apparaît dans `/config` comme **Default teammate model** | `"sonnet"` |

353| `workflowSizeGuideline` | {/* min-version: 2.1.202 */}**Par défaut** : `unrestricted`, qui n'envoie aucune directive. Définit le [nombre d'agents que Claude vise](/fr/workflows#set-a-size-guideline) dans les workflows dynamiques qu'il écrit. Claude Code envoie la valeur à Claude comme conseil, pas un plafond appliqué. Accepte `unrestricted`, `small`, `medium`, ou `large`. Apparaît dans `/config` comme **Dynamic workflow size**. Vous pouvez également le définir directement avec `/config workflowSizeGuideline=small`. Nécessite Claude Code v2.1.202 ou ultérieur. {/* min-version: 2.1.203 */}La directive de taille remplace également le seuil par défaut pour l'[avertissement `Large workflow`](/fr/workflows#cost) ; ce comportement nécessite Claude Code v2.1.203 ou ultérieur | `"small"` |

349 354 

350<h3 id="worktree-settings">355<h3 id="worktree-settings">

351 Paramètres de worktree356 Paramètres de worktree


354Configurez comment `--worktree` crée et gère les git worktrees.359Configurez comment `--worktree` crée et gère les git worktrees.

355 360 

356| Clé | Description | Exemple |361| Clé | Description | Exemple |

357| :---------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------ |362| :---------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------ |

358| `worktree.baseRef` | Quelle ref les nouveaux worktrees branchent. `"fresh"` (par défaut) branche à partir de `origin/<default-branch>` pour un arbre propre correspondant au distant. `"head"` branche à partir de votre `HEAD` local actuel, donc les commits non poussés et l'état de la branche de fonctionnalité sont présents dans le worktree. S'applique à `--worktree`, l'outil `EnterWorktree`, et l'isolation du subagent | `"head"` |363| `worktree.baseRef` | Quelle ref les nouveaux worktrees branchent. `"fresh"` (par défaut) branche à partir de `origin/<default-branch>` pour un arbre propre correspondant au distant. `"head"` branche à partir de votre `HEAD` local actuel, donc les commits non poussés et l'état de la branche de fonctionnalité sont présents dans le worktree. S'applique à `--worktree`, l'outil `EnterWorktree`, et l'isolation du subagent | `"head"` |

359| `worktree.symlinkDirectories` | Répertoires à créer en lien symbolique à partir du référentiel principal dans chaque worktree pour éviter de dupliquer les grands répertoires sur le disque. Aucun répertoire n'est créé en lien symbolique par défaut | `["node_modules", ".cache"]` |364| `worktree.symlinkDirectories` | Répertoires à créer en lien symbolique à partir du référentiel principal dans chaque worktree pour éviter de dupliquer les grands répertoires sur le disque. Aucun répertoire n'est créé en lien symbolique par défaut | `["node_modules", ".cache"]` |

360| `worktree.sparsePaths` | Répertoires à extraire dans chaque worktree via git sparse-checkout. Seuls les chemins listés plus les fichiers au niveau racine sont écrits sur le disque, ce qui est plus rapide dans les grands monorepos | `["packages/my-app", "shared/utils"]` |365| `worktree.sparsePaths` | Répertoires à extraire dans chaque worktree via git sparse-checkout. Seuls les chemins listés plus les fichiers au niveau racine sont écrits sur le disque, ce qui est plus rapide dans les grands monorepos | `["packages/my-app", "shared/utils"]` |

361| `worktree.bgIsolation` | {/* min-version: 2.1.143 */}Mode d'isolation pour les [sessions de fond](/fr/agent-view#how-file-edits-are-isolated). `"worktree"` (par défaut) bloque `Edit`/`Write` dans le checkout principal jusqu'à ce que `EnterWorktree` soit appelé. `"none"` permet aux tâches de fond d'éditer la copie de travail directement. Nécessite Claude Code v2.1.143 ou ultérieur | `"none"` |366| `worktree.bgIsolation` | {/* min-version: 2.1.143 */}Mode d'isolation pour les [sessions de fond](/fr/agent-view#how-file-edits-are-isolated). `"worktree"` (par défaut) bloque `Edit`/`Write` dans le checkout principal jusqu'à ce que `EnterWorktree` soit appelé. {/* min-version: 2.1.203 */}En dehors d'un référentiel git, un [hook `WorktreeCreate`](/fr/worktrees#non-git-version-control) qui échoue libère le bloc pour que la session puisse éditer le répertoire de travail en place ; nécessite Claude Code v2.1.203 ou ultérieur. `"none"` permet aux tâches de fond d'éditer la copie de travail directement. Nécessite Claude Code v2.1.143 ou ultérieur | `"none"` |

362 367 

363Pour copier les fichiers ignorés par git comme `.env` dans les nouveaux worktrees, utilisez un [fichier `.worktreeinclude`](/fr/worktrees#copy-gitignored-files-into-worktrees) dans la racine de votre projet à la place d'un paramètre.368Pour copier les fichiers ignorés par git comme `.env` dans les nouveaux worktrees, utilisez un [fichier `.worktreeinclude`](/fr/worktrees#copy-gitignored-files-into-worktrees) dans la racine de votre projet à la place d'un paramètre.

364 369 


367</h3>372</h3>

368 373 

369| Clés | Description | Exemple |374| Clés | Description | Exemple |

370| :---------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :--------------------------------------------------------------------- |375| :---------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :--------------------------------------------------------------------- |

371| `allow` | Tableau de règles de permission pour autoriser l'utilisation d'outils. Les globs de nom d'outil ne sont supportés que dans la position d'outil après un préfixe littéral `mcp__<server>__`, tel que `mcp__github__get_*` ; le segment du serveur doit être sans glob. Voir [Syntaxe de règle de permission](#permission-rule-syntax) ci-dessous pour les détails de correspondance de modèle | `[ "Bash(git diff *)" ]` |376| `allow` | Tableau de règles de permission pour autoriser l'utilisation d'outils. Les globs de nom d'outil ne sont supportés que dans la position d'outil après un préfixe littéral `mcp__<server>__`, tel que `mcp__github__get_*` ; le segment du serveur doit être sans glob. Voir [Syntaxe de règle de permission](#permission-rule-syntax) ci-dessous pour les détails de correspondance de modèle | `[ "Bash(git diff *)" ]` |

372| `ask` | Tableau de règles de permission pour demander une confirmation lors de l'utilisation d'outils. Voir [Syntaxe de règle de permission](#permission-rule-syntax) ci-dessous | `[ "Bash(git push *)" ]` |377| `ask` | Tableau de règles de permission pour demander une confirmation lors de l'utilisation d'outils. Voir [Syntaxe de règle de permission](#permission-rule-syntax) ci-dessous | `[ "Bash(git push *)" ]` |

373| `deny` | Tableau de règles de permission pour refuser l'utilisation d'outils. Utilisez ceci pour exclure les fichiers sensibles de l'accès de Claude Code. Les noms d'outils acceptent les modèles glob : `"*"` refuse chaque outil et `"mcp__*"` refuse tous les outils MCP. Voir [Syntaxe de règle de permission](#permission-rule-syntax) et [Limitations de permission Bash](/fr/permissions#tool-specific-permission-rules) | `[ "WebFetch", "Bash(curl *)", "Read(./.env)", "Read(./secrets/**)" ]` |378| `deny` | Tableau de règles de permission pour refuser l'utilisation d'outils. Utilisez ceci pour exclure les fichiers sensibles de l'accès de Claude Code. Les noms d'outils acceptent les modèles glob : `"*"` refuse chaque outil et `"mcp__*"` refuse tous les outils MCP. Voir [Syntaxe de règle de permission](#permission-rule-syntax) et [Limitations de permission Bash](/fr/permissions#tool-specific-permission-rules) | `[ "WebFetch", "Bash(curl *)", "Read(./.env)", "Read(./secrets/**)" ]` |

374| `additionalDirectories` | [Répertoires de travail](/fr/permissions#working-directories) supplémentaires pour l'accès aux fichiers. La plupart de la configuration `.claude/` n'est [pas découverte](/fr/permissions#additional-directories-grant-file-access-not-configuration) à partir de ces répertoires | `[ "../docs/" ]` |379| `additionalDirectories` | [Répertoires de travail](/fr/permissions#working-directories) supplémentaires pour l'accès aux fichiers. La plupart de la configuration `.claude/` n'est [pas découverte](/fr/permissions#additional-directories-grant-file-access-not-configuration) à partir de ces répertoires | `[ "../docs/" ]` |

375| `defaultMode` | [Mode de permission](/fr/permission-modes) par défaut lors de l'ouverture de Claude Code. Valeurs valides : `default`, `acceptEdits`, `plan`, `auto`, `dontAsk`, `bypassPermissions`. {/* min-version: 2.1.142 */}À partir de Claude Code v2.1.142, `auto` est ignoré quand défini dans les paramètres de projet ou locaux (`.claude/settings.json`, `.claude/settings.local.json`) pour qu'un référentiel ne puisse pas se donner le mode auto. Définissez-le dans `~/.claude/settings.json` à la place. L'indicateur CLI `--permission-mode` remplace ce paramètre pour une seule session | `"acceptEdits"` |380| `defaultMode` | [Mode de permission](/fr/permission-modes) par défaut lors de l'ouverture de Claude Code. Valeurs valides : `default`, `acceptEdits`, `plan`, `auto`, `dontAsk`, `bypassPermissions`, et {/* min-version: 2.1.200 */}}`manual` comme alias pour `default`, le mode étiqueté Manuel dans la CLI et les extensions VS Code et JetBrains. L'alias `manual` nécessite Claude Code v2.1.200 ou ultérieur. {/* min-version: 2.1.142 */}}`auto` est ignoré quand défini dans les paramètres de projet ou locaux, pour qu'un référentiel ne puisse pas se donner le mode auto ; définissez-le dans `~/.claude/settings.json` à la place. Avant v2.1.142, les paramètres de projet pouvaient définir `auto`. L'indicateur CLI `--permission-mode` remplace ce paramètre pour une seule session | `"acceptEdits"` |

376| `disableBypassPermissionsMode` | Définir à `"disable"` pour empêcher l'activation du mode `bypassPermissions`. Ceci désactive l'indicateur de ligne de commande `--dangerously-skip-permissions`. Généralement placé dans les [paramètres gérés](/fr/permissions#managed-settings) pour appliquer la politique organisationnelle, mais fonctionne à partir de n'importe quelle portée | `"disable"` |381| `disableBypassPermissionsMode` | Définir à `"disable"` pour empêcher l'activation du mode `bypassPermissions`. Ceci désactive l'indicateur de ligne de commande `--dangerously-skip-permissions`. Généralement placé dans les [paramètres gérés](/fr/permissions#managed-settings) pour appliquer la politique organisationnelle, mais fonctionne à partir de n'importe quelle portée | `"disable"` |

377| `skipDangerousModePermissionPrompt` | Ignorer l'invite de confirmation affichée avant d'entrer en mode bypass permissions via `--dangerously-skip-permissions` ou `defaultMode: "bypassPermissions"`. Ignoré quand défini dans les paramètres de projet (`.claude/settings.json`) pour empêcher les référentiels non fiables d'auto-contourner l'invite | `true` |382| `skipDangerousModePermissionPrompt` | Ignorer l'invite de confirmation affichée avant d'entrer en mode bypass permissions via `--dangerously-skip-permissions` ou `defaultMode: "bypassPermissions"`. Ignoré quand défini dans les paramètres de projet (`.claude/settings.json`) pour empêcher les référentiels non fiables d'auto-contourner l'invite | `true` |

378 383 


400Configurez le comportement avancé du sandboxing. Le sandboxing isole les commandes bash de votre système de fichiers et réseau. Voir [Sandboxing](/fr/sandboxing) pour plus de détails.405Configurez le comportement avancé du sandboxing. Le sandboxing isole les commandes bash de votre système de fichiers et réseau. Voir [Sandboxing](/fr/sandboxing) pour plus de détails.

401 406 

402| Clés | Description | Exemple |407| Clés | Description | Exemple |

403| :------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :--------------------------------------------------- |408| :------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------- |

404| `enabled` | Activer le sandboxing bash (macOS, Linux, et WSL2). Par défaut : false | `true` |409| `enabled` | Activer le sandboxing bash (macOS, Linux, et WSL2). Par défaut : false | `true` |

405| `failIfUnavailable` | Quitter avec une erreur au démarrage si `sandbox.enabled` est true mais que le sandbox ne peut pas démarrer (dépendances manquantes ou plateforme non supportée). Quand false (par défaut), un avertissement est affiché et les commandes s'exécutent sans sandbox. Destiné aux déploiements de paramètres gérés qui nécessitent le sandboxing comme une porte dure | `true` |410| `failIfUnavailable` | Quitter avec une erreur au démarrage si `sandbox.enabled` est true mais que le sandbox ne peut pas démarrer (dépendances manquantes ou plateforme non supportée). Quand false (par défaut), un avertissement est affiché et les commandes s'exécutent sans sandbox. Destiné aux déploiements de paramètres gérés qui nécessitent le sandboxing comme une porte dure | `true` |

406| `autoAllowBashIfSandboxed` | Approuver automatiquement les commandes bash quand sandboxées. Par défaut : true | `true` |411| `autoAllowBashIfSandboxed` | Approuver automatiquement les commandes bash quand sandboxées. Par défaut : true | `true` |


412| `filesystem.allowRead` | Chemins à réautoriser pour la lecture dans les régions `denyRead`. A la priorité sur `denyRead`. Les tableaux sont fusionnés dans toutes les portées de paramètres. Utilisez ceci pour créer des modèles d'accès en lecture spécifiques à l'espace de travail. | `["."]` |417| `filesystem.allowRead` | Chemins à réautoriser pour la lecture dans les régions `denyRead`. A la priorité sur `denyRead`. Les tableaux sont fusionnés dans toutes les portées de paramètres. Utilisez ceci pour créer des modèles d'accès en lecture spécifiques à l'espace de travail. | `["."]` |

413| `filesystem.allowManagedReadPathsOnly` | (Paramètres gérés uniquement) Seuls les chemins `allowRead` à partir des paramètres gérés sont respectés. `denyRead` fusionne toujours à partir de toutes les sources. Par défaut : false | `true` |418| `filesystem.allowManagedReadPathsOnly` | (Paramètres gérés uniquement) Seuls les chemins `allowRead` à partir des paramètres gérés sont respectés. `denyRead` fusionne toujours à partir de toutes les sources. Par défaut : false | `true` |

414| `credentials.files` | {/* min-version: 2.1.187 */}Fichiers ou répertoires d'identifiants que les commandes sandboxées ne peuvent pas lire. Applique le même bloc de lecture que `filesystem.denyRead` ; la clé séparée garde les chemins d'identifiants groupés avec `credentials.envVars` et à l'écart des règles générales du système de fichiers. Chaque entrée est `{ "path": "...", "mode": "deny" }`, et `deny` est le seul mode supporté pour les fichiers. Les chemins utilisent les mêmes [préfixes](#sandbox-path-prefixes) que les paramètres `filesystem.*`. Les tableaux sont fusionnés dans toutes les portées de paramètres. Nécessite Claude Code v2.1.187 ou ultérieur. | `[{ "path": "~/.aws/credentials", "mode": "deny" }]` |419| `credentials.files` | {/* min-version: 2.1.187 */}Fichiers ou répertoires d'identifiants que les commandes sandboxées ne peuvent pas lire. Applique le même bloc de lecture que `filesystem.denyRead` ; la clé séparée garde les chemins d'identifiants groupés avec `credentials.envVars` et à l'écart des règles générales du système de fichiers. Chaque entrée est `{ "path": "...", "mode": "deny" }`, et `deny` est le seul mode supporté pour les fichiers. Les chemins utilisent les mêmes [préfixes](#sandbox-path-prefixes) que les paramètres `filesystem.*`. Les tableaux sont fusionnés dans toutes les portées de paramètres. Nécessite Claude Code v2.1.187 ou ultérieur. | `[{ "path": "~/.aws/credentials", "mode": "deny" }]` |

415| `credentials.envVars` | {/* min-version: 2.1.187 */}Variables d'environnement à [protéger des commandes sandboxées](/fr/sandboxing#protect-credentials). Chaque entrée a un `name` et un `mode` ; le nom doit commencer par une lettre ou un tiret bas et contenir uniquement des lettres, des chiffres, et des tirets bas. `deny` supprime la variable de l'environnement des commandes sandboxées. Nécessite Claude Code v2.1.187 ou ultérieur. {/* min-version: 2.1.199 */}`mask` remplace la variable par une valeur sentinelle par session à l'intérieur du sandbox tandis que le proxy du sandbox substitue la valeur réelle sur les demandes sortantes vers l'entrée `injectHosts` de cette entrée ; cela nécessite `network.tlsTerminate` et Claude Code v2.1.199 ou ultérieur. Les entrées `mask` ne sont honorées que à partir des paramètres utilisateur, gérés ou CLI `--settings`, pas à partir de `.claude/settings.json` ou `.claude/settings.local.json`. Les tableaux sont fusionnés dans toutes les portées de paramètres, et `deny` a la priorité quand la même variable apparaît avec les deux modes. | `[{ "name": "GITHUB_TOKEN", "mode": "deny" }]` |420| `credentials.envVars` | {/* min-version: 2.1.187 */}Variables d'environnement à [protéger des commandes sandboxées](/fr/sandboxing#protect-credentials). Chaque entrée a un `name` et un `mode` ; le nom doit commencer par une lettre ou un tiret bas et contenir uniquement des lettres, des chiffres, et des tirets bas. `deny` supprime la variable de l'environnement des commandes sandboxées. Nécessite Claude Code v2.1.187 ou ultérieur. {/* min-version: 2.1.199 */}}`mask` remplace la variable par une valeur sentinelle par session à l'intérieur du sandbox tandis que le proxy du sandbox substitue la valeur réelle sur les demandes sortantes vers l'entrée `injectHosts` de cette entrée ; cela nécessite `network.tlsTerminate` et Claude Code v2.1.199 ou ultérieur. Les entrées `mask` ne sont honorées que à partir des paramètres utilisateur, gérés ou CLI `--settings`, pas à partir de `.claude/settings.json` ou `.claude/settings.local.json`. Les tableaux sont fusionnés dans toutes les portées de paramètres, et `deny` a la priorité quand la même variable apparaît avec les deux modes. | `[{ "name": "GITHUB_TOKEN", "mode": "deny" }]` |

416| `credentials.envVars[].injectHosts` | Hôtes où le proxy du sandbox substitue la valeur réelle d'une entrée `mask`. Chaque hôte doit également être couvert par `network.allowedDomains`, soit exactement soit par un caractère générique. Quand non défini, le proxy substitue la valeur sur les demandes à chaque hôte dans `network.allowedDomains`. Accepté mais ignoré quand `mode` est `deny`. Nécessite Claude Code v2.1.199 ou ultérieur. {/* min-version: 2.1.199 */} | `["api.github.com"]` |421| `credentials.envVars[].injectHosts` | Hôtes où le proxy du sandbox substitue la valeur réelle d'une entrée `mask`. Chaque hôte doit également être couvert par `network.allowedDomains`, soit exactement soit par un caractère générique. Quand non défini, le proxy substitue la valeur sur les demandes à chaque hôte dans `network.allowedDomains`. Accepté mais ignoré quand `mode` est `deny`. Nécessite Claude Code v2.1.199 ou ultérieur. {/* min-version: 2.1.199 */} | `["api.github.com"]` |

417| `credentials.allowPlaintextInject` | Autoriser la substitution `mask` sur les demandes HTTP simples ainsi que sur HTTPS terminé par TLS. Sur HTTP simple, l'identité en amont n'est pas vérifiée et l'identifiant voyage en clair, donc laissez ceci désactivé en dehors des réseaux de test de confiance. Honoré uniquement à partir des paramètres utilisateur, gérés ou CLI `--settings`, pas à partir de `.claude/settings.json` ou `.claude/settings.local.json`. Par défaut : false. Nécessite Claude Code v2.1.199 ou ultérieur. {/* min-version: 2.1.199 */} | `true` |422| `credentials.allowPlaintextInject` | Autoriser la substitution `mask` sur les demandes HTTP simples ainsi que sur HTTPS terminé par TLS. Sur HTTP simple, l'identité en amont n'est pas vérifiée et l'identifiant voyage en clair, donc laissez ceci désactivé en dehors des réseaux de test de confiance. Honoré uniquement à partir des paramètres utilisateur, gérés ou CLI `--settings`, pas à partir de `.claude/settings.json` ou `.claude/settings.local.json`. Par défaut : false. Nécessite Claude Code v2.1.199 ou ultérieur. {/* min-version: 2.1.199 */} | `true` |

418| `network.allowUnixSockets` | (macOS uniquement) Chemins de socket Unix accessibles dans le sandbox. Ignoré sur Linux et WSL2, où le filtre seccomp ne peut pas inspecter les chemins de socket ; utilisez `allowAllUnixSockets` à la place. | `["~/.ssh/agent-socket"]` |423| `network.allowUnixSockets` | (macOS uniquement) Chemins de socket Unix accessibles dans le sandbox. Ignoré sur Linux et WSL2, où le filtre seccomp ne peut pas inspecter les chemins de socket ; utilisez `allowAllUnixSockets` à la place. | `["~/.ssh/agent-socket"]` |


734 Exclure les fichiers sensibles739 Exclure les fichiers sensibles

735</h3>740</h3>

736 741 

737Pour empêcher Claude Code d'accéder aux fichiers contenant des informations sensibles comme les clés API, les secrets, et les fichiers d'environnement, utilisez le paramètre `permissions.deny` dans votre fichier `.claude/settings.json` :742Pour emp empêcher Claude Code d'accéder aux fichiers contenant des informations sensibles comme les clés API, les secrets, et les fichiers d'environnement, utilisez le paramètre `permissions.deny` dans votre fichier `.claude/settings.json` :

738 743 

739```json theme={null}744```json theme={null}

740{745{

setup.md +9 −3

Details

188 S'authentifier188 S'authentifier

189</h2>189</h2>

190 190 

191Claude Code nécessite un compte Pro, Max, Team, Enterprise ou Console. Le plan gratuit Claude.ai n'inclut pas l'accès à Claude Code. Vous pouvez également utiliser Claude Code avec un fournisseur d'API tiers comme [Amazon Bedrock](/fr/amazon-bedrock), [Google Vertex AI](/fr/google-vertex-ai) ou [Microsoft Foundry](/fr/microsoft-foundry).191Claude Code nécessite un compte Pro, Max, Team, Enterprise ou Console. Le plan gratuit Claude.ai n'inclut pas l'accès à Claude Code. Vous pouvez également utiliser Claude Code avec un fournisseur d'API tiers comme [Amazon Bedrock](/fr/amazon-bedrock), [Google Cloud's Agent Platform](/fr/google-vertex-ai) ou [Microsoft Foundry](/fr/microsoft-foundry).

192 192 

193Après l'installation, connectez-vous en exécutant `claude` et en suivant les invites du navigateur. Consultez [Authentification](/fr/authentication) pour tous les types de comptes et les options de configuration d'équipe.193Après l'installation, connectez-vous en exécutant `claude` et en suivant les invites du navigateur. Consultez [Authentification](/fr/authentication) pour tous les types de comptes et les options de configuration d'équipe.

194 194 


376 376 

377<Tabs>377<Tabs>

378 <Tab title="apt">378 <Tab title="apt">

379 Pour Debian et Ubuntu. Les commandes suivantes configurent le canal `stable` :379 Pour Debian et Ubuntu. Les commandes d'installation ci-dessous téléchargent la clé de signature avec `curl`, que les installations fraîches de Debian et Ubuntu peuvent ne pas inclure. Si le téléchargement échoue avec `sudo: curl: command not found`, installez d'abord curl :

380 

381 ```bash theme={null}

382 sudo apt install curl

383 ```

384 

385 Les commandes suivantes configurent le canal `stable` :

380 386 

381 ```bash theme={null}387 ```bash theme={null}

382 sudo install -d -m 0755 /etc/apt/keyrings388 sudo install -d -m 0755 /etc/apt/keyrings


526 </Step>532 </Step>

527 533 

528 <Step title="Vérifier le binaire par rapport au manifeste">534 <Step title="Vérifier le binaire par rapport au manifeste">

529 Comparez la somme de contrôle SHA256 de votre binaire téléchargé avec la valeur répertoriée sous `platforms.<platform>.checksum` dans `manifest.json`.535 Comparez la somme de contrôle SHA256 du binaire avec la valeur répertoriée sous `platforms.<platform>.checksum` dans `manifest.json`. Les commandes ci-dessous supposent un binaire `claude` dans le répertoire courant. Pour vérifier un binaire natif installé à la place, exécutez la commande par rapport à `~/.local/share/claude/versions/VERSION`, en remplaçant VERSION par la version que vous avez définie à l'étape 2.

530 536 

531 <Tabs>537 <Tabs>

532 <Tab title="Linux">538 <Tab title="Linux">

skills.md +11 −3

Details

22 Skills groupées22 Skills groupées

23</h2>23</h2>

24 24 

25Claude Code inclut un ensemble de skills groupées qui sont disponibles dans chaque session sauf si elles sont désactivées avec le paramètre [`disableBundledSkills`](/fr/settings#available-settings), notamment `/code-review`, `/batch`, `/debug`, `/loop` et `/claude-api`. Contrairement à la plupart des commandes intégrées, qui exécutent une logique fixe directement, les skills groupées sont basées sur des prompts : elles donnent à Claude des instructions détaillées et le laissent orchestrer le travail en utilisant ses outils. Vous les invoquez de la même manière que n'importe quelle autre skill, en tapant `/` suivi du nom de la skill.25Claude Code inclut un ensemble de skills groupées qui sont disponibles dans chaque session sauf si elles sont désactivées avec le paramètre [`disableBundledSkills`](/fr/settings#available-settings), notamment `/doctor`, `/code-review`, `/batch`, `/debug`, `/loop` et `/claude-api`. Contrairement à la plupart des commandes intégrées, qui exécutent une logique fixe directement, les skills groupées sont basées sur des prompts : elles donnent à Claude des instructions détaillées et le laissent orchestrer le travail en utilisant ses outils. Vous les invoquez de la même manière que n'importe quelle autre skill, en tapant `/` suivi du nom de la skill.

26 

27La vérification de configuration [`/doctor`](/fr/commands#all-commands) est l'une des exceptions à `disableBundledSkills` dans Claude Code v2.1.205 et versions ultérieures : elle reste tapable quand le paramètre est activé. Pour la masquer, définissez la variable d'environnement `DISABLE_DOCTOR_COMMAND` ou une entrée [`skillOverrides`](#override-skill-visibility-from-settings) de `"doctor": "off"`. Avant v2.1.205, `/doctor` était une commande intégrée plutôt qu'une skill groupée.

26 28 

27Les skills groupées sont listées aux côtés des commandes intégrées dans la [référence des commandes](/fr/commands), marquées **Skill** dans la colonne Objectif.29Les skills groupées sont listées aux côtés des commandes intégrées dans la [référence des commandes](/fr/commands), marquées **Skill** dans la colonne Objectif.

28 30 


129 131 

130Taper `/deploy` exécute la skill de la racine du projet. Tapez le nom qualifié `/apps/web:deploy` pour exécuter la variante imbriquée explicitement.132Taper `/deploy` exécute la skill de la racine du projet. Tapez le nom qualifié `/apps/web:deploy` pour exécuter la variante imbriquée explicitement.

131 133 

134Quand vous ou Claude invoquez le nom non qualifié, la skill de la racine du projet se charge, et Claude Code ajoute une liste des variantes qualifiées par répertoire à son contenu avec une instruction pour invoquer également toute variante dont le répertoire contient les fichiers sur lesquels Claude travaille. Une skill imbriquée s'applique donc toujours au travail dans son répertoire quand seul le nom non qualifié est invoqué. Nécessite Claude Code v2.1.203 ou ultérieur.

135 

132Une entrée `<skill-name>` dans les emplacements d'entreprise, personnels ou de projet peut être un lien symbolique vers un répertoire ailleurs sur le disque. Claude Code suit le lien symbolique et lit `SKILL.md` à partir du répertoire cible, et si la même cible est accessible à partir de plusieurs emplacements, Claude Code charge la skill une seule fois. Les skills de plugin gèrent les liens symboliques différemment ; voir [Partager des fichiers dans une marketplace avec des liens symboliques](/fr/plugins-reference#share-files-within-a-marketplace-with-symlinks).136Une entrée `<skill-name>` dans les emplacements d'entreprise, personnels ou de projet peut être un lien symbolique vers un répertoire ailleurs sur le disque. Claude Code suit le lien symbolique et lit `SKILL.md` à partir du répertoire cible, et si la même cible est accessible à partir de plusieurs emplacements, Claude Code charge la skill une seule fois. Les skills de plugin gèrent les liens symboliques différemment ; voir [Partager des fichiers dans une marketplace avec des liens symboliques](/fr/plugins-reference#share-files-within-a-marketplace-with-symlinks).

133 137 

134<Note>138<Note>


390 394 

391Quand vous ou Claude invoquez une skill, le contenu `SKILL.md` rendu entre dans la conversation comme un seul message et y reste pour le reste de la session. Claude Code ne relit pas le fichier de skill aux tours suivants, donc écrivez les directives qui devraient s'appliquer tout au long d'une tâche comme des instructions permanentes plutôt que des étapes ponctuelles.395Quand vous ou Claude invoquez une skill, le contenu `SKILL.md` rendu entre dans la conversation comme un seul message et y reste pour le reste de la session. Claude Code ne relit pas le fichier de skill aux tours suivants, donc écrivez les directives qui devraient s'appliquer tout au long d'une tâche comme des instructions permanentes plutôt que des étapes ponctuelles.

392 396 

397Quand Claude réinvoque une skill dont le contenu rendu est identique à la copie déjà dans le contexte, Claude Code ajoute une courte note que la skill est déjà chargée plutôt qu'une deuxième copie du contenu. Quand le contenu rendu diffère, parce que les arguments ont changé ou qu'une commande de [contexte dynamique](#inject-dynamic-context) a produit une nouvelle sortie, Claude Code ajoute le contenu complet à nouveau. Avant v2.1.202, chaque réinvocation ajoutait une autre copie complète des instructions de la skill.

398 

393[L'auto-compaction](/fr/how-claude-code-works#when-context-fills-up) porte les skills invoquées en avant dans un budget de tokens. Quand la conversation est résumée pour libérer du contexte, Claude Code réattache l'invocation la plus récente de chaque skill après le résumé, en gardant les premiers 5 000 tokens de chacune. Les skills réattachées partagent un budget combiné de 25 000 tokens. Claude Code remplit ce budget en commençant par la skill la plus récemment invoquée, donc les skills plus anciennes peuvent être entièrement supprimées après la compaction si vous en avez invoqué beaucoup dans une session.399[L'auto-compaction](/fr/how-claude-code-works#when-context-fills-up) porte les skills invoquées en avant dans un budget de tokens. Quand la conversation est résumée pour libérer du contexte, Claude Code réattache l'invocation la plus récente de chaque skill après le résumé, en gardant les premiers 5 000 tokens de chacune. Les skills réattachées partagent un budget combiné de 25 000 tokens. Claude Code remplit ce budget en commençant par la skill la plus récemment invoquée, donc les skills plus anciennes peuvent être entièrement supprimées après la compaction si vous en avez invoqué beaucoup dans une session.

394 400 

395Si une skill semble cesser d'influencer le comportement après la première réponse, le contenu est généralement toujours présent et le modèle choisit d'autres outils ou approches. Renforcez la `description` et les instructions de la skill pour que le modèle continue à la préférer, ou utilisez [hooks](/fr/hooks) pour appliquer le comportement de manière déterministe. Si la skill est grande ou vous avez invoqué plusieurs autres après elle, réinvoquez-la après la compaction pour restaurer le contenu complet.401Si une skill semble cesser d'influencer le comportement après la première réponse, le contenu est généralement toujours présent et le modèle choisit d'autres outils ou approches. Renforcez la `description` et les instructions de la skill pour que le modèle continue à la préférer, ou utilisez [hooks](/fr/hooks) pour appliquer le comportement de manière déterministe. Si la skill est grande ou vous avez invoqué plusieurs autres après elle, réinvoquez-la après la compaction pour restaurer le contenu complet.


908 Les descriptions de skills sont coupées court914 Les descriptions de skills sont coupées court

909</h3>915</h3>

910 916 

911Les descriptions de skills sont chargées dans le contexte pour que Claude sache ce qui est disponible. Tous les noms de skills sont toujours inclus, mais si vous avez beaucoup de skills, les descriptions sont raccourcies pour tenir dans le budget de caractères, ce qui peut supprimer les mots-clés dont Claude a besoin pour correspondre à votre demande. Le budget s'adapte à 1 % de la fenêtre de contexte du modèle. Quand il déborde, les descriptions des skills que vous invoquez le moins sont supprimées en premier, de sorte que les skills que vous utilisez réellement conservent leur texte complet. Exécutez `/doctor` pour voir combien de descriptions de skills sont raccourcies ou supprimées et quelles skills sont affectées.917Claude Code charge une liste de noms de skills et de descriptions dans le contexte pour que Claude sache ce qui est disponible. La liste contient toujours tous les noms de skills, mais si vous avez beaucoup de skills, Claude Code raccourcit les descriptions pour tenir dans le budget de caractères de la liste, ce qui peut supprimer les mots-clés dont Claude a besoin pour correspondre à votre demande. Le budget s'adapte à 1 % de la fenêtre de contexte du modèle. Quand la liste déborde, Claude Code supprime les descriptions en commençant par les skills que vous invoquez le moins, de sorte que les skills que vous utilisez le plus conservent leur texte complet.

918 

919Exécutez `/doctor` pour une estimation du coût contextuel de la liste et de ses plus grands contributeurs. Quand la liste dépasse son budget, Claude Code écrit également un avertissement dans le journal de débogage, visible avec [`--debug`](/fr/cli-reference#cli-flags).

912 920 

913À partir de la v2.1.196, la ligne Skills dans `/context` rapporte la taille de la liste après l'application du budget, de sorte qu'elle correspond à ce que le modèle reçoit. Les versions antérieures comptaient le texte complet de chaque description, de sorte que la ligne pouvait afficher une valeur plusieurs fois plus grande que le budget que `/doctor` rapporte.921La ligne Skills dans `/context` rapporte la taille de la liste après l'application du budget, de sorte qu'elle correspond à ce que le modèle reçoit. Avant la v2.1.196, la ligne comptait le texte complet de chaque description et pouvait afficher une valeur plusieurs fois plus grande que le budget configuré.

914 922 

915Pour augmenter le budget, définissez le paramètre [`skillListingBudgetFraction`](/fr/settings#available-settings) (par exemple `0.02` = 2 %) ou la variable d'environnement `SLASH_COMMAND_TOOL_CHAR_BUDGET` à un nombre de caractères fixe. Pour libérer du budget pour d'autres skills, définissez les entrées de faible priorité sur `"name-only"` dans [`skillOverrides`](#override-skill-visibility-from-settings) afin qu'elles s'affichent sans description. Vous pouvez également réduire le texte `description` et `when_to_use` à la source : mettez en avant le cas d'utilisation clé, puisque le texte combiné de chaque entrée est limité à 1 536 caractères indépendamment du budget. Le plafond est configurable avec [`skillListingMaxDescChars`](/fr/settings#available-settings).923Pour augmenter le budget, définissez le paramètre [`skillListingBudgetFraction`](/fr/settings#available-settings) (par exemple `0.02` = 2 %) ou la variable d'environnement `SLASH_COMMAND_TOOL_CHAR_BUDGET` à un nombre de caractères fixe. Pour libérer du budget pour d'autres skills, définissez les entrées de faible priorité sur `"name-only"` dans [`skillOverrides`](#override-skill-visibility-from-settings) afin qu'elles s'affichent sans description. Vous pouvez également réduire le texte `description` et `when_to_use` à la source : mettez en avant le cas d'utilisation clé, puisque le texte combiné de chaque entrée est limité à 1 536 caractères indépendamment du budget. Le plafond est configurable avec [`skillListingMaxDescChars`](/fr/settings#available-settings).

916 924 

statusline.md +3 −1

Details

1044}1044}

1045```1045```

1046 1046 

1047La commande s'exécute une fois par cycle d'actualisation avec toutes les lignes de sous-agent visibles passées en tant qu'objet JSON unique sur stdin. L'entrée inclut les [champs d'entrée de hook de base](/fr/hooks#common-input-fields) plus `columns` (la largeur de ligne utilisable) et un tableau `tasks`, où chaque tâche a `id`, `name`, `type`, `status`, `description`, `label`, `startTime`, `tokenCount`, `tokenSamples` et `cwd`.1047La commande s'exécute une fois par cycle d'actualisation avec toutes les lignes de sous-agent visibles passées en tant qu'objet JSON unique sur stdin. L'entrée inclut les [champs d'entrée de hook de base](/fr/hooks#common-input-fields), un champ `columns` avec la largeur de ligne utilisable, et un tableau `tasks`. Chaque tâche a `id`, `name`, `type`, `status`, `description`, `label`, `startTime`, `model`, `contextWindowSize`, `tokenCount`, `tokenSamples` et `cwd`.

1048 

1049Le champ `model` par tâche est l'ID de modèle résolu sur lequel la tâche s'exécute. `contextWindowSize` est la fenêtre de contexte de ce modèle en tokens, calculée de la même manière que `context_window.context_window_size` de la barre de statut principale, vous pouvez donc rendre un pourcentage par ligne à partir de `tokenCount`. Les deux champs nécessitent Claude Code v2.1.205 ou une version ultérieure et sont omis pour une tâche dont le modèle n'est pas encore résolu.

1048 1050 

1049Écrivez une ligne JSON sur stdout par ligne que vous voulez remplacer, sous la forme `{"id": "<task id>", "content": "<row body>"}`. La chaîne `content` est rendue telle quelle, y compris les couleurs ANSI et les hyperliens OSC 8. Omettez le `id` d'une tâche pour conserver le rendu par défaut pour cette ligne ; émettez une chaîne `content` vide pour la masquer.1051Écrivez une ligne JSON sur stdout par ligne que vous voulez remplacer, sous la forme `{"id": "<task id>", "content": "<row body>"}`. La chaîne `content` est rendue telle quelle, y compris les couleurs ANSI et les hyperliens OSC 8. Omettez le `id` d'une tâche pour conserver le rendu par défaut pour cette ligne ; émettez une chaîne `content` vide pour la masquer.

1050 1052 

sub-agents.md +9 −3

Details

183 183 

184Claude Code analyse `.claude/agents/` et `~/.claude/agents/` de manière récursive, vous pouvez donc organiser les définitions dans des sous-dossiers tels que `agents/review/` ou `agents/research/`. Le chemin du sous-répertoire n'affecte pas la façon dont un sous-agent est identifié ou invoqué, car l'identité provient uniquement du champ frontmatter `name`.184Claude Code analyse `.claude/agents/` et `~/.claude/agents/` de manière récursive, vous pouvez donc organiser les définitions dans des sous-dossiers tels que `agents/review/` ou `agents/research/`. Le chemin du sous-répertoire n'affecte pas la façon dont un sous-agent est identifié ou invoqué, car l'identité provient uniquement du champ frontmatter `name`.

185 185 

186Gardez les valeurs `name` uniques dans tout l'arborescence : si deux fichiers dans une même portée déclarent le même nom, Claude Code en charge un seul. {/* min-version: 2.1.196 */}À partir de la v2.1.196, l'exécution de `/doctor` signale les noms d'agents en doublon dans la même portée et affiche quelle définition est active.186Gardez les valeurs `name` uniques dans tout l'arborescence : si deux fichiers dans une même portée déclarent le même nom, Claude Code en charge un seul, choisi par l'ordre de lecture du système de fichiers plutôt que par une précédence documentée. Entre les répertoires de projet imbriqués, la définition la plus proche du répertoire de travail gagne, comme décrit ci-dessus. {/* min-version: 2.1.205 */}La vérification de configuration [`/doctor`](/fr/commands#all-commands) signale les fichiers dans le même répertoire qui partagent un nom et propose de renommer ou de supprimer tous sauf un. Avant la v2.1.205, `/doctor` ouvrait un écran de diagnostics qui listait les doublons et montrait quelle définition était active.

187 187 

188Les répertoires `agents/` des plugins sont également analysés de manière récursive. Contrairement aux portées de projet et utilisateur, un sous-dossier à l'intérieur du répertoire `agents/` d'un plugin devient partie de l'[identifiant limité](#invoke-subagents-explicitly) : un fichier à `agents/review/security.md` dans le plugin `my-plugin` s'enregistre comme `my-plugin:review:security`.188Les répertoires `agents/` des plugins sont également analysés de manière récursive. Contrairement aux portées de projet et utilisateur, un sous-dossier à l'intérieur du répertoire `agents/` d'un plugin devient partie de l'[identifiant limité](#invoke-subagents-explicitly) : un fichier à `agents/review/security.md` dans le plugin `my-plugin` s'enregistre comme `my-plugin:review:security`.

189 189 


268 268 

269Le frontmatter définit les métadonnées et la configuration du sous-agent. Le corps devient l'invite système qui guide le comportement du sous-agent. Les sous-agents reçoivent uniquement cette invite système plus les détails d'environnement de base comme le répertoire de travail, pas l'invite système complète de Claude Code.269Le frontmatter définit les métadonnées et la configuration du sous-agent. Le corps devient l'invite système qui guide le comportement du sous-agent. Les sous-agents reçoivent uniquement cette invite système plus les détails d'environnement de base comme le répertoire de travail, pas l'invite système complète de Claude Code.

270 270 

271En [mode non interactif](/fr/headless), le drapeau [`--append-subagent-system-prompt`](/fr/cli-reference#cli-flags) ajoute le texte que vous fournissez à la fin de l'invite système de chaque sous-agent, y compris les sous-agents imbriqués. Nécessite Claude Code v2.1.205 ou ultérieur.

272 

271Un sous-agent démarre dans le répertoire de travail actuel de la conversation principale. Au sein d'un sous-agent, les commandes `cd` ne persistent pas entre les appels d'outils Bash ou PowerShell et n'affectent pas le répertoire de travail de la conversation principale. Pour donner au sous-agent une copie isolée du référentiel à la place, définissez [`isolation: worktree`](#supported-frontmatter-fields).273Un sous-agent démarre dans le répertoire de travail actuel de la conversation principale. Au sein d'un sous-agent, les commandes `cd` ne persistent pas entre les appels d'outils Bash ou PowerShell et n'affectent pas le répertoire de travail de la conversation principale. Pour donner au sous-agent une copie isolée du référentiel à la place, définissez [`isolation: worktree`](#supported-frontmatter-fields).

272 274 

275{/* min-version: 2.1.203 */}Un sous-agent avec `isolation: worktree` exécute ses commandes Bash et PowerShell à l'intérieur de son worktree. Une commande dont le répertoire de travail se résout à votre extraction principale à la place, par exemple parce que le répertoire worktree a été supprimé pendant que le sous-agent s'exécutait, échoue avec une erreur. Avant la v2.1.203, une telle commande pouvait s'exécuter dans l'extraction principale.

276 

273<h4 id="supported-frontmatter-fields">277<h4 id="supported-frontmatter-fields">

274 Champs de frontmatter pris en charge278 Champs de frontmatter pris en charge

275</h4>279</h4>


283| `tools` | Non | [Outils](#available-tools) que le sous-agent peut utiliser. Hérite de tous les outils s'il est omis. Pour précharger les Skills dans le contexte, utilisez le champ `skills` plutôt que de lister `Skill` ici |287| `tools` | Non | [Outils](#available-tools) que le sous-agent peut utiliser. Hérite de tous les outils s'il est omis. Pour précharger les Skills dans le contexte, utilisez le champ `skills` plutôt que de lister `Skill` ici |

284| `disallowedTools` | Non | Outils à refuser, supprimés de la liste héritée ou spécifiée |288| `disallowedTools` | Non | Outils à refuser, supprimés de la liste héritée ou spécifiée |

285| `model` | Non | [Modèle](#choose-a-model) à utiliser : `sonnet`, `opus`, `haiku`, `fable`, un ID de modèle complet (par exemple, `claude-opus-4-8`), ou `inherit`. Par défaut `inherit` |289| `model` | Non | [Modèle](#choose-a-model) à utiliser : `sonnet`, `opus`, `haiku`, `fable`, un ID de modèle complet (par exemple, `claude-opus-4-8`), ou `inherit`. Par défaut `inherit` |

286| `permissionMode` | Non | [Mode de permission](#permission-modes) : `default`, `acceptEdits`, `auto`, `dontAsk`, `bypassPermissions` ou `plan`. Ignoré pour les [sous-agents de plugin](#choose-the-subagent-scope) |290| `permissionMode` | Non | [Mode de permission](#permission-modes) : `default`, `acceptEdits`, `auto`, `dontAsk`, `bypassPermissions`, `plan`, ou {/* min-version: 2.1.200 */}`manual` comme alias pour `default`. L'alias `manual` nécessite Claude Code v2.1.200 ou ultérieur. Ignoré pour les [sous-agents de plugin](#choose-the-subagent-scope) |

287| `maxTurns` | Non | Nombre maximum de tours d'agent avant que le sous-agent s'arrête |291| `maxTurns` | Non | Nombre maximum de tours d'agent avant que le sous-agent s'arrête |

288| `skills` | Non | [Skills](/fr/skills) à précharger dans le contexte du sous-agent au démarrage. Le contenu complet de la skill est injecté, pas seulement la description. Les sous-agents peuvent toujours invoquer les skills de projet, utilisateur et plugin non listées via l'outil Skill |292| `skills` | Non | [Skills](/fr/skills) à précharger dans le contexte du sous-agent au démarrage. Le contenu complet de la skill est injecté, pas seulement la description. Les sous-agents peuvent toujours invoquer les skills de projet, utilisateur et plugin non listées via l'outil Skill |

289| `mcpServers` | Non | [Serveurs MCP](/fr/mcp) disponibles pour ce sous-agent. Chaque entrée est soit un nom de serveur référençant un serveur déjà configuré (par exemple, `"slack"`) soit une définition en ligne avec le nom du serveur comme clé et une [configuration de serveur MCP](/fr/mcp#installing-mcp-servers) complète comme valeur. Ignoré pour les [sous-agents de plugin](#choose-the-subagent-scope) |293| `mcpServers` | Non | [Serveurs MCP](/fr/mcp) disponibles pour ce sous-agent. Chaque entrée est soit un nom de serveur référençant un serveur déjà configuré (par exemple, `"slack"`) soit une définition en ligne avec le nom du serveur comme clé et une [configuration de serveur MCP](/fr/mcp#installing-mcp-servers) complète comme valeur. Ignoré pour les [sous-agents de plugin](#choose-the-subagent-scope) |


792 796 

793{/* min-version: 2.1.199 */}À partir de la v2.1.199, un sous-agent dont l'exécution se termine sur une erreur API, comme une limite d'utilisation ou une erreur serveur répétée, signale cet échec à Claude au lieu de retourner le texte d'erreur comme s'il s'agissait des résultats du sous-agent. Ce que Claude reçoit dépend de l'endroit où le sous-agent s'est exécuté :797{/* min-version: 2.1.199 */}À partir de la v2.1.199, un sous-agent dont l'exécution se termine sur une erreur API, comme une limite d'utilisation ou une erreur serveur répétée, signale cet échec à Claude au lieu de retourner le texte d'erreur comme s'il s'agissait des résultats du sous-agent. Ce que Claude reçoit dépend de l'endroit où le sous-agent s'est exécuté :

794 798 

795* **Premier plan** : si une limite de débit, une surcharge ou une erreur serveur coupe un sous-agent qui a déjà produit une sortie, l'outil Agent retourne cette sortie partielle avec une note indiquant que le sous-agent a été coupé et n'a pas terminé sa tâche. Sinon, l'appel d'outil échoue avec [`Agent terminated early due to an API error`](/fr/errors#agent-terminated-early-due-to-an-api-error), suivi du détail de l'erreur.799* **Premier plan** : si une limite de débit, une surcharge ou une erreur serveur coupe un sous-agent qui a déjà produit une sortie, l'outil Agent retourne cette sortie partielle avec une note indiquant que le sous-agent a été coupé et n'a pas terminé sa tâche. {/* min-version: 2.1.200 */}Un sous-agent qui n'a rien produit, ou dont la seule sortie était des appels d'outils, échoue avec [`Agent terminated early due to an API error`](/fr/errors#agent-terminated-early-due-to-an-api-error), suivi du détail de l'erreur. Dans la v2.1.199, une limite de débit, une surcharge ou une erreur serveur qui a coupé la forme appels-d'outils-uniquement a retourné un résultat partiel vide contenant uniquement la note de coupure à la place.

796* **Arrière-plan** : le sous-agent est marqué comme échoué, et le message que Claude reçoit lorsqu'il se termine nomme l'erreur API et inclut la dernière sortie du sous-agent, de sorte que le travail partiel n'est pas perdu.800* **Arrière-plan** : le sous-agent est marqué comme échoué, et le message que Claude reçoit lorsqu'il se termine nomme l'erreur API et inclut la dernière sortie du sous-agent, de sorte que le travail partiel n'est pas perdu.

797 801 

798Une fois que l'erreur API sous-jacente est résolue, demandez à Claude de réessayer la tâche ou de [reprendre le sous-agent](#resume-subagents).802Une fois que l'erreur API sous-jacente est résolue, demandez à Claude de réessayer la tâche ou de [reprendre le sous-agent](#resume-subagents).


924 928 

925Si un sous-agent arrêté reçoit un `SendMessage`, il se reprend automatiquement en arrière-plan sans nécessiter une nouvelle invocation `Agent`.929Si un sous-agent arrêté reçoit un `SendMessage`, il se reprend automatiquement en arrière-plan sans nécessiter une nouvelle invocation `Agent`.

926 930 

931Reprendre démarre une nouvelle exécution de l'agent sous le même ID, de sorte qu'un sous-agent qui avait déjà échoué ou s'était terminé s'affiche à nouveau comme en cours d'exécution dans la liste des tâches et dans les événements de tâche du SDK Agent. Avant la v2.1.205, il continuait à afficher son statut antérieur échoué ou terminé pendant que l'exécution reprise fonctionnait.

932 

927{/* min-version: 2.1.199 */}À partir de la v2.1.199, `SendMessage` vérifie qu'un nom fait toujours référence au même agent qu'il a atteint plus tôt dans la conversation. Si un agent plus récent a pris le nom, comme un sous-agent en arrière-plan réengendré qui l'a réutilisé, Claude Code refuse l'envoi plutôt que de le livrer au mauvais agent, et l'erreur signale quel agent le nom atteint maintenant pour que Claude puisse le rediriger. Pour atteindre l'agent antérieur pendant qu'il s'exécute toujours, Claude l'adresse par l'ID d'agent de son résultat de génération. La vérification est limitée à la conversation actuelle et se réinitialise sur `/clear`.933{/* min-version: 2.1.199 */}À partir de la v2.1.199, `SendMessage` vérifie qu'un nom fait toujours référence au même agent qu'il a atteint plus tôt dans la conversation. Si un agent plus récent a pris le nom, comme un sous-agent en arrière-plan réengendré qui l'a réutilisé, Claude Code refuse l'envoi plutôt que de le livrer au mauvais agent, et l'erreur signale quel agent le nom atteint maintenant pour que Claude puisse le rediriger. Pour atteindre l'agent antérieur pendant qu'il s'exécute toujours, Claude l'adresse par l'ID d'agent de son résultat de génération. La vérification est limitée à la conversation actuelle et se réinitialise sur `/clear`.

928 934 

929{/* min-version: 2.1.198 */}À partir de la v2.1.198, un sous-agent traite les messages de l'agent qui l'a lancé comme une direction de tâche normale, y compris les corrections de cours en cours de tâche, et agit en fonction de ceux-ci dans ses propres paramètres de permission. Deux limites tiennent toujours indépendamment de qui a envoyé le message : aucun message d'aucun agent ne compte comme votre approbation pour une invite de permission en attente, et aucun message d'agent ne peut modifier les paramètres de permission d'un sous-agent, `CLAUDE.md`, ou la configuration. Seul le système de permission ou vos propres messages peuvent accorder l'approbation.935{/* min-version: 2.1.198 */}À partir de la v2.1.198, un sous-agent traite les messages de l'agent qui l'a lancé comme une direction de tâche normale, y compris les corrections de cours en cours de tâche, et agit en fonction de ceux-ci dans ses propres paramètres de permission. Deux limites tiennent toujours indépendamment de qui a envoyé le message : aucun message d'aucun agent ne compte comme votre approbation pour une invite de permission en attente, et aucun message d'agent ne peut modifier les paramètres de permission d'un sous-agent, `CLAUDE.md`, ou la configuration. Seul le système de permission ou vos propres messages peuvent accorder l'approbation.

Details

102 <th>Anthropic Console</th>102 <th>Anthropic Console</th>

103 <th>Amazon Bedrock</th>103 <th>Amazon Bedrock</th>

104 <th>Claude Platform on AWS</th>104 <th>Claude Platform on AWS</th>

105 <th>Google Vertex AI</th>105 <th>Google Cloud's Agent Platform, anciennement Vertex AI</th>

106 <th>Microsoft Foundry</th>106 <th>Microsoft Foundry</th>

107 </tr>107 </tr>

108 </thead>108 </thead>


196 196 

197* [Claude for Teams ou Enterprise](/fr/authentication#claude-for-teams-or-enterprise)197* [Claude for Teams ou Enterprise](/fr/authentication#claude-for-teams-or-enterprise)

198* [Anthropic Console](/fr/authentication#claude-console-authentication)198* [Anthropic Console](/fr/authentication#claude-console-authentication)

199* [Passerelle d'applications Claude](/fr/claude-apps-gateway), une passerelle auto-hébergée qui ajoute la connexion IdP devant Amazon Bedrock, Claude Platform on AWS, Google Vertex AI, Microsoft Foundry ou l'API Anthropic199* [Passerelle d'applications Claude](/fr/claude-apps-gateway), une passerelle auto-hébergée qui ajoute la connexion IdP devant Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform, Microsoft Foundry ou l'API Anthropic

200* [Amazon Bedrock](/fr/amazon-bedrock)200* [Amazon Bedrock](/fr/amazon-bedrock)

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

202* [Google Vertex AI](/fr/google-vertex-ai)202* [Google Cloud's Agent Platform](/fr/google-vertex-ai)

203* [Microsoft Foundry](/fr/microsoft-foundry)203* [Microsoft Foundry](/fr/microsoft-foundry)

204 204 

205<h2 id="configure-proxies-and-gateways">205<h2 id="configure-proxies-and-gateways">


219 219 

220<Tabs>220<Tabs>

221 <Tab title="Proxy d'entreprise">221 <Tab title="Proxy d'entreprise">

222 Acheminez le trafic Bedrock via votre proxy d'entreprise en définissant les [variables d'environnement](/fr/env-vars) suivantes :222 Acheminez le trafic Amazon Bedrock via votre proxy d'entreprise en définissant les [variables d'environnement](/fr/env-vars) suivantes :

223 223 

224 ```bash theme={null}224 ```bash theme={null}

225 # Enable Bedrock225 # Enable Bedrock


232 </Tab>232 </Tab>

233 233 

234 <Tab title="Passerelle LLM">234 <Tab title="Passerelle LLM">

235 Acheminez le trafic Bedrock via votre passerelle LLM en définissant les [variables d'environnement](/fr/env-vars) suivantes :235 Acheminez le trafic Amazon Bedrock via votre passerelle LLM en définissant les [variables d'environnement](/fr/env-vars) suivantes :

236 236 

237 ```bash theme={null}237 ```bash theme={null}

238 # Enable Bedrock238 # Enable Bedrock


251 251 

252<Tabs>252<Tabs>

253 <Tab title="Proxy d'entreprise">253 <Tab title="Proxy d'entreprise">

254 Acheminez le trafic Foundry via votre proxy d'entreprise en définissant les [variables d'environnement](/fr/env-vars) suivantes :254 Acheminez le trafic Microsoft Foundry via votre proxy d'entreprise en définissant les [variables d'environnement](/fr/env-vars) suivantes :

255 255 

256 ```bash theme={null}256 ```bash theme={null}

257 # Enable Microsoft Foundry257 # Enable Microsoft Foundry


265 </Tab>265 </Tab>

266 266 

267 <Tab title="Passerelle LLM">267 <Tab title="Passerelle LLM">

268 Acheminez le trafic Foundry via votre passerelle LLM en définissant les [variables d'environnement](/fr/env-vars) suivantes :268 Acheminez le trafic Microsoft Foundry via votre passerelle LLM en définissant les [variables d'environnement](/fr/env-vars) suivantes :

269 269 

270 ```bash theme={null}270 ```bash theme={null}

271 # Enable Microsoft Foundry271 # Enable Microsoft Foundry


278 </Tab>278 </Tab>

279</Tabs>279</Tabs>

280 280 

281<h3 id="google-vertex-ai">281<h3 id="google-cloud’s-agent-platform">

282 Google Vertex AI282 Google Cloud's Agent Platform

283</h3>283</h3>

284 284 

285<Tabs>285<Tabs>

286 <Tab title="Proxy d'entreprise">286 <Tab title="Proxy d'entreprise">

287 Acheminez le trafic Vertex AI via votre proxy d'entreprise en définissant les [variables d'environnement](/fr/env-vars) suivantes :287 Acheminez le trafic Google Cloud's Agent Platform via votre proxy d'entreprise en définissant les [variables d'environnement](/fr/env-vars) suivantes :

288 288 

289 ```bash theme={null}289 ```bash theme={null}

290 # Enable Vertex290 # Enable Agent Platform

291 export CLAUDE_CODE_USE_VERTEX=1291 export CLAUDE_CODE_USE_VERTEX=1

292 export CLOUD_ML_REGION=us-east5292 export CLOUD_ML_REGION=us-east5

293 export ANTHROPIC_VERTEX_PROJECT_ID=your-project-id293 export ANTHROPIC_VERTEX_PROJECT_ID=your-project-id


298 </Tab>298 </Tab>

299 299 

300 <Tab title="Passerelle LLM">300 <Tab title="Passerelle LLM">

301 Acheminez le trafic Vertex AI via votre passerelle LLM en définissant les [variables d'environnement](/fr/env-vars) suivantes :301 Acheminez le trafic Google Cloud's Agent Platform via votre passerelle LLM en définissant les [variables d'environnement](/fr/env-vars) suivantes :

302 302 

303 ```bash theme={null}303 ```bash theme={null}

304 # Enable Vertex304 # Enable Agent Platform

305 export CLAUDE_CODE_USE_VERTEX=1305 export CLAUDE_CODE_USE_VERTEX=1

306 306 

307 # Configure LLM gateway307 # Configure LLM gateway


348 Épingler les versions de modèle pour les fournisseurs de cloud348 Épingler les versions de modèle pour les fournisseurs de cloud

349</h3>349</h3>

350 350 

351Si vous déployez via [Bedrock](/fr/amazon-bedrock), [Vertex AI](/fr/google-vertex-ai), [Foundry](/fr/microsoft-foundry) ou [Claude Platform on AWS](/fr/claude-platform-on-aws), épinglez les versions de modèle spécifiques en utilisant `ANTHROPIC_DEFAULT_FABLE_MODEL`, `ANTHROPIC_DEFAULT_OPUS_MODEL`, `ANTHROPIC_DEFAULT_SONNET_MODEL` et `ANTHROPIC_DEFAULT_HAIKU_MODEL`. Sans épinglage, les alias de modèle se résolvent à la valeur par défaut intégrée de Claude Code pour ce fournisseur, ce qui peut être en retard par rapport à la version la plus récente et peut ne pas encore être activé dans votre compte. L'épinglage vous permet de contrôler quand vos utilisateurs passent à un nouveau modèle. Voir [Configuration du modèle](/fr/model-config#pin-models-for-third-party-deployments) pour ce que chaque fournisseur fait lorsque la valeur par défaut n'est pas disponible.351Si vous déployez via [Amazon Bedrock](/fr/amazon-bedrock), [Google Cloud's Agent Platform](/fr/google-vertex-ai), [Microsoft Foundry](/fr/microsoft-foundry) ou [Claude Platform on AWS](/fr/claude-platform-on-aws), épinglez les versions de modèle spécifiques en utilisant `ANTHROPIC_DEFAULT_FABLE_MODEL`, `ANTHROPIC_DEFAULT_OPUS_MODEL`, `ANTHROPIC_DEFAULT_SONNET_MODEL` et `ANTHROPIC_DEFAULT_HAIKU_MODEL`. Sans épinglage, les alias de modèle se résolvent à la valeur par défaut intégrée de Claude Code pour ce fournisseur, ce qui peut être en retard par rapport à la version la plus récente et peut ne pas encore être activé dans votre compte. L'épinglage vous permet de contrôler quand vos utilisateurs passent à un nouveau modèle. Voir [Configuration du modèle](/fr/model-config#pin-models-for-third-party-deployments) pour ce que chaque fournisseur fait lorsque la valeur par défaut n'est pas disponible.

352 352 

353<h3 id="configure-security-policies">353<h3 id="configure-security-policies">

354 Configurer les politiques de sécurité354 Configurer les politiques de sécurité

tools-reference.md +11 −11

Details

11Pour ajouter des outils personnalisés, connectez un [serveur MCP](/fr/mcp). Pour étendre Claude avec des flux de travail réutilisables basés sur des invites, écrivez une [skill](/fr/skills), qui s'exécute via l'outil `Skill` existant plutôt que d'ajouter une nouvelle entrée d'outil.11Pour ajouter des outils personnalisés, connectez un [serveur MCP](/fr/mcp). Pour étendre Claude avec des flux de travail réutilisables basés sur des invites, écrivez une [skill](/fr/skills), qui s'exécute via l'outil `Skill` existant plutôt que d'ajouter une nouvelle entrée d'outil.

12 12 

13| Outil | Description | Permission requise |13| Outil | Description | Permission requise |

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

15| `Agent` | Crée un [subagent](/fr/sub-agents) avec sa propre fenêtre de contexte pour gérer une tâche. Voir [comportement de l'outil Agent](#agent-tool-behavior) | Non |15| `Agent` | Crée un [subagent](/fr/sub-agents) avec sa propre fenêtre de contexte pour gérer une tâche. Voir [comportement de l'outil Agent](#agent-tool-behavior) | Non |

16| `Artifact` | Publie un fichier HTML ou Markdown en tant qu'[artifact](/fr/artifacts) : une page interactive privée sur claude.ai. Sur les plans Team et Enterprise, vous pouvez le partager au sein de votre organisation. {/* plan-availability: feature=artifacts plans=pro,max,team,enterprise providers=anthropic */}Nécessite un plan Pro, Max, Team ou Enterprise et une authentification `/login` ; voir [Disponibilité](/fr/artifacts#availability) | Oui |16| `Artifact` | Publie un fichier HTML ou Markdown en tant qu'[artifact](/fr/artifacts) : une page interactive privée sur claude.ai. Sur les plans Team et Enterprise, vous pouvez le partager au sein de votre organisation. {/* plan-availability: feature=artifacts plans=pro,max,team,enterprise providers=anthropic */}Nécessite un plan Pro, Max, Team ou Enterprise et une authentification `/login` ; voir [Disponibilité](/fr/artifacts#availability) | Oui |

17| `AskUserQuestion` | Pose des questions à choix multiples pour recueillir les exigences ou clarifier l'ambiguïté. {/* min-version: 2.1.198 */}À partir de v2.1.198, si vous ne répondez pas dans les 60 secondes, la boîte de dialogue se ferme d'elle-même : elle soumet toutes les options que vous aviez déjà sélectionnées et indique à Claude que vous êtes peut-être absent de votre clavier, afin que Claude procède selon son propre jugement et puisse poser à nouveau la question plus tard. Un compte à rebours apparaît pour les 20 dernières secondes. N'importe quelle frappe de touche maintient la boîte de dialogue ouverte, tout comme une fenêtre active sur les terminaux qui signalent le focus. Définissez la variable d'environnement [`CLAUDE_AFK_TIMEOUT_MS`](/fr/env-vars#variables) pour modifier la durée d'attente de Claude Code, ou à une valeur importante comme `86400000`, 24 heures, pour garder les questions ouvertes pendant que vous êtes absent. Ce délai d'expiration s'applique uniquement aux questions à choix multiples de `AskUserQuestion` ; les invites de permission, y compris l'approbation du plan, ne se résolvent jamais automatiquement en cas d'inactivité | Non |17| `AskUserQuestion` | Pose des questions à choix multiples pour recueillir les exigences ou clarifier l'ambiguïté. {/* min-version: 2.1.200 */}Les questions restent ouvertes jusqu'à ce que vous y répondiez : il n'y a pas de délai d'inactivité par défaut. Pour que le dialogue auto-continue en cas d'inactivité, définissez le paramètre [`askUserQuestionTimeout`](/fr/settings#available-settings) sur `60s`, `5m`, ou `10m`, soit dans votre `settings.json` utilisateur, soit à partir de la ligne **Question auto-continue timeout** dans `/config`. Une fois le délai d'inactivité choisi écoulé sans entrée, le dialogue se ferme de lui-même : il soumet toutes les options que vous aviez déjà sélectionnées et indique à Claude que vous êtes peut-être absent de votre clavier, afin que Claude procède selon son propre jugement et puisse poser à nouveau la question plus tard. Un compte à rebours apparaît pour les 20 dernières secondes. N'importe quelle frappe de touche redémarre la minuterie, tout comme une fenêtre active sur les terminaux qui signalent le focus. Le délai d'expiration s'applique uniquement aux questions à choix multiples de `AskUserQuestion` ; les invites de permission, y compris l'approbation du plan, ne se résolvent jamais automatiquement en cas d'inactivité. Dans les versions v2.1.198 et v2.1.199, le dialogue auto-continuait après 60 secondes d'inactivité par défaut, et [`CLAUDE_AFK_TIMEOUT_MS`](/fr/env-vars#variables) était le seul moyen de modifier cela | Non |

18| `Bash` | Exécute des commandes shell dans votre environnement. Voir [comportement de l'outil Bash](#bash-tool-behavior) | Oui |18| `Bash` | Exécute des commandes shell dans votre environnement. Voir [comportement de l'outil Bash](#bash-tool-behavior) | Oui |

19| `CronCreate` | Planifie une invite récurrente ou ponctuelle dans la session actuelle. Les tâches sont limitées à la session et restaurées sur `--resume` ou `--continue` si non expirées. Voir [tâches planifiées](/fr/scheduled-tasks) | Non |19| `CronCreate` | Planifie une invite récurrente ou ponctuelle dans la session actuelle. Les tâches sont limitées à la session et restaurées sur `--resume` ou `--continue` si non expirées. Voir [tâches planifiées](/fr/scheduled-tasks) | Non |

20| `CronDelete` | Annule une tâche planifiée par ID | Non |20| `CronDelete` | Annule une tâche planifiée par ID | Non |

21| `CronList` | Liste toutes les tâches planifiées dans la session | Non |21| `CronList` | Liste toutes les tâches planifiées dans la session | Non |

22| `Edit` | Effectue des modifications ciblées sur des fichiers spécifiques. Voir [comportement de l'outil Edit](#edit-tool-behavior) | Oui |22| `Edit` | Effectue des modifications ciblées sur des fichiers spécifiques. Voir [comportement de l'outil Edit](#edit-tool-behavior) | Oui |

23| `EnterPlanMode` | Bascule en mode plan pour concevoir une approche avant de coder | Non |23| `EnterPlanMode` | Bascule en mode plan pour concevoir une approche avant de coder | Non |

24| `EnterWorktree` | Crée un [git worktree](/fr/worktrees) isolé et y bascule. Passez un `path` pour basculer dans un worktree existant du référentiel actuel au lieu d'en créer un nouveau. De dans une session worktree, ou à partir d'un subagent avec un répertoire de travail épinglé tel que [`isolation: worktree`](/fr/sub-agents#supported-frontmatter-fields), seule la forme `path` est disponible et la cible doit être sous `.claude/worktrees/` | Non |24| `EnterWorktree` | Crée un [git worktree](/fr/worktrees) isolé et y bascule. Passez un `path` pour basculer dans un worktree existant au lieu d'en créer un nouveau. {/* min-version: 2.1.203 */}À la première entrée, la cible peut être un worktree du référentiel actuel ou, dans un espace de travail multi-référentiel, d'un référentiel imbriqué à l'intérieur. Avant v2.1.203, un worktree d'un référentiel imbriqué était rejeté. À partir d'une session worktree, ou d'un subagent avec un répertoire de travail épinglé tel que [`isolation: worktree`](/fr/sub-agents#supported-frontmatter-fields), seule la forme `path` est disponible et la cible doit être sous `.claude/worktrees/` du référentiel de la session | Non |

25| `ExitPlanMode` | Présente un plan pour approbation et quitte le mode plan | Oui |25| `ExitPlanMode` | Présente un plan pour approbation et quitte le mode plan | Oui |

26| `ExitWorktree` | Quitte une session worktree et revient au répertoire d'origine. Non disponible pour les subagents qui s'exécutent déjà dans leur propre répertoire de travail, comme avec [`isolation: worktree`](/fr/sub-agents#supported-frontmatter-fields) | Non |26| `ExitWorktree` | Quitte une session worktree et revient au répertoire d'origine. Non disponible pour les subagents qui s'exécutent déjà dans leur propre répertoire de travail, comme avec [`isolation: worktree`](/fr/sub-agents#supported-frontmatter-fields) | Non |

27| `Glob` | Trouve des fichiers en fonction de la correspondance de motifs. Voir [comportement de l'outil Glob](#glob-tool-behavior) | Non |27| `Glob` | Trouve des fichiers en fonction de la correspondance de motifs. Voir [comportement de l'outil Glob](#glob-tool-behavior) | Non |


31| `Monitor` | Exécute une commande en arrière-plan et renvoie chaque ligne de sortie à Claude, afin qu'il puisse réagir aux entrées de journal, aux modifications de fichiers, ou au statut interrogé en milieu de conversation. Peut également ouvrir une WebSocket et traiter chaque message entrant comme un événement. Voir [outil Monitor](#monitor-tool) | Oui |31| `Monitor` | Exécute une commande en arrière-plan et renvoie chaque ligne de sortie à Claude, afin qu'il puisse réagir aux entrées de journal, aux modifications de fichiers, ou au statut interrogé en milieu de conversation. Peut également ouvrir une WebSocket et traiter chaque message entrant comme un événement. Voir [outil Monitor](#monitor-tool) | Oui |

32| `NotebookEdit` | Modifie les cellules de notebook Jupyter. Voir [comportement de l'outil NotebookEdit](#notebookedit-tool-behavior) | Oui |32| `NotebookEdit` | Modifie les cellules de notebook Jupyter. Voir [comportement de l'outil NotebookEdit](#notebookedit-tool-behavior) | Oui |

33| `PowerShell` | Exécute des commandes PowerShell nativement. Voir [outil PowerShell](#powershell-tool) pour la disponibilité | Oui |33| `PowerShell` | Exécute des commandes PowerShell nativement. Voir [outil PowerShell](#powershell-tool) pour la disponibilité | Oui |

34| `PushNotification` | Envoie une notification de bureau, et une notification push sur téléphone quand [Remote Control](/fr/remote-control) est connecté, afin qu'une tâche de longue durée ou une [tâche planifiée](/fr/scheduled-tasks) puisse vous atteindre quand vous vous éloignez. {/* plan-availability: feature=push-notifications providers=anthropic */}La livraison push s'effectue via l'infrastructure hébergée par Anthropic, qui n'est pas accessible depuis Amazon Bedrock, Google Vertex AI, ou Microsoft Foundry | Non |34| `PushNotification` | Envoie une notification de bureau, et une notification push sur téléphone quand [Remote Control](/fr/remote-control) est connecté, afin qu'une tâche de longue durée ou une [tâche planifiée](/fr/scheduled-tasks) puisse vous atteindre quand vous vous éloignez. {/* plan-availability: feature=push-notifications providers=anthropic */}La livraison push s'effectue via l'infrastructure hébergée par Anthropic, qui n'est pas accessible depuis Amazon Bedrock, Google Cloud's Agent Platform, ou Microsoft Foundry | Non |

35| `Read` | Lit le contenu des fichiers. Voir [comportement de l'outil Read](#read-tool-behavior) | Non |35| `Read` | Lit le contenu des fichiers. Voir [comportement de l'outil Read](#read-tool-behavior) | Non |

36| `ReadMcpResourceTool` | Lit une ressource MCP spécifique par URI | Non |36| `ReadMcpResourceTool` | Lit une ressource MCP spécifique par URI | Non |

37| `RemoteTrigger` | Crée, met à jour, exécute et liste les [Routines](/fr/routines) sur claude.ai. Soutient la commande `/schedule`. {/* plan-availability: feature=routines plans=pro,max,team,enterprise providers=anthropic */}Les Routines vivent sur claude.ai et nécessitent un plan Pro, Max, Team ou Enterprise, donc cet outil n'est pas accessible depuis Amazon Bedrock, Google Vertex AI, ou Microsoft Foundry | Non |37| `RemoteTrigger` | Crée, met à jour, exécute et liste les [Routines](/fr/routines) sur claude.ai. Soutient la commande `/schedule`. {/* plan-availability: feature=routines plans=pro,max,team,enterprise providers=anthropic */}Les Routines vivent sur claude.ai et nécessitent un plan Pro, Max, Team ou Enterprise, donc cet outil n'est pas accessible depuis Amazon Bedrock, Google Cloud's Agent Platform, ou Microsoft Foundry | Non |

38| `ReportFindings` | Signale les résultats de l'examen du code sous forme de liste structurée, avec un fichier, un résumé et un scénario d'échec par résultat, afin que Claude Code puisse les afficher au lieu de les imprimer sous forme de texte. Claude l'appelle quand les instructions actives d'examen du code le lui demandent. {/* min-version: 2.1.196 */}Nécessite Claude Code v2.1.196 ou ultérieur. {/* min-version: 2.1.199 */}À partir de v2.1.199, un résultat peut également porter une étiquette `category` optionnelle, telle que `correctness` ou `test-coverage`, affichée à côté de l'emplacement du fichier dans la liste rendue | Non |38| `ReportFindings` | Signale les résultats de l'examen du code sous forme de liste structurée, avec un fichier, un résumé et un scénario d'échec par résultat, afin que Claude Code puisse les afficher au lieu de les imprimer sous forme de texte. Claude l'appelle quand les instructions actives d'examen du code le lui demandent. {/* min-version: 2.1.196 */}Nécessite Claude Code v2.1.196 ou ultérieur. {/* min-version: 2.1.199 */}À partir de v2.1.199, un résultat peut également porter une étiquette `category` optionnelle, telle que `correctness` ou `test-coverage`, affichée à côté de l'emplacement du fichier dans la liste rendue | Non |

39| `ScheduleWakeup` | Reprogramme la prochaine itération d'une [`/loop` auto-rythmée](/fr/scheduled-tasks#let-claude-choose-the-interval). Claude l'appelle à la fin de chaque itération pour choisir quand la prochaine s'exécute, entre une minute et une heure ; vous ne l'appelez pas directement. Le réveil en attente apparaît dans `session_crons` dans [entrée du hook Stop](/fr/hooks#stop-input). {/* plan-availability: feature=loop-dynamic providers=anthropic */}Non disponible sur Amazon Bedrock, Google Vertex AI, ou Microsoft Foundry, où une invite `/loop` sans intervalle s'exécute selon un calendrier fixe à la place | Non |39| `ScheduleWakeup` | Reprogramme la prochaine itération d'une [`/loop` auto-rythmée](/fr/scheduled-tasks#let-claude-choose-the-interval). Claude l'appelle à la fin de chaque itération pour choisir quand la prochaine s'exécute, entre une minute et une heure ; vous ne l'appelez pas directement. Pour terminer la boucle à la place, Claude l'appelle avec `stop: true`, ce qui annule le réveil en attente. {/* min-version: 2.1.202 */}Le champ `stop` nécessite Claude Code v2.1.202 ou ultérieur. Le réveil en attente apparaît dans `session_crons` dans [entrée du hook Stop](/fr/hooks#stop-input). {/* plan-availability: feature=loop-dynamic providers=anthropic */}Non disponible sur Amazon Bedrock, Google Cloud's Agent Platform, ou Microsoft Foundry, où une invite `/loop` sans intervalle s'exécute selon un calendrier fixe à la place | Non |

40| `SendMessage` | Envoie un message à un coéquipier de l'[équipe d'agents](/fr/agent-teams), ou [reprend un subagent](/fr/sub-agents#resume-subagents) par son ID d'agent ou son nom. Les subagents arrêtés se reprennent automatiquement en arrière-plan. Les messages de protocole d'équipe structurés nécessitent des équipes d'agents. Un destinataire ne traite jamais un message d'un autre agent comme votre consentement ou approbation. {/* min-version: 2.1.198 */}À partir de v2.1.198, un subagent traite un message de l'agent qui l'a lancé comme une direction de tâche normale plutôt que comme une demande entre pairs. {/* min-version: 2.1.199 */}À partir de v2.1.199, un envoi à un nom qui se résout maintenant à un agent différent de celui auquel il s'est résolu plus tôt dans la conversation est refusé au lieu d'être livré ; voir [Reprendre les subagents](/fr/sub-agents#resume-subagents) | Non |40| `SendMessage` | Envoie un message à un coéquipier de l'[équipe d'agents](/fr/agent-teams), ou [reprend un subagent](/fr/sub-agents#resume-subagents) par son ID d'agent ou son nom. Les subagents arrêtés se reprennent automatiquement en arrière-plan. Les messages de protocole d'équipe structurés nécessitent des équipes d'agents. Un destinataire ne traite jamais un message d'un autre agent comme votre consentement ou approbation. {/* min-version: 2.1.198 */}À partir de v2.1.198, un subagent traite un message de l'agent qui l'a lancé comme une direction de tâche normale plutôt que comme une demande entre pairs. {/* min-version: 2.1.199 */}À partir de v2.1.199, un envoi à un nom qui se résout maintenant à un agent différent de celui auquel il s'est résolu plus tôt dans la conversation est refusé au lieu d'être livré ; voir [Reprendre les subagents](/fr/sub-agents#resume-subagents) | Non |

41| `SendUserFile` | Envoie des fichiers de la session vers vous avec une légende optionnelle, afin qu'un rapport généré, un diagramme, une capture d'écran, ou un artefact construit atteigne votre appareil au lieu de seulement être mentionné dans la transcription. {/* min-version: 2.1.196 */}À partir de v2.1.196, l'entrée optionnelle `display` contrôle la présentation : `render` ouvre le fichier en ligne dans le client, `attach` affiche une carte de téléchargement uniquement, et quand elle n'est pas définie, le client décide selon le type de fichier. Disponible quand un client [Remote Control](/fr/remote-control) est connecté ou la session s'exécute dans un environnement cloud géré tel que [Claude Code sur le web](/fr/claude-code-on-the-web). La livraison s'effectue via l'infrastructure hébergée par Anthropic, donc l'outil n'est pas disponible sur Amazon Bedrock, Google Vertex AI, ou Microsoft Foundry | Non |41| `SendUserFile` | Envoie des fichiers de la session vers vous avec une légende optionnelle, afin qu'un rapport généré, un diagramme, une capture d'écran, ou un artefact construit atteigne votre appareil au lieu de seulement être mentionné dans la transcription. {/* min-version: 2.1.196 */}À partir de v2.1.196, l'entrée optionnelle `display` contrôle la présentation : `render` ouvre le fichier en ligne dans le client, `attach` affiche une carte de téléchargement uniquement, et quand elle n'est pas définie, le client décide selon le type de fichier. Disponible quand un client [Remote Control](/fr/remote-control) est connecté ou la session s'exécute dans un environnement cloud géré tel que [Claude Code sur le web](/fr/claude-code-on-the-web). La livraison s'effectue via l'infrastructure hébergée par Anthropic, donc l'outil n'est pas disponible sur Amazon Bedrock, Google Cloud's Agent Platform, ou Microsoft Foundry | Non |

42| `ShareOnboardingGuide` | {/* plan-availability: feature=onboarding-guide-share plans=pro,max,team,enterprise providers=anthropic */}Télécharge `ONBOARDING.md` et retourne un lien de partage que les coéquipiers peuvent ouvrir dans Claude Code. Appelé depuis `/team-onboarding` après que le guide soit écrit. Disponible pour les abonnés claude.ai sur les plans Pro, Max, Team et Enterprise | Oui |42| `ShareOnboardingGuide` | {/* plan-availability: feature=onboarding-guide-share plans=pro,max,team,enterprise providers=anthropic */}Télécharge `ONBOARDING.md` et retourne un lien de partage que les coéquipiers peuvent ouvrir dans Claude Code. Appelé depuis `/team-onboarding` après que le guide soit écrit. Disponible pour les abonnés claude.ai sur les plans Pro, Max, Team et Enterprise | Oui |

43| `Skill` | Exécute une [skill](/fr/skills#control-who-invokes-a-skill) dans la conversation principale | Oui |43| `Skill` | Exécute une [skill](/fr/skills#control-who-invokes-a-skill) dans la conversation principale | Oui |

44| `TaskCreate` | Crée une nouvelle tâche dans la liste des tâches | Non |44| `TaskCreate` | Crée une nouvelle tâche dans la liste des tâches | Non |

45| `TaskGet` | Récupère les détails complets d'une tâche spécifique | Non |45| `TaskGet` | Récupère les détails complets d'une tâche spécifique | Non |

46| `TaskList` | Liste toutes les tâches avec leur statut actuel | Non |46| `TaskList` | Liste toutes les tâches avec leur statut actuel | Non |

47| `TaskOutput` | (Obsolète) Récupère la sortie d'une tâche en arrière-plan. Préférez `Read` sur le chemin du fichier de sortie de la tâche | Non |47| `TaskOutput` | Récupère la sortie d'une tâche en arrière-plan. Obsolète en faveur de `Read` sur le chemin du fichier de sortie de la tâche. {/* min-version: 2.1.203 */}Quand aucune tâche ne correspond à l'ID, l'erreur liste les agents d'arrière-plan en cours d'exécution par ID et description. Avant v2.1.203, l'erreur nommait uniquement l'ID manquant | Non |

48| `TaskStop` | Arrête une tâche en arrière-plan en cours d'exécution par ID. {/* min-version: 2.1.198 */}À partir de v2.1.198, accepte également un [coéquipier de l'équipe d'agents](/fr/agent-teams) ou un agent d'arrière-plan nommé par ID d'agent ou nom | Non |48| `TaskStop` | Arrête une tâche en arrière-plan en cours d'exécution par ID. {/* min-version: 2.1.198 */}Accepte également un [coéquipier de l'équipe d'agents](/fr/agent-teams) ou un agent d'arrière-plan nommé par ID d'agent ou nom. Avant v2.1.198, il acceptait uniquement un ID de tâche en arrière-plan. {/* min-version: 2.1.203 */}Quand aucune tâche ne correspond à l'ID, l'erreur liste les agents d'arrière-plan en cours d'exécution par ID et description, y compris les agents qu'un autre agent a créés. Avant v2.1.203, l'erreur listait les coéquipiers et agents nommés en cours d'exécution mais pas les agents d'arrière-plan qu'un autre agent a créés, donc ceux-ci ne pouvaient pas être identifiés ou arrêtés à partir de la conversation principale | Non |

49| `TaskUpdate` | Met à jour le statut de la tâche, les dépendances, les détails, ou supprime les tâches | Non |49| `TaskUpdate` | Met à jour le statut de la tâche, les dépendances, les détails, ou supprime les tâches | Non |

50| `TodoWrite` | {/* min-version: 2.1.142 */}Gère la liste de contrôle des tâches de la session. Désactivé par défaut à partir de v2.1.142 en faveur de `TaskCreate`, `TaskGet`, `TaskList`, et `TaskUpdate`. Définissez `CLAUDE_CODE_ENABLE_TASKS=0` pour réactiver | Non |50| `TodoWrite` | {/* min-version: 2.1.142 */}Gère la liste de contrôle des tâches de la session. Désactivé par défaut à partir de v2.1.142 en faveur de `TaskCreate`, `TaskGet`, `TaskList`, et `TaskUpdate`. Définissez `CLAUDE_CODE_ENABLE_TASKS=0` pour réactiver | Non |

51| `ToolSearch` | Recherche et charge les outils différés quand la [recherche d'outils](/fr/mcp#scale-with-mcp-tool-search) est activée | Non |51| `ToolSearch` | Recherche et charge les outils différés quand la [recherche d'outils](/fr/mcp#scale-with-mcp-tool-search) est activée | Non |


220 220 

221Quand Monitor exécute une commande, il utilise les mêmes [règles de permission que Bash](/fr/permissions#tool-specific-permission-rules), donc les motifs `allow` et `deny` que vous avez définis pour Bash s'appliquent ici aussi. La [source WebSocket](#websocket-source) a sa propre invite d'approbation.221Quand Monitor exécute une commande, il utilise les mêmes [règles de permission que Bash](/fr/permissions#tool-specific-permission-rules), donc les motifs `allow` et `deny` que vous avez définis pour Bash s'appliquent ici aussi. La [source WebSocket](#websocket-source) a sa propre invite d'approbation.

222 222 

223L'outil n'est pas disponible sur Amazon Bedrock, Google Vertex AI, ou Microsoft Foundry. Il n'est également pas disponible quand `DISABLE_TELEMETRY` ou `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` est défini.223L'outil n'est pas disponible sur Amazon Bedrock, Google Cloud's Agent Platform, ou Microsoft Foundry. Il n'est également pas disponible quand `DISABLE_TELEMETRY` ou `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` est défini.

224 224 

225Les plugins peuvent déclarer des moniteurs qui démarrent automatiquement quand le plugin est actif, au lieu de demander à Claude de les démarrer. Voir [moniteurs de plugin](/fr/plugins-reference#monitors).225Les plugins peuvent déclarer des moniteurs qui démarrent automatiquement quand le plugin est actif, au lieu de demander à Claude de les démarrer. Voir [moniteurs de plugin](/fr/plugins-reference#monitors).

226 226 


371Les règles de permission WebSearch ne prennent pas de spécificateur. Une entrée `WebSearch` nu dans `allow` ou `deny` est la seule forme.371Les règles de permission WebSearch ne prennent pas de spécificateur. Une entrée `WebSearch` nu dans `allow` ou `deny` est la seule forme.

372 372 

373<Note>373<Note>

374 WebSearch est disponible sur l'API Claude, [Claude Platform on AWS](/fr/claude-platform-on-aws), et Microsoft Foundry. Sur Google Cloud Vertex AI, il fonctionne avec les modèles Claude 4 et versions ultérieures, y compris Opus, Sonnet et Haiku. Amazon Bedrock n'expose pas l'outil de recherche web côté serveur.374 WebSearch est disponible sur l'API Claude, [Claude Platform on AWS](/fr/claude-platform-on-aws), et Microsoft Foundry. Sur Google Cloud's Agent Platform, il fonctionne avec les modèles Claude 4 et versions ultérieures, y compris Opus, Sonnet et Haiku. Amazon Bedrock n'expose pas l'outil de recherche web côté serveur.

375</Note>375</Note>

376 376 

377<h2 id="write-tool-behavior">377<h2 id="write-tool-behavior">

Details

15Faites correspondre le message d'erreur ou le symptôme que vous voyez à une solution :15Faites correspondre le message d'erreur ou le symptôme que vous voyez à une solution :

16 16 

17| Ce que vous voyez | Solution |17| Ce que vous voyez | Solution |

18| :--------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------ |18| :--------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------- |

19| `command not found: claude` ou `'claude' is not recognized` | [Corrigez votre PATH](#command-not-found-claude-after-installation) |19| `command not found: claude` ou `'claude' is not recognized` | [Corrigez votre PATH](#command-not-found-claude-after-installation) |

20| `syntax error near unexpected token '<'` | [Le script d'installation retourne du HTML](#install-script-returns-html-instead-of-a-shell-script) |20| `syntax error near unexpected token '<'` | [Le script d'installation retourne du HTML](#install-script-returns-html-instead-of-a-shell-script) |

21| `curl: (22) The requested URL returned error: 403` | [Le script d'installation a retourné 403](#install-script-returns-html-instead-of-a-shell-script) |21| `curl: (22) The requested URL returned error: 403` | [Le script d'installation a retourné 403](#install-script-returns-html-instead-of-a-shell-script) |

22| `curl: (23)` ou `curl: (56) Failure writing output to destination` | [Vérifiez la connectivité ou utilisez un programme d'installation alternatif](#curl-56-failure-writing-output-to-destination) |22| `curl: (23)` ou `curl: (56) Failure writing output to destination` | [Vérifiez la connectivité ou utilisez un programme d'installation alternatif](#curl-56-failure-writing-output-to-destination) |

23| `Killed` pendant l'installation sur Linux | [Ajoutez de l'espace d'échange pour les serveurs à faible mémoire](#install-killed-on-low-memory-linux-servers) |23| `Killed` pendant l'installation sur Linux, ou `Installation was killed before it could finish (exit code 137)` | [Libérez de la mémoire ou ajoutez de l'espace d'échange](#install-killed-on-low-memory-linux-servers) |

24| `TLS connect error` ou `SSL/TLS secure channel` | [Mettez à jour les certificats CA](#tls-or-ssl-connection-errors) |24| `TLS connect error` ou `SSL/TLS secure channel` | [Mettez à jour les certificats CA](#tls-or-ssl-connection-errors) |

25| `Failed to fetch version` ou impossible d'atteindre le serveur de téléchargement | [Vérifiez les paramètres réseau et proxy](#check-network-connectivity) |25| `Failed to fetch version` ou impossible d'atteindre le serveur de téléchargement | [Vérifiez les paramètres réseau et proxy](#check-network-connectivity) |

26| `irm is not recognized` ou `&& is not valid` | [Utilisez la bonne commande pour votre shell](#wrong-install-command-on-windows) |26| `irm is not recognized` ou `&& is not valid` | [Utilisez la bonne commande pour votre shell](#wrong-install-command-on-windows) |


39| `App unavailable in region` | Claude Code n'est pas disponible dans votre pays. Consultez [les pays pris en charge](https://www.anthropic.com/supported-countries). |39| `App unavailable in region` | Claude Code n'est pas disponible dans votre pays. Consultez [les pays pris en charge](https://www.anthropic.com/supported-countries). |

40| `unable to get local issuer certificate` | [Configurez les certificats CA d'entreprise](#tls-or-ssl-connection-errors) |40| `unable to get local issuer certificate` | [Configurez les certificats CA d'entreprise](#tls-or-ssl-connection-errors) |

41| `OAuth error` ou `403 Forbidden` | [Corrigez l'authentification](#login-and-authentication) |41| `OAuth error` ou `403 Forbidden` | [Corrigez l'authentification](#login-and-authentication) |

42| `Could not load the default credentials` ou `Could not load credentials from any providers` | [Identifiants Bedrock, Vertex ou Foundry](#bedrock-vertex-or-foundry-credentials-not-loading) |42| `Could not load the default credentials` ou `Could not load credentials from any providers` | [Identifiants Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry](#bedrock-agent-platform-or-foundry-credentials-not-loading) |

43| `ChainedTokenCredential authentication failed` ou `CredentialUnavailableError` | [Identifiants Bedrock, Vertex ou Foundry](#bedrock-vertex-or-foundry-credentials-not-loading) |43| `ChainedTokenCredential authentication failed` ou `CredentialUnavailableError` | [Identifiants Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry](#bedrock-agent-platform-or-foundry-credentials-not-loading) |

44| `API Error: 500`, `529 Overloaded`, `429`, ou autres erreurs 4xx et 5xx non listées ci-dessus | Consultez la [Référence des erreurs](/fr/errors) |44| `API Error: 500`, `529 Overloaded`, `429`, ou autres erreurs 4xx et 5xx non listées ci-dessus | Consultez la [Référence des erreurs](/fr/errors) |

45 45 

46Si votre problème n'est pas listé, travaillez à travers les vérifications de diagnostic ci-dessous pour affiner la cause.46Si votre problème n'est pas listé, travaillez à travers les vérifications de diagnostic ci-dessous pour affiner la cause.


538 Installation interrompue sur les serveurs Linux à faible mémoire538 Installation interrompue sur les serveurs Linux à faible mémoire

539</h3>539</h3>

540 540 

541Si vous voyez `Killed` pendant l'installation sur un VPS ou une instance cloud :541Un message `Killed` pendant l'installation signifie généralement que le tueur OOM (out-of-memory) Linux a terminé l'étape `claude install` car le système a manqué de mémoire libre. Cela est courant sur les petits VPS et instances cloud. Le script d'installation signale la cause et se termine avec le code 137 :

542 542 

543```text theme={null}543```text theme={null}

544Setting up Claude Code...544Setting up Claude Code...

545Installing Claude Code native build latest...

546bash: line 142: 34803 Killed "$binary_path" install ${TARGET:+"$TARGET"}545bash: line 142: 34803 Killed "$binary_path" install ${TARGET:+"$TARGET"}

546Installation was killed before it could finish (exit code 137). This usually means the system ran out of memory.

547Claude Code needs roughly 512MB of free memory to install. Free up memory, then run this script again.

547```548```

548 549 

549Le tueur OOM Linux a terminé le processus car le système a manqué de mémoire. Claude Code nécessite au moins 4 Go de RAM disponible.550Avant v2.1.200, le script s'est terminé avec seulement la ligne `Killed` nue du shell et aucune explication.

551 

552L'installation nécessite environ 512 Mo de mémoire libre, et l'exécution de Claude Code en nécessite davantage. Consultez les [exigences système](/fr/setup#system-requirements).

550 553 

551**Solutions :**554**Solutions :**

552 555 


781Le paquet npm `@anthropic-ai/claude-code` récupère le binaire natif via une dépendance optionnelle par plateforme comme `@anthropic-ai/claude-code-darwin-arm64`. Si l'exécution de `claude` après l'installation affiche `Could not find native binary package "@anthropic-ai/claude-code-<platform>"`, vérifiez les causes suivantes :784Le paquet npm `@anthropic-ai/claude-code` récupère le binaire natif via une dépendance optionnelle par plateforme comme `@anthropic-ai/claude-code-darwin-arm64`. Si l'exécution de `claude` après l'installation affiche `Could not find native binary package "@anthropic-ai/claude-code-<platform>"`, vérifiez les causes suivantes :

782 785 

783* **Les dépendances optionnelles sont désactivées.** Supprimez `--omit=optional` de votre commande d'installation npm, `--no-optional` de pnpm, ou `--ignore-optional` de yarn, et vérifiez que `.npmrc` ne définit pas `optional=false`. Puis réinstallez. Le binaire natif est livré uniquement en tant que dépendance optionnelle, donc il n'y a pas de secours JavaScript s'il est ignoré.786* **Les dépendances optionnelles sont désactivées.** Supprimez `--omit=optional` de votre commande d'installation npm, `--no-optional` de pnpm, ou `--ignore-optional` de yarn, et vérifiez que `.npmrc` ne définit pas `optional=false`. Puis réinstallez. Le binaire natif est livré uniquement en tant que dépendance optionnelle, donc il n'y a pas de secours JavaScript s'il est ignoré.

784* **Plateforme non supportée.** Les binaires précompilés sont publiés pour `darwin-arm64`, `darwin-x64`, `linux-x64`, `linux-arm64`, `linux-x64-musl`, `linux-arm64-musl`, `win32-x64`, et `win32-arm64`. Claude Code ne livre pas de binaire pour d'autres plateformes ; consultez les [exigences système](/fr/setup#system-requirements).787* **Plateforme non supportée.** Les binaires précompilés sont publiés pour `darwin-arm64`, `darwin-x64`, `linux-x64`, `linux-arm64`, `linux-x64-musl`, `linux-arm64-musl`, `win32-x64`, et `win32-arm64`. Claude Code ne livre pas de binaire pour d'autres plateformes ; consultez les [exigences système](/fr/setup#system-requirements). {/* min-version: 2.1.205 */}Sur FreeBSD, le programme d'installation signale la plateforme comme non supportée. Avant v2.1.205, il traitait FreeBSD comme Linux et téléchargeait un binaire qui ne pouvait pas s'exécuter.

785* **Le miroir npm d'entreprise manque les paquets de plateforme.** Assurez-vous que votre registre reflète les huit paquets `@anthropic-ai/claude-code-*` de plateforme en plus du paquet méta.788* **Le miroir npm d'entreprise manque les paquets de plateforme.** Assurez-vous que votre registre reflète les huit paquets `@anthropic-ai/claude-code-*` de plateforme en plus du paquet méta.

786 789 

787L'installation avec `--ignore-scripts` ne déclenche pas cette erreur. L'étape postinstall qui lie le binaire en place est ignorée, donc Claude Code revient à un wrapper qui localise et génère le binaire de plateforme à chaque lancement. Cela fonctionne mais démarre plus lentement ; réinstallez avec les scripts activés pour l'exécution directe.790L'installation avec `--ignore-scripts` ne déclenche pas cette erreur. L'étape postinstall qui lie le binaire en place est ignorée, donc Claude Code revient à un wrapper qui localise et génère le binaire de plateforme à chaque lancement. Cela fonctionne mais démarre plus lentement ; réinstallez avec les scripts activés pour l'exécution directe.


876 879 

877Sur macOS, la connexion peut également échouer lorsque le Keychain est verrouillé ou que son mot de passe est désynchronisé avec votre mot de passe de compte, ce qui empêche Claude Code de sauvegarder les identifiants. Exécutez `claude doctor` pour vérifier l'accès au Keychain. Pour déverrouiller le Keychain manuellement, exécutez `security unlock-keychain ~/Library/Keychains/login.keychain-db`. Si le déverrouillage n'aide pas, ouvrez Keychain Access, sélectionnez le Keychain `login`, et choisissez Édition > Changer le mot de passe du Keychain « login » pour le resynchroniser avec votre mot de passe de compte.880Sur macOS, la connexion peut également échouer lorsque le Keychain est verrouillé ou que son mot de passe est désynchronisé avec votre mot de passe de compte, ce qui empêche Claude Code de sauvegarder les identifiants. Exécutez `claude doctor` pour vérifier l'accès au Keychain. Pour déverrouiller le Keychain manuellement, exécutez `security unlock-keychain ~/Library/Keychains/login.keychain-db`. Si le déverrouillage n'aide pas, ouvrez Keychain Access, sélectionnez le Keychain `login`, et choisissez Édition > Changer le mot de passe du Keychain « login » pour le resynchroniser avec votre mot de passe de compte.

878 881 

879<h3 id="bedrock-vertex-or-foundry-credentials-not-loading">882<h3 id="bedrock-agent-platform-or-foundry-credentials-not-loading">

880 Les identifiants Bedrock, Vertex ou Foundry ne se chargent pas883 Les identifiants Bedrock, Agent Platform ou Foundry ne se chargent pas

881</h3>884</h3>

882 885 

883Si vous avez configuré Claude Code pour utiliser un fournisseur cloud et voyez `Could not load credentials from any providers` sur Bedrock, `Could not load the default credentials` sur Vertex, ou `ChainedTokenCredential authentication failed` sur Foundry, votre CLI du fournisseur cloud n'est probablement pas authentifiée dans le shell actuel.886Si vous avez configuré Claude Code pour utiliser un fournisseur cloud et voyez `Could not load credentials from any providers` sur Amazon Bedrock, `Could not load the default credentials` sur Google Cloud's Agent Platform, ou `ChainedTokenCredential authentication failed` sur Microsoft Foundry, votre CLI du fournisseur cloud n'est probablement pas authentifiée dans le shell actuel.

884 887 

885Pour Bedrock, confirmez que vos identifiants AWS sont valides :888Pour Amazon Bedrock, confirmez que vos identifiants AWS sont valides :

886 889 

887```bash theme={null}890```bash theme={null}

888aws sts get-caller-identity891aws sts get-caller-identity

889```892```

890 893 

891Pour Vertex AI, confirmez que `ANTHROPIC_VERTEX_PROJECT_ID` et `CLOUD_ML_REGION` sont définis dans votre shell, puis définissez les identifiants par défaut de l'application :894Pour Google Cloud's Agent Platform, confirmez que `ANTHROPIC_VERTEX_PROJECT_ID` et `CLOUD_ML_REGION` sont définis dans votre shell, puis définissez les identifiants par défaut de l'application :

892 895 

893```bash theme={null}896```bash theme={null}

894gcloud auth application-default login897gcloud auth application-default login


902 905 

903Si les identifiants fonctionnent dans votre terminal mais pas dans l'extension VS Code ou JetBrains, le processus IDE n'a probablement pas hérité de votre environnement shell. Définissez les variables d'environnement du fournisseur dans les paramètres de l'IDE lui-même, ou lancez l'IDE depuis un terminal où elles sont déjà exportées.906Si les identifiants fonctionnent dans votre terminal mais pas dans l'extension VS Code ou JetBrains, le processus IDE n'a probablement pas hérité de votre environnement shell. Définissez les variables d'environnement du fournisseur dans les paramètres de l'IDE lui-même, ou lancez l'IDE depuis un terminal où elles sont déjà exportées.

904 907 

905Consultez [Amazon Bedrock](/fr/amazon-bedrock), [Google Vertex AI](/fr/google-vertex-ai), ou [Microsoft Foundry](/fr/microsoft-foundry) pour la configuration complète du fournisseur.908Consultez [Amazon Bedrock](/fr/amazon-bedrock), [Google Cloud's Agent Platform](/fr/google-vertex-ai), ou [Microsoft Foundry](/fr/microsoft-foundry) pour la configuration complète du fournisseur.

906 909 

907<h2 id="still-stuck">910<h2 id="still-stuck">

908 Toujours bloqué911 Toujours bloqué

Details

9Cette page couvre les problèmes de performance, de stabilité et de recherche une fois que Claude Code est en cours d'exécution. Pour d'autres problèmes, commencez par la page qui correspond à votre situation :9Cette page couvre les problèmes de performance, de stabilité et de recherche une fois que Claude Code est en cours d'exécution. Pour d'autres problèmes, commencez par la page qui correspond à votre situation :

10 10 

11| Symptôme | Aller à |11| Symptôme | Aller à |

12| :--------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------- |12| :----------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------- |

13| `command not found`, l'installation échoue, problèmes de PATH, `EACCES`, erreurs TLS | [Dépanner l'installation et la connexion](/fr/troubleshoot-install) |13| `command not found`, l'installation échoue, problèmes de PATH, `EACCES`, erreurs TLS | [Dépanner l'installation et la connexion](/fr/troubleshoot-install) |

14| Boucles de connexion, erreurs OAuth, `403 Forbidden`, « organisation désactivée », identifiants Bedrock/Vertex/Foundry | [Dépanner l'installation et la connexion](/fr/troubleshoot-install#login-and-authentication) |14| Mise à jour ou l'installation du téléchargement échoue avec `The connection dropped while downloading the update` ou `aborted` | [Référence des erreurs](/fr/errors#the-connection-dropped-while-downloading-the-update) |

15| Boucles de connexion, erreurs OAuth, `403 Forbidden`, « organisation désactivée », identifiants Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry | [Dépanner l'installation et la connexion](/fr/troubleshoot-install#login-and-authentication) |

15| Les paramètres ne s'appliquent pas, les hooks ne se déclenchent pas, les serveurs MCP ne se chargent pas | [Déboguer votre configuration](/fr/debug-your-config) |16| Les paramètres ne s'appliquent pas, les hooks ne se déclenchent pas, les serveurs MCP ne se chargent pas | [Déboguer votre configuration](/fr/debug-your-config) |

16| `API Error: 5xx`, `529 Overloaded`, `429`, erreurs de validation de requête | [Référence des erreurs](/fr/errors) |17| `API Error: 5xx`, `529 Overloaded`, `429`, erreurs de validation de requête | [Référence des erreurs](/fr/errors) |

17| `model not found` ou `you may not have access to it` | [Référence des erreurs](/fr/errors#there%E2%80%99s-an-issue-with-the-selected-model) |18| `model not found` ou `you may not have access to it` | [Référence des erreurs](/fr/errors#there%E2%80%99s-an-issue-with-the-selected-model) |


19| Le plugin JetBrains ou l'IDE n'est pas détecté | [Intégration JetBrains](/fr/jetbrains#troubleshooting) |20| Le plugin JetBrains ou l'IDE n'est pas détecté | [Intégration JetBrains](/fr/jetbrains#troubleshooting) |

20| Utilisation élevée du CPU ou de la mémoire, réponses lentes, blocages, la recherche ne trouve pas les fichiers | [Performance et stabilité](#performance-and-stability) ci-dessous |21| Utilisation élevée du CPU ou de la mémoire, réponses lentes, blocages, la recherche ne trouve pas les fichiers | [Performance et stabilité](#performance-and-stability) ci-dessous |

21 22 

22Si vous n'êtes pas sûr de ce qui s'applique, exécutez `/doctor` dans Claude Code pour une vérification automatisée de votre installation, vos paramètres, vos serveurs MCP et votre utilisation du contexte. Si `claude` ne démarre pas du tout, exécutez `claude doctor` depuis votre shell à la place.23Si vous n'êtes pas sûr de ce qui s'applique, exécutez `/doctor` dans Claude Code pour une vérification automatisée de votre installation, vos paramètres, vos extensions et votre utilisation du contexte ; il propose des corrections qu'il peut appliquer après votre confirmation. Si `claude` ne démarre pas du tout, exécutez `claude doctor` depuis votre shell à la place. Exécutez `/mcp` pour vérifier l'état du serveur MCP.

23 24 

24<h2 id="performance-and-stability">25<h2 id="performance-and-stability">

25 Performance et stabilité26 Performance et stabilité


119Les pénalités de performance de lecture de disque lors du [travail sur les systèmes de fichiers sur WSL](https://learn.microsoft.com/en-us/windows/wsl/filesystems) peuvent entraîner moins de correspondances que prévu lors de l'utilisation de Claude Code sur WSL. La recherche fonctionne toujours, mais retourne moins de résultats que sur un système de fichiers natif.120Les pénalités de performance de lecture de disque lors du [travail sur les systèmes de fichiers sur WSL](https://learn.microsoft.com/en-us/windows/wsl/filesystems) peuvent entraîner moins de correspondances que prévu lors de l'utilisation de Claude Code sur WSL. La recherche fonctionne toujours, mais retourne moins de résultats que sur un système de fichiers natif.

120 121 

121<Note>122<Note>

122 `/doctor` affichera Search comme OK dans ce cas.123 `claude doctor` affiche Search comme OK dans ce cas.

123</Note>124</Note>

124 125 

125**Solutions :**126**Solutions :**


136 137 

137Si vous rencontrez des problèmes non couverts ici :138Si vous rencontrez des problèmes non couverts ici :

138 139 

1391. Exécutez `/doctor` pour vérifier la santé de l'installation, la validité des paramètres, la configuration MCP et l'utilisation du contexte en une seule passe1401. Exécutez `/doctor` pour une vérification de la configuration et `/mcp` pour vérifier l'état du serveur MCP

1402. Utilisez la commande `/feedback` dans Claude Code pour signaler les problèmes directement à Anthropic1412. Utilisez la commande `/feedback` dans Claude Code pour signaler les problèmes directement à Anthropic

1413. Vérifiez le [référentiel GitHub](https://github.com/anthropics/claude-code) pour les problèmes connus1423. Vérifiez le [référentiel GitHub](https://github.com/anthropics/claude-code) pour les problèmes connus

1424. Demandez directement à Claude ses capacités et fonctionnalités. Claude a un accès intégré à sa documentation.1434. Demandez directement à Claude ses capacités et fonctionnalités. Claude a un accès intégré à sa documentation.

ultraplan.md +1 −1

Details

18* **Rédaction sans intervention** : le plan est généré à distance, votre terminal reste libre pour d'autres travaux18* **Rédaction sans intervention** : le plan est généré à distance, votre terminal reste libre pour d'autres travaux

19* **Exécution flexible** : approuvez le plan pour l'exécuter sur le web et ouvrir une demande de tirage, ou renvoyez-le à votre terminal19* **Exécution flexible** : approuvez le plan pour l'exécuter sur le web et ouvrir une demande de tirage, ou renvoyez-le à votre terminal

20 20 

21Ultraplan nécessite un compte [Claude Code sur le web](/fr/claude-code-on-the-web) et un référentiel GitHub. Parce qu'il s'exécute sur l'infrastructure cloud d'Anthropic, il n'est pas disponible lors de l'utilisation d'Amazon Bedrock, Google Cloud Vertex AI ou Microsoft Foundry. La session cloud s'exécute dans l'[environnement cloud](/fr/claude-code-on-the-web#the-cloud-environment) par défaut de votre compte. Si vous n'avez pas encore d'environnement cloud, ultraplan en crée un automatiquement lors de son premier lancement.21Ultraplan nécessite un compte [Claude Code sur le web](/fr/claude-code-on-the-web) et un référentiel GitHub. Parce qu'il s'exécute sur l'infrastructure cloud d'Anthropic, il n'est pas disponible lors de l'utilisation d'Amazon Bedrock, de la plateforme Agent de Google Cloud ou de Microsoft Foundry. La session cloud s'exécute dans l'[environnement cloud](/fr/claude-code-on-the-web#the-cloud-environment) par défaut de votre compte. Si vous n'avez pas encore d'environnement cloud, ultraplan en crée un automatiquement lors de son premier lancement.

22 22 

23<h2 id="launch-ultraplan-from-the-cli">23<h2 id="launch-ultraplan-from-the-cli">

24 Lancer ultraplan depuis la CLI24 Lancer ultraplan depuis la CLI

ultrareview.md +5 −5

Details

15Comparé à un `/code-review` local ou `/review`, ultrareview offre :15Comparé à un `/code-review` local ou `/review`, ultrareview offre :

16 16 

17* **Signal plus élevé** : chaque constatation signalée est indépendamment reproduite et vérifiée, de sorte que les résultats se concentrent sur les bugs réels plutôt que sur les suggestions de style17* **Signal plus élevé** : chaque constatation signalée est indépendamment reproduite et vérifiée, de sorte que les résultats se concentrent sur les bugs réels plutôt que sur les suggestions de style

18* **Couverture plus large** : une flotte plus importante d'agents examinateurs explore le changement en parallèle, ce qui met en évidence les problèmes qu'une révision d'effort moyen local pourrait manquer18* **Couverture plus large** : une flotte plus importante d'agents examinateurs explore le changement en parallèle, ce qui met en évidence les problèmes qu'une révision locale pourrait manquer

19* **Aucune utilisation de ressources locales** : la révision s'exécute entièrement dans un sandbox distant, de sorte que votre terminal reste libre pour d'autres travaux pendant qu'elle s'exécute19* **Aucune utilisation de ressources locales** : la révision s'exécute entièrement dans un sandbox distant, de sorte que votre terminal reste libre pour d'autres travaux pendant qu'elle s'exécute

20 20 

21Ultrareview nécessite une authentification avec un compte Claude.ai car il s'exécute sur Claude Code sur l'infrastructure web. Si vous êtes connecté avec une clé API uniquement, exécutez `/login` et authentifiez-vous d'abord avec Claude.ai. Ultrareview n'est pas disponible lors de l'utilisation de Claude Code avec Amazon Bedrock, Google Cloud Vertex AI ou Microsoft Foundry, et il n'est pas disponible pour les organisations qui ont activé la rétention zéro des données.21Ultrareview nécessite une authentification avec un compte Claude.ai car il s'exécute sur Claude Code sur l'infrastructure web. Si vous êtes connecté avec une clé API uniquement, exécutez `/login` et authentifiez-vous d'abord avec Claude.ai. Ultrareview n'est pas disponible lors de l'utilisation de Claude Code avec Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry, et il n'est pas disponible pour les organisations qui ont activé la rétention zéro des données.

22 22 

23<h2 id="run-ultrareview-from-the-cli">23<h2 id="run-ultrareview-from-the-cli">

24 Exécuter ultrareview à partir de la CLI24 Exécuter ultrareview à partir de la CLI


104Les trois commandes examinent le code, mais elles ciblent différentes étapes de votre flux de travail.104Les trois commandes examinent le code, mais elles ciblent différentes étapes de votre flux de travail.

105 105 

106| | `/code-review` | `/review <pr>` | `/code-review ultra` |106| | `/code-review` | `/review <pr>` | `/code-review ultra` |

107| ---------- | ----------------------------------- | ------------------------------------------------- | ------------------------------------------------------------------------------------------------ |107| ---------- | ----------------------------------- | ---------------------------------------------------------------- | ------------------------------------------------------------------------------------------------ |

108| Cible | votre diff de travail | une pull request GitHub | votre diff de travail ou une pull request |108| Cible | votre diff de travail | une pull request GitHub | votre diff de travail ou une pull request |

109| S'exécute | localement dans votre session | localement dans votre session | à distance dans un sandbox cloud |109| S'exécute | localement dans votre session | localement dans votre session | à distance dans un sandbox cloud |

110| Profondeur | s'adapte à l'argument effort | le moteur `/code-review` moyen | flotte multi-agents avec vérification indépendante |110| Profondeur | s'adapte à l'argument effort | une révision en un seul passage au niveau d'effort de la session | flotte multi-agents avec vérification indépendante |

111| Durée | secondes à quelques minutes | quelques minutes | environ 5 à 10 minutes |111| Durée | secondes à quelques minutes | secondes à quelques minutes | environ 5 à 10 minutes |

112| Coût | compte vers l'utilisation normale | compte vers l'utilisation normale | exécutions gratuites, puis environ 5 à 20 dollars par révision en tant que crédits d'utilisation |112| Coût | compte vers l'utilisation normale | compte vers l'utilisation normale | exécutions gratuites, puis environ 5 à 20 dollars par révision en tant que crédits d'utilisation |

113| Idéal pour | retours rapides lors de l'itération | examen de la PR d'un coéquipier avant approbation | confiance pré-fusion sur les changements substantiels |113| Idéal pour | retours rapides lors de l'itération | examen de la PR d'un coéquipier avant approbation | confiance pré-fusion sur les changements substantiels |

114 114 

Details

20 20 

21La dictée vocale envoie votre audio enregistré aux serveurs d'Anthropic pour la transcription. L'audio n'est pas traité localement. Elle nécessite tous les éléments suivants :21La dictée vocale envoie votre audio enregistré aux serveurs d'Anthropic pour la transcription. L'audio n'est pas traité localement. Elle nécessite tous les éléments suivants :

22 22 

23* **Un compte Claude.ai** : le service de reconnaissance vocale n'est disponible que lorsque vous vous authentifiez avec un compte, et n'est pas disponible lorsque Claude Code est configuré pour utiliser directement une clé API Anthropic, Amazon Bedrock, Google Vertex AI ou Microsoft Foundry.23* **Un compte Claude.ai** : le service de reconnaissance vocale n'est disponible que lorsque vous vous authentifiez avec un compte, et n'est pas disponible lorsque Claude Code est configuré pour utiliser directement une clé API Anthropic, Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry.

24* **Une organisation sans conformité HIPAA activée** : `/voice` affiche `Voice mode is disabled by your organization's policy` lorsque cette restriction s'applique.24* **Une organisation sans conformité HIPAA activée** : `/voice` affiche `Voice mode is disabled by your organization's policy` lorsque cette restriction s'applique.

25* **Un microphone local** : la dictée vocale ne fonctionne pas dans les environnements distants tels que [Claude Code sur le web](/fr/claude-code-on-the-web) ou les sessions SSH.25* **Un microphone local** : la dictée vocale ne fonctionne pas dans les environnements distants tels que [Claude Code sur le web](/fr/claude-code-on-the-web) ou les sessions SSH.

26* **WSLg, si vous exécutez Claude Code dans WSL** : WSLg est inclus avec WSL2 lorsqu'il est installé à partir du Microsoft Store sur Windows 10 ou 11. Si WSLg n'est pas disponible, par exemple sur WSL1, exécutez Claude Code en Windows natif à la place.26* **WSLg, si vous exécutez Claude Code dans WSL** : WSLg est inclus avec WSL2 lorsqu'il est installé à partir du Microsoft Store sur Windows 10 ou 11. Si WSLg n'est pas disponible, par exemple sur WSL1, exécutez Claude Code en Windows natif à la place.


183* **`No audio recording tool found` sur Linux** : le module audio natif n'a pas pu se charger et aucun retour n'est installé. Installez SoX avec la commande affichée dans le message d'erreur, par exemple `sudo apt-get install sox`.183* **`No audio recording tool found` sur Linux** : le module audio natif n'a pas pu se charger et aucun retour n'est installé. Installez SoX avec la commande affichée dans le message d'erreur, par exemple `sudo apt-get install sox`.

184* **`Voice mode requires a microphone, but SoX could not open an audio capture device`** : SoX est installé, mais l'hôte n'a pas de périphérique de capture audio, par exemple un serveur sans interface graphique ou un conteneur. Exécutez Claude Code sur une machine avec un microphone. {/* min-version: 2.1.195 */}À partir de la v2.1.195, Claude Code sur Linux signale ce message dans cette situation ; les versions antérieures vous demandaient d'installer SoX même s'il était déjà installé.184* **`Voice mode requires a microphone, but SoX could not open an audio capture device`** : SoX est installé, mais l'hôte n'a pas de périphérique de capture audio, par exemple un serveur sans interface graphique ou un conteneur. Exécutez Claude Code sur une machine avec un microphone. {/* min-version: 2.1.195 */}À partir de la v2.1.195, Claude Code sur Linux signale ce message dans cette situation ; les versions antérieures vous demandaient d'installer SoX même s'il était déjà installé.

185* **`Voice mode could not find a working audio recorder in WSL`** : WSLg achemine l'audio via PulseAudio plutôt qu'un périphérique ALSA, donc SoX a besoin que son backend PulseAudio soit installé explicitement. Exécutez `sudo apt install sox libsox-fmt-pulse`. L'installation de `sox` seul installe le backend ALSA, qui ne peut pas enregistrer sur WSL car il n'y a pas de périphérique `/dev/snd`.185* **`Voice mode could not find a working audio recorder in WSL`** : WSLg achemine l'audio via PulseAudio plutôt qu'un périphérique ALSA, donc SoX a besoin que son backend PulseAudio soit installé explicitement. Exécutez `sudo apt install sox libsox-fmt-pulse`. L'installation de `sox` seul installe le backend ALSA, qui ne peut pas enregistrer sur WSL car il n'y a pas de périphérique `/dev/snd`.

186* **`Voice input is failing repeatedly and has been paused`** : la dictée vocale a rencontré plusieurs échecs de démarrage d'affilée et a cessé de tenter de nouvelles sessions jusqu'à ce qu'une réussisse. Cela signifie généralement que le microphone ou la pile audio sur cet hôte ne peut pas capturer l'audio, par exemple un serveur sans interface graphique, un shell distant sans passage audio, ou une permission de microphone refusée. Confirmez un périphérique d'entrée fonctionnant, corrigez la cause sous-jacente à partir des entrées ci-dessus, puis déclenchez à nouveau la voix.186* **`Voice input is failing repeatedly and has been paused`** : la dictée vocale a rencontré plusieurs échecs de capture d'affilée et a cessé de tenter de nouvelles sessions jusqu'à ce qu'une réussisse. Un échec compte que le microphone ne démarre pas ou que l'enregistreur démarre puis s'arrête sans produire d'audio. Cela signifie généralement que le microphone ou la pile audio sur cet hôte ne peut pas capturer l'audio, par exemple un serveur sans interface graphique, un shell distant sans passage audio, ou une permission de microphone refusée. Confirmez un périphérique d'entrée fonctionnant, corrigez la cause sous-jacente à partir des entrées ci-dessus, puis déclenchez à nouveau la voix. {/* min-version: 2.1.202 */}Avant la v2.1.202, seuls les échecs de démarrage comptaient vers la pause.

187* **Rien ne se passe en maintenant `Space` en mode maintien** : regardez l'entrée d'invite pendant que vous maintenez. Si les espaces continuent à s'accumuler, la dictée vocale est probablement désactivée ; exécutez `/voice hold` pour l'activer. Si un ou deux espaces seulement apparaissent puis rien, la dictée vocale est activée mais la détection de maintien ne se déclenche pas. La détection de maintien nécessite que votre terminal envoie des événements de répétition des touches, elle ne peut donc pas détecter une touche maintenue si la répétition des touches est désactivée au niveau du système d'exploitation. Basculez vers le mode appui avec `/voice tap` pour éviter l'exigence de répétition des touches.187* **Rien ne se passe en maintenant `Space` en mode maintien** : regardez l'entrée d'invite pendant que vous maintenez. Si les espaces continuent à s'accumuler, la dictée vocale est probablement désactivée ; exécutez `/voice hold` pour l'activer. Si un ou deux espaces seulement apparaissent puis rien, la dictée vocale est activée mais la détection de maintien ne se déclenche pas. La détection de maintien nécessite que votre terminal envoie des événements de répétition des touches, elle ne peut donc pas détecter une touche maintenue si la répétition des touches est désactivée au niveau du système d'exploitation. Basculez vers le mode appui avec `/voice tap` pour éviter l'exigence de répétition des touches.

188* **Appuyer sur `Space` tape un espace au lieu d'enregistrer en mode appui** : le premier appui ne commence l'enregistrement que lorsque l'entrée d'invite est vide. Effacez d'abord l'entrée, ou vérifiez que vous êtes en mode appui en exécutant `/voice tap`.188* **Appuyer sur `Space` tape un espace au lieu d'enregistrer en mode appui** : le premier appui ne commence l'enregistrement que lorsque l'entrée d'invite est vide. Effacez d'abord l'entrée, ou vérifiez que vous êtes en mode appui en exécutant `/voice tap`.

189* **`No audio detected from microphone`** : l'enregistrement a commencé mais a capturé le silence. Confirmez que le périphérique d'entrée correct est défini comme valeur par défaut du système et que son niveau d'entrée n'est pas coupé ou proche de zéro. Sur Windows, ouvrez Paramètres → Système → Son → Entrée et sélectionnez votre microphone. Sur macOS, ouvrez Paramètres système → Son → Entrée.189* **`No audio detected from microphone`** : l'enregistrement a commencé mais a capturé le silence. Confirmez que le périphérique d'entrée correct est défini comme valeur par défaut du système et que son niveau d'entrée n'est pas coupé ou proche de zéro. Sur Windows, ouvrez Paramètres → Système → Son → Entrée et sélectionnez votre microphone. Sur macOS, ouvrez Paramètres système → Son → Entrée.

190* **`Voice connection failed`** : votre enregistrement n'a jamais atteint le service de transcription car la connexion a échoué. Vérifiez votre réseau et réessayez. {/* min-version: 2.1.200 */}Un enregistrement qui ne capture aucun audio signale `No audio detected from microphone` au lieu de ce message. Avant la v2.1.200, un microphone silencieux pouvait signaler un échec de connexion, ce qui suggérait un problème réseau alors que le problème réel était le périphérique d'entrée.

190* **`No speech detected`** : l'audio a atteint le service de transcription mais aucun mot n'a été reconnu. Parlez plus près du microphone, réduisez le bruit de fond et confirmez que votre [langue de dictée](#change-the-dictation-language) correspond à la langue que vous parlez.191* **`No speech detected`** : l'audio a atteint le service de transcription mais aucun mot n'a été reconnu. Parlez plus près du microphone, réduisez le bruit de fond et confirmez que votre [langue de dictée](#change-the-dictation-language) correspond à la langue que vous parlez.

191* **La transcription est brouillée ou dans la mauvaise langue** : la dictée utilise par défaut l'anglais. Si vous dictez dans une autre langue, définissez-la d'abord dans `/config`. Consultez [Modifier la langue de dictée](#change-the-dictation-language).192* **La transcription est brouillée ou dans la mauvaise langue** : la dictée utilise par défaut l'anglais. Si vous dictez dans une autre langue, définissez-la d'abord dans `/config`. Consultez [Modifier la langue de dictée](#change-the-dictation-language).

192 193 

vs-code.md +11 −7

Details

19Avant d'installer, assurez-vous que vous avez :19Avant d'installer, assurez-vous que vous avez :

20 20 

21* VS Code 1.98.0 ou supérieur21* VS Code 1.98.0 ou supérieur

22* Un compte Anthropic : tout abonnement Claude payant (Pro, Max, Team ou Enterprise) ou un compte Claude Console fonctionne, et aucune clé API n'est requise. Vous vous [connecterez](/fr/authentication#log-in-to-claude-code) avec ce compte lors de la première ouverture de l'extension. Si vous accédez à Claude par l'intermédiaire d'un fournisseur tiers comme Amazon Bedrock ou Google Vertex AI, consultez [Utiliser des fournisseurs tiers](#use-third-party-providers) pour les instructions de configuration.22* Un compte Anthropic : tout abonnement Claude payant (Pro, Max, Team ou Enterprise) ou un compte Claude Console fonctionne, et aucune clé API n'est requise. Vous vous [connecterez](/fr/authentication#log-in-to-claude-code) avec ce compte lors de la première ouverture de l'extension. Si vous accédez à Claude par l'intermédiaire d'un fournisseur tiers comme Amazon Bedrock ou Google Cloud's Agent Platform, consultez [Utiliser des fournisseurs tiers](#use-third-party-providers) pour les instructions de configuration.

23 23 

24<Tip>24<Tip>

25 L'extension inclut sa propre copie du CLI (interface de ligne de commande) pour le panneau de chat. Pour exécuter `claude` dans le terminal intégré de VS Code, vous avez également besoin de l'[installation CLI autonome](/fr/setup). Consultez [Extension VS Code vs. CLI Claude Code](#vs-code-extension-vs-claude-code-cli) pour plus de détails.25 L'extension inclut sa propre copie du CLI (interface de ligne de commande) pour le panneau de chat. Pour exécuter `claude` dans le terminal intégré de VS Code, vous avez également besoin de l'[installation CLI autonome](/fr/setup). Consultez [Extension VS Code vs. CLI Claude Code](#vs-code-extension-vs-claude-code-cli) pour plus de détails.


102 102 

103La zone de saisie prend en charge plusieurs fonctionnalités :103La zone de saisie prend en charge plusieurs fonctionnalités :

104 104 

105* **Modes de permission** : cliquez sur l'indicateur de mode en bas de la zone de saisie pour changer de mode. En mode normal, Claude demande une permission avant chaque action. En Plan Mode, Claude décrit ce qu'il fera et attend l'approbation avant d'apporter des modifications. VS Code ouvre automatiquement le plan en tant que document markdown complet où vous pouvez ajouter des commentaires en ligne pour donner des commentaires avant que Claude ne commence. En mode acceptation automatique, Claude apporte des modifications sans demander. Définissez la valeur par défaut dans les paramètres VS Code sous `claudeCode.initialPermissionMode`.105* **Modes de permission** : cliquez sur l'indicateur de mode en bas de la zone de saisie pour changer de mode, ou définissez la valeur par défaut dans les paramètres VS Code sous `claudeCode.initialPermissionMode`. Consultez [modes de permission](/fr/permission-modes#switch-permission-modes) pour chaque mode que l'indicateur propose.

106 * **Manuel** : Claude demande une permission avant chaque action.

107 * **Plan** : Claude décrit ce qu'il fera et attend l'approbation avant d'apporter des modifications. VS Code ouvre automatiquement le plan en tant que document Markdown complet où vous pouvez ajouter des commentaires en ligne pour donner des commentaires avant que Claude ne commence.

108 * **Édition automatique** : Claude apporte des modifications sans demander.

106* **Menu de commandes** : cliquez sur `/` ou tapez `/` pour ouvrir le menu de commandes. Les options incluent l'attachement de fichiers, le changement de modèles, l'activation de la réflexion étendue, l'affichage de l'utilisation du plan (`/usage`) et le démarrage d'une session [Remote Control](/fr/remote-control) (`/remote-control`). La section Personnaliser fournit l'accès aux serveurs MCP, hooks, mémoire, permissions et plugins. Les éléments avec une icône de terminal s'ouvrent dans le terminal intégré.109* **Menu de commandes** : cliquez sur `/` ou tapez `/` pour ouvrir le menu de commandes. Les options incluent l'attachement de fichiers, le changement de modèles, l'activation de la réflexion étendue, l'affichage de l'utilisation du plan (`/usage`) et le démarrage d'une session [Remote Control](/fr/remote-control) (`/remote-control`). La section Personnaliser fournit l'accès aux serveurs MCP, hooks, mémoire, permissions et plugins. Les éléments avec une icône de terminal s'ouvrent dans le terminal intégré.

110 * {/* min-version: 2.1.203 */}La section Paramètres inclut **Activer Remote Control pour toutes les sessions**, qui définit [`remoteControlAtStartup`](/fr/settings#available-settings) afin que [chaque nouvelle session interactive se connecte automatiquement à Remote Control](/fr/remote-control#enable-remote-control-for-all-sessions). Nécessite Claude Code v2.1.203 ou version ultérieure.

107* **Indicateur de contexte** : la zone de saisie affiche la quantité de fenêtre de contexte de Claude que vous utilisez. Claude se compacte automatiquement si nécessaire, ou vous pouvez exécuter `/compact` manuellement.111* **Indicateur de contexte** : la zone de saisie affiche la quantité de fenêtre de contexte de Claude que vous utilisez. Claude se compacte automatiquement si nécessaire, ou vous pouvez exécuter `/compact` manuellement.

108* **Réflexion étendue** : permet à Claude de consacrer plus de temps à raisonner sur des problèmes complexes. Activez-la via le menu de commandes (`/`). Le raisonnement de Claude apparaît dans la conversation sous forme de blocs réduits : cliquez sur un bloc pour le lire, ou appuyez sur `Ctrl+O` pour développer ou réduire chaque bloc de réflexion dans la session. Consultez [Réflexion étendue](/fr/model-config#extended-thinking) pour plus de détails.112* **Réflexion étendue** : permet à Claude de consacrer plus de temps à raisonner sur des problèmes complexes. Activez-la via le menu de commandes (`/`). Le raisonnement de Claude apparaît dans la conversation sous forme de blocs réduits : cliquez sur un bloc pour le lire, ou appuyez sur `Ctrl+O` pour développer ou réduire chaque bloc de réflexion dans la session. Consultez [Réflexion étendue](/fr/model-config#extended-thinking) pour plus de détails.

109* **Entrée multiligne** : appuyez sur `Shift+Entrée` pour ajouter une nouvelle ligne sans envoyer. Cela fonctionne également dans l'entrée en texte libre ' Autre ' des dialogues de question.113* **Entrée multiligne** : appuyez sur `Shift+Entrée` pour ajouter une nouvelle ligne sans envoyer. Cela fonctionne également dans l'entrée en texte libre « Autre » des dialogues de question.

110 114 

111<h3 id="reference-files-and-folders">115<h3 id="reference-files-and-folders">

112 Référencer des fichiers et des dossiers116 Référencer des fichiers et des dossiers


356</h3>360</h3>

357 361 

358| Paramètre | Par défaut | Description |362| Paramètre | Par défaut | Description |

359| ----------------------------------- | ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |363| ----------------------------------- | ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

360| `useTerminal` | `false` | Lancer Claude en mode terminal au lieu du panneau graphique |364| `useTerminal` | `false` | Lancer Claude en mode terminal au lieu du panneau graphique |

361| `initialPermissionMode` | `default` | Contrôle les invites d'approbation pour les nouvelles conversations : `default`, `plan`, `acceptEdits` ou `bypassPermissions`. Consultez [modes de permission](/fr/permission-modes). |365| `initialPermissionMode` | `default` | Contrôle les invites d'approbation pour les nouvelles conversations : `default`, `plan`, `acceptEdits` ou `bypassPermissions`. {/* min-version: 2.1.200 */}`manual` est un alias pour `default` et sélectionne le mode étiqueté **Manual** dans l'indicateur de mode. Nécessite Claude Code v2.1.200 ou version ultérieure. Consultez [modes de permission](/fr/permission-modes). |

362| `preferredLocation` | `panel` | Où Claude s'ouvre : `sidebar` (droite) ou `panel` (nouvel onglet) |366| `preferredLocation` | `panel` | Où Claude s'ouvre : `sidebar` (droite) ou `panel` (nouvel onglet) |

363| `autosave` | `true` | Enregistrement automatique des fichiers avant que Claude ne les lise ou ne les écrive |367| `autosave` | `true` | Enregistrement automatique des fichiers avant que Claude ne les lise ou ne les écrive |

364| `useCtrlEnterToSend` | `false` | Utiliser Ctrl/Cmd+Entrée au lieu d'Entrée pour envoyer les invites |368| `useCtrlEnterToSend` | `false` | Utiliser Ctrl/Cmd+Entrée au lieu d'Entrée pour envoyer les invites |


479 Utiliser des fournisseurs tiers483 Utiliser des fournisseurs tiers

480</h2>484</h2>

481 485 

482Par défaut, Claude Code se connecte directement à l'API d'Anthropic. Si votre organisation utilise Amazon Bedrock, Google Vertex AI ou Microsoft Foundry pour accéder à Claude, configurez l'extension pour utiliser votre fournisseur à la place :486Par défaut, Claude Code se connecte directement à l'API d'Anthropic. Si votre organisation utilise Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry pour accéder à Claude, configurez l'extension pour utiliser votre fournisseur à la place :

483 487 

484<Steps>488<Steps>

485 <Step title="Désactiver l'invite de connexion">489 <Step title="Désactiver l'invite de connexion">


492 Suivez le guide de configuration de votre fournisseur :496 Suivez le guide de configuration de votre fournisseur :

493 497 

494 * [Claude Code sur Amazon Bedrock](/fr/amazon-bedrock)498 * [Claude Code sur Amazon Bedrock](/fr/amazon-bedrock)

495 * [Claude Code sur Google Vertex AI](/fr/google-vertex-ai)499 * [Claude Code sur Google Cloud's Agent Platform](/fr/google-vertex-ai)

496 * [Claude Code sur Microsoft Foundry](/fr/microsoft-foundry)500 * [Claude Code sur Microsoft Foundry](/fr/microsoft-foundry)

497 501 

498 Ces guides couvrent la configuration de votre fournisseur dans `~/.claude/settings.json`, ce qui garantit que vos paramètres sont partagés entre l'extension VS Code et le CLI.502 Ces guides couvrent la configuration de votre fournisseur dans `~/.claude/settings.json`, ce qui garantit que vos paramètres sont partagés entre l'extension VS Code et le CLI.

Details

43Claude Code se comporte de la même manière partout. Ce qui change, c'est où le code s'exécute et si votre configuration locale est disponible. L'application Desktop offre à la fois des sessions locales et cloud, donc ses réponses ci-dessous dépendent de celle que vous choisissez :43Claude Code se comporte de la même manière partout. Ce qui change, c'est où le code s'exécute et si votre configuration locale est disponible. L'application Desktop offre à la fois des sessions locales et cloud, donc ses réponses ci-dessous dépendent de celle que vous choisissez :

44 44 

45| | Sur le web | Remote Control | Terminal CLI | Application Desktop |45| | Sur le web | Remote Control | Terminal CLI | Application Desktop |

46| :-------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------- | :---------------------- | :--------------------------------- |46| :-------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------ | :--------------------------------------------------------- | :---------------------- | :--------------------------------- |

47| **Le code s'exécute sur** | VM cloud Anthropic | Votre machine | Votre machine | Votre machine ou VM cloud |47| **Le code s'exécute sur** | VM cloud Anthropic | Votre machine | Votre machine | Votre machine ou VM cloud |

48| **Vous discutez depuis** | claude.ai ou application mobile | claude.ai ou application mobile | Votre terminal | L'interface utilisateur Desktop |48| **Vous discutez depuis** | claude.ai ou application mobile | claude.ai ou application mobile | Votre terminal | L'interface utilisateur Desktop |

49| **Utilise votre configuration locale** | Non, référentiel uniquement | Oui | Oui | Oui pour local, non pour cloud |49| **Utilise votre configuration locale** | Non, référentiel uniquement | Oui | Oui | Oui pour local, non pour cloud |

50| **Nécessite GitHub** | Oui, ou [regroupez un référentiel local](/fr/claude-code-on-the-web#send-local-repositories-without-github) via `--remote` | Non | Non | Uniquement pour les sessions cloud |50| **Nécessite GitHub** | Oui, ou [regroupez un référentiel local](/fr/claude-code-on-the-web#send-local-repositories-without-github) via `--cloud` | Non | Non | Uniquement pour les sessions cloud |

51| **Continue de s'exécuter si vous vous déconnectez** | Oui | Tant que le terminal reste ouvert | Non | Dépend du type de session |51| **Continue de s'exécuter si vous vous déconnectez** | Oui | Tant que le terminal reste ouvert | Non | Dépend du type de session |

52| **[Modes de permission](/fr/permission-modes)** | Accepter les modifications, Plan, Auto | Demander, Accepter automatiquement les modifications, Plan | Tous les modes | Dépend du type de session |52| **[Modes de permission](/fr/permission-modes)** | Accepter les modifications, Plan, Auto | Demander, Accepter automatiquement les modifications, Plan | Tous les modes | Dépend du type de session |

53| **Accès réseau** | Configurable par environnement | Réseau de votre machine | Réseau de votre machine | Dépend du type de session |53| **Accès réseau** | Configurable par environnement | Réseau de votre machine | Réseau de votre machine | Dépend du type de session |


113 /web-setup113 /web-setup

114 ```114 ```

115 115 

116 Cela synchronise votre jeton `gh` avec votre compte Claude. Si vous n'avez pas encore d'environnement cloud, `/web-setup` en crée un avec accès réseau Trusted et aucun script de configuration. Vous pouvez [modifier l'environnement ou ajouter des variables](/fr/claude-code-on-the-web#configure-your-environment) après. Une fois que `/web-setup` est terminé, vous pouvez démarrer des sessions cloud depuis votre terminal avec [`--remote`](/fr/claude-code-on-the-web#from-terminal-to-web) ou configurer des tâches récurrentes avec [`/schedule`](/fr/routines).116 Cela synchronise votre jeton `gh` avec votre compte Claude. Si vous n'avez pas encore d'environnement cloud, `/web-setup` en crée un avec accès réseau Trusted et aucun script de configuration. Vous pouvez [modifier l'environnement ou ajouter des variables](/fr/claude-code-on-the-web#configure-your-environment) après. Une fois que `/web-setup` est terminé, vous pouvez démarrer des sessions cloud depuis votre terminal avec [`--cloud`](/fr/claude-code-on-the-web#from-terminal-to-web) ou configurer des tâches récurrentes avec [`/schedule`](/fr/routines).

117 </Step>117 </Step>

118</Steps>118</Steps>

119 119 


129 </Step>129 </Step>

130 130 

131 <Step title="Choisissez un mode de permission">131 <Step title="Choisissez un mode de permission">

132 Le menu déroulant du mode à côté de l'entrée par défaut est **Accepter automatiquement les modifications**, où Claude effectue des modifications et pousse une branche sans s'arrêter pour approbation. Basculez vers **Plan Mode** si vous voulez que Claude propose une approche et attende votre feu vert avant de modifier les fichiers. Les sessions cloud n'offrent pas les permissions Ask ou Bypass permissions. Consultez [Modes de permission](/fr/permission-modes) pour la liste complète.132 Le menu déroulant du mode à côté de l'entrée par défaut est **Accepter automatiquement les modifications**, où Claude effectue des modifications et pousse une branche sans s'arrêter pour approbation. Basculez vers **Plan Mode** si vous voulez que Claude propose une approche et attende votre feu vert avant de modifier les fichiers. Les sessions cloud n'offrent pas les permissions Ask ou Bypass permissions. Consultez la [liste complète des modes de permission](/fr/permission-modes#available-modes) pour savoir ce que chacun permet.

133 </Step>133 </Step>

134 134 

135 <Step title="Décrivez la tâche et soumettez">135 <Step title="Décrivez la tâche et soumettez">

136 Tapez une description de ce que vous voulez et appuyez sur Entrée. Soyez spécifique :136 Tapez une description de ce que vous voulez et appuyez sur Entrée. Soyez spécifique :

137 137 

138 * Nommez le fichier ou la fonction : ' Ajouter un README avec les instructions de configuration ' ou ' Corriger le test d'authentification défaillant dans `tests/test_auth.py` ' est mieux que ' corriger les tests '138 * Nommez le fichier ou la fonction : « Ajouter un README avec les instructions de configuration » ou « Corriger le test d'authentification défaillant dans `tests/test_auth.py` » est mieux que « corriger les tests »

139 * Collez la sortie d'erreur si vous l'avez139 * Collez la sortie d'erreur si vous l'avez

140 * Décrivez le comportement attendu, pas seulement le symptôme140 * Décrivez le comportement attendu, pas seulement le symptôme

141 141 


216 216 

217Si vous l'avez tapé à l'intérieur de Claude Code et le menu de commandes affiche `Aucune commande ne correspond à "/web-setup"`, ou que le soumettre retourne `Commande inconnue : /web-setup`, la commande est masquée parce qu'une exigence n'est pas satisfaite. La cause est généralement que votre CLI est plus ancienne que v2.1.80 ou vous êtes authentifié avec une clé API ou un fournisseur tiers au lieu d'un abonnement claude.ai. Exécutez `claude update`, puis `/login` pour vous connecter avec votre compte claude.ai.217Si vous l'avez tapé à l'intérieur de Claude Code et le menu de commandes affiche `Aucune commande ne correspond à "/web-setup"`, ou que le soumettre retourne `Commande inconnue : /web-setup`, la commande est masquée parce qu'une exigence n'est pas satisfaite. La cause est généralement que votre CLI est plus ancienne que v2.1.80 ou vous êtes authentifié avec une clé API ou un fournisseur tiers au lieu d'un abonnement claude.ai. Exécutez `claude update`, puis `/login` pour vous connecter avec votre compte claude.ai.

218 218 

219<h3 id="could-not-create-a-cloud-environment-or-no-cloud-environment-available-when-using-remote-or-ultraplan">219<h3 id="could-not-create-a-cloud-environment-or-no-cloud-environment-available-when-using-cloud-or-ultraplan">

220 « Impossible de créer un environnement cloud » ou « Aucun environnement cloud disponible » lors de l'utilisation de `--remote` ou ultraplan220 « Impossible de créer un environnement cloud » ou « Aucun environnement cloud disponible » lors de l'utilisation de `--cloud` ou ultraplan

221</h3>221</h3>

222 222 

223Les fonctionnalités de session à distance créent automatiquement un environnement cloud par défaut si vous n'en avez pas. Si vous voyez « Impossible de créer un environnement cloud », la création automatique a échoué. {/* max-version: 2.1.100 */}Si vous voyez « Aucun environnement cloud disponible », votre CLI est antérieur à la création automatique. Dans les deux cas, exécutez `/web-setup` dans la CLI Claude Code pour en créer un manuellement, ou visitez [claude.ai/code](https://claude.ai/code) et suivez l'étape **Créez votre environnement** ci-dessus.223Les fonctionnalités de session à distance créent automatiquement un environnement cloud par défaut si vous n'en avez pas. Si vous voyez « Impossible de créer un environnement cloud », la création automatique a échoué. {/* max-version: 2.1.100 */}Si vous voyez « Aucun environnement cloud disponible », votre CLI est antérieur à la création automatique. Dans les deux cas, exécutez `/web-setup` dans la CLI Claude Code pour en créer un manuellement, ou visitez [claude.ai/code](https://claude.ai/code) et suivez l'étape **Créez votre environnement** ci-dessus.

whats-new.md +1 −1

Details

33</Update>33</Update>

34 34 

35<Update label="Week 23" description="1er–5 juin 2026" tags={["v2.1.158–v2.1.165"]}>35<Update label="Week 23" description="1er–5 juin 2026" tags={["v2.1.158–v2.1.165"]}>

36 **Auto mode sur Bedrock, Vertex et Foundry** : auto mode est maintenant disponible sur les fournisseurs tiers pour Opus 4.7 et Opus 4.8, remplaçant les invites de permission par des vérifications de sécurité en arrière-plan.36 **Auto mode sur Amazon Bedrock, Google Cloud's Agent Platform et Microsoft Foundry** : auto mode est maintenant disponible sur les fournisseurs tiers pour Opus 4.7 et Opus 4.8, remplaçant les invites de permission par des vérifications de sécurité en arrière-plan.

37 37 

38 Également cette semaine : **les modifications automatiques plus sûres** demandent une confirmation avant d'écrire des fichiers qui peuvent exécuter du code en mode `acceptEdits` ; **`/plugin list`** affiche vos plugins installés en ligne ; et les **exigences de version** permettent aux déploiements gérés d'exiger une plage de version Claude Code approuvée.38 Également cette semaine : **les modifications automatiques plus sûres** demandent une confirmation avant d'écrire des fichiers qui peuvent exécuter du code en mode `acceptEdits` ; **`/plugin list`** affiche vos plugins installés en ligne ; et les **exigences de version** permettent aux déploiements gérés d'exiger une plage de version Claude Code approuvée.

39 39 

Details

102 102 

103 <div className="digest-wins-grid">103 <div className="digest-wins-grid">

104 <div>Vue de focus : appuyez sur <code>Ctrl+O</code> en mode sans scintillement pour réduire la vue à votre dernier prompt, un résumé d'outil d'une ligne avec diffstats, et la réponse finale de Claude</div>104 <div>Vue de focus : appuyez sur <code>Ctrl+O</code> en mode sans scintillement pour réduire la vue à votre dernier prompt, un résumé d'outil d'une ligne avec diffstats, et la réponse finale de Claude</div>

105 <div>Assistants de configuration guidés <a href="/fr/docs/amazon-bedrock">Bedrock</a> et <a href="/fr/docs/google-vertex-ai">Vertex AI</a> sur l'écran de connexion : choisissez « plateforme tierce » pour une authentification étape par étape, une région, une vérification des identifiants et un épinglage de modèle</div>105 <div>Assistants de configuration guidés <a href="/fr/docs/amazon-bedrock">Amazon Bedrock</a> et <a href="/fr/docs/google-vertex-ai">Plateforme Agent de Google Cloud</a> sur l'écran de connexion : choisissez « plateforme tierce » pour une authentification étape par étape, une région, une vérification des identifiants et un épinglage de modèle</div>

106 <div><code>/agents</code> obtient une disposition en onglets : un onglet En cours affiche les sous-agents en direct avec un compte <code>● N en cours</code>, plus les actions Exécuter l'agent et Afficher l'instance en cours dans l'onglet Bibliothèque</div>106 <div><code>/agents</code> obtient une disposition en onglets : un onglet En cours affiche les sous-agents en direct avec un compte <code>● N en cours</code>, plus les actions Exécuter l'agent et Afficher l'instance en cours dans l'onglet Bibliothèque</div>

107 <div>Le niveau d'effort par défaut est maintenant <code>high</code> pour les utilisateurs de clé API, Bedrock, Vertex, Foundry, Team et Enterprise (contrôlez avec <code>/effort</code>)</div>107 <div>Le niveau d'effort par défaut est maintenant <code>high</code> pour les utilisateurs de clé API, Amazon Bedrock, Plateforme Agent de Google Cloud, Microsoft Foundry, Team et Enterprise (contrôlez avec <code>/effort</code>)</div>

108 <div><code>/cost</code> affiche une ventilation par modèle et par accès au cache pour les utilisateurs d'abonnement</div>108 <div><code>/cost</code> affiche une ventilation par modèle et par accès au cache pour les utilisateurs d'abonnement</div>

109 <div><code>/release-notes</code> est maintenant un sélecteur de version interactif</div>109 <div><code>/release-notes</code> est maintenant un sélecteur de version interactif</div>

110 <div>Ligne d'état : nouveau paramètre <code>refreshInterval</code> qui réexécute la commande toutes les N secondes, et <code>workspace.git\_worktree</code> dans l'entrée JSON</div>110 <div>Ligne d'état : nouveau paramètre <code>refreshInterval</code> qui réexécute la commande toutes les N secondes, et <code>workspace.git\_worktree</code> dans l'entrée JSON</div>

Details

105 <div>Les serveurs MCP qui rencontrent une erreur transitoire lors du démarrage réessaient maintenant jusqu'à 3 fois au lieu de rester déconnectés</div>105 <div>Les serveurs MCP qui rencontrent une erreur transitoire lors du démarrage réessaient maintenant jusqu'à 3 fois au lieu de rester déconnectés</div>

106 <div><code>ANTHROPIC\_BEDROCK\_SERVICE\_TIER</code> sélectionne un niveau de service Bedrock : <code>default</code>, <code>flex</code>, ou <code>priority</code></div>106 <div><code>ANTHROPIC\_BEDROCK\_SERVICE\_TIER</code> sélectionne un niveau de service Bedrock : <code>default</code>, <code>flex</code>, ou <code>priority</code></div>

107 <div><code>/terminal-setup</code> active le paramètre d'accès au presse-papiers d'iTerm2 afin que <code>/copy</code> fonctionne, y compris depuis tmux</div>107 <div><code>/terminal-setup</code> active le paramètre d'accès au presse-papiers d'iTerm2 afin que <code>/copy</code> fonctionne, y compris depuis tmux</div>

108 <div>Vertex AI supporte maintenant la Fédération d'identité de charge de travail basée sur les certificats X.509 (mTLS ADC)</div>108 <div>La plateforme Agent de Google Cloud supporte maintenant la Fédération d'identité de charge de travail basée sur les certificats X.509 (mTLS ADC)</div>

109 <div>Corrections importantes des fuites mémoire : sessions riches en images, <code>/usage</code> sur les historiques de transcription volumineux, et outils de longue durée sans événements de progression</div>109 <div>Corrections importantes des fuites mémoire : sessions riches en images, <code>/usage</code> sur les historiques de transcription volumineux, et outils de longue durée sans événements de progression</div>

110 </div>110 </div>

111</div>111</div>

Details

37 <div>Nouvelle commande <a href="/fr/code-review"><code>/code-review</code></a> qui signale les bugs de correction à un niveau d'effort choisi comme <code>/code-review high</code>, et <code>--comment</code> publie les résultats sous forme de commentaires GitHub PR en ligne. <code>/simplify</code> reste un examen séparé de nettoyage uniquement.</div>37 <div>Nouvelle commande <a href="/fr/code-review"><code>/code-review</code></a> qui signale les bugs de correction à un niveau d'effort choisi comme <code>/code-review high</code>, et <code>--comment</code> publie les résultats sous forme de commentaires GitHub PR en ligne. <code>/simplify</code> reste un examen séparé de nettoyage uniquement.</div>

38 <div>Les sessions en arrière-plan apparaissent désormais dans <code>/resume</code> aux côtés des sessions interactives, marquées avec <code>bg</code>, et les sessions épinglées avec <code>Ctrl+T</code> dans <code>claude agents</code> restent actives en cas d'inactivité</div>38 <div>Les sessions en arrière-plan apparaissent désormais dans <code>/resume</code> aux côtés des sessions interactives, marquées avec <code>bg</code>, et les sessions épinglées avec <code>Ctrl+T</code> dans <code>claude agents</code> restent actives en cas d'inactivité</div>

39 <div><code>claude agents --json</code> répertorie les sessions actives au format JSON pour les scripts, comme les barres d'état et les sélecteurs de session</div>39 <div><code>claude agents --json</code> répertorie les sessions actives au format JSON pour les scripts, comme les barres d'état et les sélecteurs de session</div>

40 <div>L'outil PowerShell est désormais activé par défaut sur Windows pour les utilisateurs de Bedrock, Vertex et Foundry ; désactivez-le avec <code>CLAUDE\_CODE\_USE\_POWERSHELL\_TOOL=0</code></div>40 <div>L'outil PowerShell est désormais activé par défaut sur Windows pour les utilisateurs d'Amazon Bedrock, de Google Cloud's Agent Platform et de Microsoft Foundry ; désactivez-le avec <code>CLAUDE\_CODE\_USE\_POWERSHELL\_TOOL=0</code></div>

41 <div><code>claude plugin disable</code> refuse désormais quand un autre plugin activé dépend de la cible, et <code>claude plugin enable</code> force-active les dépendances transitives</div>41 <div><code>claude plugin disable</code> refuse désormais quand un autre plugin activé dépend de la cible, et <code>claude plugin enable</code> force-active les dépendances transitives</div>

42 <div>Le volet de navigation du marché <code>/plugin</code> affiche le coût de contexte projeté, et les écrans Découvrir et Parcourir répertorient les commandes, agents, compétences, hooks et serveurs MCP/LSP d'un plugin avant l'installation</div>42 <div>Le volet de navigation du marché <code>/plugin</code> affiche le coût de contexte projeté, et les écrans Découvrir et Parcourir répertorient les commandes, agents, compétences, hooks et serveurs MCP/LSP d'un plugin avant l'installation</div>

43 <div>Nouveau paramètre <code>worktree.bgIsolation: "none"</code> qui permet aux sessions en arrière-plan de modifier directement la copie de travail sans <code>EnterWorktree</code>, pour les dépôts où les worktrees ne sont pas pratiques</div>43 <div>Nouveau paramètre <code>worktree.bgIsolation: "none"</code> qui permet aux sessions en arrière-plan de modifier directement la copie de travail sans <code>EnterWorktree</code>, pour les dépôts où les worktrees ne sont pas pratiques</div>

Details

109 <div>Claude Code bascule maintenant vers votre <code>--fallback-model</code> configuré pour le reste de la session lorsque le modèle principal n'est pas trouvé, au lieu d'échouer à chaque demande</div>109 <div>Claude Code bascule maintenant vers votre <code>--fallback-model</code> configuré pour le reste de la session lorsque le modèle principal n'est pas trouvé, au lieu d'échouer à chaque demande</div>

110 <div>Les plugins peuvent déclarer <code>defaultEnabled: false</code> dans <code>plugin.json</code> ou une entrée marketplace, afin qu'ils s'installent sans s'activer jusqu'à ce que vous les activiez</div>110 <div>Les plugins peuvent déclarer <code>defaultEnabled: false</code> dans <code>plugin.json</code> ou une entrée marketplace, afin qu'ils s'installent sans s'activer jusqu'à ce que vous les activiez</div>

111 <div>Mode Vim : <code>/</code> en mode NORMAL ouvre la recherche d'historique inversée, correspondant au mode vi de Bash et Zsh</div>111 <div>Mode Vim : <code>/</code> en mode NORMAL ouvre la recherche d'historique inversée, correspondant au mode vi de Bash et Zsh</div>

112 <div>L'exécution d'outils en streaming est maintenant toujours activée, y compris avec la télémétrie désactivée et sur Bedrock, Vertex et Foundry</div>112 <div>L'exécution d'outils en streaming est maintenant toujours activée, y compris avec la télémétrie désactivée et sur Amazon Bedrock, Google Cloud's Agent Platform, et Microsoft Foundry</div>

113 <div><code>←←</code> pour ouvrir la vue agents fonctionne maintenant sur Bedrock, Vertex, Foundry, et avec la télémétrie désactivée</div>113 <div><code>←←</code> pour ouvrir la vue agents fonctionne maintenant sur Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, et avec la télémétrie désactivée</div>

114 <div>Claude dans Chrome : choisissez quel navigateur connecté utiliser via <code>/chrome</code> → « Sélectionner un navigateur… », ou dans le chat lorsqu'une action de navigateur s'exécute avec plusieurs connectés</div>114 <div>Claude dans Chrome : choisissez quel navigateur connecté utiliser via <code>/chrome</code> → « Sélectionner un navigateur… », ou dans le chat lorsqu'une action de navigateur s'exécute avec plusieurs connectés</div>

115 <div><code>claude mcp list</code> et <code>claude mcp get</code> affichent maintenant les serveurs <code>.mcp.json</code> non approuvés comme en attente d'approbation au lieu d'approuver automatiquement et de se connecter lorsque la sortie est redirigée</div>115 <div><code>claude mcp list</code> et <code>claude mcp get</code> affichent maintenant les serveurs <code>.mcp.json</code> non approuvés comme en attente d'approbation au lieu d'approuver automatiquement et de se connecter lorsque la sortie est redirigée</div>

116 </div>116 </div>

Details

4 4 

5# Semaine 23 · 1er–5 juin 20265# Semaine 23 · 1er–5 juin 2026

6 6 

7> Exécutez le mode auto sur Bedrock, Vertex et Foundry, demandez une confirmation avant d'écrire des fichiers pouvant exécuter du code en mode acceptEdits, listez les plugins installés avec /plugin list, et exigez une plage de version approuvée pour les déploiements gérés.7> Exécutez le mode auto sur Amazon Bedrock, Google Cloud's Agent Platform et Microsoft Foundry, demandez une confirmation avant d'écrire des fichiers pouvant exécuter du code en mode acceptEdits, listez les plugins installés avec /plugin list, et exigez une plage de version approuvée pour les déploiements gérés.

8 8 

9<div className="digest-meta">9<div className="digest-meta">

10 <span>Versions <a href="/fr/changelog#2-1-158">v2.1.158 → v2.1.165</a></span>10 <span>Versions <a href="/fr/changelog#2-1-158">v2.1.158 → v2.1.165</a></span>


13 13 

14<div className="digest-feature">14<div className="digest-feature">

15 <div className="digest-feature-header">15 <div className="digest-feature-header">

16 <span className="digest-feature-title">Mode auto sur Bedrock, Vertex et Foundry</span>16 <span className="digest-feature-title">Mode auto sur Amazon Bedrock, Google Cloud's Agent Platform et Microsoft Foundry</span>

17 <span className="digest-feature-pill">v2.1.158</span>17 <span className="digest-feature-pill">v2.1.158</span>

18 </div>18 </div>

19 19 

20 <p className="digest-feature-lede">Le mode auto est désormais disponible sur Bedrock, Vertex et Foundry pour Opus 4.7 et Opus 4.8, remplaçant les invites de permission par des vérifications de sécurité en arrière-plan sur les fournisseurs tiers. Activez-le en définissant <code>CLAUDE\_CODE\_ENABLE\_AUTO\_MODE=1</code>.</p>20 <p className="digest-feature-lede">Le mode auto est désormais disponible sur Amazon Bedrock, Google Cloud's Agent Platform et Microsoft Foundry pour Opus 4.7 et Opus 4.8, remplaçant les invites de permission par des vérifications de sécurité en arrière-plan sur les fournisseurs tiers. Activez-le en définissant <code>CLAUDE\_CODE\_ENABLE\_AUTO\_MODE=1</code>.</p>

21 21 

22 <p className="digest-feature-try">Activez-le sur un fournisseur tiers, puis basculez vers le mode auto avec Maj+Tab :</p>22 <p className="digest-feature-try">Activez-le sur un fournisseur tiers, puis basculez vers le mode auto avec Maj+Tab :</p>

23 23 


25 export CLAUDE_CODE_ENABLE_AUTO_MODE=125 export CLAUDE_CODE_ENABLE_AUTO_MODE=1

26 ```26 ```

27 27 

28 <a className="digest-feature-link" href="/fr/permission-modes#enable-auto-mode-on-bedrock-vertex-ai-or-foundry">Activez le mode auto sur les fournisseurs tiers</a>28 <a className="digest-feature-link" href="/fr/permission-modes#enable-auto-mode-on-bedrock-agent-platform-or-foundry">Activez le mode auto sur les fournisseurs tiers</a>

29</div>29</div>

30 30 

31<div className="digest-feature">31<div className="digest-feature">

workflows.md +28 −2

Details

9{/* plan-availability: feature=workflows plans=pro,max,team,enterprise providers=all */}9{/* plan-availability: feature=workflows plans=pro,max,team,enterprise providers=all */}

10 10 

11<Note>11<Note>

12 Les workflows dynamiques nécessitent Claude Code v2.1.154 ou version ultérieure et sont disponibles sur tous les plans payants, avec accès à l'API Anthropic, et sur Amazon Bedrock, Google Cloud Vertex AI et Microsoft Foundry. Sur Pro, activez-les à partir de la ligne Dynamic workflows dans `/config`.12 Les workflows dynamiques nécessitent Claude Code v2.1.154 ou version ultérieure et sont disponibles sur tous les plans payants, avec accès à l'API Anthropic, et sur Amazon Bedrock, Google Cloud's Agent Platform et Microsoft Foundry. Sur Pro, activez-les à partir de la ligne Dynamic workflows dans `/config`.

13</Note>13</Note>

14 14 

15Un workflow dynamique est un script JavaScript qui orchestre des [sous-agents](/fr/sub-agents) à grande échelle. Claude écrit le script pour la tâche que vous décrivez, et un runtime l'exécute en arrière-plan tandis que votre session reste réactive.15Un workflow dynamique est un script JavaScript qui orchestre des [sous-agents](/fr/sub-agents) à grande échelle. Claude écrit le script pour la tâche que vous décrivez, et un runtime l'exécute en arrière-plan tandis que votre session reste réactive.


148/effort ultracode148/effort ultracode

149```149```

150 150 

151Pour démarrer une session avec ultracode déjà activé, lancez avec `claude --effort ultracode`. Nécessite Claude Code v2.1.203 ou ultérieur.

152 

151Avec ultracode activé, Claude décide quand une tâche justifie un workflow. Une seule demande peut se transformer en plusieurs workflows d'affilée : un pour comprendre le code, un pour faire le changement, et un pour le vérifier. Cela s'applique à chaque tâche de la session, donc chaque demande utilise plus de tokens et prend plus de temps qu'aux niveaux d'effort inférieurs.153Avec ultracode activé, Claude décide quand une tâche justifie un workflow. Une seule demande peut se transformer en plusieurs workflows d'affilée : un pour comprendre le code, un pour faire le changement, et un pour le vérifier. Cela s'applique à chaque tâche de la session, donc chaque demande utilise plus de tokens et prend plus de temps qu'aux niveaux d'effort inférieurs.

152 154 

153Ultracode dure pour la session actuelle et se réinitialise quand vous en commencez une nouvelle. Revenez avec `/effort high` quand vous retournez au travail de routine. Il est disponible sur les modèles qui supportent l'[effort](/fr/model-config#adjust-effort-level) `xhigh` ; sur les autres modèles, le menu `/effort` ne l'offre pas.155Ultracode dure pour la session actuelle et se réinitialise quand vous en commencez une nouvelle. Revenez avec `/effort high` quand vous retournez au travail de routine. Il est disponible sur les modèles qui supportent l'[effort](/fr/model-config#adjust-effort-level) `xhigh` ; sur les autres modèles, le menu `/effort` ne l'offre pas.


346 348 

347Un workflow génère de nombreux agents, donc une seule exécution peut utiliser significativement plus de tokens que de travailler à travers la même tâche en conversation. Les exécutions comptent vers l'utilisation de votre plan et les limites de débit comme toute autre session.349Un workflow génère de nombreux agents, donc une seule exécution peut utiliser significativement plus de tokens que de travailler à travers la même tâche en conversation. Les exécutions comptent vers l'utilisation de votre plan et les limites de débit comme toute autre session.

348 350 

349Pour évaluer les dépenses avant de vous engager dans une tâche importante, exécutez d'abord le workflow sur un petit échantillon : un répertoire au lieu de l'ensemble du dépôt, ou une question étroite au lieu d'une question large. La vue `/workflows` affiche l'utilisation des tokens de chaque agent au fur et à mesure que l'exécution progresse, et vous pouvez arrêter l'exécution à tout moment sans perdre le travail terminé. Les [limites de comportement](#behavior-and-limits) du runtime limitent le nombre d'agents qu'une seule exécution peut générer, ce qui limite le coût d'un script qui s'échappe.351Pour évaluer les dépenses avant de vous engager dans une tâche importante, exécutez d'abord le workflow sur un petit échantillon : un répertoire au lieu de l'ensemble du dépôt, ou une question étroite au lieu d'une question large. La vue `/workflows` affiche l'utilisation des tokens de chaque agent au fur et à mesure que l'exécution progresse, et vous pouvez arrêter l'exécution à tout moment sans perdre le travail terminé. Les [limites de comportement](#behavior-and-limits) du runtime limitent le nombre d'agents qu'une seule exécution peut générer, ce qui limite le coût d'un script qui s'échappe. Pour garder chaque exécution plus petite par défaut, [définissez une directive de taille](#set-a-size-guideline) dans `/config`.

352 

353Claude Code signale également une exécution qui devient anormalement grande. Quand un workflow planifie plus de 25 agents, ou que son total de tokens projeté dépasse 1,5 million, sa ligne de progression dans le panneau des tâches sous la zone de saisie affiche un avertissement `Large workflow`. L'avertissement vous dirige vers [`/workflows`](#watch-the-run), où vous pouvez arrêter l'exécution. Nécessite Claude Code v2.1.203 ou ultérieur.

354 

355L'avertissement est consultatif : il ne met pas en pause ou ne limite pas l'exécution. Deux paramètres changent quand vous le voyez :

356 

357* Si vous [définissez une directive de taille](#set-a-size-guideline), le nombre d'agents de la directive remplace le seuil de 25 agents.

358* Les sessions avec [ultracode](#let-claude-decide-with-ultracode) activé n'affichent pas l'avertissement, car l'activation d'ultracode vous inscrit déjà aux exécutions importantes.

350 359 

351Chaque agent dans un workflow utilise le modèle de votre session sauf si le script achemine une étape vers un autre. Pour contrôler le coût du modèle :360Chaque agent dans un workflow utilise le modèle de votre session sauf si le script achemine une étape vers un autre. Pour contrôler le coût du modèle :

352 361 

353* Vérifiez `/model` avant une exécution importante si vous basculez généralement vers un modèle plus petit pour le travail de routine362* Vérifiez `/model` avant une exécution importante si vous basculez généralement vers un modèle plus petit pour le travail de routine

354* Demandez à Claude d'utiliser un modèle plus petit pour les étapes qui n'ont pas besoin du plus fort quand vous décrivez la tâche363* Demandez à Claude d'utiliser un modèle plus petit pour les étapes qui n'ont pas besoin du plus fort quand vous décrivez la tâche

355 364 

365<h3 id="set-a-size-guideline">

366 Définir une directive de taille

367</h3>

368 

369Le paramètre Dynamic workflow size dans `/config` garde les workflows que Claude écrit à une échelle plus petite par défaut. Claude Code envoie le paramètre à Claude comme conseil, donc une invite qui appelle une échelle différente le remplace toujours. Nécessite Claude Code v2.1.202 ou ultérieur.

370 

371Chaque valeur définit le nombre d'agents que Claude vise dans les scripts qu'il écrit.

372 

373| Valeur | Conseil envoyé à Claude |

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

375| `unrestricted` | Aucune directive. C'est la valeur par défaut. |

376| `small` | Viser moins de 5 agents. |

377| `medium` | Viser moins de 15 agents. |

378| `large` | Viser moins de 50 agents. |

379 

380Les modifications prennent effet à l'invite suivante. Les [limites d'agents du runtime](#behavior-and-limits) s'appliquent toujours indépendamment du paramètre.

381 

356<h3 id="turn-workflows-off">382<h3 id="turn-workflows-off">

357 Désactiver les workflows383 Désactiver les workflows

358</h3>384</h3>

worktrees.md +6 −0

Details

40 40 

41Avant d'utiliser `--worktree` de manière interactive dans un répertoire pour la première fois, acceptez la boîte de dialogue de confiance de l'espace de travail en exécutant `claude` une fois dans ce répertoire. Si la confiance n'a pas encore été acceptée, `--worktree` se termine avec une erreur et vous invite à exécuter `claude` dans le répertoire en premier. Les exécutions non interactives avec `-p` ignorent la [vérification de confiance](/fr/security), donc `claude -p --worktree` procède sans elle.41Avant d'utiliser `--worktree` de manière interactive dans un répertoire pour la première fois, acceptez la boîte de dialogue de confiance de l'espace de travail en exécutant `claude` une fois dans ce répertoire. Si la confiance n'a pas encore été acceptée, `--worktree` se termine avec une erreur et vous invite à exécuter `claude` dans le répertoire en premier. Les exécutions non interactives avec `-p` ignorent la [vérification de confiance](/fr/security), donc `claude -p --worktree` procède sans elle.

42 42 

43Si Claude Code ne peut pas entrer dans le répertoire du worktree au démarrage, par exemple parce qu'un hook [`WorktreeCreate`](/fr/hooks#worktreecreate) a affiché quelque chose d'autre que le répertoire qu'il a créé, ou parce que le répertoire a été supprimé après sa configuration, Claude Code affiche une erreur nommant le chemin et se termine avec le code 1. Avant la v2.1.205, cela plantait la session, et avec `-p` cela s'arrêtait pendant environ 30 secondes avant de se terminer avec le code 0.

44 

45{/* min-version: 2.1.200 */}Les plugins installés à [portée du projet](/fr/plugins-reference#plugin-installation-scopes) à partir de l'extraction principale se chargent également dans les worktrees du même dépôt, vous n'avez donc pas besoin de les réinstaller par worktree. Cela s'applique que vous créiez le worktree avec `--worktree` ou avec `git worktree add`. Nécessite Claude Code v2.1.200 ou ultérieur.

46 

43<Tip>47<Tip>

44 Ajoutez `.claude/worktrees/` à votre `.gitignore` pour que le contenu des worktrees n'apparaisse pas comme des fichiers non suivis dans votre extraction principale.48 Ajoutez `.claude/worktrees/` à votre `.gitignore` pour que le contenu des worktrees n'apparaisse pas comme des fichiers non suivis dans votre extraction principale.

45</Tip>49</Tip>


106 110 

107Pendant qu'un agent s'exécute, Claude exécute `git worktree lock` sur son worktree pour que le nettoyage concurrent ne puisse pas le supprimer. Le verrou est libéré quand l'agent se termine. Pour nettoyer un worktree que le balayage conserve, exécutez `git worktree remove`, en ajoutant `--force` si le worktree a des modifications non validées ou des fichiers non suivis.111Pendant qu'un agent s'exécute, Claude exécute `git worktree lock` sur son worktree pour que le nettoyage concurrent ne puisse pas le supprimer. Le verrou est libéré quand l'agent se termine. Pour nettoyer un worktree que le balayage conserve, exécutez `git worktree remove`, en ajoutant `--force` si le worktree a des modifications non validées ou des fichiers non suivis.

108 112 

113Sur Windows, avant de supprimer un worktree, Claude Code supprime toute jonction NTFS ou lien symbolique de répertoire à n'importe quelle profondeur à l'intérieur comme entrée de lien, afin que la suppression du worktree ne supprime pas les fichiers vers lesquels un lien pointe. Avant la v2.1.205, Claude Code supprimait uniquement les liens de niveau supérieur comme entrées de lien, et la suppression d'un worktree avec une jonction imbriquée dans un sous-répertoire pouvait supprimer le contenu du répertoire vers lequel le lien pointait en dehors du worktree.

114 

109<h2 id="manage-worktrees-manually">115<h2 id="manage-worktrees-manually">

110 Gérer les worktrees manuellement116 Gérer les worktrees manuellement

111</h2>117</h2>

Details

19* [Paramètres gérés par le serveur](/fr/server-managed-settings)19* [Paramètres gérés par le serveur](/fr/server-managed-settings)

20* Journaux d'audit20* Journaux d'audit

21 21 

22ZDR pour Claude Code sur Claude for Enterprise s'applique uniquement à la plateforme directe d'Anthropic. Pour les déploiements de Claude sur Amazon Bedrock, Google Vertex AI ou Microsoft Foundry, consultez les politiques de conservation des données de ces plateformes.22ZDR pour Claude Code sur Claude for Enterprise s'applique uniquement à la plateforme directe d'Anthropic. Pour les déploiements de Claude sur Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry, consultez les politiques de conservation des données de ces plateformes.

23 23 

24<h2 id="zdr-scope">24<h2 id="zdr-scope">

25 Portée de ZDR25 Portée de ZDR