Documentation 2026-10-10 23:01 UTC to 2026-10-11 23:57 UTC

2386 kind: "task-notification";2386 kind: "task-notification";

2387 subkind?: "scheduled-trigger" | "peer-send-message";2387 subkind?: "scheduled-trigger" | "peer-send-message";

2388 fireReason?: string;2388 fireReason?: string;

2389 runId?: string;

2389 }2390 }

2390 | { kind: "coordinator" }2391 | { kind: "coordinator" }

2391 | { kind: "auto-continuation" }2392 | { kind: "auto-continuation" }

2415 2416 

2416`fireReason` indique pourquoi une notification `scheduled-trigger` s'est déclenchée, sous la forme d'un court jeton en minuscules comme `scheduled`, `manual`, `retry`, `catch_up`, ou `api`. Les serveurs Anthropic le définissent sur les livraisons d'une [routine](/docs/fr/routines), et votre application le définit quand elle déclare une exécution planifiée. Il est absent quand ni l'un ni l'autre n'en a envoyé. Nécessite TypeScript Agent SDK v0.3.280 ou ultérieur.2417`fireReason` indique pourquoi une notification `scheduled-trigger` s'est déclenchée, sous la forme d'un court jeton en minuscules comme `scheduled`, `manual`, `retry`, `catch_up`, ou `api`. Les serveurs Anthropic le définissent sur les livraisons d'une [routine](/docs/fr/routines), et votre application le définit quand elle déclare une exécution planifiée. Il est absent quand ni l'un ni l'autre n'en a envoyé. Nécessite TypeScript Agent SDK v0.3.280 ou ultérieur.

2417 2418 

2419Une tâche en arrière-plan peut s'exécuter plusieurs fois sous le même `task_id`, par exemple lorsque Claude [reprend un sous-agent](/docs/fr/agent-sdk/subagents#resume-subagents). Chaque exécution possède son propre [`run_id`](#sdktaskstartedmessage). Lorsque la notification d'une exécution atteint votre session sous forme de message utilisateur, `runId` sur l'origine `task-notification` de ce message contient la même valeur. Une notification peut arriver après le démarrage de l'exécution suivante de la tâche, et elle porte toujours l'ID de l'exécution précédente. Pour savoir à quelle exécution appartient un tour, comparez `runId`, et non `task_id`. Nécessite le SDK Agent TypeScript v0.3.292 ou une version ultérieure.

2420 

2418<h4 id="declare-a-scheduled-run">2421<h4 id="declare-a-scheduled-run">

2419 Déclarer une exécution planifiée2422 Déclarer une exécution planifiée

2420</h4>2423</h4>

3263 Types d'entrée d'outil3266 Types d'entrée d'outil

3264</h2>3267</h2>

3265 3268 

3266Documentation des schémas d'entrée pour tous les outils Claude Code intégrés. Ces types sont exportés depuis `@anthropic-ai/claude-agent-sdk/sdk-tools` et peuvent être utilisés pour les interactions d'outils type-safe.3269Documentation des schémas d'entrée pour les outils Claude Code intégrés. Ces types sont exportés depuis `@anthropic-ai/claude-agent-sdk/sdk-tools` et peuvent être utilisés pour les interactions d'outils type-safe.

3267 3270 

3268<h3 id="toolinputschemas">3271<h3 id="toolinputschemas">

3269 `ToolInputSchemas`3272 `ToolInputSchemas`

4079 Types de sortie d'outils4082 Types de sortie d'outils

4080</h2>4083</h2>

4081 4084 

4082Documentation des schémas de sortie pour tous les outils Claude Code intégrés. Ces types sont exportés depuis `@anthropic-ai/claude-agent-sdk/sdk-tools` et représentent les données de réponse réelles renvoyées par chaque outil.4085Documentation des schémas de sortie pour les outils Claude Code intégrés. Ces types sont exportés depuis `@anthropic-ai/claude-agent-sdk/sdk-tools` et représentent les données de réponse réelles renvoyées par chaque outil.

4083 4086 

4084<h3 id="tooloutputschemas">4087<h3 id="tooloutputschemas">

4085 `ToolOutputSchemas`4088 `ToolOutputSchemas`

5732 `SDKTaskNotificationMessage`5735 `SDKTaskNotificationMessage`

5733</h3>5736</h3>

5734 5737 

5735Notification lorsqu'une tâche en arrière-plan se termine, échoue ou est arrêtée. Les tâches en arrière-plan incluent les commandes Bash `run_in_background`, les surveillances [Monitor](#monitor) et les sous-agents en arrière-plan. Pour le champ `ambient`, consultez [`SDKTaskStartedMessage`](#sdktaskstartedmessage), qui le définit et son exigence de version.5738Notification lorsqu'une tâche en arrière-plan se termine, échoue ou est arrêtée. Les tâches en arrière-plan incluent les commandes Bash `run_in_background`, les surveillances [Monitor](#monitor) et les sous-agents en arrière-plan. Pour les champs `run_id` et `ambient`, consultez [`SDKTaskStartedMessage`](#sdktaskstartedmessage), qui les définit ainsi que leurs exigences de version.

5736 5739 

5737```typescript theme={null}5740```typescript theme={null}

5738type SDKTaskNotificationMessage = {5741type SDKTaskNotificationMessage = {

5739 type: "system";5742 type: "system";

5740 subtype: "task_notification";5743 subtype: "task_notification";

5741 task_id: string;5744 task_id: string;

5745 run_id?: string;

5742 tool_use_id?: string;5746 tool_use_id?: string;

5743 status: "completed" | "failed" | "stopped";5747 status: "completed" | "failed" | "stopped";

5744 reason?: "worker_restart";5748 reason?: "worker_restart";

5911 type: "system";5915 type: "system";

5912 subtype: "task_started";5916 subtype: "task_started";

5913 task_id: string;5917 task_id: string;

5918 run_id?: string;

5914 tool_use_id?: string;5919 tool_use_id?: string;

5915 description: string;5920 description: string;

5916 task_type?: string;5921 task_type?: string;

5923};5928};

5924```5929```

5925 5930 

5931`run_id` identifie une exécution de la tâche. Lorsqu'une tâche s'exécute de nouveau sous le même `task_id`, comme un [sous-agent que Claude reprend](/docs/fr/agent-sdk/subagents#resume-subagents), la nouvelle exécution reçoit un nouveau `run_id`. Le champ nécessite Agent SDK v0.3.292 ou version ultérieure. Utilisez-le pour distinguer les exécutions d'une même tâche :

5932 

5933* **Associer les messages à une exécution** : les messages `task_started`, [`task_progress`](#sdktaskprogressmessage), [`task_updated`](#sdktaskupdatedmessage) et [`task_notification`](#sdktasknotificationmessage) d'une même exécution portent le même `run_id`. L'entrée de l'exécution dans chaque [`SDKBackgroundTasksChangedMessage`](#sdkbackgroundtaskschangedmessage) le porte également, tout comme le [`runId`](#task-notification-subkinds) sur l'origine du message utilisateur qui livre la notification de l'exécution.

5934* **Détecter un message tardif** : comparés comme de simples chaînes, les ID d'exécution d'une tâche se trient dans l'ordre de démarrage des exécutions ; un message dont le `run_id` se trie avant l'exécution que vous affichez provient donc d'une exécution antérieure. Traitez la valeur comme opaque en dehors de cette comparaison.

5935* **Se rabattre sur `task_id`** : lorsqu'un message ne porte aucun `run_id`, comme le `task_notification` qu'une session reprise émet pour clôturer une tâche que le processus précédent avait démarrée, attribuez-le par `task_id`.

5936 

5937Par exemple, ces trois messages, réduits à leurs champs d'identification, proviennent d'un sous-agent en arrière-plan que Claude a repris une fois. Les deux messages `task_started` partagent un `task_id`, et la notification qui a mis fin à la première exécution porte l'ID de la première exécution :

5938 

5939```json theme={null}

5940{"subtype": "task_started", "task_id": "a5c2e8f41b09d7a36", "run_id": "0mubbs7i8-6f0c2d41"}

5941{"subtype": "task_notification", "task_id": "a5c2e8f41b09d7a36", "run_id": "0mubbs7i8-6f0c2d41", "status": "completed"}

5942{"subtype": "task_started", "task_id": "a5c2e8f41b09d7a36", "run_id": "0mubc18m1-b7719e05"}

5943```

5944 

5926`ambient` est `true` pour les tâches qui ne font pas partie du travail de la session, telles que les tâches que Claude Code exécute pour son propre fonctionnement. Les surveillances de mise à jour en direct sont également ambiantes, y compris les surveillances que l'utilisateur a demandées. Excluez les tâches ambiantes des indicateurs d'activité. Le champ nécessite Agent SDK v0.3.247 ou version ultérieure.5945`ambient` est `true` pour les tâches qui ne font pas partie du travail de la session, telles que les tâches que Claude Code exécute pour son propre fonctionnement. Les surveillances de mise à jour en direct sont également ambiantes, y compris les surveillances que l'utilisateur a demandées. Excluez les tâches ambiantes des indicateurs d'activité. Le champ nécessite Agent SDK v0.3.247 ou version ultérieure.

5927 5946 

5928`ambient` apparaît également sur [`SDKTaskNotificationMessage`](#sdktasknotificationmessage) et sur les entrées [`SDKBackgroundTasksChangedMessage`](#sdkbackgroundtaskschangedmessage).5947`ambient` apparaît également sur [`SDKTaskNotificationMessage`](#sdktasknotificationmessage) et sur les entrées [`SDKBackgroundTasksChangedMessage`](#sdkbackgroundtaskschangedmessage).

5946 `SDKTaskProgressMessage`5965 `SDKTaskProgressMessage`

5947</h3>5966</h3>

5948 5967 

5949Émis périodiquement pendant qu'un sous-agent ou une tâche en arrière-plan s'exécute.5968Émis périodiquement pendant qu'un sous-agent ou une tâche en arrière-plan s'exécute. Pour le champ `run_id`, consultez [`SDKTaskStartedMessage`](#sdktaskstartedmessage), qui le définit ainsi que son exigence de version.

5950 5969 

5951Pour une tâche de sous-agent, le champ `summary` porte un résumé de progression généré par le modèle et n'est rempli que lorsque [`agentProgressSummaries`](#options) est activé. Pour un [appel d'outil MCP mis en arrière-plan](/docs/fr/mcp#automatic-backgrounding-of-long-tool-calls), `summary` porte le dernier progrès signalé par le serveur MCP et ne dépend pas de cette option.5970Pour une tâche de sous-agent, le champ `summary` porte un résumé de progression généré par le modèle et n'est rempli que lorsque [`agentProgressSummaries`](#options) est activé. Pour un [appel d'outil MCP mis en arrière-plan](/docs/fr/mcp#automatic-backgrounding-of-long-tool-calls), `summary` porte le dernier progrès signalé par le serveur MCP et ne dépend pas de cette option.

5952 5971 

5955 type: "system";5974 type: "system";

5956 subtype: "task_progress";5975 subtype: "task_progress";

5957 task_id: string;5976 task_id: string;

5977 run_id?: string;

5958 tool_use_id?: string;5978 tool_use_id?: string;

5959 description: string;5979 description: string;

5960 subagent_type?: string;5980 subagent_type?: string;

5974 `SDKTaskUpdatedMessage`5994 `SDKTaskUpdatedMessage`

5975</h3>5995</h3>

5976 5996 

5977Émis lorsque l'état d'une tâche en arrière-plan change, par exemple lorsqu'elle passe de `running` à `completed`. Fusionnez `patch` dans votre carte de tâches locale indexée par `task_id`. Le champ `end_time` est un horodatage d'époque Unix en millisecondes, comparable avec `Date.now()`.5997Émis lorsque l'état d'une tâche en arrière-plan change, par exemple lorsqu'elle passe de `running` à `completed`. Fusionnez `patch` dans votre carte de tâches locale indexée par `task_id`. Le champ `end_time` est un horodatage d'époque Unix en millisecondes, comparable avec `Date.now()`. Pour le champ `run_id`, consultez [`SDKTaskStartedMessage`](#sdktaskstartedmessage), qui le définit ainsi que son exigence de version.

5978 5998 

5979```typescript theme={null}5999```typescript theme={null}

5980type SDKTaskUpdatedMessage = {6000type SDKTaskUpdatedMessage = {

5981 type: "system";6001 type: "system";

5982 subtype: "task_updated";6002 subtype: "task_updated";

5983 task_id: string;6003 task_id: string;

6004 run_id?: string;

5984 patch: {6005 patch: {

5985 status?: "pending" | "running" | "completed" | "failed" | "killed";6006 status?: "pending" | "running" | "completed" | "failed" | "killed";

5986 description?: string;6007 description?: string;

5998 `SDKBackgroundTasksChangedMessage`6019 `SDKBackgroundTasksChangedMessage`

5999</h3>6020</h3>

6000 6021 

6001Émis chaque fois que l'ensemble des tâches en arrière-plan en direct change : une tâche démarre, se termine ou est tuée ; un agent au premier plan est mis en arrière-plan ; ou le champ `description`, `ambient` ou `parent_task_id` d'une tâche change. Pour le champ `parent_task_id` de chaque entrée, consultez [`SDKTaskStartedMessage`](#sdktaskstartedmessage), qui le définit et son exigence de version.6022Émis chaque fois que l'ensemble des tâches en arrière-plan en direct change : une tâche démarre, se termine ou est tuée ; un agent au premier plan est mis en arrière-plan ; ou le champ `description`, `ambient` ou `parent_task_id` d'une tâche change. Pour les champs `run_id` et `parent_task_id` de chaque entrée, consultez [`SDKTaskStartedMessage`](#sdktaskstartedmessage), qui les définit ainsi que leurs exigences de version.

6002 6023 

6003Le tableau `tasks` est l'ensemble en direct complet. Remplacez tout ensemble mis en cache par chaque payload au lieu d'appairer les événements `task_started` et `task_notification`, afin que le prochain changement d'appartenance corrige tout événement que vous avez manqué.6024Le tableau `tasks` est l'ensemble en direct complet. Remplacez tout ensemble mis en cache par chaque payload au lieu d'appairer les événements `task_started` et `task_notification`, afin que le prochain changement d'appartenance corrige tout événement que vous avez manqué.

6004 6025 

6016 subtype: "background_tasks_changed";6037 subtype: "background_tasks_changed";

6017 tasks: {6038 tasks: {

6018 task_id: string;6039 task_id: string;

6040 run_id?: string;

6019 task_type: string;6041 task_type: string;

6020 subagent_type?: string;6042 subagent_type?: string;

6021 description: string;6043 description: string;

300* **Vous arrêtez le tour** : Claude Code annule le basculement et affiche `Backgrounding cancelled — the turn was stopped.` Par exemple, le tour s'arrête lorsque vous [interrompez Claude avec `Esc`](/docs/fr/interactive-mode#general-controls) ou sélectionnez **No** [sans commentaire](/docs/fr/permissions#add-a-comment-when-you-answer-a-permission-prompt) sur une demande de permission de la conversation principale, ou appuyez sur `Esc` sur une question que Claude y pose. Appuyez à nouveau sur `←` pour mettre la session en arrière-plan.300* **Vous arrêtez le tour** : Claude Code annule le basculement et affiche `Backgrounding cancelled — the turn was stopped.` Par exemple, le tour s'arrête lorsque vous [interrompez Claude avec `Esc`](/docs/fr/interactive-mode#general-controls) ou sélectionnez **No** [sans commentaire](/docs/fr/permissions#add-a-comment-when-you-answer-a-permission-prompt) sur une demande de permission de la conversation principale, ou appuyez sur `Esc` sur une question que Claude y pose. Appuyez à nouveau sur `←` pour mettre la session en arrière-plan.

301* **Un message en file d'attente ne peut pas être déplacé** : les messages que vous avez [mis en file d'attente pendant que Claude travaillait](/docs/fr/interactive-mode#queue-messages-while-claude-works) sont déplacés vers la session en arrière-plan avec la conversation. Lorsque l'un d'eux ne peut pas l'être, la session reste au premier plan et Claude Code affiche un avis comme `Cannot open agents — 1 queued message can't move to the background. Press ← again once Claude has read it.`301* **Un message en file d'attente ne peut pas être déplacé** : les messages que vous avez [mis en file d'attente pendant que Claude travaillait](/docs/fr/interactive-mode#queue-messages-while-claude-works) sont déplacés vers la session en arrière-plan avec la conversation. Lorsque l'un d'eux ne peut pas l'être, la session reste au premier plan et Claude Code affiche un avis comme `Cannot open agents — 1 queued message can't move to the background. Press ← again once Claude has read it.`

302 302 

303Lorsque Claude Code met la session en arrière-plan, que ce soit après environ dix secondes ou après que vous avez appuyé à nouveau sur `←`, il arrête une commande shell que Claude exécute encore au premier plan. Claude Code n'affiche pas le dialogue `Background this session?` pour cette commande. Dans la session en arrière-plan, Claude n'a aucune trace du démarrage de la commande, Claude peut donc exécuter la commande à nouveau. Pour que la commande continue de s'exécuter lorsque la session est déplacée, appuyez sur `Ctrl+B` pour [la transformer en commande en arrière-plan](/docs/fr/interactive-mode#background-bash-commands) pendant que Claude Code attend encore.

304 

303Appuyer sur `←` crée la ligne de la session même lorsque la conversation n'a pas encore de messages, afin que `→` y revienne toujours.305Appuyer sur `←` crée la ligne de la session même lorsque la conversation n'a pas encore de messages, afin que `→` y revienne toujours.

304 306 

305Vous pouvez désactiver ce raccourci pour les sessions au premier plan avec le paramètre [`leftArrowOpensAgents`](/docs/fr/settings-reference#leftarrowopensagents) dans `/config`.307Vous pouvez désactiver ce raccourci pour les sessions au premier plan avec le paramètre [`leftArrowOpensAgents`](/docs/fr/settings-reference#leftarrowopensagents) dans `/config`.

126* **Se connecter avec votre compte Console**, étiqueté `(recommended)` : Claude Code conserve le jeton OAuth de cette connexion et le stocke en tant que [profil Anthropic](#anthropic-profiles-and-federation-credentials). Il ne crée aucune clé API126* **Se connecter avec votre compte Console**, étiqueté `(recommended)` : Claude Code conserve le jeton OAuth de cette connexion et le stocke en tant que [profil Anthropic](#anthropic-profiles-and-federation-credentials). Il ne crée aucune clé API

127* **Créer une clé API**, étiqueté `(legacy)` : Claude Code crée une clé API Console pour vous et la stocke avec vos autres identifiants127* **Créer une clé API**, étiqueté `(legacy)` : Claude Code crée une clé API Console pour vous et la stocke avec vos autres identifiants

128 128 

129En pratique, le profil stocke une connexion OAuth tandis qu'une clé API est un identifiant statique : Claude Code actualise automatiquement la connexion du profil, et lorsque l'actualisation échoue, les demandes échouent avec [Anthropic profile login expired](/docs/fr/errors#anthropic-profile-login-expired) jusqu'à ce que vous vous reconnectiez.129En pratique, le profil stocke une connexion OAuth tandis qu'une clé API est un identifiant statique. Claude Code actualise automatiquement la connexion du profil, et lorsque l'actualisation échoue, les requêtes échouent avec une [erreur de connexion de profil expirée](/docs/fr/errors#anthropic-profile-login-expired) jusqu'à ce que vous vous reconnectiez.

130 130 

131Vous n'avez pas le choix sur chaque machine. Claude Code crée une clé API sans demander dans ces cas :131Vous n'avez pas le choix sur chaque machine. Claude Code crée une clé API sans demander dans ces cas :

132 132 

292 292 

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

294 294 

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

296 296 

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

298 298 

88 Quand la demande d'utilisation échoue88 Quand la demande d'utilisation échoue

89</h4>89</h4>

90 90 

91Quand la demande de vos limites de plan échoue, le plus souvent parce que le point de terminaison d'utilisation est limité en débit, `/usage` affiche les dernières barres d'utilisation qu'il a chargées sur cette machine au cours des 60 dernières minutes, ainsi qu'une note « Showing last-known usage » indiquant depuis combien de temps ces données ont été récupérées. Appuyez sur `r` pour réessayer ; une nouvelle tentative réussie remplace les dernières barres connues par des données actualisées. Sans un instantané des 60 dernières minutes, `/usage` signale que le point de terminaison d'utilisation est limité en débit et propose le même raccourci de nouvelle tentative. Avant la v2.1.208, une demande limitée en débit dans une session qui n'avait pas encore chargé l'utilisation affichait toujours l'erreur sans barres.91Quand la requête de vos limites de plan échoue, le plus souvent parce que l'endpoint d'utilisation est limité en débit, `/usage` affiche les dernières barres d'utilisation qu'il a chargées sur cette machine au cours des 60 dernières minutes, ainsi qu'une note `Showing last-known usage` indiquant depuis combien de temps ces données ont été récupérées. Appuyez sur `r` pour réessayer ; une nouvelle tentative réussie remplace les dernières barres connues par des données actualisées. Sans un instantané des 60 dernières minutes, `/usage` signale que l'endpoint d'utilisation est limité en débit et propose le même raccourci de nouvelle tentative. Avant la v2.1.208, une requête limitée en débit dans une session qui n'avait pas encore chargé l'utilisation affichait toujours l'erreur sans barres.

92 

93<h3 id="read-the-token-count-beside-the-spinner">

94 Lire le décompte de tokens à côté du spinner

95</h3>

96 

97Pendant que Claude travaille dans la conversation principale, la ligne à côté du spinner peut se terminer par un temps écoulé et un décompte de tokens, comme dans `Deciphering… (10m 27s · ↓ 5.5k tokens)`. Il s'agit d'un décompte approximatif et en direct de la sortie que le tour actuel a produite jusqu'ici. La flèche à côté du décompte pointe vers le bas pendant que la sortie arrive ou que des outils s'exécutent.

98 

99* **Ce qu'il couvre** : la sortie générée par le tour, comme le texte et les appels d'outils que Claude renvoie en streaming, sa réflexion, et la sortie des sous-agents qui s'exécutent au [premier plan](/docs/fr/sub-agents#run-subagents-in-foreground-or-background)

100* **Ce qu'il exclut** : ce que Claude Code envoie au modèle, donc votre prompt, l'historique de la conversation et le reste de votre contexte ne le font pas évoluer

101* **Quand il se réinitialise** : au début de chaque tour, et quand Claude Code [compacte la conversation](/docs/fr/prompt-caching#compacting-the-conversation)

102* **Quand il reste masqué** : jusqu'à ce que la sortie commence à arriver, quand la ligne est trop étroite pour l'afficher, et en [mode lecteur d'écran](/docs/fr/accessibility)

103 

104Il ne correspondra pas aux chiffres de sortie `Usage by model` dans le bloc Session de `/usage`, qui additionnent toute la session plutôt qu'un seul tour. Il diffère aussi du décompte de tokens que [le mode verbeux ajoute](/docs/fr/statusline#notifications-share-the-status-line-row), car ce décompte mesure la taille de votre contexte plutôt que la sortie d'un tour.

92 105 

93<h3 id="analyze-your-usage-patterns">106<h3 id="analyze-your-usage-patterns">

94 Analyser vos modèles d'utilisation107 Analyser vos modèles d'utilisation

98 98 

99Le 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.99Le 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.

100 100 

101Si 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`](/docs/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.101Si le problème persiste en mode sécurisé, ou si vos paramètres eux-mêmes sont suspects, démarrez une session sans aucune de vos propres configurations et vérifiez si le problème se reproduit.

102 102 

103```bash theme={null}103<Steps>

104cd /tmp && CLAUDE_CONFIG_DIR=/tmp/claude-clean claude104 <Step title="Créer un répertoire vide et s'y déplacer">

105```105 Dans votre shell, sans session Claude Code en cours d'exécution, créez le répertoire et déplacez-vous dedans :

106 106 

107La session propre n'a aucun paramètre utilisateur ou projet, hooks, serveurs MCP, plugins ou mémoire. Au premier lancement, attendez-vous aux écrans de configuration initiale, en commençant par la sélection du thème. Si vous les voyez, le répertoire de configuration propre est en vigueur. Les lancements ultérieurs avec le même répertoire ignorent ces écrans car Claude Code y enregistre l'état de l'intégration.107 <Tabs>

108 108 <Tab title="Bash or Zsh">

109* Les paramètres gérés s'appliquent toujours si votre organisation les déploie. Claude Code lit les profils MDM, la politique de registre et `managed-settings.json` à partir d'emplacements en dehors du répertoire de configuration, et [récupère les paramètres gérés par le serveur](/docs/fr/server-managed-settings#fetch-and-caching-behavior) à nouveau pour la session propre une fois qu'elle dispose des identifiants109 ```bash theme={null}

110* Vous serez invité à vous connecter à nouveau110 mkdir -p ~/claude-clean/empty && cd ~/claude-clean/empty

111 111 ```

112Si le problème disparaît ici, la cause se trouve quelque part dans vos fichiers réels `~/.claude` ou `.claude` du projet. Réintroduisez-les un à la fois, en copiant les fichiers dans le répertoire temporaire ou en lançant depuis votre projet, pour trouver lequel. S'il persiste dans la session propre, la cause se trouve en dehors de votre configuration utilisateur et projet. Exécutez `/status` pour vérifier si les paramètres gérés sont en vigueur, recherchez les [variables d'environnement](/docs/fr/env-vars) qui affectent Claude Code, puis consultez [Troubleshooting](/docs/fr/troubleshooting).112 </Tab>

113 

114 <Tab title="PowerShell">

115 ```powershell theme={null}

116 New-Item -ItemType Directory -Force "$HOME/claude-clean/empty" | Out-Null

117 Set-Location "$HOME/claude-clean/empty"

118 ```

119 </Tab>

120 </Tabs>

121 </Step>

122 

123 <Step title="Démarrer Claude Code avec un répertoire de configuration propre">

124 Depuis le même shell, définissez [`CLAUDE_CONFIG_DIR`](/docs/fr/env-vars) sur un nouveau répertoire à la place de `~/.claude`, et passez [`--setting-sources user`](/docs/fr/cli-reference#cli-flags) pour désactiver la configuration du projet, comme `.claude/settings.json`, `CLAUDE.md` et `.mcp.json` :

125 

126 <Tabs>

127 <Tab title="Bash or Zsh">

128 La variable s'applique uniquement à ce lancement.

129 

130 ```bash theme={null}

131 CLAUDE_CONFIG_DIR=~/claude-clean/config claude --setting-sources user

132 ```

133 </Tab>

134 

135 <Tab title="PowerShell">

136 La variable reste définie pour le reste de cette session PowerShell, de sorte que les lancements ultérieurs de `claude` dans la même fenêtre continuent d'utiliser le répertoire propre. Pour revenir à votre répertoire habituel, exécutez `Remove-Item Env:CLAUDE_CONFIG_DIR` avant le prochain lancement.

137 

138 ```powershell theme={null}

139 $env:CLAUDE_CONFIG_DIR = "$HOME/claude-clean/config"

140 claude --setting-sources user

141 ```

142 </Tab>

143 </Tabs>

144 

145 Au premier lancement, vous repassez par les écrans de configuration initiale, signe que le répertoire de configuration propre est en vigueur. Les paramètres gérés s'appliquent toujours, et les [connecteurs](/docs/fr/mcp#use-mcp-servers-from-claude-ai) se chargent toujours si vous vous connectez avec un compte claude.ai.

146 </Step>

147 

148 <Step title="Reproduire le problème">

149 Répétez ce qui a déclenché le problème dans la session propre :

150 

151 * **Le problème a disparu** : la cause se trouve dans votre configuration utilisateur ou projet. Copiez `~/.claude.json` et les fichiers de `~/.claude` dans `~/claude-clean/config` un par un. Si aucun ne fait réapparaître le problème, accédez au répertoire de votre projet dans le même shell et démarrez Claude Code sans `--setting-sources user`. Dans Bash ou Zsh, exécutez `CLAUDE_CONFIG_DIR=~/claude-clean/config claude`. Dans PowerShell, la variable est toujours définie, exécutez donc `claude`.

152 * **Le problème persiste** : la cause se trouve en dehors de votre configuration utilisateur et projet. Exécutez `/status` dans la session pour vérifier la présence de paramètres gérés, vérifiez les [variables d'environnement](/docs/fr/env-vars) de votre shell, puis consultez [Dépannage](/docs/fr/troubleshooting).

153 </Step>

154</Steps>

113 155 

114<h2 id="check-common-causes">156<h2 id="check-common-causes">

115 Vérifier les causes courantes157 Vérifier les causes courantes

127| Une valeur `settings.json` semble ignorée | La même clé est définie dans `settings.local.json` | `settings.local.json` remplace `settings.json`, et les deux remplacent `~/.claude/settings.json`. Consultez [settings precedence](/docs/fr/settings#settings-precedence). |169| Une valeur `settings.json` semble ignorée | La même clé est définie dans `settings.local.json` | `settings.local.json` remplace `settings.json`, et les deux remplacent `~/.claude/settings.json`. Consultez [settings precedence](/docs/fr/settings#settings-precedence). |

128| Le skill n'apparaît pas dans `/skills` | Le fichier skill est à `.claude/skills/name.md` au lieu d'être dans un dossier | Utilisez un dossier avec `SKILL.md` à l'intérieur : `.claude/skills/name/SKILL.md`. |170| Le skill n'apparaît pas dans `/skills` | Le fichier skill est à `.claude/skills/name.md` au lieu d'être dans un dossier | Utilisez un dossier avec `SKILL.md` à l'intérieur : `.claude/skills/name/SKILL.md`. |

129| Le skill apparaît dans `/skills` mais Claude ne l'invoque jamais | Le skill a `disable-model-invocation: true` dans son frontmatter, ou sa description ne correspond pas à la façon dont vous formulez la demande | Vérifiez le badge dans `/skills` : un label « user-only » signifie que Claude ne le déclenchera pas de lui-même. Consultez [skill invocation](/docs/fr/skills). |171| Le skill apparaît dans `/skills` mais Claude ne l'invoque jamais | Le skill a `disable-model-invocation: true` dans son frontmatter, ou sa description ne correspond pas à la façon dont vous formulez la demande | Vérifiez le badge dans `/skills` : un label « user-only » signifie que Claude ne le déclenchera pas de lui-même. Consultez [skill invocation](/docs/fr/skills). |

130| Les instructions du sous-répertoire `CLAUDE.md` semblent ignorées | Les fichiers du sous-répertoire se chargent à la demande, pas au démarrage de la session | Consultez [quand les fichiers de sous-répertoire se chargent](/docs/fr/memory#how-claude-md-files-load). Avant la v2.1.288, seul l'outil Read les chargeait. |172| Les instructions du sous-répertoire `CLAUDE.md` semblent ignorées | Les fichiers du sous-répertoire se chargent à la demande, pas au démarrage de la session | Pour charger le `CLAUDE.md` d'un sous-répertoire, demandez à Claude de lire un autre fichier de ce sous-répertoire. Consultez [quand les fichiers de sous-répertoire se chargent](/docs/fr/memory#how-claude-md-files-load). |

131| Le sous-agent ignore les instructions `CLAUDE.md` | Les agents Explore et Plan intégrés ignorent `CLAUDE.md`. Un sous-agent personnalisé le charge de la même manière que la conversation principale, sauf si sa définition définit [`omitClaudeMd`](/docs/fr/sub-agents#supported-frontmatter-fields) | Pour Explore ou Plan, reformulez l'instruction dans votre invite de délégation. Pour un sous-agent qui définit `omitClaudeMd`, supprimez le champ. Pour tout autre sous-agent personnalisé, mettez les instructions critiques dans le corps du fichier agent, qui devient l'invite système du sous-agent. Consultez [what loads at startup](/docs/fr/sub-agents#what-loads-at-startup). |173| Le sous-agent ignore les instructions `CLAUDE.md` | Les agents Explore et Plan intégrés ignorent `CLAUDE.md`. Un sous-agent personnalisé le charge de la même manière que la conversation principale, sauf si sa définition définit [`omitClaudeMd`](/docs/fr/sub-agents#supported-frontmatter-fields) | Pour Explore ou Plan, reformulez l'instruction dans votre invite de délégation. Pour un sous-agent qui définit `omitClaudeMd`, supprimez le champ. Pour tout autre sous-agent personnalisé, mettez les instructions critiques dans le corps du fichier agent, qui devient l'invite système du sous-agent. Consultez [what loads at startup](/docs/fr/sub-agents#what-loads-at-startup). |

132| La logique de nettoyage ne s'exécute jamais à la fin de la session | Aucun hook `SessionEnd` configuré | Ajoutez un hook `SessionEnd` dans `settings.json`. Consultez la [hook events list](/docs/fr/hooks#hook-events). |174| La logique de nettoyage ne s'exécute jamais à la fin de la session | Aucun hook `SessionEnd` configuré | Ajoutez un hook `SessionEnd` dans `settings.json`. Consultez la [hook events list](/docs/fr/hooks#hook-events). |

133| Les serveurs MCP dans `.mcp.json` ne se chargent jamais | Le fichier est sous `.claude/`, ou ses serveurs se trouvent sous une clé `servers` de haut niveau, comme dans le `mcp.json` de VS Code, au lieu de `mcpServers` | La configuration MCP du projet va à la racine du référentiel sous `.mcp.json`, pas à l'intérieur de `.claude/`, avec les serveurs sous la clé `mcpServers`. Consultez [MCP configuration](/docs/fr/mcp). |175| Les serveurs MCP dans `.mcp.json` ne se chargent jamais | Le fichier est sous `.claude/`, ou ses serveurs se trouvent sous une clé `servers` de haut niveau, comme dans le `mcp.json` de VS Code, au lieu de `mcpServers` | La configuration MCP du projet va à la racine du référentiel sous `.mcp.json`, pas à l'intérieur de `.claude/`, avec les serveurs sous la clé `mcpServers`. Consultez [MCP configuration](/docs/fr/mcp). |

913 913 

914Chaque entrée nécessite `id`, `name` et `sshHost`. Les champs `sshPort` et `sshIdentityFile` sont optionnels. Les utilisateurs peuvent également ajouter `sshConfigs` à leur propre `~/.claude/settings.json`.914Chaque entrée nécessite `id`, `name` et `sshHost`. Les champs `sshPort` et `sshIdentityFile` sont optionnels. Les utilisateurs peuvent également ajouter `sshConfigs` à leur propre `~/.claude/settings.json`.

915 915 

916Si vous omettez `user@` dans `sshHost`, Desktop se connecte en tant que `User` que le fichier `~/.ssh/config` de chaque développeur définit pour l'hôte, ou à défaut en tant que son nom d'utilisateur sur son propre ordinateur.

917 

916<h4 id="restrict-which-ssh-hosts-users-can-connect-to">918<h4 id="restrict-which-ssh-hosts-users-can-connect-to">

917 Restreindre les hôtes SSH auxquels les utilisateurs peuvent se connecter919 Restreindre les hôtes SSH auxquels les utilisateurs peuvent se connecter

918</h4>920</h4>

937 939 

938`sshHostAllowlist` est lu uniquement à partir des paramètres gérés ; les valeurs dans les paramètres utilisateur ou projet sont ignorées. Seule l'application Claude Desktop honore ce paramètre ; la CLI Claude Code et les extensions IDE ne le lisent pas, et il ne restreint pas les commandes `ssh` exécutées via l'outil Bash. Il gouverne les hôtes auxquels l'application Desktop se connecte, pas la sortie réseau, donc associez-le aux contrôles réseau ou zero-trust de votre organisation si vous avez besoin d'une limite stricte.940`sshHostAllowlist` est lu uniquement à partir des paramètres gérés ; les valeurs dans les paramètres utilisateur ou projet sont ignorées. Seule l'application Claude Desktop honore ce paramètre ; la CLI Claude Code et les extensions IDE ne le lisent pas, et il ne restreint pas les commandes `ssh` exécutées via l'outil Bash. Il gouverne les hôtes auxquels l'application Desktop se connecte, pas la sortie réseau, donc associez-le aux contrôles réseau ou zero-trust de votre organisation si vous avez besoin d'une limite stricte.

939 941 

942<h4 id="turn-off-local-sessions-and-distribute-ssh-connections">

943 Désactiver les sessions locales et distribuer des connexions SSH

944</h4>

945 

946Pour désactiver les sessions locales et limiter les sessions SSH aux hôtes de votre choix, déployez ensemble [`disableDesktopLocalSessions`](/docs/fr/settings-reference#disabledesktoplocalsessions), [`sshConfigs`](#pre-configure-ssh-connections-for-your-team) et [`sshHostAllowlist`](#restrict-which-ssh-hosts-users-can-connect-to).

947 

948<Note>

949 Cette configuration s'adresse aux utilisateurs qui se connectent avec un compte Claude. Avec un [fournisseur tiers](/docs/fr/third-party-integrations), les sessions SSH sont désactivées par défaut, et définir `sshHostAllowlist` peut les activer. Lisez [SSH remote sessions in Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/ssh-remote-sessions) avant de déployer ces clés.

950</Note>

951 

952L'exemple suivant désactive les sessions locales, ajoute une connexion et limite les sessions SSH à l'hôte de cette connexion :

953 

954```json managed-settings.json theme={null}

955{

956 "disableDesktopLocalSessions": true,

957 "sshConfigs": [

958 {

959 "id": "shared-dev-vm",

960 "name": "Shared Dev VM",

961 "sshHost": "dev.example.com"

962 }

963 ],

964 "sshHostAllowlist": ["dev.example.com"]

965}

966```

967 

968Les clés s'appliquent à l'application de bureau. Elles ne modifient pas les autres façons d'exécuter Claude Code, comme la CLI, Cowork et les sessions cloud :

969 

970* **La CLI** : aucune des clés n'empêche un développeur d'exécuter la CLI Claude Code sur son propre ordinateur

971* **Cowork** : aucune des clés ne s'applique aux sessions [Cowork](https://claude.com/docs/cowork/overview) ni aux tâches planifiées Cowork

972* **Sessions cloud** : aucune des clés ne modifie la disponibilité des [sessions cloud](#cloud-sessions). Pour les désactiver, utilisez le paramètre **Sessions cloud** sous [Contrôles de la console d'administration](#admin-console-controls).

973 

974Lorsque vous adaptez l'exemple, vérifiez les noms d'hôte et la version de Desktop :

975 

976* **Noms d'hôte** : assurez-vous qu'un modèle dans `sshHostAllowlist` correspond au nom d'hôte de chaque entrée `sshConfigs`, sans `user@`, sinon les développeurs ne peuvent pas s'y connecter. Pour savoir comment Desktop fait correspondre un nom d'hôte, voir [Restreindre les hôtes SSH auxquels les utilisateurs peuvent se connecter](#restrict-which-ssh-hosts-users-can-connect-to).

977* **Version** : `disableDesktopLocalSessions` nécessite Claude Desktop v1.37937.0 ou une version ultérieure

978 

979Placez les trois clés dans une seule [source gérée](/docs/fr/managed-settings#how-claude-code-combines-managed-sources), la mieux classée de celles que vous fournissez. Si vous fournissez des [paramètres gérés par le serveur](/docs/fr/server-managed-settings), conservez également une copie des trois clés dans la politique MDM ou le fichier de paramètres gérés le mieux classé sur chaque ordinateur. Desktop récupère les paramètres gérés par le serveur au lancement, et la copie présente sur l'ordinateur s'applique tant qu'une récupération n'a pas réussi.

980 

981Pour confirmer que les paramètres s'appliquent, vérifiez l'ordinateur d'un développeur :

982 

983<Steps>

984 <Step title="Vérifier la liste déroulante d'environnement">

985 Quittez et rouvrez Desktop, puis ouvrez la liste déroulante d'environnement dans la zone de prompt. **Local** est grisé, et **Shared Dev VM** apparaît sous **SSH**. Si **Local** est toujours disponible, vérifiez la version de Desktop, que le fichier est un JSON valide et quelle source gérée l'ordinateur lit.

986 </Step>

987 

988 <Step title="Ajouter un hôte absent de la liste d'autorisation">

989 [Ajoutez une connexion SSH](#ssh-sessions) avec un nom d'hôte absent de la liste d'autorisation, comme `other.example.com`. Desktop enregistre la connexion mais refuse de se connecter, et indique que les paramètres de votre organisation n'autorisent pas la connexion.

990 </Step>

991</Steps>

992 

940<h2 id="enterprise-configuration">993<h2 id="enterprise-configuration">

941 Configuration d'entreprise994 Configuration d'entreprise

942</h2>995</h2>

256| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | Définissez sur `1` pour désactiver toutes les fonctionnalités de tâches en arrière-plan, y compris le paramètre `run_in_background` des outils Bash et de sous-agent, la mise en arrière-plan automatique et le raccourci Ctrl+B |256| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | Définissez sur `1` pour désactiver toutes les fonctionnalités de tâches en arrière-plan, y compris le paramètre `run_in_background` des outils Bash et de sous-agent, la mise en arrière-plan automatique et le raccourci Ctrl+B |

257| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_DEFAULT` | Définissez sur `1` pour empêcher Claude Code de traiter une réponse en streaming [Amazon Bedrock](/docs/fr/amazon-bedrock) dont l'en-tête `Content-Type` est absent ou vide comme le flux d'événements binaire d'Amazon Bedrock. Par défaut, Claude Code suppose qu'une passerelle a supprimé l'en-tête d'une réponse par ailleurs non modifiée ; il décode donc le corps et le streaming continue de fonctionner. Ne définissez cette variable que pour une passerelle qui réémet également le flux sous forme de server-sent events ; Claude Code lit alors le corps sans en-tête comme des server-sent events. Nécessite Claude Code v2.1.239 ou ultérieur |257| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_DEFAULT` | Définissez sur `1` pour empêcher Claude Code de traiter une réponse en streaming [Amazon Bedrock](/docs/fr/amazon-bedrock) dont l'en-tête `Content-Type` est absent ou vide comme le flux d'événements binaire d'Amazon Bedrock. Par défaut, Claude Code suppose qu'une passerelle a supprimé l'en-tête d'une réponse par ailleurs non modifiée ; il décode donc le corps et le streaming continue de fonctionner. Ne définissez cette variable que pour une passerelle qui réémet également le flux sous forme de server-sent events ; Claude Code lit alors le corps sans en-tête comme des server-sent events. Nécessite Claude Code v2.1.239 ou ultérieur |

258| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD` | Définissez sur `1` pour ignorer la vérification selon laquelle une réponse en streaming [Amazon Bedrock](/docs/fr/amazon-bedrock) porte le content-type `application/vnd.amazon.eventstream`. Sans cette variable, lorsqu'une réponse porte un autre content-type, Claude Code fait échouer la requête avec une erreur indiquant ce type, ce qui signifie qu'une [passerelle ou un proxy transforme la réponse](/docs/fr/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy). Configurez la passerelle pour qu'elle transmette l'en-tête `Content-Type` et le corps sans modification plutôt que de définir cette variable. Nécessite Claude Code v2.1.208 ou ultérieur |258| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD` | Définissez sur `1` pour ignorer la vérification selon laquelle une réponse en streaming [Amazon Bedrock](/docs/fr/amazon-bedrock) porte le content-type `application/vnd.amazon.eventstream`. Sans cette variable, lorsqu'une réponse porte un autre content-type, Claude Code fait échouer la requête avec une erreur indiquant ce type, ce qui signifie qu'une [passerelle ou un proxy transforme la réponse](/docs/fr/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy). Configurez la passerelle pour qu'elle transmette l'en-tête `Content-Type` et le corps sans modification plutôt que de définir cette variable. Nécessite Claude Code v2.1.208 ou ultérieur |

259| `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF` | Définissez sur `1` pour arrêter les commandes shell en arrière-plan en cours d'exécution d'une [session en arrière-plan](/docs/fr/agent-view), ses workflows dynamiques et, depuis la v2.1.198, ses sous-agents en arrière-plan lorsque le [superviseur](/docs/fr/agent-view#the-supervisor-process) arrête, redémarre ou met à jour le processus de cette session, au lieu de les transmettre au processus suivant de la session. N'affecte que cette transmission : mettre une session en arrière-plan avec `←` ou [`/background`](/docs/fr/agent-view#from-inside-a-session) transfère toujours le travail en cours, et `CLAUDE_DISABLE_ADOPT` désactive les deux. Nécessite Claude Code v2.1.196 ou ultérieur |259| `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF` | Définissez à `1` pour arrêter les commandes shell en arrière-plan en cours d'exécution, les workflows dynamiques et, depuis la v2.1.198, les sous-agents en arrière-plan d'une [session en arrière-plan](/docs/fr/agent-view) lorsque le [superviseur](/docs/fr/agent-view#the-supervisor-process) arrête, redémarre ou met à jour le processus de cette session, au lieu de les transmettre au processus suivant de la session. N'affecte que ce transfert : mettre une session en arrière-plan avec `←` ou [`/background`](/docs/fr/agent-view#from-inside-a-session) transfère toujours le travail en arrière-plan en cours, et `CLAUDE_DISABLE_ADOPT` désactive les deux. Nécessite Claude Code v2.1.196 ou ultérieur |

260| `CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP` | Définissez sur `1` pour empêcher Claude Code de terminer les [commandes shell en arrière-plan](/docs/fr/interactive-mode#background-bash-commands) en cas de pression mémoire. Par défaut, sous macOS et Linux, Claude Code termine les shells en arrière-plan lorsque le système d'exploitation signale une pression mémoire critique et que la session est inactive depuis 30 minutes sans tour ni sous-agent en cours. Windows ne dispose d'aucun signal de pression mémoire ; cette variable n'y a donc aucun effet. Nécessite Claude Code v2.1.193 ou ultérieur |260| `CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP` | Définissez sur `1` pour empêcher Claude Code de terminer les [commandes shell en arrière-plan](/docs/fr/interactive-mode#background-bash-commands) en cas de pression mémoire. Par défaut, sous macOS et Linux, Claude Code termine les shells en arrière-plan lorsque le système d'exploitation signale une pression mémoire critique et que la session est inactive depuis 30 minutes sans tour ni sous-agent en cours. Windows ne dispose d'aucun signal de pression mémoire ; cette variable n'y a donc aucun effet. Nécessite Claude Code v2.1.193 ou ultérieur |

261| `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` | Définissez sur `1` pour désactiver les [skills](/docs/fr/skills) et workflows fournis avec Claude Code : les skills et workflows fournis sont entièrement supprimés, tandis que les commandes intégrées comme `/init` restent saisissables mais sont masquées au modèle. `/doctor` reste saisissable comme les commandes intégrées ; masquez-la plutôt avec `DISABLE_DOCTOR_COMMAND`. Les skills provenant des plugins, de `.claude/skills/` et de `.claude/commands/` ne sont pas affectés. Équivalent au paramètre [`disableBundledSkills`](/docs/fr/settings-reference#disablebundledskills) |261| `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` | Définissez sur `1` pour désactiver les [skills](/docs/fr/skills) et workflows fournis avec Claude Code : les skills et workflows fournis sont entièrement supprimés, tandis que les commandes intégrées comme `/init` restent saisissables mais sont masquées au modèle. `/doctor` reste saisissable comme les commandes intégrées ; masquez-la plutôt avec `DISABLE_DOCTOR_COMMAND`. Les skills provenant des plugins, de `.claude/skills/` et de `.claude/commands/` ne sont pas affectés. Équivalent au paramètre [`disableBundledSkills`](/docs/fr/settings-reference#disablebundledskills) |

262| `CLAUDE_CODE_DISABLE_CFC_PROMPT` | Définissez sur `1` pour garder disponibles les outils de navigateur [Claude in Chrome](/docs/fr/chrome) tout en omettant la section Chrome du prompt système et le [skill fourni](/docs/fr/skills#bundled-skills) `/claude-in-chrome`. Destinée aux hôtes qui intègrent Claude Code et fournissent leurs propres instructions pour le navigateur. Nécessite Claude Code v2.1.257 ou ultérieur |262| `CLAUDE_CODE_DISABLE_CFC_PROMPT` | Définissez sur `1` pour garder disponibles les outils de navigateur [Claude in Chrome](/docs/fr/chrome) tout en omettant la section Chrome du prompt système et le [skill fourni](/docs/fr/skills#bundled-skills) `/claude-in-chrome`. Destinée aux hôtes qui intègrent Claude Code et fournissent leurs propres instructions pour le navigateur. Nécessite Claude Code v2.1.257 ou ultérieur |

94| `Your account is on hold and can't use Claude Code. View details or appeal: https://claude.ai/restricted` | [Authentification](#your-account-is-on-hold) |94| `Your account is on hold and can't use Claude Code. View details or appeal: https://claude.ai/restricted` | [Authentification](#your-account-is-on-hold) |

95| `Your account is on hold and can't sign in to Claude Code. View details or appeal: https://claude.ai/restricted` | [Authentification](#your-account-is-on-hold) |95| `Your account is on hold and can't sign in to Claude Code. View details or appeal: https://claude.ai/restricted` | [Authentification](#your-account-is-on-hold) |

96| `Anthropic profile login expired · Re-authenticate your Anthropic profile` | [Authentification](#anthropic-profile-login-expired) |96| `Anthropic profile login expired · Re-authenticate your Anthropic profile` | [Authentification](#anthropic-profile-login-expired) |

97| `Login expired · Run /login to sign in again, or re-authenticate your Anthropic profile` | [Authentification](#anthropic-profile-login-expired) |

97| `Anthropic profile login expired · Run /login to use your claude.ai account instead, or re-authenticate the profile` | [Authentification](#anthropic-profile-login-expired) |98| `Anthropic profile login expired · Run /login to use your claude.ai account instead, or re-authenticate the profile` | [Authentification](#anthropic-profile-login-expired) |

98| `does not meet scope requirement user:profile` | [Authentification](#oauth-scope-requirement) |99| `does not meet scope requirement user:profile` | [Authentification](#oauth-scope-requirement) |

99| `claude.ai rejected the session token` / `session token rejected` | [Authentification](#claude-ai-rejected-the-session-token) |100| `claude.ai rejected the session token` / `session token rejected` | [Authentification](#claude-ai-rejected-the-session-token) |

1303Failed to authenticate: OAuth session expired and could not be refreshed1304Failed to authenticate: OAuth session expired and could not be refreshed

1304```1305```

1305 1306 

1307Pour un message `Login expired` qui se termine par `or re-authenticate your Anthropic profile`, consultez [Anthropic profile login expired](#anthropic-profile-login-expired).

1308 

1306Cet état est différent de [Jeton OAuth révoqué ou expiré](#oauth-token-revoked-or-expired). Ces messages signalent un rejet renvoyé par l'API. Claude Code produit lui-même `Login expired` pour une connexion qu'il n'a déjà pas réussi à renouveler ; il n'envoie donc aucune requête. Lorsque le renouvellement échoue parce que le compte lui-même est suspendu plutôt que parce que la connexion est obsolète, Claude Code affiche plutôt [Votre compte est suspendu](#your-account-is-on-hold).1309Cet état est différent de [Jeton OAuth révoqué ou expiré](#oauth-token-revoked-or-expired). Ces messages signalent un rejet renvoyé par l'API. Claude Code produit lui-même `Login expired` pour une connexion qu'il n'a déjà pas réussi à renouveler ; il n'envoie donc aucune requête. Lorsque le renouvellement échoue parce que le compte lui-même est suspendu plutôt que parce que la connexion est obsolète, Claude Code affiche plutôt [Votre compte est suspendu](#your-account-is-on-hold).

1307 1310 

1308Les sessions authentifiées avec une clé API, [`CLAUDE_CODE_OAUTH_TOKEN`](/docs/fr/env-vars) ou un fournisseur tiers n'utilisent pas la connexion enregistrée et ne voient jamais ce message.1311Les sessions authentifiées avec une clé API, [`CLAUDE_CODE_OAUTH_TOKEN`](/docs/fr/env-vars) ou un fournisseur tiers n'utilisent pas la connexion enregistrée et ne voient jamais ce message.

1468 Connexion au profil Anthropic expirée1471 Connexion au profil Anthropic expirée

1469</h3>1472</h3>

1470 1473 

1471Claude Code s'authentifie via un profil d'identifiants Anthropic dont les identifiants de connexion enregistrés ont expiré, et le profil ne contient aucun identifiant d'actualisation que Claude Code pourrait utiliser pour les renouveler. Claude Code arrête chaque requête localement sans réessayer, car une nouvelle tentative lirait les mêmes identifiants expirés.1474Claude Code s'authentifie via un profil d'identifiants Anthropic dont l'identifiant de connexion enregistré a expiré, et le profil ne contient aucun identifiant d'actualisation que Claude Code puisse utiliser pour le renouveler. Claude Code arrête chaque requête localement sans réessayer.

1472 1475 

1473```text theme={null}1476```text theme={null}

1474Anthropic profile login expired · Re-authenticate your Anthropic profile1477Anthropic profile login expired · Re-authenticate your Anthropic profile

1475Anthropic profile login expired · Run /login to use your claude.ai account instead, or re-authenticate the profile1478Login expired · Run /login to sign in again, or re-authenticate your Anthropic profile

1476```1479```

1477 1480 

1478Ce message n'apparaît que lorsque les identifiants actifs proviennent d'un profil d'identifiants Anthropic, que vous sélectionnez avec la variable d'environnement `ANTHROPIC_PROFILE`, que Claude Code découvre comme profil actif dans votre répertoire de configuration Anthropic, ou que Claude Code a écrit lorsque vous vous êtes [connecté sans clé API](/docs/fr/authentication#sign-in-without-an-api-key). Les sessions qui s'authentifient avec une clé API, un jeton bearer comme `ANTHROPIC_AUTH_TOKEN` ou un fournisseur tiers ne voient jamais ce message.

1479 

1480Sur une machine qui [propose la connexion sans clé](/docs/fr/authentication#sign-in-without-an-api-key), exécutez `/login`, choisissez le compte Anthropic Console et reconnectez-vous pour renouveler un profil écrit par la connexion Console sans clé ou par `ant auth login` de la Claude Platform CLI. Claude Code remplace les identifiants expirés dans ce profil. Pour un profil de fédération ou un profil créé par un autre outil, `/login` ne renouvelle pas les identifiants. La forme que vous voyez dépend de si vous avez sélectionné le profil ou si Claude Code l'a découvert :

1481 

1482* Lorsque vous définissez `ANTHROPIC_PROFILE` explicitement, le message se termine par `Re-authenticate your Anthropic profile`.

1483* Lorsque Claude Code a découvert le profil depuis votre répertoire de configuration, le message propose `/login`, car Claude Code donne la priorité à un `/login` fonctionnel sur le profil découvert et s'authentifie alors avec votre compte claude.ai ou Console. Avant la v2.1.234, Claude Code affichait également la forme `Re-authenticate your Anthropic profile` dans ce cas.

1484 

1485**Que faire :**1481**Que faire :**

1486 1482 

1487* Reconnectez-vous au profil, puis réessayez : sur une machine qui [propose la connexion sans clé](/docs/fr/authentication#sign-in-without-an-api-key), exécutez `/login` et choisissez le compte Anthropic Console pour un profil écrit par la connexion Console sans clé ou par `ant auth login` de la Claude Platform CLI ; pour les autres profils, utilisez l'outil qui les a créés1483* Si le message commence par `Login expired`, exécutez `/login` pour vous reconnecter

1484* Pour renouveler un profil écrit par la connexion Console sans clé ou par `ant auth login` de la CLI Claude Platform, exécutez `/login` sur une machine qui [propose la connexion sans clé](/docs/fr/authentication#sign-in-without-an-api-key). Choisissez le compte Anthropic Console, puis **Sign in with your Console account**. Claude Code remplace l'identifiant expiré dans ce profil

1485* Pour renouveler un profil créé par un autre outil, reconnectez-vous avec cet outil. Si vous choisissez plutôt **Sign in with your Console account** dans `/login`, Claude Code laisse le profil tel quel et crée une clé API

1488* Si un administrateur a provisionné les identifiants du profil, demandez-lui d'en émettre de nouveaux1486* Si un administrateur a provisionné les identifiants du profil, demandez-lui d'en émettre de nouveaux

1489* Exécutez `/status` pour confirmer la source d'identifiants active et le nom du profil1487* Exécutez `/status` pour confirmer la source d'identifiants active et le nom du profil

1490* Pour cesser d'utiliser le profil, supprimez `ANTHROPIC_PROFILE` si vous l'avez définie, puis authentifiez-vous d'une autre manière, par exemple avec `/login` ou `ANTHROPIC_API_KEY`1488* Pour cesser d'utiliser le profil, supprimez `ANTHROPIC_PROFILE` si vous l'avez définie, puis authentifiez-vous d'une autre manière, par exemple avec `/login` ou `ANTHROPIC_API_KEY`

1491 1489 

1490Le début du message vous indique comment Claude Code a trouvé le profil :

1491 

1492* Lorsque Claude Code a découvert le profil à partir de votre répertoire de configuration et que son mode d'authentification est `user_oauth`, le message commence par `Login expired` et propose d'abord `/login`. Claude Code donne à un `/login` fonctionnel la priorité sur le profil découvert, puis s'authentifie plutôt avec votre compte claude.ai. De la v2.1.234 à la v2.1.277, cette forme indiquait `Anthropic profile login expired · Run /login to use your claude.ai account instead, or re-authenticate the profile`. Avant la v2.1.234, Claude Code affichait également la forme `Re-authenticate your Anthropic profile` dans ce cas.

1493* Lorsque vous avez sélectionné le profil avec `ANTHROPIC_PROFILE`, le message commence par `Anthropic profile login expired`.

1494 

1495Ce message n'apparaît que lorsque l'identifiant actif provient d'un profil d'identifiants Anthropic, soit un profil que vous sélectionnez avec la variable d'environnement `ANTHROPIC_PROFILE`, soit un profil que Claude Code découvre comme profil actif dans votre répertoire de configuration Anthropic, soit un profil que Claude Code a écrit lorsque vous vous êtes [connecté sans clé API](/docs/fr/authentication#sign-in-without-an-api-key). Les sessions qui s'authentifient avec une clé API, un jeton bearer comme `ANTHROPIC_AUTH_TOKEN` ou un fournisseur tiers ne voient jamais ce message.

1496 

1492<h3 id="oauth-scope-requirement">1497<h3 id="oauth-scope-requirement">

1493 Exigence de scope OAuth1498 Exigence de scope OAuth

1494</h3>1499</h3>

4039 4044 

4040**Que faire :**4045**Que faire :**

4041 4046 

4042* Exécutez `claude plugin marketplace remove <name>`. Cela désinstalle aussi les plugins installés à partir de la marketplace et supprime leurs données sauvegardées4047* Pour conserver une marketplace qu'un fichier de paramètres déclare en ligne avec `"source": "settings"`, renommez-la avant de supprimer l'ancien nom, car supprimer la marketplace supprime aussi son entrée de vos fichiers de paramètres. Claude Code v2.1.292 ou ultérieur énumère ces étapes dans le message :

4043* Pour conserver la marketplace à la place, attendez que son responsable la renomme, puis exécutez `claude plugin marketplace update <name>`4048 1. Dans chaque fichier de paramètres qui liste la marketplace sous `extraKnownMarketplaces`, donnez à la clé de l'entrée et à son `source.name` un même nouveau nom en ASCII simple qui ne ressemble pas à un nom officiel. Si un administrateur ajoute la marketplace via les paramètres gérés de votre organisation, c'est l'administrateur qui effectue cette étape

4049 2. Exécutez `claude plugin marketplace remove <old-name>`, ou supprimez l'ancien nom dans l'onglet **Marketplaces** de `/plugin`. Cela désinstalle aussi ses plugins et supprime leurs données, options et secrets

4050 3. Redémarrez Claude Code, dans le dossier du projet si le fichier est un fichier de paramètres de projet. Installez ensuite les plugins à partir de la marketplace renommée

4051* Pour conserver toute autre marketplace, attendez que son responsable la renomme, puis exécutez `claude plugin marketplace update <name>`

4052* Pour supprimer la marketplace, exécutez `claude plugin marketplace remove <name>`. Cela désinstalle aussi les plugins installés à partir de la marketplace et supprime leurs données, options et secrets

4044* Si vous publiez la marketplace, renommez-la dans votre `marketplace.json` ; les utilisateurs mettent alors à jour la marketplace au lieu de la supprimer4053* Si vous publiez la marketplace, renommez-la dans votre `marketplace.json` ; les utilisateurs mettent alors à jour la marketplace au lieu de la supprimer

4045 4054 

4046<h3 id="marketplace-is-already-added-from-a-different-source">4055<h3 id="marketplace-is-already-added-from-a-different-source">

3321 WorktreeCreate3321 WorktreeCreate

3322</h3>3322</h3>

3323 3323 

3324S'exécute lors de la création d'un worktree, que ce soit depuis `claude --worktree`, depuis un [sous-agent utilisant `isolation: "worktree"`](/docs/fr/sub-agents#choose-the-subagent-scope), ou pour une [session en arrière-plan](/docs/fr/agent-view#how-file-edits-are-isolated) que Claude Code isole dans son propre worktree. Par défaut, Claude Code crée la copie de travail isolée avec `git worktree`. Configurer un hook WorktreeCreate remplace ce comportement git par défaut, ce qui vous permet d'utiliser un autre système de gestion de versions comme SVN, Perforce ou Mercurial.3324S'exécute lorsque Claude Code crée un worktree, par exemple dans les cas suivants :

3325 

3326* Vous démarrez une session avec `claude --worktree`

3327* Claude crée un worktree pendant une session et y bascule avec l'outil [`EnterWorktree`](/docs/fr/tools-reference)

3328* Un [sous-agent utilise `isolation: "worktree"`](/docs/fr/sub-agents#choose-the-subagent-scope)

3329* Un [workflow](/docs/fr/workflows#migrate-many-files-in-parallel) exécute un agent dans son propre worktree

3330* Claude Code isole une [session en arrière-plan](/docs/fr/agent-view#how-file-edits-are-isolated) dans son propre worktree

3331* [`claude remote-control`](/docs/fr/remote-control#start-a-remote-control-session) en mode `worktree` démarre une session dans son propre worktree

3332 

3333Lorsque Claude exécute `git worktree add` via l'outil Bash au lieu d'appeler `EnterWorktree`, votre hook WorktreeCreate ne s'exécute pas. Pour inspecter ou bloquer cette commande, ajoutez un hook [`PreToolUse`](#pretooluse) avec le matcher `Bash`.

3334 

3335Par défaut, Claude Code crée la copie de travail isolée avec `git worktree`. La configuration d'un hook WorktreeCreate remplace ce comportement git par défaut, ce qui vous permet d'utiliser un autre système de gestion de versions comme SVN, Perforce ou Mercurial.

3325 3336 

3326Comme le hook remplace entièrement le comportement par défaut, [`.worktreeinclude`](/docs/fr/worktrees#copy-gitignored-files-into-worktrees) n'est pas traité. Si vous devez copier des fichiers de configuration locaux comme `.env` dans le nouveau worktree, faites-le dans votre script de hook.3337Comme le hook remplace entièrement le comportement par défaut, [`.worktreeinclude`](/docs/fr/worktrees#copy-gitignored-files-into-worktrees) n'est pas traité. Si vous devez copier des fichiers de configuration locaux comme `.env` dans le nouveau worktree, faites-le dans votre script de hook.

3327 3338 

3390* Vous quittez une [session de worktree](/docs/fr/worktrees#start-claude-in-a-worktree) interactive et choisissez de supprimer le worktree lorsque Claude Code vous le demande3401* Vous quittez une [session de worktree](/docs/fr/worktrees#start-claude-in-a-worktree) interactive et choisissez de supprimer le worktree lorsque Claude Code vous le demande

3391* Vous quittez une session de worktree interactive que vous n'avez pas [nommée](/docs/fr/sessions#name-your-sessions), Claude Code ne trouve aucun fichier modifié ou non suivi, et supprime le worktree sans vous le demander3402* Vous quittez une session de worktree interactive que vous n'avez pas [nommée](/docs/fr/sessions#name-your-sessions), Claude Code ne trouve aucun fichier modifié ou non suivi, et supprime le worktree sans vous le demander

3392* Vous supprimez une [session en arrière-plan](/docs/fr/agent-view#what-deleting-a-session-removes) qui s'exécute dans le worktree3403* Vous supprimez une [session en arrière-plan](/docs/fr/agent-view#what-deleting-a-session-removes) qui s'exécute dans le worktree

3404* Vous demandez à Claude de quitter et de supprimer le worktree pendant une session, et Claude le supprime avec l'outil [`ExitWorktree`](/docs/fr/tools-reference)

3405* Une session démarrée par [`claude remote-control`](/docs/fr/remote-control#start-a-remote-control-session) en mode `worktree` se termine sans plantage, et Claude Code ne trouve dans son worktree aucun fichier modifié ou non suivi ni aucun nouveau commit

3406* Vous arrêtez `claude remote-control` alors que des sessions qu'il a démarrées en mode `worktree` sont toujours en cours d'exécution, et Claude Code ne trouve dans leurs worktrees aucun fichier modifié ou non suivi ni aucun nouveau commit

3407 

3408Lorsqu'un sous-agent ou un agent de workflow se termine, Claude Code conserve le worktree que votre hook WorktreeCreate a créé pour lui et n'exécute pas votre hook WorktreeRemove. Supprimez vous-même ces worktrees une fois le travail terminé.

3409 

3410Claude Code ne vous demande rien avant l'exécution de votre hook pour un appel `ExitWorktree` ou un nettoyage `claude remote-control`. `ExitWorktree` refuse de supprimer un worktree créé par un hook à moins que l'appel ne passe [`discard_changes: true`](/docs/fr/agent-sdk/typescript#exitworktree), ce qui fait de votre hook la dernière vérification sur ce chemin.

3393 3411 

3394Claude Code utilise git pour rechercher les fichiers modifiés ou non suivis ; il n'en trouve donc aucun dans un worktree qui n'est pas un checkout git ni situé dans l'un d'eux, même lorsque le répertoire contient du travail non commité. Vérifiez la présence de ce travail dans votre hook WorktreeRemove avant qu'il ne supprime quoi que ce soit.3412Claude Code utilise git pour rechercher les fichiers modifiés ou non suivis ; il n'en trouve donc aucun dans un worktree qui n'est pas un checkout git ni situé dans l'un d'eux, même lorsque le répertoire contient du travail non commité. Vérifiez la présence de ce travail dans votre hook WorktreeRemove avant qu'il ne supprime quoi que ce soit.

3395 3413 

3396Pour les worktrees basés sur git, Claude Code gère automatiquement le nettoyage avec `git worktree remove`. Si vous avez configuré un hook WorktreeCreate, associez-le à un hook WorktreeRemove pour contrôler le nettoyage des worktrees qu'il crée :3414Pour les worktrees basés sur git, Claude Code gère automatiquement le nettoyage avec `git worktree remove`. Si vous avez configuré un hook WorktreeCreate, associez-le à un hook WorktreeRemove pour contrôler le nettoyage :

3397 3415 

3398* **Aucun hook WorktreeRemove** : lorsque Claude Code supprime le worktree au moment où vous quittez une session de worktree, il se rabat sur `git worktree remove --force` sur le chemin renvoyé par votre hook WorktreeCreate, de sorte qu'un worktree reconnu par git est supprimé. Un worktree que git ne reconnaît pas, par exemple un worktree créé par votre hook avec un système de gestion de versions autre que git, reste sur le disque. Pour savoir ce que fait la suppression d'une [session en arrière-plan](/docs/fr/agent-view#what-deleting-a-session-removes) avec un worktree créé par un hook, consultez les règles de suppression de la vue des agents.3416* **Aucun hook WorktreeRemove** : Claude Code se rabat sur git pour une suppression à la sortie ou via `ExitWorktree`, et conserve le worktree lorsque `claude remote-control` effectue le nettoyage :

3417 * **Vous quittez une session worktree, ou Claude appelle `ExitWorktree`** : Claude Code supprime le chemin renvoyé par votre hook WorktreeCreate comme le ferait `git worktree remove --force`, de sorte qu'un worktree reconnu par git est supprimé. Un worktree que git ne reconnaît pas, par exemple un worktree créé par votre hook avec un système de gestion de versions autre que git, reste sur le disque.

3418 * **`claude remote-control` nettoie le worktree d'une session** : le worktree reste sur le disque, et le terminal qui exécute `claude remote-control` affiche `worktree removal failed, kept: <path>`.

3419 * **Vous supprimez une session en arrière-plan** : consultez [Ce que supprime la suppression d'une session](/docs/fr/agent-view#what-deleting-a-session-removes).

3399* **Le hook se termine avec 0** : le worktree est considéré comme supprimé. Claude Code ne lit rien d'autre du hook, assurez-vous donc que votre hook a bien supprimé le répertoire.3420* **Le hook se termine avec 0** : le worktree est considéré comme supprimé. Claude Code ne lit rien d'autre du hook, assurez-vous donc que votre hook a bien supprimé le répertoire.

3400* **Le hook se termine avec un code non nul** : la suppression échoue si le répertoire situé à `worktree_path` existe toujours ensuite, et le worktree reste sur le disque sans solution de repli git. Un hook qui a supprimé le répertoire avant de se terminer avec un code non nul est considéré comme ayant supprimé le worktree. Pour savoir comment l'échec est signalé, consultez [Entrée de WorktreeRemove](#worktreeremove-input).3421* **Le hook se termine avec un code non nul** : la suppression échoue si le répertoire situé à `worktree_path` existe toujours ensuite, et le worktree reste sur le disque sans solution de repli git. Un hook qui a supprimé le répertoire avant de se terminer avec un code non nul est considéré comme ayant supprimé le worktree. Pour savoir comment l'échec est signalé, consultez [Entrée de WorktreeRemove](#worktreeremove-input).

3401 3422 

3403 3424 

3404Claude Code ignore les [champs de sortie JSON](#json-output) d'un hook WorktreeRemove, tels que `systemMessage` et `continue`.3425Claude Code ignore les [champs de sortie JSON](#json-output) d'un hook WorktreeRemove, tels que `systemMessage` et `continue`.

3405 3426 

3406Pour la suppression d'une session en arrière-plan, Claude Code vérifie le chemin de worktree enregistré avant d'exécuter le hook et refuse un chemin qui est un lien symbolique ou qui passe par un lien symbolique sous la racine du dépôt. Le hook s'exécute pour un worktree qui contient encore des fichiers uniquement lorsque vous confirmez la suppression dans la [vue des agents](/docs/fr/agent-view#what-deleting-a-session-removes) ; pour un tel worktree, [`claude rm`](/docs/fr/agent-view#manage-sessions-from-the-shell) conserve au contraire la session et le worktree. Avant la v2.1.216, le hook s'exécutait sur le chemin enregistré sans ces vérifications.3427Lors de la suppression d'une session en arrière-plan, Claude Code vérifie le chemin de worktree enregistré avant d'exécuter le hook et refuse un chemin qui est un lien symbolique ou qui passe par un lien symbolique situé sous la racine du dépôt. Sur ce chemin, le hook ne s'exécute pour un worktree qui contient encore des fichiers que lorsque vous confirmez la suppression dans la [vue des agents](/docs/fr/agent-view#what-deleting-a-session-removes) ; pour un tel worktree, [`claude rm`](/docs/fr/agent-view#manage-sessions-from-the-shell) conserve au contraire la session et le worktree. Avant la v2.1.216, le hook s'exécutait sur le chemin enregistré sans ces vérifications.

3407 3428 

3408Claude Code transmet le chemin renvoyé par WorktreeCreate en tant que `worktree_path` dans l'entrée du hook. Cet exemple lit ce chemin et supprime le répertoire :3429Claude Code transmet le chemin renvoyé par WorktreeCreate en tant que `worktree_path` dans l'entrée du hook. Cet exemple lit ce chemin et supprime le répertoire :

3409 3430 

3444 3465 

3445* Le worktree reste sur le disque, et la commande et le stderr du hook sont envoyés au [log de débogage](#debug-hooks).3466* Le worktree reste sur le disque, et la commande et le stderr du hook sont envoyés au [log de débogage](#debug-hooks).

3446* Si vous supprimiez une session en arrière-plan, la session est également conservée. Le message de refus dans la [vue des agents](/docs/fr/agent-view#what-deleting-a-session-removes) indique comment le hook s'est terminé, par exemple `exited 1`, cite le début de son stderr et précise si une nouvelle suppression de la session supprime quand même le répertoire.3467* Si vous supprimiez une session en arrière-plan, la session est également conservée. Le message de refus dans la [vue des agents](/docs/fr/agent-view#what-deleting-a-session-removes) indique comment le hook s'est terminé, par exemple `exited 1`, cite le début de son stderr et précise si une nouvelle suppression de la session supprime quand même le répertoire.

3468* Si `claude remote-control` nettoyait le worktree d'une session, le terminal qui l'exécute affiche `worktree removal failed, kept: <path>`.

3447 3469 

3448<h3 id="precompact">3470<h3 id="precompact">

3449 PreCompact3471 PreCompact

55| Vous voulez | Commencez par | Isolation nécessaire | Notes |55| Vous voulez | Commencez par | Isolation nécessaire | Notes |

56| :- | :- | :- | :- |56| :- | :- | :- | :- |

57| Examiner chaque action vous-même | Mode manuel : `claude --permission-mode default` | Aucune | Travail sensible, code non familier |57| Examiner chaque action vous-même | Mode manuel : `claude --permission-mode default` | Aucune | Travail sensible, code non familier |

58| Itérer localement avec moins d'invites, sans classificateur | Mode manuel plus le sandbox Bash en [mode auto-allow](/docs/fr/sandboxing#sandbox-modes) : `claude --permission-mode default`, puis exécutez `/sandbox` et sélectionnez auto-allow | Le sandbox Bash intégré, sur macOS, Linux et WSL2 | Les règles de refus s'appliquent toujours, et les règles d'ask qui nomment une commande, comme `Bash(git push *)`, invitent toujours. Pour activer le sandbox à partir d'un fichier de paramètres à la place, définissez [`sandbox.enabled`](/docs/fr/settings-reference#sandbox-enabled) sur `true` |58| Itérer localement avec moins d'invites, sans classificateur | Mode manuel plus le sandbox Bash en [mode auto-allow](/docs/fr/sandboxing#sandbox-modes) : `claude --permission-mode default`, puis exécutez `/sandbox` et sélectionnez auto-allow | Le sandbox Bash intégré, sur macOS, Linux et WSL2 | Les règles de refus s'appliquent toujours, et les règles d'ask qui nomment une commande, comme `Bash(git push *)`, invitent toujours. Le [mode auto-allow](/docs/fr/sandboxing#auto-allow-mode) couvre d'autres commandes qui peuvent déclencher une demande de permission. Pour activer le sandbox à partir d'un fichier de paramètres à la place, définissez [`sandbox.enabled`](/docs/fr/settings-reference#sandbox-enabled) sur `true` |

59| Explorer avant de modifier quoi que ce soit | `claude --permission-mode plan` | Aucune | Claude Code bloque les modifications jusqu'à ce que vous [approuviez un plan](#review-and-approve-a-plan) |59| Explorer avant de modifier quoi que ce soit | `claude --permission-mode plan` | Aucune | Claude Code bloque les modifications jusqu'à ce que vous [approuviez un plan](#review-and-approve-a-plan) |

60| Travailler en mode automatique sans intervention | `claude --permission-mode auto`, le [mode de permission de démarrage intégré](#which-mode-a-session-starts-in) avec v2.1.283 ou ultérieur | Aucune ; un sandbox ou un conteneur ajoute une défense en profondeur | Nécessite un [modèle pris en charge](#eliminate-prompts-with-auto-mode), et votre organisation peut [désactiver le mode auto](#eliminate-prompts-with-auto-mode) |60| Travailler en mode automatique sans intervention | `claude --permission-mode auto`, le [mode de permission de démarrage intégré](#which-mode-a-session-starts-in) avec v2.1.283 ou ultérieur | Aucune ; un sandbox ou un conteneur ajoute une défense en profondeur | Nécessite un [modèle pris en charge](#eliminate-prompts-with-auto-mode), et votre organisation peut [désactiver le mode auto](#eliminate-prompts-with-auto-mode) |

61| Exécuter en CI avec une liste d'autorisation exacte | `claude -p "run the test suite" --permission-mode dontAsk --allowedTools "Bash(npm test)" "Read"` | Aucune au-delà de ce que votre exécuteur CI fournit | Les [sessions cloud](/docs/fr/claude-code-on-the-web) ignorent `dontAsk` des fichiers de paramètres |61| Exécuter en CI avec une liste d'autorisation exacte | `claude -p "run the test suite" --permission-mode dontAsk --allowedTools "Bash(npm test)" "Read"` | Aucune au-delà de ce que votre exécuteur CI fournit | Les [sessions cloud](/docs/fr/claude-code-on-the-web) ignorent `dontAsk` des fichiers de paramètres |

744* Les règles ask limitées au contenu comme `Bash(git push *)` forcent toujours une invite744* Les règles ask limitées au contenu comme `Bash(git push *)` forcent toujours une invite

745* Les règles de refus explicites s'appliquent toujours745* Les règles de refus explicites s'appliquent toujours

746* Les commandes `rm` ou `rmdir` qui ciblent un [chemin critique](/docs/fr/permission-modes#critical-paths) passent toujours par le flux d'autorisation régulier746* Les commandes `rm` ou `rmdir` qui ciblent un [chemin critique](/docs/fr/permission-modes#critical-paths) passent toujours par le flux d'autorisation régulier

747* D'autres commandes en sandbox peuvent également passer par le flux d'autorisation régulier, comme le décrit le [mode d'autorisation automatique](/docs/fr/sandboxing#auto-allow-mode)

747 748 

748Les commandes qui ne s'exécutent pas en sandbox, comme les commandes exclues, respectent la règle ask `Bash` simple comme d'habitude. Consultez [modes sandbox](/docs/fr/sandboxing#sandbox-modes) pour modifier ce comportement.749Les commandes qui ne s'exécutent pas en sandbox, comme les commandes exclues, respectent la règle ask `Bash` simple comme d'habitude. Consultez [modes sandbox](/docs/fr/sandboxing#sandbox-modes) pour modifier ce comportement.

749 750 

55* **Noms commençant par `claudeai-`** : réservés pour les marketplaces hébergées sur claude.ai. `claude plugin marketplace add` refuse toute autre marketplace qui en utilise un avec `Cannot add marketplace "<name>": names starting with "claudeai-" are reserved for marketplaces hosted on claude.ai`.55* **Noms commençant par `claudeai-`** : réservés pour les marketplaces hébergées sur claude.ai. `claude plugin marketplace add` refuse toute autre marketplace qui en utilise un avec `Cannot add marketplace "<name>": names starting with "claudeai-" are reserved for marketplaces hosted on claude.ai`.

56* **Le dossier de téléchargement d'une marketplace GitHub enregistrée, `<owner>-<repo>`** : Claude Code télécharge une marketplace ajoutée à partir d'une source `github` telle que `acme/x-tools` via un dossier nommé `acme-x-tools`, quel que soit le `name` propre à cette marketplace. Tant que cette marketplace est enregistrée sous un nom autre que `acme-x-tools`, `claude plugin marketplace add` refuse une autre marketplace nommée `acme-x-tools` après l'avoir téléchargée, et signale `Can't use the marketplace name "acme-x-tools"`. Cette vérification nécessite Claude Code v2.1.290 ou ultérieure.56* **Le dossier de téléchargement d'une marketplace GitHub enregistrée, `<owner>-<repo>`** : Claude Code télécharge une marketplace ajoutée à partir d'une source `github` telle que `acme/x-tools` via un dossier nommé `acme-x-tools`, quel que soit le `name` propre à cette marketplace. Tant que cette marketplace est enregistrée sous un nom autre que `acme-x-tools`, `claude plugin marketplace add` refuse une autre marketplace nommée `acme-x-tools` après l'avoir téléchargée, et signale `Can't use the marketplace name "acme-x-tools"`. Cette vérification nécessite Claude Code v2.1.290 ou ultérieure.

57 57 

58Quand une marketplace enregistrée cesse de se charger parce que son nom imite celui d'une marketplace officielle, `claude plugin list` et `/plugin` signalent `Claude Code refuses the marketplace name "<name>"`. Le message vous indique de supprimer la marketplace. La supprimer désinstalle également ses plugins et supprime leurs données enregistrées. Ce message de refus nommé nécessite Claude Code v2.1.282 ou ultérieure.58Quand une marketplace enregistrée cesse de se charger parce que son nom imite celui d'une marketplace officielle, `claude plugin list` et `/plugin` signalent `Claude Code refuses the marketplace name "<name>"`. Le message vous indique de supprimer la marketplace. La supprimer désinstalle également ses plugins et supprime leurs données, options et secrets. Ce message de refus nommé nécessite Claude Code v2.1.282 ou ultérieure.

59 

60Si un fichier de paramètres déclare la marketplace en ligne, le message vous indique de renommer son entrée avant de supprimer l'ancien nom. Pour les étapes, consultez [Claude Code refuse le nom de la marketplace](/docs/fr/errors#claude-code-refuses-the-marketplace-name). Le message les énumère dans Claude Code v2.1.292 ou ultérieure.

59 61 

60<h2 id="top-level-fields">62<h2 id="top-level-fields">

61 Champs de niveau supérieur63 Champs de niveau supérieur

88| [`prompt.submit`](/docs/fr/plugins/mods/events#rewrite-or-add-to-a-prompt) | Un prompt est soumis | `next({ ...e, text })`, `next({ ...e, context })` ou `{ drop: reason }` |88| [`prompt.submit`](/docs/fr/plugins/mods/events#rewrite-or-add-to-a-prompt) | Un prompt est soumis | `next({ ...e, text })`, `next({ ...e, context })` ou `{ drop: reason }` |

89| `prompt.fill`, `prompt.suggest` | Du texte est sur le point d'être placé dans la zone de prompt en tant que brouillon, ou en tant que suggestion estompée | `next(e)` avec le texte modifié |89| `prompt.fill`, `prompt.suggest` | Du texte est sur le point d'être placé dans la zone de prompt en tant que brouillon, ou en tant que suggestion estompée | `next(e)` avec le texte modifié |

90| `prompt.edit` | L'utilisateur modifie la zone de prompt | `next(e)` |90| `prompt.edit` | L'utilisateur modifie la zone de prompt | `next(e)` |

91| `prompt.autocomplete` | L'utilisateur saisit du texte dans la zone de prompt et un mot se termine au niveau du curseur. `e.token` est ce mot. Claude Code n'attend pas le hook : ses propres lignes d'autocomplétion s'affichent en premier. | `{ suggestions }`, une liste de lignes `{ text, label, description }` affichées sous celles de Claude Code. Choisir une ligne remplace le mot par son `text`. |

91| `prompt.compose` | Claude Code génère un prompt système | `{ sections }`, une liste de `{ id, text, scope }` dans l'ordre d'envoi |92| `prompt.compose` | Claude Code génère un prompt système | `{ sections }`, une liste de `{ id, text, scope }` dans l'ordre d'envoi |

92| [`prompt.section`](/docs/fr/plugins/mods/events#rewrite-or-add-to-a-prompt) | Une fois pour chaque section nommée du prompt système. `e.name` est l'`id` de la section dans `prompt.compose`. | `{ text }`, ou `{ text: null }` pour omettre la section |93| [`prompt.section`](/docs/fr/plugins/mods/events#rewrite-or-add-to-a-prompt) | Une fois pour chaque section nommée du prompt système. `e.name` est l'`id` de la section dans `prompt.compose`. | `{ text }`, ou `{ text: null }` pour omettre la section |

93| [`prompt.context`](/docs/fr/plugins/mods/events#rewrite-or-add-to-a-prompt) | Une fois pour chaque conversation, pour le contexte envoyé avec le premier message | `{ blocks }` |94| [`prompt.context`](/docs/fr/plugins/mods/events#rewrite-or-add-to-a-prompt) | Une fois pour chaque conversation, pour le contexte envoyé avec le premier message | `{ blocks }` |

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

65 | `-c`, `--continue` | Reprendre la session que le dernier serveur dans ce répertoire a démarrée, au lieu d'en créer une nouvelle. Voir [Reprendre les sessions après l'arrêt du serveur](#resume-sessions-after-stopping-the-server). 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. |65 | `-c`, `--continue` | Reprendre la session que le dernier serveur dans ce répertoire a démarrée, au lieu d'en créer une nouvelle. Voir [Reprendre les sessions après l'arrêt du serveur](#resume-sessions-after-stopping-the-server). 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. |

66 | `--session-id <id>` | Reprendre une session par son ID. Voir [Reprendre les sessions après l'arrêt du serveur](#resume-sessions-after-stopping-the-server). 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. |66 | `--session-id <id>` | Reprendre une session par son ID. Voir [Reprendre les sessions après l'arrêt du serveur](#resume-sessions-after-stopping-the-server). 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. |

67 | `--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](/docs/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`. |67 | `--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 son propre [git worktree](/docs/fr/worktrees). Nécessite un dépôt git ou un [hook `WorktreeCreate`](/docs/fr/hooks#worktreecreate).<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`. |

68 | `--capacity <N>` | Nombre maximum de sessions concurrentes. La valeur par défaut est 32. Ne peut pas être utilisé avec `--spawn=session`. |68 | `--capacity <N>` | Nombre maximum de sessions concurrentes. La valeur par défaut est 32. Ne peut pas être utilisé avec `--spawn=session`. |

69 | `--[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. Si vous passez `--no-create-session-in-dir` pour démarrer sans aucune, Claude Code archive les sessions du serveur lorsque vous l'arrêtez, il n'y a donc rien à [reprendre](#resume-sessions-after-stopping-the-server). |69 | `--[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. Si vous passez `--no-create-session-in-dir` pour démarrer sans aucune, Claude Code archive les sessions du serveur lorsque vous l'arrêtez, il n'y a donc rien à [reprendre](#resume-sessions-after-stopping-the-server). |

70 | `--permission-mode <mode>` | Définissez le [mode de permission](/docs/fr/permission-modes) de démarrage pour les sessions du serveur, tel que `acceptEdits`. Accepte `manual` comme alias pour `default` ; un mode non reconnu arrête le serveur au démarrage et liste les modes valides. |70 | `--permission-mode <mode>` | Définissez le [mode de permission](/docs/fr/permission-modes) de démarrage pour les sessions du serveur, tel que `acceptEdits`. Accepte `manual` comme alias pour `default` ; un mode non reconnu arrête le serveur au démarrage et liste les modes valides. |

202* Les [règles de refus](/docs/fr/permissions) explicites sont toujours respectées202* Les [règles de refus](/docs/fr/permissions) explicites sont toujours respectées

203* Les commandes `rm` ou `rmdir` qui ciblent un [chemin critique](/docs/fr/permission-modes#critical-paths) passent toujours par le flux de permission standard203* Les commandes `rm` ou `rmdir` qui ciblent un [chemin critique](/docs/fr/permission-modes#critical-paths) passent toujours par le flux de permission standard

204* Les [règles de demande](/docs/fr/permissions) ciblant un contenu, comme `Bash(git push *)`, imposent toujours une demande, même pour les commandes en sandbox204* Les [règles de demande](/docs/fr/permissions) ciblant un contenu, comme `Bash(git push *)`, imposent toujours une demande, même pour les commandes en sandbox

205* Une règle de demande `Bash` seule, ou sa forme équivalente `Bash(*)`, est ignorée pour les commandes exécutées en sandbox ; elle s'applique toujours aux commandes qui se rabattent sur le flux de permission standard. En [mode plan](/docs/fr/permission-modes#analyze-before-you-edit-with-plan-mode), la règle n'est pas ignorée : elle déclenche aussi une demande pour les commandes en sandbox, y compris celles en lecture seule205* Une règle de demande `Bash` seule, ou sa forme équivalente `Bash(*)`, est ignorée pour les commandes exécutées en sandbox ; elle s'applique toujours aux commandes qui s'exécutent en dehors du sandbox. En [mode plan](/docs/fr/permission-modes#analyze-before-you-edit-with-plan-mode), la règle n'est pas ignorée : elle déclenche aussi une demande pour les commandes en sandbox, y compris celles en lecture seule

206* Les commandes de l'[outil Monitor](/docs/fr/tools-reference#monitor-tool) ne sont pas approuvées automatiquement, bien qu'elles s'exécutent toujours dans le sandbox. Pour éviter la demande, ajoutez une [règle d'autorisation](/docs/fr/permissions#bash) qui correspond à la commande, comme `Bash(npm run *)`206* Les commandes de l'[outil Monitor](/docs/fr/tools-reference#monitor-tool) ne sont pas approuvées automatiquement, bien qu'elles s'exécutent toujours dans le sandbox. Pour éviter la demande, ajoutez une [règle d'autorisation](/docs/fr/permissions#bash) qui correspond à la commande, comme `Bash(npm run *)`

207 207 

208Certaines commandes en sandbox passent également par le [flux de permission](/docs/fr/permissions) standard au lieu d'être approuvées automatiquement. C'est le cas de commandes telles que `FOO=bar npm test`, où une variable définie devant une commande peut changer le programme exécuté, ainsi que de `make CC=clang` ou `eval "ls"`. Vos règles d'autorisation et votre mode de permission déterminent alors si vous recevez une demande, et la commande s'exécute toujours dans le sandbox.

209 

210Pour ces trois commandes, une [règle d'autorisation](/docs/fr/permissions#bash) qui correspond à la commande met fin à une demande récurrente. Ces règles illustrent le principe :

211 

212* `Bash(make *)` approuve `make CC=clang`

213* `Bash(FOO=bar npm *)` approuve `FOO=bar npm test`. Lorsque la commande commence par une affectation de variable, incluez l'affectation dans la règle

214* `Bash(eval "ls")` approuve `eval "ls"`. Une règle avec caractère générique telle que `Bash(eval *)` ne supprime pas cette demande ; écrivez donc une règle qui correspond à la commande entière

215 

216Une règle d'autorisation qui correspond à une commande approuve également une [nouvelle tentative hors sandbox](#the-unsandboxed-retry-escape-hatch) de celle-ci, de sorte que la commande peut s'exécuter en dehors du sandbox sans demande.

217 

208<Info>218<Info>

209 Le mode d'approbation automatique fonctionne indépendamment de votre paramètre de mode de permission, à trois exceptions près : le [mode plan](/docs/fr/permission-modes#analyze-before-you-edit-with-plan-mode), une commande en mode auto qui comporte des [domaines autorisés par commande](#per-command-allowed-domains-in-auto-mode), et l'[examen par le classifieur côté serveur](/docs/fr/permission-modes#how-the-classifier-evaluates-actions) des commandes en sandbox en mode auto. Même si vous n'êtes pas en mode « accept edits », les commandes Bash en sandbox s'exécutent automatiquement lorsque l'approbation automatique est activée. Cela signifie que les commandes Bash qui modifient des fichiers dans les limites du sandbox s'exécutent sans demande, même en mode Manual, où les outils de modification de fichiers déclencheraient une demande.219 Le mode d'approbation automatique fonctionne indépendamment de votre paramètre de mode de permission, à trois exceptions près : le [mode plan](/docs/fr/permission-modes#analyze-before-you-edit-with-plan-mode), une commande en mode auto qui comporte des [domaines autorisés par commande](#per-command-allowed-domains-in-auto-mode), et l'[examen par le classifieur côté serveur](/docs/fr/permission-modes#how-the-classifier-evaluates-actions) des commandes en sandbox en mode auto. Même si vous n'êtes pas en mode « accept edits », les commandes Bash en sandbox s'exécutent automatiquement lorsque l'approbation automatique est activée. Cela signifie que les commandes Bash qui modifient des fichiers dans les limites du sandbox s'exécutent sans demande, même en mode Manual, où les outils de modification de fichiers déclencheraient une demande.

210 220 

191 Gigue191 Gigue

192</h3>192</h3>

193 193 

194Une tâche planifiée peut s'exécuter à un moment différent de celui indiqué par sa planification. Si les tâches de chaque session s'exécutaient exactement à l'heure prévue, beaucoup d'entre elles appelleraient l'API au même moment. Claude Code décale donc l'heure d'exécution de chaque tâche. Les tâches récurrentes s'exécutent en retard, et les tâches ponctuelles planifiées à l'heure pile ou à la demie s'exécutent un peu en avance.194Une tâche planifiée peut s'exécuter à un moment différent de celui indiqué par sa planification. Si les tâches de chaque session s'exécutaient exactement à l'heure prévue, beaucoup d'entre elles appelleraient l'API au même moment. Claude Code décale donc l'heure d'exécution de chaque tâche. Les tâches récurrentes s'exécutent en retard, sauf une tâche qui s'exécute toutes les cinq minutes, écrite `*/5 * * * *`. Les tâches ponctuelles planifiées à l'heure pile ou à la demie s'exécutent un peu en avance.

195 195 

196<h4 id="how-late-a-recurring-task-runs">196<h4 id="how-late-a-recurring-task-runs">

197 Quel retard pour une tâche récurrente197 Quel retard pour une tâche récurrente

198</h4>198</h4>

199 199 

200Lorsque vous créez une tâche récurrente, Claude Code lui attribue un délai fixe et ajoute ce délai à chaque exécution. Le délai est calculé à partir de l'ID de la tâche, de sorte que la même tâche s'exécute avec le même nombre de minutes de retard à chaque fois, y compris lorsque la session est inactive et que rien d'autre ne s'exécute.200Sauf si elle s'exécute toutes les cinq minutes, une tâche récurrente démarre chaque exécution avec un retard pouvant atteindre la moitié de l'intervalle jusqu'à l'exécution suivante, et au plus 30 minutes. Votre tâche correspond à l'un de ces trois cas :

201 201 

202Les tâches qui s'exécutent plus souvent obtiennent des délais plus courts, et 30 minutes est le délai le plus long qu'une tâche puisse obtenir. Voici les plages de délai pour quelques planifications courantes :202* **Exécutions régulièrement espacées** : une tâche avec des intervalles égaux, par exemple toutes les heures, quotidiennement ou toutes les 10 minutes, s'exécute avec le même nombre de minutes de retard à chaque fois, y compris lorsque la session est inactive.

203* **Exécutions irrégulièrement espacées** : une tâche avec des intervalles inégaux, par exemple une tâche planifiée pour `:00` et `:15` chaque heure, peut s'exécuter avec un nombre de minutes de retard différent à chacune.

204* **Toutes les cinq minutes** : une tâche écrite `*/5 * * * *` n'est pas retardée. Une exécution exactement cinq minutes après la précédente démarrerait après l'expiration d'un [cache de prompt](/docs/fr/prompt-caching#which-ttl-each-request-gets) de cinq minutes, donc chaque exécution démarre 15 secondes plus tôt.

203 205 

204| La tâche s'exécute | Le délai est compris entre |206Trouvez votre planification dans la première colonne de ce tableau pour voir quand chacune de ses exécutions démarre.

207 

208| Planification | Démarrage de chaque exécution |

205| :- | :- |209| :- | :- |

206| Toutes les 10 minutes | 0 et 5 minutes |210| Toutes les 5 minutes, écrite `*/5 * * * *`, ce que crée `/loop 5m` | 4 minutes 45 secondes après l'exécution précédente |

207| Toutes les 30 minutes | 0 et 15 minutes |211| Toutes les 10 minutes | 0 à 5 minutes de retard |

208| Toutes les heures, ou moins souvent, par exemple quotidiennement | 0 et 30 minutes |212| Toutes les 30 minutes | 0 à 15 minutes de retard |

213| Toutes les heures, ou moins souvent, par exemple quotidiennement | 0 à 30 minutes de retard |

209 214 

210Par exemple, `7,37 * * * *` planifie une tâche pour `:07` et `:37`, qui sont espacés de 30 minutes, donc son délai est compris entre 0 et 15 minutes. Si le délai de cette tâche est de 14 minutes, elle s'exécute à `:21` et `:51` toutes les heures. Changer la planification pour une autre minute déplace l'heure d'exécution, et un délai s'y ajoute toujours.215Par exemple, `7,37 * * * *` planifie une tâche pour `:07` et `:37`, qui sont espacés de 30 minutes, donc son délai est compris entre 0 et 15 minutes. Si le délai de cette tâche est de 14 minutes, elle s'exécute à `:21` et `:51` toutes les heures. Changer la planification pour une autre minute déplace l'heure d'exécution, et un délai s'y ajoute toujours.

211 216 

1931 1931 

1932* **Scope** : [`Any file`](#scopes)1932* **Scope** : [`Any file`](#scopes)

1933* **Type** : Booléen1933* **Type** : Booléen

1934 * `true` : Claude Code exécute les commandes Bash en sandbox sans demande de permission, sous réserve des règles `deny` et des règles `ask` limitées au contenu ; `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` désactive l'auto-allow1934 * `true` : Claude Code exécute les commandes Bash en sandbox sans demande de permission, sauf dans les cas que décrit [Auto-allow mode](/docs/fr/sandboxing#auto-allow-mode) ; `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` désactive l'auto-allow

1935 * `false` : les commandes en sandbox passent par le flux de permission régulier, donc vos règles d'autorisation et le mode de permission décident. L'onglet **Mode** de `/sandbox` appelle ceci mode de permissions régulier1935 * `false` : les commandes en sandbox passent par le flux de permission régulier, donc vos règles d'autorisation et le mode de permission décident. L'onglet **Mode** de `/sandbox` appelle ceci mode de permissions régulier

1936* **Default** : `true`1936* **Default** : `true`

1937 1937 

1946}1946}

1947```1947```

1948 1948 

1949Consultez [Sandbox modes](/docs/fr/sandboxing#sandbox-modes) pour savoir sur quoi l'auto-allow demande toujours et comment il se comporte en mode plan.1949Consultez [Auto-allow mode](/docs/fr/sandboxing#auto-allow-mode) pour savoir sur quoi le mode auto-allow demande toujours et comment il se comporte en mode plan.

1950 1950 

1951<h3 id="sandbox-excludedcommands">1951<h3 id="sandbox-excludedcommands">

1952 `sandbox.excludedCommands`1952 `sandbox.excludedCommands`

1308En dehors du [rendu en plein écran](/docs/fr/fullscreen), Claude Code affiche les notifications sur la même ligne que votre barre de statut. En rendu en plein écran, Claude Code donne aux notifications leur propre ligne.1308En dehors du [rendu en plein écran](/docs/fr/fullscreen), Claude Code affiche les notifications sur la même ligne que votre barre de statut. En rendu en plein écran, Claude Code donne aux notifications leur propre ligne.

1309 1309 

1310* Les notifications système comme les erreurs de serveur MCP et les mises à jour automatiques s'affichent sur le côté droit de la ligne. Les notifications transitoires telles que l'avertissement de contexte faible circulent également dans cette zone.1310* Les notifications système comme les erreurs de serveur MCP et les mises à jour automatiques s'affichent sur le côté droit de la ligne. Les notifications transitoires telles que l'avertissement de contexte faible circulent également dans cette zone.

1311* L'activation du mode verbeux ajoute un compteur de tokens à cette zone1311* L'activation du mode verbeux ajoute un compteur de tokens à cette zone, indiquant la taille de votre contexte telle que rapportée par la dernière réponse API, et non le [décompte par tour affiché à côté de l'indicateur de chargement](/docs/fr/costs#read-the-token-count-beside-the-spinner)

1312* Sur les terminaux étroits, ces notifications peuvent tronquer votre sortie de barre de statut1312* Sur les terminaux étroits, ces notifications peuvent tronquer votre sortie de barre de statut

431 431 

432Reprenez une exécution en pause à partir de `/workflows` en la sélectionnant et en appuyant sur `p`. Pour une exécution que vous avez arrêtée, demandez à Claude de relancer le workflow avec le même script. Si les agents de l'exécution arrêtée n'ont pas encore quitté, Claude Code refuse le relancement jusqu'à ce qu'ils le fassent, afin qu'une deuxième copie de ces agents ne puisse pas s'exécuter à côté d'eux.432Reprenez une exécution en pause à partir de `/workflows` en la sélectionnant et en appuyant sur `p`. Pour une exécution que vous avez arrêtée, demandez à Claude de relancer le workflow avec le même script. Si les agents de l'exécution arrêtée n'ont pas encore quitté, Claude Code refuse le relancement jusqu'à ce qu'ils le fassent, afin qu'une deuxième copie de ces agents ne puisse pas s'exécuter à côté d'eux.

433 433 

434<h4 id="which-agents-run-again">

435 Quels agents s'exécutent à nouveau

436</h4>

437 

434Claude Code rejoue l'exécution dans l'ordre où les agents ont commencé, et chaque agent retourne soit son résultat sauvegardé, soit s'exécute à nouveau :438Claude Code rejoue l'exécution dans l'ordre où les agents ont commencé, et chaque agent retourne soit son résultat sauvegardé, soit s'exécute à nouveau :

435 439 

436* **Terminé** : retourne son résultat sauvegardé. Le premier agent dont l'invite diffère de l'exécution précédente, parce que vous avez modifié le script ou qu'un agent antérieur a retourné quelque chose de différent, s'exécute à nouveau, tout comme tous les agents après lui, même ceux qui ont terminé.440* **Terminé** : retourne son résultat sauvegardé. Le premier agent dont l'invite diffère de l'exécution précédente, parce que vous avez modifié le script ou qu'un agent antérieur a retourné quelque chose de différent, s'exécute à nouveau, tout comme tous les agents après lui, même ceux qui ont terminé.

439 443 

440Ce dernier cas signifie qu'un échec au milieu d'une distribution réexécute le travail qui a déjà terminé. Si un script démarre A, B, C et D dans cet ordre et que B échoue, relancer retourne A du cache et exécute B, C et D à nouveau.444Ce dernier cas signifie qu'un échec au milieu d'une distribution réexécute le travail qui a déjà terminé. Si un script démarre A, B, C et D dans cet ordre et que B échoue, relancer retourne A du cache et exécute B, C et D à nouveau.

441 445 

446Si vous modifiez un script qui démarrait A, B, C et D pour qu'il démarre A, C, B et D, le deuxième agent à démarrer est désormais C, là où l'exécution précédente démarrait B. Relancer retourne A du cache et exécute C, B et D à nouveau.

447 

448<h4 id="resume-after-you-leave-the-session">

449 Reprendre après avoir quitté la session

450</h4>

451 

442Vous pouvez reprendre une exécution dans la même session Claude Code. Ce qui arrive à un workflow en cours d'exécution quand vous quittez la session dépend de la façon dont vous quittez :452Vous pouvez reprendre une exécution dans la même session Claude Code. Ce qui arrive à un workflow en cours d'exécution quand vous quittez la session dépend de la façon dont vous quittez :

443 453 

444* Si vous [mettez la session en arrière-plan](/docs/fr/agent-view#what-carries-over-when-you-background), Claude Code rejoue l'exécution de la même manière dans la session en arrière-plan et la continue.454* Si vous [mettez la session en arrière-plan](/docs/fr/agent-view#what-carries-over-when-you-background), Claude Code rejoue l'exécution de la même manière dans la session en arrière-plan et la continue.

129and report the results.129and report the results.

130```130```

131 131 

132Chaque subagent obtient un worktree temporaire que Claude Code supprime automatiquement quand le subagent se termine sans modifications ; un worktree avec des modifications reste sur le disque jusqu'à ce que le [balayage périodique ci-dessous](#clean-up-subagent-and-background-session-worktrees) puisse le supprimer sans perdre de travail.132Chaque sous-agent obtient un worktree temporaire que Claude Code supprime automatiquement quand le sous-agent se termine sans modifications ; un worktree avec des modifications reste sur le disque jusqu'à ce que le [balayage périodique ci-dessous](#clean-up-subagent-and-background-session-worktrees) puisse le supprimer sans perdre de travail. Pour un worktree créé par votre [hook WorktreeCreate](/docs/fr/hooks#worktreecreate), consultez plutôt [WorktreeRemove](/docs/fr/hooks#worktreeremove).

133 133 

134Les worktrees des subagents utilisent la même [branche de base](#choose-the-base-branch) que `--worktree`, donc ils se ramifient à partir de la branche par défaut de votre dépôt sauf si `worktree.baseRef` est défini sur `"head"`.134Les worktrees des subagents utilisent la même [branche de base](#choose-the-base-branch) que `--worktree`, donc ils se ramifient à partir de la branche par défaut de votre dépôt sauf si `worktree.baseRef` est défini sur `"head"`.

135 135