Documentation — Spybara

agent-sdk/python.md +1 −1

Details

2885 2885

2886**Nom de l'outil :** `Bash`2886**Nom de l'outil :** `Bash`

2887 2887

2888Pour ce qui définit le plafond au premier plan, voir [Limites de délai d'attente et de sortie](/docs/fr/tools-reference#timeout-and-output-limits). Pour la limite de temps en arrière-plan, voir [Commandes en arrière-plan](/docs/fr/tools-reference#background-commands).2888Pour ce qui définit le plafond au premier plan, voir [Limites de délai d'attente et de sortie](/docs/fr/tools-reference#timeout-and-output-limits). Pour la limite de temps en arrière-plan, voir [Limite de temps pour les commandes en arrière-plan](/docs/fr/tools-reference#time-limit-for-background-commands).

2889 2889

2890**Entrée :**2890**Entrée :**

2891 2891

agent-sdk/typescript.md +39 −39

Details

3239};3239};

3240```3240```

3241 3241

3242Exécute les commandes Bash avec délai d'expiration optionnel et exécution en arrière-plan. Le répertoire de travail persiste entre les commandes, y compris les commandes exécutées dans les tours ultérieurs d'une session multi-tour ; l'état du shell tel que les variables d'environnement exportées ne persiste pas. Pour les limites sur les changements de répertoire qui persistent, voir [Ce qui persiste entre les commandes](/docs/fr/tools-reference#what-persists-between-commands). Pour ce qui définit le plafond de premier plan, voir [Délai d'expiration et limites de sortie](/docs/fr/tools-reference#timeout-and-output-limits). Pour la limite de temps en arrière-plan, voir [Commandes en arrière-plan](/docs/fr/tools-reference#background-commands).3242Exécute les commandes Bash avec délai d'expiration optionnel et exécution en arrière-plan. Le répertoire de travail persiste entre les commandes, y compris les commandes exécutées dans les tours ultérieurs d'une session multi-tour ; l'état du shell tel que les variables d'environnement exportées ne persiste pas. Pour les limites sur les changements de répertoire qui persistent, voir [Ce qui persiste entre les commandes](/docs/fr/tools-reference#what-persists-between-commands). Pour ce qui définit le plafond de premier plan, voir [Délai d'expiration et limites de sortie](/docs/fr/tools-reference#timeout-and-output-limits). Pour la limite de temps en arrière-plan, voir [Limite de temps pour les commandes en arrière-plan](/docs/fr/tools-reference#time-limit-for-background-commands).

3243 3243

3244<h3 id="monitor">3244<h3 id="monitor">

3245 Monitor3245 Monitor

3930Les arguments des outils MCP sont un objet ouvert : chaque serveur définit ses propres paramètres, donc le type ne place aucune contrainte sur les noms de champs ou les valeurs. Consultez le schéma d'outil du serveur pour les champs qu'un outil spécifique accepte.3930Les arguments des outils MCP sont un objet ouvert : chaque serveur définit ses propres paramètres, donc le type ne place aucune contrainte sur les noms de champs ou les valeurs. Consultez le schéma d'outil du serveur pour les champs qu'un outil spécifique accepte.

3931 3931

3932<h2 id="tool-output-types">3932<h2 id="tool-output-types">

3933 Types de sortie d'outil3933 Types de sortie d'outils

3934</h2>3934</h2>

3935 3935

3936Documentation 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 retournées par chaque outil.3936Documentation 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.

3937 3937

3938<h3 id="tooloutputschemas">3938<h3 id="tooloutputschemas">

3939 `ToolOutputSchemas`3939 `ToolOutputSchemas`

3940</h3>3940</h3>

3941 3941

3942Union de types de sortie d'outil exportés depuis `@anthropic-ai/claude-agent-sdk/sdk-tools` ; les membres incluent :3942Union des types de sortie d'outils exportés depuis `@anthropic-ai/claude-agent-sdk/sdk-tools` ; les membres incluent :

3943 3943

3944```typescript theme={null}3944```typescript theme={null}

3945type ToolOutputSchemas =3945type ToolOutputSchemas =

4057 };4057 };

4058```4058```

4059 4059

4060Retourne le résultat du sous-agent. Discriminé sur le champ `status` : `"completed"` pour les tâches terminées, `"async_launched"` pour les tâches de fond, et `"remote_launched"` pour les tâches que Claude Code a envoyées à une session cloud distante, où `sessionUrl` renvoie à cette session et `taskId` l'identifie.4060Retourne le résultat du sous-agent. Discriminé sur le champ `status` : `"completed"` pour les tâches terminées, `"async_launched"` pour les tâches en arrière-plan, et `"remote_launched"` pour les tâches que Claude Code a envoyées à une session cloud, où `sessionUrl` renvoie à cette session et `taskId` l'identifie.

4061 4061

4062Sur la variante `completed`, `resolvedModel` nomme le modèle sur lequel le sous-agent a démarré, qui peut différer du modèle demandé en entrée `model` lorsque [`availableModels`](/docs/fr/model-config#restrict-model-selection) ou une autre substitution s'applique. Ce champ nécessite Claude Code v2.1.174 ou ultérieur. Sur `async_launched`, il nomme le modèle en cours d'utilisation lorsque la tâche est passée en arrière-plan.4062Sur la variante `completed`, `resolvedModel` nomme le modèle sur lequel le sous-agent a démarré, qui peut différer du `model` d'entrée demandé lorsque [`availableModels`](/docs/fr/model-config#restrict-model-selection) ou une autre substitution s'applique. Ce champ nécessite Claude Code v2.1.174 ou ultérieur. Sur `async_launched`, il nomme le modèle en cours d'utilisation lorsque la tâche est passée en arrière-plan.

4063 4063

4064`modelsUsed` énumère les modèles utilisés par le sous-agent, dans l'ordre. Le champ est présent uniquement lorsqu'un changement de modèle en cours d'exécution s'est produit, et un modèle apparaît à nouveau lorsque l'exécution a basculé vers lui. Sur `async_launched`, la liste couvre les modèles utilisés avant la mise en arrière-plan. À la fois `modelsUsed` et le comportement de mise en arrière-plan de `resolvedModel` nécessitent Claude Code v2.1.212 ou ultérieur.4064`modelsUsed` énumère les modèles utilisés par le sous-agent, dans l'ordre. Le champ n'est présent que lorsqu'un changement de modèle en cours d'exécution s'est produit, et un modèle réapparaît lorsque l'exécution a basculé vers lui. Sur `async_launched`, la liste couvre les modèles utilisés avant la mise en arrière-plan. À la fois `modelsUsed` et le comportement de mise en arrière-plan de `resolvedModel` nécessitent Claude Code v2.1.212 ou ultérieur.

4065 4065

4066Si Claude Code [a conservé le worktree isolé du sous-agent](/docs/fr/worktrees#isolate-subagents-with-worktrees), `worktreePath` sur le résultat `completed` est l'endroit où le trouver. `worktreeBranch` est sa branche, présente lorsque Claude Code a créé le worktree avec git.4066Si Claude Code [a conservé le worktree isolé du sous-agent](/docs/fr/worktrees#isolate-subagents-with-worktrees), `worktreePath` sur le résultat `completed` indique où le trouver. `worktreeBranch` est sa branche, présente lorsque Claude Code a créé le worktree avec git.

4067 4067

4068Claude Code remplit `usage` et `totalTokens` à partir de la dernière demande API du sous-agent, pas de l'ensemble de l'exécution, donc `usage.service_tier` est la chaîne de niveau de service que l'API a signalée sur cette demande. Lorsqu'il est présent, `usage.output_tokens_details.thinking_tokens` est le nombre de jetons de sortie de cette demande qui étaient des jetons de réflexion. Le champ `output_tokens_details` nécessite TypeScript SDK v0.3.228 ou ultérieur, qui regroupe Claude Code v2.1.228.4068Claude Code remplit `usage` et `totalTokens` à partir de la dernière requête API du sous-agent, pas de l'ensemble de l'exécution, donc `usage.service_tier` est la chaîne de niveau de service que l'API a signalée sur cette requête. Lorsqu'il est présent, `usage.output_tokens_details.thinking_tokens` est le nombre de jetons de sortie de cette requête qui étaient des jetons de réflexion. Le champ `output_tokens_details` nécessite TypeScript SDK v0.3.228 ou ultérieur, qui regroupe Claude Code v2.1.228.

4069 4069

4070`usage.output_tokens_details` correspond à [`Usage.output_tokens_details`](#usage) en signification, limité à cette dernière demande, mais chaque niveau est optionnel ici. Protégez à la fois l'objet et le champ, par exemple `usage.output_tokens_details?.thinking_tokens ?? 0`, plutôt que de le lire directement.4070`usage.output_tokens_details` correspond à [`Usage.output_tokens_details`](#usage) en signification, limité à cette dernière requête, mais chaque niveau est optionnel ici. Protégez à la fois l'objet et le champ, par exemple `usage.output_tokens_details?.thinking_tokens ?? 0`, plutôt que de le lire directement.

4071 4071

4072Avant v2.1.207, le type publié était plus étroit. Il omettait `worktreePath`, `worktreeBranch`, `citations`, `toolStats.frameCount`, et les champs d'utilisation `inference_geo`, `speed` et `iterations`, et il typait `service_tier` comme `"standard" | "priority" | "batch"`. Les champs que le type marque comme optionnels peuvent être absents sur les résultats enregistrés par les versions antérieures.4072Avant v2.1.207, le type publié était plus étroit. Il omettait `worktreePath`, `worktreeBranch`, `citations`, `toolStats.frameCount`, et les champs d'utilisation `inference_geo`, `speed` et `iterations`, et il tapait `service_tier` comme `"standard" | "priority" | "batch"`. Les champs que le type marque comme optionnels peuvent être absents sur les résultats enregistrés par les versions antérieures.

4073 4073

4074<h3 id="askuserquestion-2">4074<h3 id="askuserquestion-2">

4075 AskUserQuestion4075 AskUserQuestion

4133};4133};

4134```4134```

4135 4135

4136Les champs `stdout`, `stderr` et `backgroundTaskId` portent :4136Les champs `stdout`, `stderr` et `backgroundTaskId` contiennent :

4137 4137

4138| Champ | Ce qu'il porte |4138| Champ | Ce qu'il contient |

4139| - | - |4139| - | - |

4141| `stderr` | Les avis que l'outil lui-même ajoute, comme une réinitialisation du répertoire de travail du shell, pas la sortie d'erreur de la commande |4141| `stderr` | Les avis que l'outil lui-même ajoute, comme une réinitialisation du répertoire de travail du shell, pas la sortie d'erreur de la commande |

4143 4143

4144`timedOutAfterMs` est le délai d'expiration en millisecondes, défini lorsque la commande a atteint son délai d'expiration et s'est déplacée en arrière-plan plutôt que de démarrer explicitement. `backgroundCwdHint` est défini lorsque la commande mise en arrière-plan contenait une fonction intégrée de changement de répertoire telle que `cd`, `pushd`, `popd` ou `chdir`, et note que le répertoire de travail de la session n'a pas changé. Les deux champs nécessitent Claude Code v2.1.210 ou ultérieur.4144`timedOutAfterMs` est le délai d'expiration en millisecondes, défini lorsque la commande a atteint son délai d'expiration et s'est déplacée en arrière-plan plutôt que de démarrer explicitement. `backgroundCwdHint` est défini lorsque la commande mise en arrière-plan contenait un builtin de changement de répertoire tel que `cd`, `pushd`, `popd` ou `chdir`, et note que le répertoire de travail de la session n'a pas changé. Les deux champs nécessitent Claude Code v2.1.210 ou ultérieur.

4145 4145

4146Lorsqu'un sous-agent s'exécutant au premier plan possède une commande mise en arrière-plan, la commande [se termine lorsque ce sous-agent donne sa réponse finale](/docs/fr/tools-reference#background-commands). Claude Code définit `backgroundEndsWithFinalResponse` à `true` sur de telles commandes, et omet le champ lorsque la commande survit au tour, comme les commandes démarrées par la conversation principale ou par les sous-agents de fond. Le champ nécessite Claude Code v2.1.227 ou ultérieur.4146Lorsqu'un sous-agent s'exécutant au premier plan possède une commande mise en arrière-plan, la commande [se termine lorsque l'exécution de ce sous-agent se termine](/docs/fr/tools-reference#when-a-background-command-stops). Claude Code définit `backgroundEndsWithFinalResponse` à `true` sur de telles commandes, et omet le champ lorsque la commande survit au tour, comme les commandes démarrées par la conversation principale ou par les sous-agents en arrière-plan. Le champ nécessite Claude Code v2.1.227 ou ultérieur.

4147 4147

4148Claude Code définit `gitOperation.commit.branch` à la branche nommée dans la ligne de résumé du commit git, et l'omet pour un commit effectué sur une HEAD détachée. Le champ nécessite Agent SDK v0.3.227 ou ultérieur. Claude Code signale une commande `gh pr reopen` comme l'action PR `reopened`, ce qui nécessite Agent SDK v0.3.234 ou ultérieur.4148Claude Code définit `gitOperation.commit.branch` sur la branche nommée dans la ligne de résumé du commit git, et l'omet pour un commit effectué sur un HEAD détaché. Le champ nécessite Agent SDK v0.3.227 ou ultérieur. Claude Code signale une commande `gh pr reopen` comme l'action PR `reopened`, ce qui nécessite Agent SDK v0.3.234 ou ultérieur.

4149 4149

4150<h3 id="monitor-2">4150<h3 id="monitor-2">

4151 Monitor4151 Monitor

4161};4161};

4162```4162```

4163 4163

4164Retourne l'ID de tâche de fond pour le moniteur en cours d'exécution. Utilisez cet ID avec `TaskStop` pour annuler la surveillance plus tôt.4164Retourne l'ID de la tâche en arrière-plan pour le moniteur en cours d'exécution. Utilisez cet ID avec `TaskStop` pour annuler la surveillance plus tôt.

4165 4165

4166<h3 id="edit-2">4166<h3 id="edit-2">

4167 Edit4167 Edit

4308};4308};

4309```4309```

4310 4310

4311Retourne le résultat d'écriture avec les informations de diff structuré. Ce que `originalFile` et `structuredPatch` contiennent dépend de l'écriture :4311Retourne le résultat de l'écriture avec les informations de diff structuré. Ce que `originalFile` et `structuredPatch` contiennent dépend de l'écriture :

4312 4312

4313* Pour un fichier nouvellement créé, `originalFile` est null et `structuredPatch` est vide4313* Pour un fichier nouvellement créé, `originalFile` est null et `structuredPatch` est vide

4314* Sur une réécriture, `originalFile` porte le contenu précédent, sauf lorsque ce contenu est plus grand qu'environ 10 Mo : Claude Code ignore alors le diff et retourne `originalFile` null et `structuredPatch` vide4314* Sur une réécriture, `originalFile` contient le contenu précédent, sauf lorsque ce contenu est plus grand qu'environ 10 Mo : Claude Code omet alors le diff et retourne `originalFile` null et `structuredPatch` vide

4315* `structuredPatch` est également vide lorsque l'écriture n'a rien changé ou que le diff a expiré4315* `structuredPatch` est également vide lorsque l'écriture n'a rien changé ou que le diff a expiré

4316 4316

4317<h3 id="glob-2">4317<h3 id="glob-2">

4356};4356};

4357```4357```

4358 4358

4359Retourne les résultats de recherche. La forme varie selon `mode` : liste de fichiers, contenu avec correspondances ou comptages de correspondances. En mode `count`, `numFiles` et `numMatches` sont des totaux sur l'ensemble des résultats, pas la tranche paginée. Avant v2.1.208, une `head_limit` ou un `offset` qui tronquait les entrées énumérées tronquait également ces totaux.4359Retourne les résultats de la recherche. La forme varie selon `mode` : liste de fichiers, contenu avec correspondances, ou comptages de correspondances. En mode `count`, `numFiles` et `numMatches` sont des totaux sur l'ensemble des résultats, pas la tranche paginée. Avant v2.1.208, une `head_limit` ou un `offset` qui tronquait les entrées listées tronquait également ces totaux.

4360 4360

4361`totalFiles` nécessite Claude Code v2.1.208 ou ultérieur et signale le nombre total de résultats avant la pagination `head_limit` et `offset` en mode `files_with_matches`. `totalLines` nécessite Claude Code v2.1.210 ou ultérieur et signale le nombre total de lignes avant la pagination en mode `content`.4361`totalFiles` nécessite Claude Code v2.1.208 ou ultérieur et signale le nombre total de résultats avant la pagination `head_limit` et `offset` en mode `files_with_matches`. `totalLines` nécessite Claude Code v2.1.210 ou ultérieur et signale le nombre total de lignes avant la pagination en mode `content`.

4362 4362

4375};4375};

4376```4376```

4377 4377

4378Retourne la confirmation après l'arrêt de la tâche de fond.4378Retourne une confirmation après l'arrêt de la tâche en arrière-plan.

4379 4379

4380<h3 id="notebookedit-2">4380<h3 id="notebookedit-2">

4381 NotebookEdit4381 NotebookEdit

4398};4398};

4399```4399```

4400 4400

4401Retourne le résultat de l'édition du carnet avec le contenu du fichier original et mis à jour.4401Retourne le résultat de l'édition du notebook avec les contenus de fichier original et mis à jour.

4402 4402

4403<h3 id="webfetch-2">4403<h3 id="webfetch-2">

4404 WebFetch4404 WebFetch

4424 4424

4425Retourne le contenu récupéré avec le statut HTTP et les métadonnées.4425Retourne le contenu récupéré avec le statut HTTP et les métadonnées.

4426 4426

4427`artifactRead` est l'enregistrement propre de Claude Code d'une lecture d'artefact, présent uniquement lorsque Claude a récupéré un artefact que la session peut publier. Claude Code le relit lorsqu'une session reprend afin qu'une publication ultérieure s'appuie sur la bonne version ; votre code n'a pas besoin d'agir dessus. `slug` nomme l'artefact, `ver` est la version que la lecture a enregistrée et est absent lorsqu'elle n'en a enregistré aucune, et `seeded: false` marque une lecture dont la source complète n'a pas atteint Claude. Le champ `seeded` nécessite Agent SDK v0.3.239 ou ultérieur.4427`artifactRead` est le propre enregistrement de Claude Code d'une lecture d'artefact, présent uniquement lorsque Claude a récupéré un artefact que la session peut publier. Claude Code le relit lorsqu'une session reprend afin qu'une publication ultérieure s'appuie sur la bonne version ; votre code n'a pas besoin d'agir dessus. `slug` nomme l'artefact, `ver` est la version que la lecture a enregistrée et est absent lorsqu'elle n'en a enregistré aucune, et `seeded: false` marque une lecture dont la source complète n'a pas atteint Claude. Le champ `seeded` nécessite Agent SDK v0.3.239 ou ultérieur.

4428 4428

4429<h3 id="websearch-2">4429<h3 id="websearch-2">

4430 WebSearch4430 WebSearch

4447};4447};

4448```4448```

4449 4449

4450Retourne les résultats de recherche du web.4450Retourne les résultats de la recherche sur le web.

4451 4451

4452<h3 id="workflow-2">4452<h3 id="workflow-2">

4453 Workflow4453 Workflow

4471};4471};

4472```4472```

4473 4473

4474Retourne immédiatement après que l'outil accepte l'invocation. Le résultat final arrive plus tard en tant que complément de tâche. Vérifiez `error` avant de traiter l'exécution comme démarrée : un script qui échoue sa vérification de syntaxe retourne `status: "async_launched"` avec `error` défini, et ne s'exécute jamais.4474Retourne immédiatement après que l'outil accepte l'invocation. Le résultat final arrive plus tard comme une fin de tâche. Vérifiez `error` avant de traiter l'exécution comme démarrée : un script qui échoue sa vérification de syntaxe retourne `status: "async_launched"` avec `error` défini, et ne s'exécute jamais.

4475 4475

4477| - | - | - |4477| - | - | - |

4478| `status` | `"async_launched" \| "remote_launched"` | L'outil a accepté l'invocation. `"async_launched"` pour les exécutions en processus, `"remote_launched"` pour les exécutions envoyées à une session distante au lieu de s'exécuter en processus |4478| `status` | `"async_launched" \| "remote_launched"` | L'outil a accepté l'invocation. `"async_launched"` pour les exécutions en processus, `"remote_launched"` pour les exécutions envoyées à une session cloud au lieu de s'exécuter en processus |

4482| `runId` | `string` | Identifiant d'exécution de workflow à transmettre en tant que `resumeFromRunId` lors d'une invocation ultérieure. Absent pour les exécutions `remote_launched`, où l'URL de la session cloud est la poignée de reprise |4482| `runId` | `string` | Identifiant d'exécution de workflow à passer comme `resumeFromRunId` sur une invocation ultérieure. Absent pour les exécutions `remote_launched`, où l'URL de la session cloud est la poignée de reprise |

4485| `scriptPath` | `string` | Chemin du script de workflow persisté pour cette exécution. Modifiez-le et transmettez-le en tant que `scriptPath` pour réexécuter sans renvoyer le script |4485| `scriptPath` | `string` | Chemin du script de workflow persisté pour cette exécution. Modifiez-le et renvoyez-le comme `scriptPath` pour réexécuter sans renvoyer le script |

4489 4489

4490<h3 id="todowrite-2">4490<h3 id="todowrite-2">

4523 4523

4524 Cet ensemble par défaut s'applique dans Claude Code v2.1.268 et versions ultérieures, que le SDK TypeScript Agent regroupe à partir de v0.3.268.4524 Cet ensemble par défaut s'applique dans Claude Code v2.1.268 et versions ultérieures, que le SDK TypeScript Agent regroupe à partir de v0.3.268.

4525 4525

4526 Consultez [Disponibilité du modèle](/docs/fr/agent-sdk/todo-tracking#model-availability) pour vous inscrire.4526 Voir [Disponibilité du modèle](/docs/fr/agent-sdk/todo-tracking#model-availability) pour vous inscrire.

4527</Note>4527</Note>

4528 4528

4529<h3 id="taskcreate-2">4529<h3 id="taskcreate-2">

4623};4623};

4624```4624```

4625 4625

4626Retourne l'état du plan après la sortie du mode de planification.4626Retourne l'état du plan après la sortie du mode plan.

4627 4627

4628<h3 id="listmcpresources-2">4628<h3 id="listmcpresources-2">

4629 ListMcpResources4629 ListMcpResources

4641}>;4641}>;

4642```4642```

4643 4643

4644Retourne un tableau de ressources MCP disponibles.4644Retourne un tableau des ressources MCP disponibles.

4645 4645

4646<h3 id="readmcpresource-2">4646<h3 id="readmcpresource-2">

4647 ReadMcpResource4647 ReadMcpResource

4712};4712};

4713```4713```

4714 4714

4715Retourne une confirmation que le mode de planification a été activé.4715Retourne une confirmation que le mode plan a été activé.

4716 4716

4717<h3 id="croncreate-2">4717<h3 id="croncreate-2">

4718 CronCreate4718 CronCreate

4729};4729};

4730```4730```

4731 4731

4732Retourne l'ID du travail et une description lisible par l'homme de la planification.4732Retourne l'ID du travail et une description lisible par l'homme de l'horaire.

4733 4733

4734<h3 id="crondelete-2">4734<h3 id="crondelete-2">

4735 CronDelete4735 CronDelete

4878 };4878 };

4879```4879```

4880 4880

4881Retourne l'`url` de la page publiée et le `path` local qui a été publié pour l'action de publication, avec `updated` défini à true lorsque la publication a redéployé un artefact existant, et `warnings` portant tous les avis au moment de la publication. L'action de liste retourne les lignes `artifacts` à la place, avec `truncated` défini lorsque plus d'artefacts existent que la limite demandée. Sur les listes dont la portée n'est pas `"mine"`, chaque ligne porte `rel` marquant si l'utilisateur possède l'artefact ou s'il lui a été partagé, et la `scope` de la sortie enregistre quelle portée non définie par défaut a produit la liste ; les deux sont absents sur les listes par défaut.4881Retourne l'`url` de la page publiée et le `path` local qui a été publié pour l'action de publication, avec `updated` défini à true lorsque la publication a redéployé un artefact existant, et `warnings` contenant tous les avis au moment de la publication. L'action de liste retourne les lignes `artifacts` à la place, avec `truncated` défini lorsque plus d'artefacts existent que la limite demandée. Sur les listes dont la portée n'est pas `"mine"`, chaque ligne porte `rel` marquant si l'utilisateur possède l'artefact ou s'il lui a été partagé, et la `scope` de la sortie enregistre quelle portée non-défaut a produit la liste ; les deux sont absents sur les listes par défaut.

4882 4882

4883<h3 id="projects-2">4883<h3 id="projects-2">

4884 Projects4884 Projects

4961};4961};

4962```4962```

4963 4963

4964Retourne les enfants directs de la ressource de répertoire. Les sous-répertoires apparaissent avec mimeType `"inode/directory"` ; `error` porte un message lisible par l'homme lorsque le serveur n'a pas pu énumérer le répertoire.4964Retourne les enfants directs de la ressource de répertoire. Les sous-répertoires apparaissent avec mimeType `"inode/directory"` ; `error` contient un message lisible par l'homme lorsque le serveur n'a pas pu lister le répertoire.

4965 4965

4966<h3 id="refreshmcptools-2">4966<h3 id="refreshmcptools-2">

4967 RefreshMcpTools4967 RefreshMcpTools

agent-view.md +2 −2

Details

8 8

9La vue agent, ouverte avec `claude agents`, est un seul écran pour toutes vos sessions en arrière-plan : ce qui s'exécute, ce qui a besoin de votre intervention, et ce qui est terminé. Lancez de nouvelles sessions, observez leur état en un coup d'œil au lieu de faire défiler les transcriptions, et intervenez uniquement quand l'une d'elles a besoin de vous. Chaque session en arrière-plan est une conversation Claude Code complète qui continue de s'exécuter sans terminal attaché, vous pouvez donc l'ouvrir, répondre et partir quand vous le souhaitez.9La vue agent, ouverte avec `claude agents`, est un seul écran pour toutes vos sessions en arrière-plan : ce qui s'exécute, ce qui a besoin de votre intervention, et ce qui est terminé. Lancez de nouvelles sessions, observez leur état en un coup d'œil au lieu de faire défiler les transcriptions, et intervenez uniquement quand l'une d'elles a besoin de vous. Chaque session en arrière-plan est une conversation Claude Code complète qui continue de s'exécuter sans terminal attaché, vous pouvez donc l'ouvrir, répondre et partir quand vous le souhaitez.

10 10

11<img src="https://mintcdn.com/claude-code/1B48Qz2Z9hac4SLG/images/agent-view-light.png?fit=max&auto=format&n=1B48Qz2Z9hac4SLG&q=85&s=7a186c96ed47d6700d084d77e786be65" className="dark:hidden" alt="Vue agent dans un terminal : l'en-tête affiche Claude Code v2.1.140, le modèle, le répertoire de travail et un résumé du nombre. Les sessions sont regroupées sous Nécessite une intervention, En cours d'exécution et Terminé, avec une entrée de lancement en bas et un pied de page avec des indices de clavier." width="1772" height="780" data-path="images/agent-view-light.png" />11<img src="https://mintcdn.com/claude-code/HDAmBwgbrZVk0pOt/images/agent-view-light.png?fit=max&auto=format&n=HDAmBwgbrZVk0pOt&q=85&s=d6905012bee31f3e6b3920b09c05dd02" className="dark:hidden" alt="Vue agent dans un terminal : l'en-tête affiche Claude Code v2.1.140, le modèle, le répertoire de travail et un résumé du nombre. Les sessions sont regroupées sous Nécessite une intervention, En cours d'exécution et Terminé, avec une entrée de lancement en bas et un pied de page avec des indices de clavier." width="1872" height="680" data-path="images/agent-view-light.png" />

12 12

13<img src="https://mintcdn.com/claude-code/1B48Qz2Z9hac4SLG/images/agent-view-dark.png?fit=max&auto=format&n=1B48Qz2Z9hac4SLG&q=85&s=a5bed7434bae368faea3a8f023b52aa2" className="hidden dark:block" alt="Vue agent dans un terminal : l'en-tête affiche Claude Code v2.1.140, le modèle, le répertoire de travail et un résumé du nombre. Les sessions sont regroupées sous Nécessite une intervention, En cours d'exécution et Terminé, avec une entrée de lancement en bas et un pied de page avec des indices de clavier." width="1772" height="780" data-path="images/agent-view-dark.png" />13<img src="https://mintcdn.com/claude-code/HDAmBwgbrZVk0pOt/images/agent-view-dark.png?fit=max&auto=format&n=HDAmBwgbrZVk0pOt&q=85&s=fc3c195bfc57e313ced1f1beb36cee93" className="hidden dark:block" alt="Vue agent dans un terminal : l'en-tête affiche Claude Code v2.1.140, le modèle, le répertoire de travail et un résumé du nombre. Les sessions sont regroupées sous Nécessite une intervention, En cours d'exécution et Terminé, avec une entrée de lancement en bas et un pied de page avec des indices de clavier." width="1872" height="680" data-path="images/agent-view-dark.png" />

14 14

15Utilisez la vue agent quand vous avez plusieurs tâches indépendantes sur lesquelles Claude peut travailler sans que vous regardiez chaque étape. Lancez une correction de bug, un examen de pull request et une enquête sur un test instable sous forme de trois lignes, continuez à travailler dans une autre fenêtre et vérifiez quand une ligne indique qu'elle a besoin de vous ou qu'elle a un résultat.15Utilisez la vue agent quand vous avez plusieurs tâches indépendantes sur lesquelles Claude peut travailler sans que vous regardiez chaque étape. Lancez une correction de bug, un examen de pull request et une enquête sur un test instable sous forme de trois lignes, continuez à travailler dans une autre fenêtre et vérifiez quand une ligne indique qu'elle a besoin de vous ou qu'elle a un résultat.

16 16

cli-reference.md +3 −2

Details

84| `--dangerously-skip-permissions` | Ignorer les invites de permission. Équivalent à `--permission-mode bypassPermissions`. Voir [modes de permission](/docs/fr/permission-modes#skip-all-checks-with-bypasspermissions-mode) pour ce que cela ignore et n'ignore pas. Pour les sessions démarrées avec `--bg`, le mode [persiste lorsque le superviseur redémarre la session](/docs/fr/agent-view#permission-mode-model-and-effort) | `claude --dangerously-skip-permissions` |84| `--dangerously-skip-permissions` | Ignorer les invites de permission. Équivalent à `--permission-mode bypassPermissions`. Voir [modes de permission](/docs/fr/permission-modes#skip-all-checks-with-bypasspermissions-mode) pour ce que cela ignore et n'ignore pas. Pour les sessions démarrées avec `--bg`, le mode [persiste lorsque le superviseur redémarre la session](/docs/fr/agent-view#permission-mode-model-and-effort) | `claude --dangerously-skip-permissions` |

85| `--debug` | Activer le mode débogage avec filtrage de catégorie optionnel, tel que `--debug='mcp,startup'` ou `--debug='!1p'`. Le filtre se lie uniquement dans la forme `=` ; un filtre séparé par des espaces active le mode débogage sans filtrage | `claude --debug='mcp,startup'` |85| `--debug` | Activer le mode débogage avec filtrage de catégorie optionnel, tel que `--debug='mcp,startup'` ou `--debug='!1p'`. Le filtre se lie uniquement dans la forme `=` ; un filtre séparé par des espaces active le mode débogage sans filtrage | `claude --debug='mcp,startup'` |

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

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

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

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

116| `--permission-prompts` | Définir qui répond aux invites de permission en mode impression. Avec le `host` par défaut, Claude Code les envoie à l'hôte du SDK Agent ou à l'outil `--permission-prompt-tool`. Passez `none` lorsque personne ne peut répondre, et Claude Code les refuse à la place. Voir [Désactiver les invites de permission dans les exécutions sans surveillance](/docs/fr/headless#turn-off-permission-prompts-in-unattended-runs). Nécessite Claude Code v2.1.259 ou ultérieur | `claude -p --permission-prompts none "query"` |117| `--permission-prompts` | Définir qui répond aux invites de permission en mode impression. Avec le `host` par défaut, Claude Code les envoie à l'hôte du SDK Agent ou à l'outil `--permission-prompt-tool`. Passez `none` lorsque personne ne peut répondre, et Claude Code les refuse à la place. Voir [Désactiver les invites de permission dans les exécutions sans surveillance](/docs/fr/headless#turn-off-permission-prompts-in-unattended-runs). Nécessite Claude Code v2.1.259 ou ultérieur | `claude -p --permission-prompts none "query"` |

117| `--plugin-dir` | Charger un plugin à partir d'un répertoire ou d'une archive `.zip`, ou plusieurs à partir d'un [dossier de plugins](/docs/fr/plugins/create#load-a-directory-or-archive-for-one-session), pour cette session uniquement. Chaque drapeau prend un chemin. Répétez le drapeau pour plus de chemins : `--plugin-dir A --plugin-dir B.zip`. Passer un dossier de plugins nécessite Claude Code v2.1.265 ou ultérieur | `claude --plugin-dir ./my-plugin` |118| `--plugin-dir` | Charger un plugin à partir d'un répertoire ou d'une archive `.zip`, ou plusieurs à partir d'un [dossier de plugins](/docs/fr/plugins/create#load-a-directory-or-archive-for-one-session), pour cette session uniquement. Chaque drapeau prend un chemin. Répétez le drapeau pour plus de chemins : `--plugin-dir A --plugin-dir B.zip`. Passer un dossier de plugins nécessite Claude Code v2.1.265 ou ultérieur | `claude --plugin-dir ./my-plugin` |

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

119| `--print`, `-p` | Imprimer la réponse sans mode interactif (voir la [documentation du SDK Agent](/docs/fr/agent-sdk/overview) pour les détails d'utilisation programmatique) | `claude -p "query"` |120| `--print`, `-p` | Imprimer la réponse sans mode interactif (voir la [documentation du SDK Agent](/docs/fr/agent-sdk/overview) pour les détails d'utilisation programmatique). Pour `--resume` sur une session en arrière-plan qui s'exécute toujours, voir [Reprendre une session](/docs/fr/sessions#resume-a-running-background-session) | `claude -p "query"` |

120| `--prompt-suggestions` | Émettre un message `prompt_suggestion` avec une prédiction du prochain message utilisateur après chaque tour qui en génère un ; les très courtes conversations peuvent n'en produire aucune. Nécessite `--print`, `--output-format stream-json`, et `--verbose`. Voir [Suggestions d'invite](/docs/fr/interactive-mode#prompt-suggestions) | `claude -p --prompt-suggestions --output-format stream-json --verbose "query"` |121| `--prompt-suggestions` | Émettre un message `prompt_suggestion` avec une prédiction du prochain message utilisateur après chaque tour qui en génère un ; les très courtes conversations peuvent n'en produire aucune. Nécessite `--print`, `--output-format stream-json`, et `--verbose`. Voir [Suggestions d'invite](/docs/fr/interactive-mode#prompt-suggestions) | `claude -p --prompt-suggestions --output-format stream-json --verbose "query"` |

121| `--ref <branch>` | Avec `--environment`, baser le checkout de la nouvelle session sur une ref nommée au lieu du `HEAD` local | `claude -p "Run the smoke test" --environment ccpool_abc123 --ref main` |122| `--ref <branch>` | Avec `--environment`, baser le checkout de la nouvelle session sur une ref nommée au lieu du `HEAD` local | `claude -p "Run the smoke test" --environment ccpool_abc123 --ref main` |

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

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

126| `--restricted` | Démarrer en mode restreint. Utilisez-le lorsqu'un harnais d'évaluation pilote `claude` sur une machine partagée et que Claude Code ne doit pas exécuter de commandes ou lire les paramètres utilisateur et projet de cette machine. Claude Code supprime les outils intégrés qui exécutent des commandes ou du code, et WebFetch, à moins que vous les nomiez individuellement dans `--tools`, pas via la présélection `default`. Il confine également les outils de fichier intégrés aux [répertoires de travail](/docs/fr/permissions#working-directories), charge uniquement les [paramètres gérés](/docs/fr/managed-settings) et `--settings`, refuse [`bypassPermissions`](/docs/fr/permission-modes#skip-all-checks-with-bypasspermissions-mode), et [refuse de créer des sessions cloud](/docs/fr/errors#cloud-sessions-cannot-be-created-from-a-restricted-session). Nécessite Claude Code v2.1.248 ou ultérieur | `claude --restricted -p "query"` |127| `--restricted` | Démarrer en mode restreint. Utilisez-le lorsqu'un harnais d'évaluation pilote `claude` sur une machine partagée et que Claude Code ne doit pas exécuter de commandes ou lire les paramètres utilisateur et projet de cette machine. Claude Code supprime les outils intégrés qui exécutent des commandes ou du code, et WebFetch, à moins que vous les nomiez individuellement dans `--tools`, pas via la présélection `default`. Il confine également les outils de fichier intégrés aux [répertoires de travail](/docs/fr/permissions#working-directories), charge uniquement les [paramètres gérés](/docs/fr/managed-settings) et `--settings`, refuse [`bypassPermissions`](/docs/fr/permission-modes#skip-all-checks-with-bypasspermissions-mode), et [refuse de créer des sessions cloud](/docs/fr/errors#cloud-sessions-cannot-be-created-from-a-restricted-session). Nécessite Claude Code v2.1.248 ou ultérieur | `claude --restricted -p "query"` |

127| `--resume`, `-r` | Reprendre une session spécifique par ID ou nom, ou afficher un sélecteur interactif pour choisir une session. À la place d'un ID, vous pouvez passer le chemin absolu vers le fichier de [transcription](/docs/fr/sessions#where-transcripts-are-stored) `.jsonl` d'une session. Le sélecteur et la recherche par nom incluent les sessions qui ont ajouté ce répertoire avec `/add-dir`. Lorsque vous transmettez un ID de session, Claude Code recherche le répertoire du projet actuel et ses git worktrees, puis tous les autres projets sur cette machine. Avant v2.1.223, la recherche d'ID couvrait uniquement le répertoire du projet actuel et ses git worktrees. Les [sessions en arrière-plan](/docs/fr/agent-view) apparaissent dans le sélecteur marquées avec `bg` | `claude --resume auth-refactor` |128| `--resume`, `-r` | Reprendre une session spécifique par ID ou nom, ou afficher un sélecteur interactif pour choisir une session. À la place d'un ID, vous pouvez passer le chemin absolu vers le fichier de [transcription](/docs/fr/sessions#where-transcripts-are-stored) `.jsonl` d'une session. Le sélecteur et la recherche par nom incluent les sessions qui ont ajouté ce répertoire avec `/add-dir`. Lorsque vous transmettez un ID de session, Claude Code recherche le répertoire du projet actuel et ses git worktrees, puis tous les autres projets sur cette machine. Avant v2.1.223, la recherche d'ID couvrait uniquement le répertoire du projet actuel et ses git worktrees. Les [sessions en arrière-plan](/docs/fr/agent-view) apparaissent dans le sélecteur marquées avec `bg`. Reprendre une session qui s'exécute toujours [ouvre cette session](/docs/fr/sessions#resume-a-running-background-session) dans ce terminal via `claude attach`, et une invite que vous transmettez sur la ligne de commande lui est envoyée en tant que son prochain tour. Avant v2.1.285, Claude Code refusait et affichait la commande `claude attach` à exécuter à la place | `claude --resume auth-refactor` |

128| `--safe-mode` | Démarrer avec toutes les personnalisations désactivées pour dépanner une configuration cassée : CLAUDE.md, skills, plugins, hooks, serveurs MCP, commandes et agents personnalisés, styles de sortie, workflows, thèmes personnalisés, liaisons de touches personnalisées, commandes de ligne d'état et de suggestion de fichiers, serveurs LSP, et mémoire automatique ne se chargent pas. L'authentification, la sélection du modèle, les outils intégrés et les permissions fonctionnent normalement, ce qui diffère de [`--bare`](/docs/fr/headless#start-faster-with-bare-mode). La politique des paramètres gérés s'applique toujours, y compris les hooks configurés par la politique, la ligne d'état et les commandes de suggestion de fichiers ; les plugins gérés, les skills gérés, le CLAUDE.md géré et les serveurs MCP configurés par la politique ne se chargent pas. Utile pour vérifier si une personnalisation est ce qui déclenche le [basculement automatique du modèle](/docs/fr/model-config#automatic-model-fallback). Définit [`CLAUDE_CODE_SAFE_MODE`](/docs/fr/env-vars) | `claude --safe-mode` |129| `--safe-mode` | Démarrer avec toutes les personnalisations désactivées pour dépanner une configuration cassée : CLAUDE.md, skills, plugins, hooks, serveurs MCP, commandes et agents personnalisés, styles de sortie, workflows, thèmes personnalisés, liaisons de touches personnalisées, commandes de ligne d'état et de suggestion de fichiers, serveurs LSP, et mémoire automatique ne se chargent pas. L'authentification, la sélection du modèle, les outils intégrés et les permissions fonctionnent normalement, ce qui diffère de [`--bare`](/docs/fr/headless#start-faster-with-bare-mode). La politique des paramètres gérés s'applique toujours, y compris les hooks configurés par la politique, la ligne d'état et les commandes de suggestion de fichiers ; les plugins gérés, les skills gérés, le CLAUDE.md géré et les serveurs MCP configurés par la politique ne se chargent pas. Utile pour vérifier si une personnalisation est ce qui déclenche le [basculement automatique du modèle](/docs/fr/model-config#automatic-model-fallback). Définit [`CLAUDE_CODE_SAFE_MODE`](/docs/fr/env-vars) | `claude --safe-mode` |

129| `--session-id` | Utiliser un ID de session spécifique pour la conversation (doit être un UUID valide) | `claude --session-id "550e8400-e29b-41d4-a716-446655440000"` |130| `--session-id` | Utiliser un ID de session spécifique pour la conversation (doit être un UUID valide) | `claude --session-id "550e8400-e29b-41d4-a716-446655440000"` |

130| `--setting-sources` | Liste séparée par des virgules des sources de paramètres à charger (`user`, `project`, `local`). Voir [agent view](/docs/fr/agent-view#what-carries-over-when-you-background) et [agent teams](/docs/fr/agent-teams#context-and-communication) pour les sessions que vous démarrez à partir de celle-ci qui héritent de la liste | `claude --setting-sources user,project` |131| `--setting-sources` | Liste séparée par des virgules des sources de paramètres à charger (`user`, `project`, `local`). Voir [agent view](/docs/fr/agent-view#what-carries-over-when-you-background) et [agent teams](/docs/fr/agent-teams#context-and-communication) pour les sessions que vous démarrez à partir de celle-ci qui héritent de la liste | `claude --setting-sources user,project` |

cloud-environments.md +1 −1

Details

439 439

440* **Commandes que Claude exécute** : un environnement cloud ne définit pas son propre délai d'expiration de commande, donc les défauts de l'outil Bash s'appliquent. Claude attend 2 minutes pour une commande par défaut et peut demander jusqu'à 10 minutes.440* **Commandes que Claude exécute** : un environnement cloud ne définit pas son propre délai d'expiration de commande, donc les défauts de l'outil Bash s'appliquent. Claude attend 2 minutes pour une commande par défaut et peut demander jusqu'à 10 minutes.

441 441

442 Quand une commande atteint son [délai d'expiration](/docs/fr/tools-reference#timeout-and-output-limits), Claude Code [la déplace en arrière-plan](/docs/fr/tools-reference#background-commands) au lieu de l'arrêter, sauf si la commande commence par `sleep`. Une commande déplacée de cette façon peut continuer à s'exécuter pendant jusqu'à 30 minutes supplémentaires avant que Claude Code l'arrête à son [délai d'expiration en arrière-plan](/docs/fr/tools-reference#background-commands). Définir `BASH_DEFAULT_TIMEOUT_MS` au-dessus de `1800000` millisecondes allonge cette limite ainsi que le défaut de premier plan.442 Quand une commande atteint son [délai d'expiration](/docs/fr/tools-reference#timeout-and-output-limits), Claude Code [la déplace en arrière-plan](/docs/fr/tools-reference#foreground-commands-that-move-to-the-background) au lieu de l'arrêter, sauf si la commande commence par `sleep`. Une commande déplacée de cette façon peut continuer à s'exécuter pendant jusqu'à 30 minutes supplémentaires avant que Claude Code l'arrête à son [délai d'expiration en arrière-plan](/docs/fr/tools-reference#time-limit-for-background-commands). Définir `BASH_DEFAULT_TIMEOUT_MS` au-dessus de `1800000` millisecondes allonge cette limite ainsi que le défaut de premier plan.

443* **Crochets SessionStart** : Claude Code annule un crochet `command` après 600 secondes sauf si vous définissez [`timeout`](/docs/fr/hooks#common-fields), en secondes, sur l'entrée du crochet. Claude Code n'applique pas le délai d'expiration sur un crochet que vous exécutez avec [`async: true`](/docs/fr/hooks#run-hooks-in-the-background).443* **Crochets SessionStart** : Claude Code annule un crochet `command` après 600 secondes sauf si vous définissez [`timeout`](/docs/fr/hooks#common-fields), en secondes, sur l'entrée du crochet. Claude Code n'applique pas le délai d'expiration sur un crochet que vous exécutez avec [`async: true`](/docs/fr/hooks#run-hooks-in-the-background).

444* **Script de configuration** : un script qui prend plus que environ cinq minutes n'est pas mis en cache. [Exigences du script](#script-requirements) couvre comment rester en dessous de cela.444* **Script de configuration** : un script qui prend plus que environ cinq minutes n'est pas mis en cache. [Exigences du script](#script-requirements) couvre comment rester en dessous de cela.

445* **Sessions inactives** : après quelques minutes sans activité, la VM d'une session s'arrête avec ses fichiers sauvegardés, et une VM arrêtée peut être réclamée ultérieurement. [Définir les variables d'environnement](#set-environment-variables) décrit ce qu'une session récupère dans chaque cas, et [Environnement expiré](/docs/fr/claude-code-on-the-web#environment-expired) couvre comment rouvrir une session dont la VM a été réclamée.445* **Sessions inactives** : après quelques minutes sans activité, la VM d'une session s'arrête avec ses fichiers sauvegardés, et une VM arrêtée peut être réclamée ultérieurement. [Définir les variables d'environnement](#set-environment-variables) décrit ce qu'une session récupère dans chaque cas, et [Environnement expiré](/docs/fr/claude-code-on-the-web#environment-expired) couvre comment rouvrir une session dont la VM a été réclamée.

commands.md +1 −1

Details

132| `/remote-control` | Rendre cette session disponible pour [Remote Control](/docs/fr/remote-control) à partir de claude.ai. L'exécuter sans connexion affiche que Remote Control nécessite un abonnement claude.ai et vous indique comment vous connecter ; avant la v2.1.206, il signalait `Unknown command: /remote-control`. Alias : `/rc` |132| `/remote-control` | Rendre cette session disponible pour [Remote Control](/docs/fr/remote-control) à partir de claude.ai. L'exécuter sans connexion affiche que Remote Control nécessite un abonnement claude.ai et vous indique comment vous connecter ; avant la v2.1.206, il signalait `Unknown command: /remote-control`. Alias : `/rc` |

133| `/remote-env` | Choisir l'[environnement cloud](/docs/fr/cloud-environments#select-an-environment-from-the-cli) par défaut pour les sessions cloud que vous démarrez à partir de l'interface de ligne de commande |133| `/remote-env` | Choisir l'[environnement cloud](/docs/fr/cloud-environments#select-an-environment-from-the-cli) par défaut pour les sessions cloud que vous démarrez à partir de l'interface de ligne de commande |

134| `/rename [name]` | Renommer la session actuelle et afficher le nom sur la barre d'invite. Sans nom, génère automatiquement un à partir de l'historique de conversation. Également disponible en mode non interactif (`-p`) ; nécessite Claude Code v2.1.205 ou ultérieur. À partir de chaque surface de renommage, y compris claude.ai et l'application de bureau, Claude Code remplace les caractères de contrôle et invisibles dans le nouveau nom par des espaces et limite le nom à 200 caractères. Si le nom est vide une fois les caractères invisibles supprimés, Claude Code le rejette et affiche `That name is empty once invisible characters are removed. Usage: /rename <name>`. Le remplacement de caractères et la limite de longueur nécessitent Claude Code v2.1.221 ou ultérieur. Si une autre session en direct sur cette machine utilise déjà un nom que vous passez, Claude Code applique [une variante de celui-ci](/docs/fr/sessions#name-your-sessions) à la place |134| `/rename [name]` | Renommer la session actuelle et afficher le nom sur la barre d'invite. Sans nom, génère automatiquement un à partir de l'historique de conversation. Également disponible en mode non interactif (`-p`) ; nécessite Claude Code v2.1.205 ou ultérieur. À partir de chaque surface de renommage, y compris claude.ai et l'application de bureau, Claude Code remplace les caractères de contrôle et invisibles dans le nouveau nom par des espaces et limite le nom à 200 caractères. Si le nom est vide une fois les caractères invisibles supprimés, Claude Code le rejette et affiche `That name is empty once invisible characters are removed. Usage: /rename <name>`. Le remplacement de caractères et la limite de longueur nécessitent Claude Code v2.1.221 ou ultérieur. Si une autre session en direct sur cette machine utilise déjà un nom que vous passez, Claude Code applique [une variante de celui-ci](/docs/fr/sessions#name-your-sessions) à la place |

135| `/resume [session]` | Reprendre une conversation par ID ou nom, ou ouvrir le sélecteur de session. Les [sessions en arrière-plan](/docs/fr/agent-view) apparaissent dans le sélecteur marquées avec `bg` ; une qui est encore en cours d'exécution ne peut pas être reprise ici, donc attachez-vous à partir de `claude agents` ou arrêtez-la d'abord. Alias : `/continue` |135| `/resume [session]` | Reprendre une conversation par ID ou nom, ou ouvrir le sélecteur de session. Les [sessions en arrière-plan](/docs/fr/agent-view) apparaissent dans le sélecteur marquées avec `bg`. Reprendre une qui est encore en cours d'exécution, à partir du sélecteur ou par ID ou nom, [ouvre cette session](/docs/fr/sessions#resume-a-running-background-session) : votre conversation actuelle se déplace en arrière-plan et ce terminal s'attache à celle en cours d'exécution. Appuyez sur `←` sur une invite vide pour revenir à la vue agent, qui répertorie également la conversation que vous avez laissée. Avant la v2.1.285, Claude Code refusait et vous disait d'ouvrir la session avec `claude attach` ou de l'arrêter d'abord. Alias : `/continue` |

136| `/review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [pr#\|branch\|path]` | Alias de [`/code-review`](/docs/fr/code-review#review-a-diff-locally) : examine le diff actuel, ou un numéro de demande de fusion, une branche ou un chemin que vous passez, tel que `/review 1234`, et prend les mêmes niveaux d'effort et drapeaux. Sans niveau donné, l'examen réutilise le dernier niveau `low` à `max` que vous avez tapé ; consultez [Examiner un diff localement](/docs/fr/code-review#review-a-diff-locally) pour les règles exactes. Pour un examen cloud approfondi, utilisez [`/code-review ultra`](/docs/fr/ultrareview). Avant la v2.1.223, `/review` était une commande distincte qui exécutait un examen unique en lecture seule d'une demande de fusion GitHub par numéro, répertoriant les demandes de fusion ouvertes à choisir lorsqu'elle était exécutée sans argument ; de la v2.1.186 à la v2.1.201, elle exécutait le même moteur multi-agents que `/code-review medium` |136| `/review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [pr#\|branch\|path]` | Alias de [`/code-review`](/docs/fr/code-review#review-a-diff-locally) : examine le diff actuel, ou un numéro de demande de fusion, une branche ou un chemin que vous passez, tel que `/review 1234`, et prend les mêmes niveaux d'effort et drapeaux. Sans niveau donné, l'examen réutilise le dernier niveau `low` à `max` que vous avez tapé ; consultez [Examiner un diff localement](/docs/fr/code-review#review-a-diff-locally) pour les règles exactes. Pour un examen cloud approfondi, utilisez [`/code-review ultra`](/docs/fr/ultrareview). Avant la v2.1.223, `/review` était une commande distincte qui exécutait un examen unique en lecture seule d'une demande de fusion GitHub par numéro, répertoriant les demandes de fusion ouvertes à choisir lorsqu'elle était exécutée sans argument ; de la v2.1.186 à la v2.1.201, elle exécutait le même moteur multi-agents que `/code-review medium` |

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

138| `/run` | **[Skill](/docs/fr/skills#bundled-skills).** Lancer et piloter l'application de votre projet pour voir un changement fonctionner, pas seulement passer les tests. Consultez [Exécuter et vérifier votre application](/docs/fr/skills#run-and-verify-your-app) |138| `/run` | **[Skill](/docs/fr/skills#bundled-skills).** Lancer et piloter l'application de votre projet pour voir un changement fonctionner, pas seulement passer les tests. Consultez [Exécuter et vérifier votre application](/docs/fr/skills#run-and-verify-your-app) |

desktop.md +8 −0

Details

967 967

968Pour déplacer une session CLI dans Desktop, exécutez `/desktop` dans le terminal. Claude enregistre votre session et l'ouvre dans l'application de bureau, puis quitte la CLI. Cette commande est disponible sur macOS et Windows x64 quand vous êtes connecté avec un abonnement Claude. Elle n'est pas disponible avec l'authentification par clé API ou sur Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry.968Pour déplacer une session CLI dans Desktop, exécutez `/desktop` dans le terminal. Claude enregistre votre session et l'ouvre dans l'application de bureau, puis quitte la CLI. Cette commande est disponible sur macOS et Windows x64 quand vous êtes connecté avec un abonnement Claude. Elle n'est pas disponible avec l'authentification par clé API ou sur Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry.

969 969

970Depuis votre shell, [`claude --desktop`](/docs/fr/cli-reference#cli-flags) ouvre Desktop directement sans démarrer une session terminal. Cela nécessite Claude Code v2.1.285 ou ultérieur et a les mêmes exigences de plateforme et de connexion que `/desktop`. Sans autres arguments, il ouvre Desktop dans le répertoire courant. Pour ouvrir une session CLI existante dans Desktop, ajoutez `--continue` pour la conversation la plus récente dans ce répertoire, ou `--resume` avec l'ID de session que `/status` affiche :

971

972```bash theme={null}

973claude --desktop --resume <session-id>

974```

975

976Claude Code affiche `Opening session <session-id> in Claude Desktop`, la session s'ouvre dans l'application, et la commande se termine. Un nom de session ne fonctionne pas à la place de l'ID. Claude Code ne déplace pas une session qui est ouverte dans un autre terminal ou qui s'exécute toujours en arrière-plan. Si Claude Desktop n'est pas installé, la commande affiche un lien de téléchargement et se termine.

977

970Vous pouvez également reprendre une session CLI depuis Desktop avec `/resume`. La commande est disponible dans les sessions locales, pas dans les sessions SSH, WSL ou cloud.978Vous pouvez également reprendre une session CLI depuis Desktop avec `/resume`. La commande est disponible dans les sessions locales, pas dans les sessions SSH, WSL ou cloud.

971 979

972Pour continuer une session terminal dans Desktop :980Pour continuer une session terminal dans Desktop :

env-vars.md +2 −2

Details

192| `API_FORCE_IDLE_TIMEOUT` | Remplacez le délai d'inactivité du corps de 5 minutes qui interrompt une réponse de modèle en continu lorsqu'aucun octet n'arrive. Définissez sur `0` pour désactiver le délai d'expiration, par exemple lorsqu'une [passerelle](/docs/fr/llm-gateway) lente ou un modèle local fait une pause plus longue que 5 minutes entre les chunks, ou `1` pour le maintenir activé pour chaque fournisseur. Lorsqu'il n'est pas défini, le délai d'expiration est actif sur les fournisseurs autres que l'API Anthropic directe, [Claude Platform on AWS](/docs/fr/claude-platform-on-aws) et Amazon Bedrock avec `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1` défini. Les [chiens de garde de flux](/docs/fr/network-config#streaming-idle-watchdogs) s'exécutent indépendamment et interrompent une longue pause silencieuse même lorsque vous définissez `0` ici |192| `API_FORCE_IDLE_TIMEOUT` | Remplacez le délai d'inactivité du corps de 5 minutes qui interrompt une réponse de modèle en continu lorsqu'aucun octet n'arrive. Définissez sur `0` pour désactiver le délai d'expiration, par exemple lorsqu'une [passerelle](/docs/fr/llm-gateway) lente ou un modèle local fait une pause plus longue que 5 minutes entre les chunks, ou `1` pour le maintenir activé pour chaque fournisseur. Lorsqu'il n'est pas défini, le délai d'expiration est actif sur les fournisseurs autres que l'API Anthropic directe, [Claude Platform on AWS](/docs/fr/claude-platform-on-aws) et Amazon Bedrock avec `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1` défini. Les [chiens de garde de flux](/docs/fr/network-config#streaming-idle-watchdogs) s'exécutent indépendamment et interrompent une longue pause silencieuse même lorsque vous définissez `0` ici |

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

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

195| `BASH_DEFAULT_TIMEOUT_MS` | Délai d'expiration par défaut pour une commande Bash ou PowerShell au premier plan, en millisecondes (par défaut : 120000, ou 2 minutes). Un délai par défaut plus long que 30 minutes devient également la [limite de temps par défaut pour les commandes d'arrière-plan](/docs/fr/tools-reference#background-commands). La limite de temps d'arrière-plan nécessite Claude Code v2.1.285 ou ultérieur |195| `BASH_DEFAULT_TIMEOUT_MS` | Délai d'expiration par défaut pour une commande Bash ou PowerShell au premier plan, en millisecondes (par défaut : 120000, ou 2 minutes). Un délai par défaut plus long que 30 minutes devient également la [limite de temps par défaut pour les commandes d'arrière-plan](/docs/fr/tools-reference#time-limit-for-background-commands). La limite de temps d'arrière-plan nécessite Claude Code v2.1.285 ou ultérieur |

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

197| `BASH_MAX_TIMEOUT_MS` | Délai d'expiration maximum que le modèle peut définir pour une commande Bash ou PowerShell au premier plan, en millisecondes (par défaut : 600000, ou 10 minutes). Le plafond effectif est le plus grand de ceci et de `BASH_DEFAULT_TIMEOUT_MS`. Un plafond effectif plus long que 2 heures devient également le maximum [limite de temps pour les commandes d'arrière-plan](/docs/fr/tools-reference#background-commands). La limite de temps d'arrière-plan nécessite Claude Code v2.1.285 ou ultérieur |197| `BASH_MAX_TIMEOUT_MS` | Délai d'expiration maximum que le modèle peut définir pour une commande Bash ou PowerShell au premier plan, en millisecondes (par défaut : 600000, ou 10 minutes). Le plafond effectif est le plus grand de ceci et de `BASH_DEFAULT_TIMEOUT_MS`. Un plafond effectif plus long que 2 heures devient également le maximum [limite de temps pour les commandes d'arrière-plan](/docs/fr/tools-reference#time-limit-for-background-commands). La limite de temps d'arrière-plan nécessite Claude Code v2.1.285 ou ultérieur |

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

199| `CCR_FORCE_BUNDLE` | Définissez sur `1` pour forcer [`claude --cloud`](/docs/fr/claude-code-on-the-web#send-local-repositories-without-github) à regrouper et télécharger votre référentiel local au lieu de le cloner à partir de son distant |199| `CCR_FORCE_BUNDLE` | Définissez sur `1` pour forcer [`claude --cloud`](/docs/fr/claude-code-on-the-web#send-local-repositories-without-github) à regrouper et télécharger votre référentiel local au lieu de le cloner à partir de son distant |

200| `CLAUDECODE` | Définissez sur `1` dans les sous-processus que Claude Code génère (outils Bash et PowerShell, sessions tmux, commandes [hook](/docs/fr/hooks), commandes [ligne d'état](/docs/fr/statusline), sous-processus [serveur MCP](/docs/fr/mcp) stdio). Les extensions IDE définissent également ceci dans leurs terminaux intégrés. Utilisez pour détecter quand un script s'exécute à l'intérieur d'un sous-processus généré par Claude Code. Pour vérifier si le processus actuel a été généré directement par un appel d'outil ou un hook, plutôt qu'à l'intérieur d'un serveur MCP stdio que Claude Code a démarré, utilisez `CLAUDE_CODE_CHILD_SESSION` à la place |200| `CLAUDECODE` | Définissez sur `1` dans les sous-processus que Claude Code génère (outils Bash et PowerShell, sessions tmux, commandes [hook](/docs/fr/hooks), commandes [ligne d'état](/docs/fr/statusline), sous-processus [serveur MCP](/docs/fr/mcp) stdio). Les extensions IDE définissent également ceci dans leurs terminaux intégrés. Utilisez pour détecter quand un script s'exécute à l'intérieur d'un sous-processus généré par Claude Code. Pour vérifier si le processus actuel a été généré directement par un appel d'outil ou un hook, plutôt qu'à l'intérieur d'un serveur MCP stdio que Claude Code a démarré, utilisez `CLAUDE_CODE_CHILD_SESSION` à la place |

errors.md +7 −5

Details

3657 Impossible d'ouvrir Claude Desktop3657 Impossible d'ouvrir Claude Desktop

3658</h3>3658</h3>

3659 3659

3660Vous avez exécuté [`/desktop`](/docs/fr/desktop#coming-from-the-cli), ou son alias `/app`, et la commande système que Claude Code utilise pour ouvrir Claude Desktop a échoué. La session reste dans le terminal.3660Vous avez exécuté [`/desktop`](/docs/fr/desktop#coming-from-the-cli) ou son alias `/app` dans une session, ou [`claude --desktop`](/docs/fr/cli-reference#cli-flags) dans votre shell, et la commande système que Claude Code utilise pour ouvrir Claude Desktop a échoué. Après `/desktop`, la session reste dans le terminal ; `claude --desktop` imprime le message sans le préfixe `Error:` et se termine avec le statut 1.

3661

3662Le texte entre parenthèses nomme la commande qui a échoué, avec son code de sortie et la première ligne de sa sortie d'erreur lorsqu'elle l'a produite. Sur macOS cette commande est `open`, comme dans cet exemple ; sur Windows c'est `rundll32` :

3661 3663

3662```text theme={null}3664```text theme={null}

3663Error: Couldn't open Claude Desktop (`open` exited 1: LSOpenURLsWithRole() failed for the URL claude://resume?session=<session-id> with error -10814). Open Claude Desktop and run /desktop again.3665Error: Couldn't open Claude Desktop (`open` exited 1: LSOpenURLsWithRole() failed for the URL claude://resume?session=<session-id> with error -10814). Open Claude Desktop and try again.

3664```3666```

3665 3667

3666**Que faire :**3668**Que faire :**

3667 3669

3668* Ouvrez Claude Desktop vous-même, puis exécutez `/desktop` à nouveau3670* Ouvrez Claude Desktop vous-même, puis exécutez `/desktop` ou `claude --desktop` à nouveau

3669* Pour lire la sortie d'erreur complète de cette commande, activez la journalisation de débogage avec `/debug`, exécutez `/desktop` à nouveau, et vérifiez le journal de débogage3671* Pour lire la sortie d'erreur complète de la commande qui a échoué, activez la journalisation de débogage avec `/debug` et exécutez `/desktop` à nouveau, ou exécutez `claude --desktop --debug-file <path>`, puis vérifiez le journal de débogage

3670 3672

3671Avant la v2.1.275, le message était `Failed to open Claude Desktop. Please try opening it manually.` et ne disait pas ce qui a échoué.3673Avant la v2.1.285, le message se terminait par `Open Claude Desktop and run /desktop again.` Avant la v2.1.275, c'était `Failed to open Claude Desktop. Please try opening it manually.` et ne disait pas ce qui a échoué.

3672 3674

3673<h3 id="terminal-setup-left-your-zed-keymap-unchanged">3675<h3 id="terminal-setup-left-your-zed-keymap-unchanged">

3674 /terminal-setup a laissé votre keymap Zed inchangée3676 /terminal-setup a laissé votre keymap Zed inchangée

hooks.md +1 −1

Details

1938| :- | :- |1938| :- | :- |

1939| `permissionDecision` | `"allow"` ignore l'invite de permission, sauf pour les [actions qu'aucun mode n'approuve automatiquement](/docs/fr/permission-modes#actions-no-mode-auto-approves) et pour `AskUserQuestion` et `ExitPlanMode`, qui ont besoin de [`updatedInput` associé](#allow-with-updatedinput). `"deny"` empêche l'appel d'outil. `"ask"` demande à l'utilisateur de confirmer. `"defer"` quitte proprement pour que l'outil puisse être repris plus tard. Les [règles de refus et de demande](/docs/fr/permissions#manage-permissions) sont toujours évaluées indépendamment de ce que le hook retourne |1939| `permissionDecision` | `"allow"` ignore l'invite de permission, sauf pour les [actions qu'aucun mode n'approuve automatiquement](/docs/fr/permission-modes#actions-no-mode-auto-approves) et pour `AskUserQuestion` et `ExitPlanMode`, qui ont besoin de [`updatedInput` associé](#allow-with-updatedinput). `"deny"` empêche l'appel d'outil. `"ask"` demande à l'utilisateur de confirmer. `"defer"` quitte proprement pour que l'outil puisse être repris plus tard. Les [règles de refus et de demande](/docs/fr/permissions#manage-permissions) sont toujours évaluées indépendamment de ce que le hook retourne |

1940| `permissionDecisionReason` | Pour `"ask"`, montré à l'utilisateur mais pas Claude. Pour `"deny"`, montré à Claude. Pour `"allow"` et `"defer"`, écrit au [journal de débogage](#debug-hooks) uniquement |1940| `permissionDecisionReason` | Pour `"ask"`, montré à l'utilisateur mais pas Claude. Pour `"deny"`, montré à Claude. Pour `"allow"` et `"defer"`, écrit au [journal de débogage](#debug-hooks) uniquement |

1941| `updatedInput` | Modifie les paramètres d'entrée de l'outil avant l'exécution. Remplace l'objet d'entrée entier, donc incluez les champs inchangés aux côtés des champs modifiés. Claude Code évalue les règles de permission et l'[éligibilité de mise en arrière-plan automatique](/docs/fr/tools-reference#background-commands) d'une commande Bash contre l'entrée que votre hook retourne, pas l'entrée que Claude a envoyée. Combinez avec `"allow"` pour approuver automatiquement, ou `"ask"` pour montrer l'entrée modifiée à l'utilisateur. Pour `"defer"`, ignoré |1941| `updatedInput` | Modifie les paramètres d'entrée de l'outil avant l'exécution. Remplace l'objet d'entrée entier, donc incluez les champs inchangés aux côtés des champs modifiés. Claude Code évalue les règles de permission et l'[éligibilité de mise en arrière-plan automatique](/docs/fr/tools-reference#foreground-commands-that-move-to-the-background) d'une commande Bash contre l'entrée que votre hook retourne, pas l'entrée que Claude a envoyée. Combinez avec `"allow"` pour approuver automatiquement, ou `"ask"` pour montrer l'entrée modifiée à l'utilisateur. Pour `"defer"`, ignoré |

1942| `additionalContext` | Chaîne ajoutée au contexte de Claude aux côtés du résultat d'outil. Ignoré quand `permissionDecision` est `"defer"`. Voir [Ajouter du contexte pour Claude](#add-context-for-claude) |1942| `additionalContext` | Chaîne ajoutée au contexte de Claude aux côtés du résultat d'outil. Ignoré quand `permissionDecision` est `"defer"`. Voir [Ajouter du contexte pour Claude](#add-context-for-claude) |

1943 1943

1944Quand plusieurs hooks PreToolUse retournent des décisions différentes, la priorité est `deny` > `defer` > `ask` > `allow`.1944Quand plusieurs hooks PreToolUse retournent des décisions différentes, la priorité est `deny` > `defer` > `ask` > `allow`.

interactive-mode.md +3 −5

Details

346* Inviter Claude Code à exécuter une commande en arrière-plan346* Inviter Claude Code à exécuter une commande en arrière-plan

347* Appuyer sur `Ctrl+B` pour déplacer une invocation d'outil Bash régulière vers l'arrière-plan. Les utilisateurs de Tmux doivent appuyer sur `Ctrl+B` deux fois en raison de la touche de préfixe de tmux.347* Appuyer sur `Ctrl+B` pour déplacer une invocation d'outil Bash régulière vers l'arrière-plan. Les utilisateurs de Tmux doivent appuyer sur `Ctrl+B` deux fois en raison de la touche de préfixe de tmux.

348 348

349Lorsqu'une commande atteint son délai d'expiration avant de se terminer, Claude Code la [déplace automatiquement vers l'arrière-plan](/docs/fr/tools-reference#background-commands) au lieu de l'arrêter, sauf si la commande commence par `sleep`. Pour modifier la durée pendant laquelle les commandes s'exécutent avant que cela ne se produise, définissez les [variables d'environnement de délai d'expiration Bash](/docs/fr/tools-reference#timeout-and-output-limits).349Lorsqu'une commande atteint son délai d'expiration avant de se terminer, Claude Code la [déplace automatiquement vers l'arrière-plan](/docs/fr/tools-reference#foreground-commands-that-move-to-the-background) au lieu de l'arrêter, sauf si la commande commence par `sleep`. Pour modifier la durée pendant laquelle les commandes s'exécutent avant que cela ne se produise, définissez les [variables d'environnement de délai d'expiration Bash](/docs/fr/tools-reference#timeout-and-output-limits).

350 350

351**Fonctionnalités clés :**351**Fonctionnalités clés :**

352 352

358* Sur macOS et Linux, Claude Code termine les tâches en arrière-plan en cours d'exécution lorsque le système d'exploitation signale une pression mémoire critique, à condition que la session soit inactive depuis au moins 30 minutes et qu'aucun tour ou sous-agent ne soit en cours d'exécution. Nécessite Claude Code v2.1.193 ou version ultérieure358* Sur macOS et Linux, Claude Code termine les tâches en arrière-plan en cours d'exécution lorsque le système d'exploitation signale une pression mémoire critique, à condition que la session soit inactive depuis au moins 30 minutes et qu'aucun tour ou sous-agent ne soit en cours d'exécution. Nécessite Claude Code v2.1.193 ou version ultérieure

359 * Le [journal de débogage](/docs/fr/debug-your-config) indique pourquoi les tâches ont été arrêtées, ou pourquoi un événement de pression les a laissées en cours d'exécution359 * Le [journal de débogage](/docs/fr/debug-your-config) indique pourquoi les tâches ont été arrêtées, ou pourquoi un événement de pression les a laissées en cours d'exécution

360 * Définissez [`CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP`](/docs/fr/env-vars) sur `1` pour désactiver les arrêts dus à la pression mémoire360 * Définissez [`CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP`](/docs/fr/env-vars) sur `1` pour désactiver les arrêts dus à la pression mémoire

361* Les commandes Bash et PowerShell en arrière-plan ont une limite de temps, comptée à partir du moment où la commande entre en arrière-plan : 30 minutes, ou le `timeout` que Claude demande lorsqu'il démarre une commande en arrière-plan, jusqu'à un maximum de 2 heures. Une commande qui se déplace vers l'arrière-plan pendant son exécution, par exemple avec `Ctrl+B`, obtient 30 minutes à partir du déplacement. Lorsqu'une commande atteint sa limite, Claude Code l'arrête et indique à Claude pourquoi, et Claude peut la redémarrer avec un `timeout` plus long si le travail en a encore besoin. Deux variables d'environnement augmentent les limites, en millisecondes, et aucune ne peut les raccourcir :361* Les commandes Bash et PowerShell en arrière-plan ont une limite de temps, comptée à partir du moment où la commande entre en arrière-plan : 30 minutes, ou le `timeout` que Claude demande lorsqu'il démarre une commande en arrière-plan, jusqu'à un maximum de 2 heures. Une commande qui se déplace vers l'arrière-plan pendant son exécution, par exemple avec `Ctrl+B`, obtient 30 minutes à partir du déplacement. Lorsqu'une commande atteint sa limite, Claude Code l'arrête et indique à Claude pourquoi, et Claude peut la redémarrer avec un `timeout` plus long si le travail en a encore besoin. Pour allonger les limites, voir [Augmenter la limite de temps pour les commandes en arrière-plan](/docs/fr/tools-reference#raise-the-time-limit-for-background-commands) dans la référence des outils

362 * Définissez [`BASH_DEFAULT_TIMEOUT_MS`](/docs/fr/env-vars) au-dessus de `1800000` pour remplacer la valeur par défaut de 30 minutes par cette valeur, pour les commandes déplacées également362* Une commande en arrière-plan qu'un [sous-agent](/docs/fr/sub-agents#run-subagents-in-foreground-or-background) au premier plan a démarrée se termine lorsque l'exécution de ce sous-agent se termine, qu'elle ait réussi, échoué ou ait été interrompue ; voir [Quand une commande en arrière-plan s'arrête](/docs/fr/tools-reference#when-a-background-command-stops) dans la référence des outils

363 * Définissez [`BASH_MAX_TIMEOUT_MS`](/docs/fr/env-vars) au-dessus de `7200000` pour augmenter le maximum de 2 heures. Définir `BASH_DEFAULT_TIMEOUT_MS` au-dessus de `7200000` l'augmente de la même manière

364* Une commande en arrière-plan qu'un [sous-agent](/docs/fr/sub-agents#run-subagents-in-foreground-or-background) au premier plan a démarrée se termine lorsque l'exécution de ce sous-agent se termine, qu'elle ait réussi, échoué ou ait été interrompue ; voir [Commandes en arrière-plan](/docs/fr/tools-reference#background-commands) dans la référence des outils

365 363

366Pour désactiver toutes les fonctionnalités de tâche en arrière-plan, définissez la variable d'environnement `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` sur `1`. Voir [Variables d'environnement](/docs/fr/env-vars) pour plus de détails.364Pour désactiver toutes les fonctionnalités de tâche en arrière-plan, définissez la variable d'environnement `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` sur `1`. Voir [Variables d'environnement](/docs/fr/env-vars) pour plus de détails.

367 365

plugins/cli-reference.md +36 −2

Details

29Chaque sous-commande partage ces codes de sortie, arguments de plugin et valeurs de portée :29Chaque sous-commande partage ces codes de sortie, arguments de plugin et valeurs de portée :

30 30

31* **Codes de sortie** : `0` en cas de succès et `1` en cas d'échec. `validate` ajoute la sortie `2` pour une erreur inattendue, et `eval` ajoute les codes listés dans [sa section](#plugin-eval).31* **Codes de sortie** : `0` en cas de succès et `1` en cas d'échec. `validate` ajoute la sortie `2` pour une erreur inattendue, et `eval` ajoute les codes listés dans [sa section](#plugin-eval).

~~32* **Arguments de plugin** : un argument `<plugin>` est un `name` de plugin ou `name@marketplace`. Quand deux marketplaces offrent le même nom, utilisez la forme qualifiée.~~32* **Arguments de plugin** : un argument `<plugin>` est un `name` de plugin ou `name@marketplace`. Quand deux marketplaces offrent le même nom, utilisez la forme qualifiée. `configure` prend seulement la forme qualifiée.

33* **Portées** : `--scope` prend `user`, `project`, ou `local`, et nomme le fichier de paramètres que la commande écrit. `update` prend aussi `managed`.33* **Portées** : `--scope` prend `user`, `project`, ou `local`, et nomme le fichier de paramètres que la commande écrit. `update` prend aussi `managed`.

34 34

35<h3 id="plugin-init">35<h3 id="plugin-init">

87| Drapeau | Description |87| Drapeau | Description |

88| :- | :- |88| :- | :- |

89| `-s, --scope <scope>` | Portée d'installation : `user`, `project`, ou `local`. Par défaut `user` |89| `-s, --scope <scope>` | Portée d'installation : `user`, `project`, ou `local`. Par défaut `user` |

90| `--config <key=value>` | Définissez une option [`userConfig`](/docs/fr/plugins/manifest-reference) que le manifeste du plugin déclare. Répétez le drapeau pour chaque option. Nécessite Claude Code v2.1.147 ou ultérieur |90| `--config <key=value>` | Définissez une option [`userConfig`](/docs/fr/plugins/manifest-reference) que le manifeste du plugin déclare. Répétez le drapeau pour chaque option. Nécessite Claude Code v2.1.147 ou ultérieur. Une clé écrite `<server>.<key>` définit un paramètre qu'un [serveur MCP fourni](/docs/fr/plugins/components#include-a-packaged-mcpb-server) déclare dans sa propre `user_config` à la place, pour un fichier bundle expédié à l'intérieur du plugin. La forme `<server>.<key>` nécessite Claude Code v2.1.285 ou ultérieur |

91| `-y, --yes` | Acceptez la commande d'installation affichée sans l'invite `Run this command now?`. Ignoré quand la commande s'exécute dans une session Claude Code, comme depuis l'outil Bash ou un hook. Nécessite Claude Code v2.1.229 ou ultérieur |91| `-y, --yes` | Acceptez la commande d'installation affichée sans l'invite `Run this command now?`. Ignoré quand la commande s'exécute dans une session Claude Code, comme depuis l'outil Bash ou un hook. Nécessite Claude Code v2.1.229 ou ultérieur |

92| `--accept-command <sha256>` | Acceptez la commande d'installation affichée dont le `sha256` une exécution [`--json` précédente](#plugin-json-result) a rapporté dans `shownCommand`, à la place de `-y`. Ne peut pas être combiné avec `-y`. Voir [Accepter une commande d'installation affichée](#accept-a-displayed-install-command). Nécessite Claude Code v2.1.271 ou ultérieur |92| `--accept-command <sha256>` | Acceptez la commande d'installation affichée dont le `sha256` une exécution [`--json` précédente](#plugin-json-result) a rapporté dans `shownCommand`, à la place de `-y`. Ne peut pas être combiné avec `-y`. Voir [Accepter une commande d'installation affichée](#accept-a-displayed-install-command). Nécessite Claude Code v2.1.271 ou ultérieur |

93| `--json` | Affiche le résultat en tant qu'un objet JSON sur la dernière ligne de stdout au lieu du message lisible par l'homme, pour utilisation dans les scripts. Voir [Format de résultat JSON](#plugin-json-result). Nécessite Claude Code v2.1.268 ou ultérieur |93| `--json` | Affiche le résultat en tant qu'un objet JSON sur la dernière ligne de stdout au lieu du message lisible par l'homme, pour utilisation dans les scripts. Voir [Format de résultat JSON](#plugin-json-result). Nécessite Claude Code v2.1.268 ou ultérieur |

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

301| `--available` | Listez aussi les plugins que vos marketplaces offrent que vous n'avez pas installés. N'a aucun effet sans `--json` |301| `--available` | Listez aussi les plugins que vos marketplaces offrent que vous n'avez pas installés. N'a aucun effet sans `--json` |

302| `--data-size [plugin]` | Mesurez le répertoire de [données sauvegardées](#what-an-uninstall-deletes-and-keeps) de chaque plugin installé, ou seulement celui du plugin nommé, donné en tant que `name@marketplace`. N'a aucun effet sans `--json`. Si le nom n'a pas d'enregistrement d'installation, la commande affiche `--data-size names a plugin that is not installed` et quitte `1` au lieu d'afficher la liste. Nécessite Claude Code v2.1.285 ou ultérieur |

302 303

303Claude Code groupe la sortie lisible par l'homme par comment chaque plugin se charge :304Claude Code groupe la sortie lisible par l'homme par comment chaque plugin se charge :

304 305

331| `errorDetails` | array of objects | Un objet par entrée `errors`, donnant son `type` de diagnostic et les noms auxquels il se réfère, comme le plugin, la marketplace, le serveur, ou le fichier. Nécessite Claude Code v2.1.268 ou ultérieur |332| `errorDetails` | array of objects | Un objet par entrée `errors`, donnant son `type` de diagnostic et les noms auxquels il se réfère, comme le plugin, la marketplace, le serveur, ou le fichier. Nécessite Claude Code v2.1.268 ou ultérieur |

334| `hasUserConfig` | boolean | Présent et `true` quand le plugin s'est chargé et son manifeste déclare des options [`userConfig`](/docs/fr/plugins/manifest-reference#user-configuration). Absent pour un plugin qui n'a pas pu se charger, quel que soit ce que son manifeste déclare. Les valeurs sauvegardées ne sont jamais incluses. Nécessite Claude Code v2.1.285 ou ultérieur |

335| `projectEnabled` | boolean | Si le `.claude/settings.json` partagé du projet active le plugin. Installations de marketplace seulement. Nécessite Claude Code v2.1.285 ou ultérieur |

336| `dataDirSize` | object | Avec `--data-size`, la taille du [répertoire de données sauvegardées](#what-an-uninstall-deletes-and-keeps) du plugin en tant que `bytes` et `human` ; absent quand le répertoire est manquant ou vide. Installations de marketplace seulement. Nécessite Claude Code v2.1.285 ou ultérieur |

337| `dataDirUnreadable` | boolean | Avec `--data-size`, `true` quand le répertoire de données sauvegardées existe mais n'a pas pu être mesuré. Installations de marketplace seulement. Nécessite Claude Code v2.1.285 ou ultérieur |

333 338

334Avec `--json --available`, Claude Code affiche un objet au lieu d'un tableau. Son champ `installed` contient le tableau d'objets de plugin installé, et son champ `available` contient un objet par plugin de marketplace non installé avec les champs ci-dessous.339Avec `--json --available`, Claude Code affiche un objet au lieu d'un tableau. Son champ `installed` contient le tableau d'objets de plugin installé, et son champ `available` contient un objet par plugin de marketplace non installé avec les champs ci-dessous.

335 340

373 378

374Pour un plugin qui n'est pas chargé, Claude Code affiche ``Plugin "formatter" not found. Run `claude plugin list` to see installed plugins, or pass --plugin-dir <path> to load one from disk.`` et quitte `1`.379Pour un plugin qui n'est pas chargé, Claude Code affiche ``Plugin "formatter" not found. Run `claude plugin list` to see installed plugins, or pass --plugin-dir <path> to load one from disk.`` et quitte `1`.

375 380

381<h3 id="plugin-configure">

382 plugin configure

383</h3>

384

385Montrez les options [`userConfig`](/docs/fr/plugins/manifest-reference#user-configuration) d'un plugin installé et lesquelles sont définies, ou sauvegardez les valeurs canalisées sur stdin. Nécessite Claude Code v2.1.285 ou ultérieur.

386

387```bash theme={null}

388claude plugin configure <plugin>

389```

390

391| Drapeau | Description |

392| :- | :- |

393| `--values-stdin` | Lisez les valeurs d'option depuis stdin en tant qu'objet JSON de strings sur une seule ligne et sauvegardez-les. Les options que vous omettez conservent leurs valeurs sauvegardées |

394| `--json` | Affiche le résultat en tant qu'un objet JSON sur stdout. Sans `--values-stdin`, l'objet porte le `schema` et les `choices` des options, leurs `inputs` de démarrage, et les noms d'options `configured` et `unconfigured`. Avec `--values-stdin`, il porte les noms d'options `saved` et, quand ils pourraient être relus, les noms `unconfigured` |

395

396Sans drapeaux, la commande liste chaque option avec jusqu'à trois étiquettes : `required` ou `optional`, puis `sensitive` pour une option que le manifeste déclare sensible, puis `set` ou `not set`. Elle n'affiche aucune valeur sauvegardée. Avec `--json`, la sortie inclut les valeurs sauvegardées des options qui ne sont pas sensibles, et jamais le texte d'une sensible.

397

398Pour sauvegarder les valeurs, écrivez-les dans un fichier en tant qu'objet JSON qui mappe les clés d'option à des valeurs de string, puis passez le fichier sur stdin. Remplacez `formatter@my-marketplace` par l'id de votre propre plugin en tant que `claude plugin list` le montre. Cet exemple définit une option nommée `api_url` depuis un fichier `values.json` qui contient `{"api_url": "https://example.com"}` :

399

400```bash theme={null}

401claude plugin configure formatter@my-marketplace --values-stdin < values.json

402```

403

404Claude Code valide chaque valeur par rapport au type déclaré de l'option et affiche `Configuration saved. Restart Claude Code to apply it.` Si vous passez une clé que le manifeste ne déclare pas, ou une valeur qui échoue la validation, la commande ne sauvegarde rien, affiche `Failed to save configuration:` avec la raison, et quitte `1`. Avec `--json`, une valeur refusée affiche aussi un objet sur stdout dont le champ `refused` porte le `message` et, quand une option est en cause, sa clé `option`.

405

406Passez l'id complet `name@marketplace` du plugin, en tant que `claude plugin list` le montre. `configure` n'accepte pas un `name` nu. Quand aucun plugin chargé n'a cet id, la commande affiche `No installed plugin has the id "<plugin>".` et quitte `1`.

407

408Pour les paramètres d'un serveur MCP fourni, voir [`plugin install --config`](#plugin-install) ou l'élément **Configure** dans `/plugin`.

409

376<h3 id="plugin-prune">410<h3 id="plugin-prune">

377 plugin prune411 plugin prune

378</h3>412</h3>

plugins/components.md +13 −2

Details

868 868

869Le serveur prend son nom du `name` dans le manifeste du bundle.869Le serveur prend son nom du `name` dans le manifeste du bundle.

870 870

871Un manifeste propre du bundle peut déclarer les paramètres que le serveur a besoin de l'utilisateur dans un bloc `user_config`. Un serveur emballé avec un paramètre requis qui n'a pas de valeur enregistrée ne démarre pas. L'onglet **Errors** de `/plugin` affiche `Bundled MCP server "<name>" was not started: it needs configuration`.

872

873Les utilisateurs fournissent les valeurs de l'une de deux façons :

874

875* **Dans `/plugin`** : sélectionnez le plugin sur l'onglet **Installed** et choisissez **Configure**

876* **À l'installation, depuis le shell** : passez [`--config <server>.<key>=<value>`](/docs/fr/plugins/cli-reference#plugin-install) à `claude plugin install`. Nécessite Claude Code v2.1.285 ou ultérieur, et fonctionne seulement pour un bundle emballé à l'intérieur du plugin.

877

871Pour les transports et l'authentification, consultez [MCP](/docs/fr/mcp#plugin-provided-mcp-servers).878Pour les transports et l'authentification, consultez [MCP](/docs/fr/mcp#plugin-provided-mcp-servers).

872 879

873<h3 id="lsp-servers">880<h3 id="lsp-servers">

1071 Quand la boîte de dialogue de configuration apparaît1078 Quand la boîte de dialogue de configuration apparaît

1072</h3>1079</h3>

1073 1080

1074La boîte de dialogue n'apparaît que dans l'interface interactive `/plugin`. Elle s'ouvre pour toute option qui n'est pas encore définie quand l'utilisateur fait l'une des choses suivantes :1081La boîte de dialogue fait partie de l'interface interactive `/plugin`. Elle s'ouvre pour toute option qui n'est pas encore définie quand l'utilisateur fait l'une des choses suivantes :

1075 1082

1076* Installe le plugin dans `/plugin`1083* Installe le plugin dans `/plugin`

1077* Exécute `/plugin install <plugin>@<marketplace>` à l'intérieur d'une session1084* Exécute `/plugin install <plugin>@<marketplace>` à l'intérieur d'une session

1079 1086

1080Pour ouvrir la même boîte de dialogue à tout moment, l'utilisateur exécute `/plugin configure <plugin>@<marketplace>`.1087Pour ouvrir la même boîte de dialogue à tout moment, l'utilisateur exécute `/plugin configure <plugin>@<marketplace>`.

1081 1088

1082La commande shell `claude plugin install` ne demande jamais les valeurs `userConfig`. Pour définir les valeurs à partir du shell, passez chacune comme `--config KEY=VALUE`. Quand les options restent non définies, la commande imprime une ligne `userConfig options not yet set` qui nomme les deux façons de les définir. [La boîte de dialogue `userConfig` ne s'affiche jamais](/docs/fr/plugins/troubleshooting#the-userconfig-dialog-never-appears) cite la ligne.1089La boîte de dialogue Manage plugins de l'extension VS Code ([Manage plugins dialog](/docs/fr/vs-code#install-plugins)) demande les options non définies sous forme de formulaire après une installation, et une icône d'engrenage sur la ligne du plugin ouvre le formulaire à nouveau avec chaque option.

1090

1091La commande shell `claude plugin install` ne demande jamais les valeurs `userConfig`. Pour définir les valeurs à partir du shell, passez chacune comme `--config KEY=VALUE` lors de l'installation, ou envoyez un objet JSON à [`claude plugin configure --values-stdin`](/docs/fr/plugins/cli-reference#plugin-configure) ensuite.

1092

1093Quand les options restent non définies, `claude plugin install` imprime une ligne `userConfig options not yet set`. Pour le texte exact de la ligne, consultez [The `userConfig` dialog never appears](/docs/fr/plugins/troubleshooting#the-userconfig-dialog-never-appears).

1083 1094

1084Pour les champs d'option, où chaque valeur est stockée, comment un composant référence une valeur enregistrée, et quels champs rejettent `${user_config.*}`, consultez [Configuration utilisateur](/docs/fr/plugins/manifest-reference#user-configuration).1095Pour les champs d'option, où chaque valeur est stockée, comment un composant référence une valeur enregistrée, et quels champs rejettent `${user_config.*}`, consultez [Configuration utilisateur](/docs/fr/plugins/manifest-reference#user-configuration).

1085 1096

plugins/install.md +8 −2

Details

72 La dernière phrase du résumé vous indique si le plugin est utilisable dans cette session :72 La dernière phrase du résumé vous indique si le plugin est utilisable dans cette session :

73 73

74 * **Active now** : `Plugin is now active.` Aucun rechargement n'est nécessaire.74 * **Active now** : `Plugin is now active.` Aucun rechargement n'est nécessaire.

75 * **Active, but a server needs setup** : `Plugin is now active.` est suivi de `Its bundled MCP server needs configuration before it can start`. Le [serveur MCP fourni](/docs/fr/plugins/components#include-a-packaged-mcpb-server) du plugin ne peut pas démarrer tant que vous n'avez pas défini ses options. Sélectionnez le plugin sur l'onglet **Installed** dans `/plugin` et choisissez **Configure** pour définir les options du serveur.

75 * **Reload needed** : `Run /reload-plugins to activate.` Le panneau se ferme et Claude Code exécute ce rechargement pour vous. Si le rechargement [invaliderait le cache du prompt](/docs/fr/prompt-caching#enabling-or-disabling-a-plugin), il vous avertit et laisse le plugin en attente à la place. Exécutez `/reload-plugins --force` pour l'activer quand même, ce qui coûte une demande non mise en cache.76 * **Reload needed** : `Run /reload-plugins to activate.` Le panneau se ferme et Claude Code exécute ce rechargement pour vous. Si le rechargement [invaliderait le cache du prompt](/docs/fr/prompt-caching#enabling-or-disabling-a-plugin), il vous avertit et laisse le plugin en attente à la place. Exécutez `/reload-plugins --force` pour l'activer quand même, ce qui coûte une demande non mise en cache.

76 * **Load failed** : `The plugin couldn't be loaded`. Ouvrez l'onglet **Errors** dans `/plugin` pour connaître la raison, puis consultez [After install: plugin not working](/docs/fr/plugins/troubleshooting#plugin-installed-but-not-working).77 * **Load failed** : `The plugin couldn't be loaded`. Ouvrez l'onglet **Errors** dans `/plugin` pour connaître la raison, puis consultez [After install: plugin not working](/docs/fr/plugins/troubleshooting#plugin-installed-but-not-working).

77 </Step>78 </Step>

248Une marketplace privée est celle dans un référentiel auquel vous avez besoin d'identifiants pour cloner, sur GitHub ou n'importe quel autre hôte git. Vous l'ajoutez avec la même commande `/plugin marketplace add` ou `claude plugin marketplace add` qu'une marketplace publique. Claude Code la clone avec les identifiants git déjà sur votre machine et ne demande jamais, donc chaque façon de se connecter a une exigence :249Une marketplace privée est celle dans un référentiel auquel vous avez besoin d'identifiants pour cloner, sur GitHub ou n'importe quel autre hôte git. Vous l'ajoutez avec la même commande `/plugin marketplace add` ou `claude plugin marketplace add` qu'une marketplace publique. Claude Code la clone avec les identifiants git déjà sur votre machine et ne demande jamais, donc chaque façon de se connecter a une exigence :

249 250

250* **HTTPS** : vos assistants d'identifiants git s'appliquent, donc l'accès que vous avez configuré avec `gh auth login`, le Keychain macOS ou `git-credential-store` fonctionne. Les invites interactives sont supprimées, donc un hôte auquel vous ne vous êtes jamais authentifié échoue au lieu de demander un mot de passe.251* **HTTPS** : vos assistants d'identifiants git s'appliquent, donc l'accès que vous avez configuré avec `gh auth login`, le Keychain macOS ou `git-credential-store` fonctionne. Les invites interactives sont supprimées, donc un hôte auquel vous ne vous êtes jamais authentifié échoue au lieu de demander un mot de passe.

251* **SSH** : l'hôte doit déjà être dans votre fichier `known_hosts` et la clé doit fonctionner sans invite de phrase secrète, car les invites d'empreinte d'hôte et de phrase secrète sont également supprimées.252* **SSH** : l'hôte doit déjà être dans votre fichier `known_hosts` et la clé doit fonctionner sans invite de phrase secrète. Si votre configuration git nomme un programme SSH dans `GIT_SSH_COMMAND`, `GIT_SSH`, ou la `core.sshCommand` de votre configuration git, Claude Code exécute ce programme.

252* **Raccourci GitHub `owner/repo`** : Claude Code vérifie si votre clé SSH s'authentifie à `github.com`, puis clone sur SSH si c'est le cas et sur HTTPS sinon. Définissez [`CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1`](/docs/fr/env-vars#variables) pour ignorer cette vérification et toujours cloner sur HTTPS.253* **Raccourci GitHub `owner/repo`** : Claude Code vérifie si votre clé SSH s'authentifie à `github.com`, puis clone sur SSH si c'est le cas et sur HTTPS sinon. Définissez [`CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1`](/docs/fr/env-vars#variables) pour ignorer cette vérification et toujours cloner sur HTTPS.

253 254

254Les mêmes identifiants s'appliquent lorsque vous exécutez `/plugin install`, `/plugin marketplace update` et `claude plugin update`.255Les mêmes identifiants s'appliquent lorsque vous exécutez `/plugin install`, `/plugin marketplace update` et `claude plugin update`.

288 289

289* Tapez pour filtrer par nom ou description.290* Tapez pour filtrer par nom ou description.

290* Appuyez sur **Espace** pour activer ou désactiver le plugin sélectionné, et **f** pour le marquer comme favori.291* Appuyez sur **Espace** pour activer ou désactiver le plugin sélectionné, et **f** pour le marquer comme favori.

291* Appuyez sur **Entrée** pour ouvrir les détails d'un plugin. Le menu là offre **Disable plugin** ou **Enable plugin**, **Update now** et **Uninstall**. Les plugins qui prennent des paramètres offrent également **Configure options**.292* Appuyez sur **Entrée** pour ouvrir les détails d'un plugin.

293

294Un menu de détails de plugin offre **Disable plugin** ou **Enable plugin**, **Update now** et **Uninstall**. Deux éléments supplémentaires apparaissent pour les plugins qui prennent des paramètres, et un plugin peut afficher les deux :

295

296* **Configure options** : affiché lorsque le manifeste du plugin déclare les options [`userConfig`](/docs/fr/plugins/manifest-reference#user-configuration). Ouvre la boîte de dialogue pour ces options

297* **Configure** : affiché lorsque le plugin inclut un [serveur MCP fourni](/docs/fr/plugins/components#include-a-packaged-mcpb-server). Définit les paramètres `user_config` propres à ce serveur

292 298

293L'onglet peut également afficher les plugins à la portée **Managed**. Votre organisation les a installés via les [paramètres gérés](/docs/fr/settings#settings-files), et vous ne pouvez pas les activer, désactiver ou les désinstaller ici.299L'onglet peut également afficher les plugins à la portée **Managed**. Votre organisation les a installés via les [paramètres gérés](/docs/fr/settings#settings-files), et vous ne pouvez pas les activer, désactiver ou les désinstaller ici.

294 300

plugins/troubleshooting.md +40 −2

Details

201 201

202Un ajout réussi imprime `Successfully added marketplace: <name>`.202Un ajout réussi imprime `Successfully added marketplace: <name>`.

203 203

204<h3 id="invalid-git-url">

205 `Invalid git URL`

206</h3>

207

208Vous avez ajouté une marketplace, installé un plugin ou exécuté une mise à jour à partir d'une adresse git, et la commande a échoué avec `Invalid git URL` dans son message.

209

210Claude Code vérifie chaque adresse git avant d'exécuter git. Il refuse une adresse dont il ne supporte pas le protocole. Il refuse également une adresse que git pourrait lire comme nommant un serveur ou un dossier différent de celui que l'adresse affiche.

211

212Le texte après l'adresse nomme ce qu'il faut changer. Réécrivez l'adresse comme le message le dit et exécutez à nouveau la commande.

213

214Un refus qui dit plutôt `is blocked by enterprise policy` provient des paramètres de votre organisation. Consultez [La source de la marketplace est bloquée par la politique d'entreprise](#marketplace-source-is-blocked-by-enterprise-policy).

215

204<h3 id="path-does-not-exist">216<h3 id="path-does-not-exist">

205 `Path does not exist: <path>`217 `Path does not exist: <path>`

206</h3>218</h3>

410 422

411`claude plugin install` dans votre shell imprime un message différent. Pour un plugin déjà installé à la portée cible, il imprime `Plugin "<name>@<marketplace>" is already installed (scope: user)` et quitte 0. Si son répertoire de cache est manquant, la même commande le re-télécharge.423`claude plugin install` dans votre shell imprime un message différent. Pour un plugin déjà installé à la portée cible, il imprime `Plugin "<name>@<marketplace>" is already installed (scope: user)` et quitte 0. Si son répertoire de cache est manquant, la même commande le re-télécharge.

412 424

425<h3 id="plugin-would-share-its-folder">

426 `"<plugin>" was not installed: it would share its folder with "<other>"`

427</h3>

428

429Vous avez installé un plugin via `claude plugin install`, `/plugin`, ou une suggestion d'installation dans une session, et Claude Code l'a refusé avec cette ligne, ou avec `would share its saved data with`.

430

431L'id du plugin refusé et l'id d'un plugin installé correspondent au même dossier sur le disque : ils sont identiques une fois que `.` et `@` sont écrits comme `-`. Sur macOS et Windows, les ids qui diffèrent uniquement par les majuscules correspondent également au même dossier. Installer les deux mettrait les fichiers d'un plugin dans le dossier de l'autre, donc Claude Code refuse et le plugin installé conserve ses fichiers.

432

433Le message nomme la façon de s'en sortir :

434

435* **L'autre plugin est installé** : le message dit `Only one of the two can be installed.` et nomme la commande `claude plugin uninstall`, ou l'étape de désinstallation dans `/plugin`, qui supprime l'autre plugin. Exécutez-la, puis installez à nouveau. Pour ce que la désinstallation supprime, consultez [Ce qu'une désinstallation supprime et conserve](/docs/fr/plugins/cli-reference#what-an-uninstall-deletes-and-keeps).

436* **Les deux ids arrivent dans une installation**, comme un plugin et une dépendance dont il a besoin : aucun ordre d'installation n'aide. Seul un responsable de la marketplace qui répertorie les deux plugins peut le corriger, en renommant l'un d'eux. Lorsque les deux proviennent de marketplaces différentes, un responsable de l'une ou l'autre peut le faire.

437

413<h3 id="this-plugin-uses-a-source-type-your-claude-code-version-does-not-suppo">438<h3 id="this-plugin-uses-a-source-type-your-claude-code-version-does-not-suppo">

414 `This plugin uses a source type your Claude Code version does not support`439 `This plugin uses a source type your Claude Code version does not support`

415</h3>440</h3>

790* **`URL is unset or invalid`** : une option `${user_config.*}` que l'URL utilise n'est pas définie. Exécutez `/plugin configure <plugin>` pour la définir815* **`URL is unset or invalid`** : une option `${user_config.*}` que l'URL utilise n'est pas définie. Exécutez `/plugin configure <plugin>` pour la définir

791* **`has an invalid MCP url`** ou **`headersHelper for MCP server '<server>' references ${user_config.*}`** : la configuration du plugin lui-même est en faute. Corrigez l'`url` ou `headersHelper` dans la configuration MCP de votre plugin, ou signalez-le à l'auteur du plugin si le plugin n'est pas le vôtre. Le cas `headersHelper` a sa propre entrée sous [la commande de plugin référence user\_config](/docs/fr/errors#plugin-command-references-user-config)816* **`has an invalid MCP url`** ou **`headersHelper for MCP server '<server>' references ${user_config.*}`** : la configuration du plugin lui-même est en faute. Corrigez l'`url` ou `headersHelper` dans la configuration MCP de votre plugin, ou signalez-le à l'auteur du plugin si le plugin n'est pas le vôtre. Le cas `headersHelper` a sa propre entrée sous [la commande de plugin référence user\_config](/docs/fr/errors#plugin-command-references-user-config)

792 817

818<h4 id="bundled-mcp-server-name-was-not-started-it-needs-configuration">

819 `Bundled MCP server "<name>" was not started: it needs configuration`

820</h4>

821

822Le plugin inclut le serveur comme un [bundle MCPB](/docs/fr/plugins/components#include-a-packaged-mcpb-server) qui déclare `user_config`, et un paramètre requis n'a pas de valeur enregistrée encore ou une valeur enregistrée échoue la validation du bundle lui-même, donc Claude Code saute le démarrage du serveur. Le reste du plugin fonctionne.

823

824Sélectionnez le plugin sur l'onglet **Installed** de `/plugin` et choisissez **Configure** pour fournir les valeurs. Après avoir enregistré, `/plugin` affiche `Configuration saved.` et se ferme, et Claude Code recharge les plugins comme décrit sous [Gérer les plugins installés](/docs/fr/plugins/install#manage-installed-plugins). Le serveur démarre une fois que ce rechargement s'applique. Avant v2.1.285, Claude Code sautait le serveur sans afficher cette ligne.

825

793<h4 id="server-is-configured-but-never-connects">826<h4 id="server-is-configured-but-never-connects">

794 Le serveur est configuré mais ne se connecte jamais827 Le serveur est configuré mais ne se connecte jamais

795</h4>828</h4>

934 967

935Votre plugin déclare des options `userConfig`, mais aucune boîte de dialogue de configuration n'apparaît lorsque vous l'installez.968Votre plugin déclare des options `userConfig`, mais aucune boîte de dialogue de configuration n'apparaît lorsque vous l'installez.

936 969

937L'installation interactive affiche la boîte de dialogue, et la commande shell prend les valeurs comme drapeaux à la place :970Le fait que l'installation demande les valeurs dépend de l'endroit où vous l'exécutez :

938 971

939* **`/plugin install` dans une session, ou l'onglet Discover dans `/plugin`** : la boîte de dialogue fait partie de cette installation interactive972* **`/plugin install` dans une session, ou l'onglet Discover dans `/plugin`** : la boîte de dialogue fait partie de cette installation interactive

973* **La boîte de dialogue Gérer les plugins de l'extension VS Code** : demande les options non définies sous forme de formulaire après l'installation. Avant v2.1.285, l'installation là-bas n'affichait aucun formulaire d'options, donc définissez les valeurs à partir d'une session de terminal avec `/plugin configure <plugin>@<marketplace>`

940* **`claude plugin install` dans votre shell** : ne demande jamais les valeurs `userConfig`. Il enregistre toutes les valeurs `--config KEY=VALUE` que vous passez, et lorsque les options restent non définies, il imprime `N userConfig options not yet set — run /plugin configure <plugin>@<marketplace> in Claude Code, or pass --config KEY=VALUE.` Lorsque l'une des options non définies est requise, `(M required)` suit `not yet set`.974* **`claude plugin install` dans votre shell** : ne demande jamais les valeurs `userConfig`. Il enregistre toutes les valeurs `--config KEY=VALUE` que vous passez, et lorsque les options restent non définies, il imprime `N userConfig options not yet set — run /plugin configure <plugin>@<marketplace> in Claude Code, or pass --config KEY=VALUE.` Lorsque l'une des options non définies est requise, `(M required)` suit `not yet set`.

941 975

942Si vous avez installé à partir du shell, passez les valeurs avec `--config`, un drapeau par option :976Si vous avez installé à partir du shell, passez les valeurs avec `--config`, un drapeau par option :

945claude plugin install my-plugin@my-marketplace --config api_url=https://example.com979claude plugin install my-plugin@my-marketplace --config api_url=https://example.com

946```980```

947 981

948Lorsque chaque option est définie, la sortie d'installation ne porte aucune ligne `not yet set`. Pour ouvrir la boîte de dialogue après coup à la place, exécutez `/plugin configure my-plugin@my-marketplace` dans une session.982Lorsque chaque option est définie, la sortie d'installation ne porte aucune ligne `not yet set`.

983

984Pour ouvrir la boîte de dialogue après coup à la place, exécutez `/plugin configure my-plugin@my-marketplace` dans une session. À partir du shell, [`claude plugin configure`](/docs/fr/plugins/cli-reference#plugin-configure) affiche les options qui sont toujours non définies et enregistre les valeurs canalisées sur stdin. Cela nécessite Claude Code v2.1.285 ou ultérieur.

949 985

950Si vous passez une clé `--config` que le manifeste ne déclare pas, le plugin s'installe toujours, et la commande imprime `⚠ Installed, but --config not applied: --config key "<key>" isn't declared in this plugin's userConfig.` suivi des clés que le plugin déclare.986Si vous passez une clé `--config` que le manifeste ne déclare pas, le plugin s'installe toujours, et la commande imprime `⚠ Installed, but --config not applied: --config key "<key>" isn't declared in this plugin's userConfig.` suivi des clés que le plugin déclare.

951 987

988Pour un plugin qui expédie un [fichier bundle MCPB](/docs/fr/plugins/components#include-a-packaged-mcpb-server) déclarant son propre `user_config`, le message lit `isn't declared in this plugin's userConfig or by its bundled MCP servers.` à la place, et les clés connues incluent les clés de ce serveur, écrites `<server>.<key>`. Un bundle que le manifeste référence par URL n'est pas lu au moment de l'installation, donc ses clés ne sont pas répertoriées et le message dit de le configurer dans `/plugin`. La définition des clés `<server>.<key>` nécessite Claude Code v2.1.285 ou ultérieur.

989

952<h3 id="claude-plugin-validate-reports-errors">990<h3 id="claude-plugin-validate-reports-errors">

953 `claude plugin validate` signale des erreurs991 `claude plugin validate` signale des erreurs

954</h3>992</h3>

sessions.md +20 −2

Details

29 29

30`claude --continue` ouvre une [session en arrière-plan](/docs/fr/agent-view) qui s'est terminée, mais pas une qui est toujours en cours d'exécution ; l'ouverture de sessions en arrière-plan terminées nécessite Claude Code v2.1.257 ou ultérieur. Si votre conversation la plus récente est une que vous [avez envoyée en arrière-plan](/docs/fr/agent-view#send-the-session-to-the-background) et qu'elle s'exécute toujours là-bas, Claude Code se termine avec `Your most recent conversation is running in the background` et l'ID de cette session. Attachez-vous à la session depuis [`claude agents`](/docs/fr/agent-view#attach-to-a-session), ou exécutez `claude --resume` pour en choisir une autre.30`claude --continue` ouvre une [session en arrière-plan](/docs/fr/agent-view) qui s'est terminée, mais pas une qui est toujours en cours d'exécution ; l'ouverture de sessions en arrière-plan terminées nécessite Claude Code v2.1.257 ou ultérieur. Si votre conversation la plus récente est une que vous [avez envoyée en arrière-plan](/docs/fr/agent-view#send-the-session-to-the-background) et qu'elle s'exécute toujours là-bas, Claude Code se termine avec `Your most recent conversation is running in the background` et l'ID de cette session. Attachez-vous à la session depuis [`claude agents`](/docs/fr/agent-view#attach-to-a-session), ou exécutez `claude --resume` pour en choisir une autre.

31 31

32<span id="resume-a-running-background-session" />

34Lorsque la conversation que vous reprenez avec `claude --resume` ou `/resume` appartient à une [session en arrière-plan](/docs/fr/agent-view) qui est toujours en cours d'exécution, Claude Code ouvre la session en cours d'exécution elle-même. Avec `--bg` sur la ligne de commande, la reprise est une [expédition en arrière-plan](/docs/fr/agent-view#from-your-shell) à la place. Avant la v2.1.285, Claude Code refusait et vous disait d'ouvrir la session avec `claude attach <id>`, ou de l'arrêter d'abord avec `claude stop <id>`.

36* **Depuis votre shell** : `claude --resume <session>` exécute [`claude attach`](/docs/fr/agent-view#attach-to-a-session) sur cette session dans le même terminal au lieu de charger la transcription elle-même. Une invite que vous passez sur la ligne de commande, comme dans `claude --resume <session> "check the tests too"`, va à la session comme son prochain tour d'abord, et Claude Code affiche `Sent your prompt to the background session (<id>); opening it…` avant de s'attacher. `claude -p --resume <session> "prompt"` tapé à un terminal fait la même chose, donc `-p` ne garde pas cette exécution non-interactive.

38 Claude Code n'ouvre pas la session lorsque la ligne de commande contient l'un de ceux-ci :

40 * Entrée ou sortie redirigée ou canalisée

41 * Drapeaux qui configurent la session, tels que `--permission-mode`, `--model` ou `--settings`

42 * Drapeaux qui lisent la sortie, tels que `--output-format json` ou `--json-schema`

43 * Drapeaux qui limitent ou rembobinent l'exécution, tels que `--max-turns` ou `--max-budget-usd`

45 Avec l'un de ceux-ci, ou lorsque la [vue agent est désactivée](/docs/fr/agent-view#turn-off-agent-view), Claude Code n'envoie rien et se termine avec le statut 1, en affichant que la session s'exécute en arrière-plan ainsi que la commande `claude attach <id>` qui l'ouvre, ou en vous disant de la trouver dans `claude agents` lorsqu'il ne peut pas déterminer l'ID. Ajoutez `--fork-session` pour reprendre une copie de la conversation à la place. Pour continuer la conversation elle-même dans une session qui vous appartient, avec vos drapeaux appliqués, exécutez `claude stop <id>` puis répétez la commande.

47 Une invite qui commence par `/` ou `!` n'est pas envoyée, et non plus aucune invite pendant que la session attend votre réponse à une question. Dans les deux cas, Claude Code n'ouvre pas la session, et le message inclut `Your prompt was not sent to it` avec la raison.

48* **Depuis l'intérieur d'une session** : `/resume` déplace votre conversation actuelle en arrière-plan et attache ce terminal à la session en cours d'exécution, en affichant `Opening "<title>", running in the background (<id>)`. Appuyez sur `←` sur une invite vide pour revenir à la vue agent, qui liste également la conversation que vous avez laissée. Lorsque la conversation actuelle ne peut pas se déplacer en arrière-plan, par exemple parce que vous êtes déjà attaché à une session en arrière-plan ou que la persistance de session est désactivée, `/resume` affiche la commande `claude attach` à exécuter à la place.

32Vous pouvez exécuter `claude --resume <session-id>` depuis n'importe quel répertoire : Claude Code cherche l'ID dans le répertoire de projet courant et ses git worktrees d'abord, puis dans tous les autres projets sur cette machine, ce qui lui permet de trouver une session qui a démarré ailleurs ou qui s'est déplacée avec [`/cd`](/docs/fr/commands). La recherche inter-projets résout l'ID uniquement lorsqu'exactement un autre projet contient une transcription avec des messages pour celui-ci, donc un doublon copié à la main fait que Claude Code signale non-trouvé plutôt que de reprendre une copie arbitraire. Si aucune session stockée ne correspond à l'ID, Claude Code signale `No conversation found with session ID: <session-id>`. Avant la v2.1.223, la recherche s'arrêtait au répertoire de projet courant et à ses git worktrees, donc vous deviez reprendre depuis le répertoire dans lequel la session avait travaillé en dernier.50Vous pouvez exécuter `claude --resume <session-id>` depuis n'importe quel répertoire : Claude Code cherche l'ID dans le répertoire de projet courant et ses git worktrees d'abord, puis dans tous les autres projets sur cette machine, ce qui lui permet de trouver une session qui a démarré ailleurs ou qui s'est déplacée avec [`/cd`](/docs/fr/commands). La recherche inter-projets résout l'ID uniquement lorsqu'exactement un autre projet contient une transcription avec des messages pour celui-ci, donc un doublon copié à la main fait que Claude Code signale non-trouvé plutôt que de reprendre une copie arbitraire. Si aucune session stockée ne correspond à l'ID, Claude Code signale `No conversation found with session ID: <session-id>`. Avant la v2.1.223, la recherche s'arrêtait au répertoire de projet courant et à ses git worktrees, donc vous deviez reprendre depuis le répertoire dans lequel la session avait travaillé en dernier.

33 51

34<h3 id="what-a-resumed-session-restores">52<h3 id="what-a-resumed-session-restores">

35 Ce qu'une session reprise restaure53 Ce qu'une session reprise restaure

36</h3>54</h3>

37 55

~~38Une session reprise restaure la conversation ainsi que l'état enregistré en elle :~~56Lorsque Claude Code charge une conversation à partir de sa transcription, la session reprise restaure la conversation ainsi que l'état enregistré en elle :

39 57

40* Historique de conversation : l'historique complet, y compris les appels d'outils et les résultats. Un outil qui était toujours en cours d'exécution lorsque le processus précédent s'est terminé, par exemple lors d'un plantage, ne se termine pas ou ne s'exécute pas à nouveau lorsque vous reprenez. Claude voit l'appel marqué comme interrompu avant que son résultat ne soit enregistré et on lui dit de vérifier s'il a pris effet avant de l'exécuter à nouveau, sauf si [`CLAUDE_CODE_RESUME_INTERRUPTED_TURN`](/docs/fr/env-vars#variables) est défini. Avant la v2.1.281, Claude Code supprimait l'appel interrompu de la conversation ou le montrait à Claude comme un appel que vous aviez interrompu.58* Historique de conversation : l'historique complet, y compris les appels d'outils et les résultats. Un outil qui était toujours en cours d'exécution lorsque le processus précédent s'est terminé, par exemple lors d'un plantage, ne se termine pas ou ne s'exécute pas à nouveau lorsque vous reprenez. Claude voit l'appel marqué comme interrompu avant que son résultat ne soit enregistré et on lui dit de vérifier s'il a pris effet avant de l'exécuter à nouveau, sauf si [`CLAUDE_CODE_RESUME_INTERRUPTED_TURN`](/docs/fr/env-vars#variables) est défini. Avant la v2.1.281, Claude Code supprimait l'appel interrompu de la conversation ou le montrait à Claude comme un appel que vous aviez interrompu.

41* Modèle : la session continue sur le modèle qu'elle utilisait. Le modèle n'est pas restauré lorsqu'il a été retiré ou n'est pas autorisé par `availableModels`, lorsqu'un drapeau `--model` ou une variable d'environnement de la famille `ANTHROPIC_MODEL` en choisit un au lancement, ou sur les fournisseurs qui utilisent des ID de déploiement spécifiques au fournisseur, tels que [Amazon Bedrock, Google Cloud's Agent Platform et Microsoft Foundry](/docs/fr/third-party-integrations) ; voir [configuration du modèle](/docs/fr/model-config#setting-your-model) pour l'ordre de résolution.59* Modèle : la session continue sur le modèle qu'elle utilisait. Le modèle n'est pas restauré lorsqu'il a été retiré ou n'est pas autorisé par `availableModels`, lorsqu'un drapeau `--model` ou une variable d'environnement de la famille `ANTHROPIC_MODEL` en choisit un au lancement, ou sur les fournisseurs qui utilisent des ID de déploiement spécifiques au fournisseur, tels que [Amazon Bedrock, Google Cloud's Agent Platform et Microsoft Foundry](/docs/fr/third-party-integrations) ; voir [configuration du modèle](/docs/fr/model-config#setting-your-model) pour l'ordre de résolution.

51 Mode de permission à la reprise69 Mode de permission à la reprise

52</h4>70</h4>

53 71

~~54Le mode de permission dans lequel Claude Code démarre une session reprise dépend de la façon dont vous la reprenez :~~72Le mode de permission dans lequel Claude Code démarre une session reprise dépend de la façon dont vous la reprenez. Les cas ci-dessous s'appliquent lorsque Claude Code charge la conversation à partir de sa transcription ; lorsque vous [ouvrez une session en arrière-plan qui est toujours en cours d'exécution](#resume-a-running-background-session) à la place, cette session conserve le mode de permission dans lequel elle se trouve.

55 73

56* Terminal : `claude --continue`, `claude --resume <session-id>` ou `claude --resume <name>` lorsque le nom correspond à une session, sans `-p`. Claude Code restaure le mode de permission dans lequel se trouvait la session, sauf dans les cas du tableau. Passez `--permission-mode` ou `--dangerously-skip-permissions` pour remplacer le mode restauré.74* Terminal : `claude --continue`, `claude --resume <session-id>` ou `claude --resume <name>` lorsque le nom correspond à une session, sans `-p`. Claude Code restaure le mode de permission dans lequel se trouvait la session, sauf dans les cas du tableau. Passez `--permission-mode` ou `--dangerously-skip-permissions` pour remplacer le mode restauré.

57* Non-interactif : `claude -p --resume` ou `claude -p --continue`. Claude Code démarre l'exécution dans le mode de permission qu'une nouvelle exécution `claude -p` démarrerait, sauf qu'une session qui s'est terminée en mode plan reprend en mode plan selon les [conditions ci-dessous](#resume-in-plan-mode-with-p).75* Non-interactif : `claude -p --resume` ou `claude -p --continue`. Claude Code démarre l'exécution dans le mode de permission qu'une nouvelle exécution `claude -p` démarrerait, sauf qu'une session qui s'est terminée en mode plan reprend en mode plan selon les [conditions ci-dessous](#resume-in-plan-mode-with-p).

skills.md +1 −1

Details

740 740

741* **Répertoire de travail** : Claude Code exécute chaque commande dans le répertoire de travail actuel du shell de la session. Ce répertoire se déplace lorsque Claude exécute `cd`. Utilisez [`${CLAUDE_SKILL_DIR}` ou `${CLAUDE_PROJECT_DIR}`](#available-string-substitutions) dans les chemins qui doivent se résoudre de la même manière à chaque fois.741* **Répertoire de travail** : Claude Code exécute chaque commande dans le répertoire de travail actuel du shell de la session. Ce répertoire se déplace lorsque Claude exécute `cd`. Utilisez [`${CLAUDE_SKILL_DIR}` ou `${CLAUDE_PROJECT_DIR}`](#available-string-substitutions) dans les chemins qui doivent se résoudre de la même manière à chaque fois.

742* **stderr** : avec le shell `bash` par défaut, Claude Code fusionne stderr dans stdout. Tout ce que la commande écrit dans stderr apparaît dans le texte injecté.742* **stderr** : avec le shell `bash` par défaut, Claude Code fusionne stderr dans stdout. Tout ce que la commande écrit dans stderr apparaît dans le texte injecté.

743* **Délai d'expiration** : chaque commande s'exécute sous le [délai d'expiration](/docs/fr/tools-reference#timeout-and-output-limits) par défaut de 2 minutes de l'outil Bash. Lorsque l'outil Bash [déplace une commande expirée en arrière-plan](/docs/fr/tools-reference#background-commands), la compétence s'affiche toujours. Le texte injecté signale le déplacement et nomme la tâche en arrière-plan et le fichier collectant la sortie de la commande. Lorsque la commande est une que l'outil Bash ne met jamais automatiquement en arrière-plan, Claude Code la tue au délai d'expiration. Cet échec [abandonne l'invocation](#when-an-injected-command-fails).743* **Délai d'expiration** : chaque commande s'exécute sous le [délai d'expiration](/docs/fr/tools-reference#timeout-and-output-limits) par défaut de 2 minutes de l'outil Bash. Lorsque l'outil Bash [déplace une commande expirée en arrière-plan](/docs/fr/tools-reference#foreground-commands-that-move-to-the-background), la compétence s'affiche toujours. Le texte injecté signale le déplacement et nomme la tâche en arrière-plan et le fichier collectant la sortie de la commande. Lorsque la commande est une que l'outil Bash ne met jamais automatiquement en arrière-plan, Claude Code la tue au délai d'expiration. Cet échec [abandonne l'invocation](#when-an-injected-command-fails).

744* **Taille de la sortie** : la sortie au-delà du plafond en ligne de l'outil Bash arrive sous la forme d'un chemin de fichier plus un court aperçu, pas du texte tronqué. [Output limits](/docs/fr/tools-reference#output-limits) couvre le plafond et comment ajuster chaque limite.744* **Taille de la sortie** : la sortie au-delà du plafond en ligne de l'outil Bash arrive sous la forme d'un chemin de fichier plus un court aperçu, pas du texte tronqué. [Output limits](/docs/fr/tools-reference#output-limits) couvre le plafond et comment ajuster chaque limite.

745 745

746L'outil PowerShell applique le même comportement de délai d'expiration, de mise en arrière-plan et de plafond de sortie aux commandes qu'il exécute. Voir la section [outil PowerShell](/docs/fr/tools-reference#powershell-tool) pour ses spécificités.746L'outil PowerShell applique le même comportement de délai d'expiration, de mise en arrière-plan et de plafond de sortie aux commandes qu'il exécute. Voir la section [outil PowerShell](/docs/fr/tools-reference#powershell-tool) pour ses spécificités.

statusline.md +7 −7

Details

20Voici un exemple d'une [barre de statut multi-lignes](#display-multiple-lines) qui affiche les informations git sur la première ligne et une barre de contexte codée par couleur sur la deuxième.20Voici un exemple d'une [barre de statut multi-lignes](#display-multiple-lines) qui affiche les informations git sur la première ligne et une barre de contexte codée par couleur sur la deuxième.

21 21

22<Frame>22<Frame>

23 <img src="https://mintcdn.com/claude-code/nibzesLaJVh4ydOq/images/statusline-multiline.png?fit=max&auto=format&n=nibzesLaJVh4ydOq&q=85&s=60f11387658acc9ff75158ae85f2ac87" alt="Une barre de statut multi-lignes affichant le nom du modèle, le répertoire, la branche git sur la première ligne, et une barre de progression d'utilisation du contexte avec le coût et la durée sur la deuxième ligne" width="776" height="212" data-path="images/statusline-multiline.png" />23 <img src="https://mintcdn.com/claude-code/HDAmBwgbrZVk0pOt/images/statusline-multiline.png?fit=max&auto=format&n=HDAmBwgbrZVk0pOt&q=85&s=a9d0a2fe8e446d80b1abc46da3f93270" alt="Une barre de statut multi-lignes affichant le nom du modèle, le répertoire, la branche git sur la première ligne, et une barre de progression d'utilisation du contexte avec le coût et la durée sur la deuxième ligne" width="1224" height="262" data-path="images/statusline-multiline.png" />

24</Frame>24</Frame>

25 25

26Cette page vous guide à travers [la configuration d'une barre de statut basique](#set-up-a-status-line), explique [comment les données circulent](#how-status-lines-work) de Claude Code à votre script, liste [tous les champs que vous pouvez afficher](#available-data), et fournit [des exemples prêts à l'emploi](#examples) pour les modèles courants comme l'état git, le suivi des coûts et les barres de progression.26Cette page vous guide à travers [la configuration d'une barre de statut basique](#set-up-a-status-line), explique [comment les données circulent](#how-status-lines-work) de Claude Code à votre script, liste [tous les champs que vous pouvez afficher](#available-data), et fournit [des exemples prêts à l'emploi](#examples) pour les modèles courants comme l'état git, le suivi des coûts et les barres de progression.

93Ces exemples utilisent des scripts Bash, qui fonctionnent sur macOS et Linux. Sur Windows, voir [Configuration Windows](#windows-configuration) pour des exemples PowerShell et Git Bash.93Ces exemples utilisent des scripts Bash, qui fonctionnent sur macOS et Linux. Sur Windows, voir [Configuration Windows](#windows-configuration) pour des exemples PowerShell et Git Bash.

94 94

95<Frame>95<Frame>

96 <img src="https://mintcdn.com/claude-code/nibzesLaJVh4ydOq/images/statusline-quickstart.png?fit=max&auto=format&n=nibzesLaJVh4ydOq&q=85&s=696445e59ca0059213250651ad23db6b" alt="Une barre de statut affichant le nom du modèle, le répertoire et le pourcentage de contexte" width="726" height="164" data-path="images/statusline-quickstart.png" />96 <img src="https://mintcdn.com/claude-code/HDAmBwgbrZVk0pOt/images/statusline-quickstart.png?fit=max&auto=format&n=HDAmBwgbrZVk0pOt&q=85&s=88a7eab9c1038dd098ee8e284d96b7e6" alt="Une barre de statut affichant le nom du modèle, le répertoire et le pourcentage de contexte" width="1224" height="224" data-path="images/statusline-quickstart.png" />

97</Frame>97</Frame>

98 98

99<Steps>99<Steps>

444Affiche le modèle actuel et l'utilisation de la fenêtre de contexte avec une barre de progression visuelle. Chaque script lit JSON depuis stdin, extrait le champ `used_percentage` et construit une barre de 10 caractères où les blocs remplis (▓) représentent l'utilisation :444Affiche le modèle actuel et l'utilisation de la fenêtre de contexte avec une barre de progression visuelle. Chaque script lit JSON depuis stdin, extrait le champ `used_percentage` et construit une barre de 10 caractères où les blocs remplis (▓) représentent l'utilisation :

445 445

446<Frame>446<Frame>

447 <img src="https://mintcdn.com/claude-code/nibzesLaJVh4ydOq/images/statusline-context-window-usage.png?fit=max&auto=format&n=nibzesLaJVh4ydOq&q=85&s=15b58ab3602f036939145dde3165c6f7" alt="Une barre de statut affichant le nom du modèle et une barre de progression avec pourcentage" width="448" height="152" data-path="images/statusline-context-window-usage.png" />447 <img src="https://mintcdn.com/claude-code/HDAmBwgbrZVk0pOt/images/statusline-context-window-usage.png?fit=max&auto=format&n=HDAmBwgbrZVk0pOt&q=85&s=f3918a549912dc47e90f2b69e68bc847" alt="Une barre de statut affichant le nom du modèle et une barre de progression avec pourcentage" width="1224" height="224" data-path="images/statusline-context-window-usage.png" />

448</Frame>448</Frame>

449 449

450<CodeGroup>450<CodeGroup>

513Affiche la branche git avec des indicateurs codés par couleur pour les fichiers en attente et modifiés. Ce script utilise les [codes d'échappement ANSI](https://en.wikipedia.org/wiki/ANSI_escape_code#Colors) pour les couleurs de terminal : `\033[32m` est vert, `\033[33m` est jaune, et `\033[0m` réinitialise à la valeur par défaut.513Affiche la branche git avec des indicateurs codés par couleur pour les fichiers en attente et modifiés. Ce script utilise les [codes d'échappement ANSI](https://en.wikipedia.org/wiki/ANSI_escape_code#Colors) pour les couleurs de terminal : `\033[32m` est vert, `\033[33m` est jaune, et `\033[0m` réinitialise à la valeur par défaut.

514 514

515<Frame>515<Frame>

516 <img src="https://mintcdn.com/claude-code/nibzesLaJVh4ydOq/images/statusline-git-context.png?fit=max&auto=format&n=nibzesLaJVh4ydOq&q=85&s=e656f34f90d1d9a1d0e220988914345f" alt="Une barre de statut affichant le modèle, le répertoire, la branche git et des indicateurs colorés pour les fichiers en attente et modifiés" width="742" height="178" data-path="images/statusline-git-context.png" />516 <img src="https://mintcdn.com/claude-code/HDAmBwgbrZVk0pOt/images/statusline-git-context.png?fit=max&auto=format&n=HDAmBwgbrZVk0pOt&q=85&s=f13c190724d9ec7188c17cd2f98b7bf4" alt="Une barre de statut affichant le modèle, le répertoire, la branche git et des indicateurs colorés pour les fichiers en attente et modifiés" width="1224" height="224" data-path="images/statusline-git-context.png" />

517</Frame>517</Frame>

518 518

519Chaque script vérifie si le répertoire actuel est un dépôt git, compte les fichiers en attente et modifiés, et affiche des indicateurs codés par couleur :519Chaque script vérifie si le répertoire actuel est un dépôt git, compte les fichiers en attente et modifiés, et affiche des indicateurs codés par couleur :

611Chaque script formate le coût en devise et convertit les millisecondes en minutes et secondes :611Chaque script formate le coût en devise et convertit les millisecondes en minutes et secondes :

612 612

613<Frame>613<Frame>

614 <img src="https://mintcdn.com/claude-code/nibzesLaJVh4ydOq/images/statusline-cost-tracking.png?fit=max&auto=format&n=nibzesLaJVh4ydOq&q=85&s=e3444a51fe6f3440c134bd5f1f08ad29" alt="Une barre de statut affichant le nom du modèle, le coût de session et la durée" width="588" height="180" data-path="images/statusline-cost-tracking.png" />614 <img src="https://mintcdn.com/claude-code/HDAmBwgbrZVk0pOt/images/statusline-cost-tracking.png?fit=max&auto=format&n=HDAmBwgbrZVk0pOt&q=85&s=925f7024c3b38be0f0eca63564bfb52f" alt="Une barre de statut affichant le nom du modèle, le coût de session et la durée" width="1224" height="224" data-path="images/statusline-cost-tracking.png" />

615</Frame>615</Frame>

616 616

617<CodeGroup>617<CodeGroup>

672Votre script peut afficher plusieurs lignes pour créer un affichage plus riche.672Votre script peut afficher plusieurs lignes pour créer un affichage plus riche.

673 673

674<Frame>674<Frame>

675 <img src="https://mintcdn.com/claude-code/nibzesLaJVh4ydOq/images/statusline-multiline.png?fit=max&auto=format&n=nibzesLaJVh4ydOq&q=85&s=60f11387658acc9ff75158ae85f2ac87" alt="Une barre de statut multi-lignes affichant le nom du modèle, le répertoire, la branche git sur la première ligne, et une barre de progression d'utilisation du contexte avec le coût et la durée sur la deuxième ligne" width="776" height="212" data-path="images/statusline-multiline.png" />675 <img src="https://mintcdn.com/claude-code/HDAmBwgbrZVk0pOt/images/statusline-multiline.png?fit=max&auto=format&n=HDAmBwgbrZVk0pOt&q=85&s=a9d0a2fe8e446d80b1abc46da3f93270" alt="Une barre de statut multi-lignes affichant le nom du modèle, le répertoire, la branche git sur la première ligne, et une barre de progression d'utilisation du contexte avec le coût et la durée sur la deuxième ligne" width="1224" height="262" data-path="images/statusline-multiline.png" />

676</Frame>676</Frame>

677 677

678Cet exemple combine plusieurs techniques : couleurs basées sur des seuils (vert sous 70 %, jaune 70-89 %, rouge 90 %+), une barre de progression et des informations de branche git. Chaque instruction `print` ou `echo` crée une ligne séparée :678Cet exemple combine plusieurs techniques : couleurs basées sur des seuils (vert sous 70 %, jaune 70-89 %, rouge 90 %+), une barre de progression et des informations de branche git. Chaque instruction `print` ou `echo` crée une ligne séparée :

781Cet exemple crée un lien cliquable vers votre dépôt GitHub. Maintenez Cmd (macOS) ou Ctrl (Windows/Linux) et cliquez pour ouvrir le lien dans votre navigateur.781Cet exemple crée un lien cliquable vers votre dépôt GitHub. Maintenez Cmd (macOS) ou Ctrl (Windows/Linux) et cliquez pour ouvrir le lien dans votre navigateur.

782 782

783<Frame>783<Frame>

784 <img src="https://mintcdn.com/claude-code/nibzesLaJVh4ydOq/images/statusline-links.png?fit=max&auto=format&n=nibzesLaJVh4ydOq&q=85&s=4bcc6e7deb7cf52f41ab85a219b52661" alt="Une barre de statut affichant un lien cliquable vers un dépôt GitHub" width="726" height="198" data-path="images/statusline-links.png" />784 <img src="https://mintcdn.com/claude-code/HDAmBwgbrZVk0pOt/images/statusline-links.png?fit=max&auto=format&n=HDAmBwgbrZVk0pOt&q=85&s=4778a144a28cb498c99d5fa018bb374a" alt="Une barre de statut affichant un lien cliquable vers un dépôt GitHub" width="1224" height="224" data-path="images/statusline-links.png" />

785</Frame>785</Frame>

786 786

787Chaque script obtient l'URL du dépôt distant, convertit le format SSH en HTTPS et enveloppe le nom du dépôt dans les codes d'échappement OSC 8. La version Bash utilise `printf '%b'` qui interprète les échappements de barre oblique inverse de manière plus fiable que `echo -e` sur différents shells :787Chaque script obtient l'URL du dépôt distant, convertit le format SSH en HTTPS et enveloppe le nom du dépôt dans les codes d'échappement OSC 8. La version Bash utilise `printf '%b'` qui interprète les échappements de barre oblique inverse de manière plus fiable que `echo -e` sur différents shells :

tools-reference.md +20 −4

Details

174* `BASH_DEFAULT_TIMEOUT_MS` — le délai par défaut quand Claude ne transmet pas de délai d'expiration ; deux minutes par défaut174* `BASH_DEFAULT_TIMEOUT_MS` — le délai par défaut quand Claude ne transmet pas de délai d'expiration ; deux minutes par défaut

175* `BASH_MAX_TIMEOUT_MS` — avec le délai par défaut, définit le plafond qui limite ce que Claude demande : le plafond effectif est le plus grand des deux, dix minutes par défaut175* `BASH_MAX_TIMEOUT_MS` — avec le délai par défaut, définit le plafond qui limite ce que Claude demande : le plafond effectif est le plus grand des deux, dix minutes par défaut

176 176

177Pour une commande que Claude démarre en arrière-plan, `timeout` définit plutôt la durée pendant laquelle la commande peut s'exécuter là, avec le délai par défaut et le maximum séparés décrits sous [Commandes en arrière-plan](#background-commands). L'[outil PowerShell](#powershell-tool) suit les mêmes règles de délai d'expiration et lit les deux mêmes variables.177Pour une commande que Claude démarre en arrière-plan, `timeout` définit plutôt la durée pendant laquelle la commande peut s'exécuter là, avec le délai par défaut et le maximum séparés décrits sous [Limite de temps pour les commandes en arrière-plan](#time-limit-for-background-commands). L'[outil PowerShell](#powershell-tool) suit les mêmes règles de délai d'expiration et lit les deux mêmes variables.

178 178

179<h4 id="output-limits">179<h4 id="output-limits">

180 Limites de sortie180 Limites de sortie

199 199

200Pour les processus de longue durée tels que les serveurs de développement ou les compilations de surveillance, Claude peut définir `run_in_background: true` pour démarrer la commande en tant que tâche en arrière-plan et continuer à travailler pendant qu'elle s'exécute. Listez et arrêtez les tâches en arrière-plan avec `/tasks`. Après en avoir arrêté une là, ou à partir d'un client connecté tel que l'application de bureau, Claude continue au lieu d'attendre. Si un sous-agent a démarré la commande, c'est ce sous-agent qui continue.200Pour les processus de longue durée tels que les serveurs de développement ou les compilations de surveillance, Claude peut définir `run_in_background: true` pour démarrer la commande en tant que tâche en arrière-plan et continuer à travailler pendant qu'elle s'exécute. Listez et arrêtez les tâches en arrière-plan avec `/tasks`. Après en avoir arrêté une là, ou à partir d'un client connecté tel que l'application de bureau, Claude continue au lieu d'attendre. Si un sous-agent a démarré la commande, c'est ce sous-agent qui continue.

201 201

202Une commande qu'un [sous-agent au premier plan](/docs/fr/sub-agents#run-subagents-in-foreground-or-background) a démarrée s'arrête quand l'exécution de ce sous-agent se termine, qu'elle ait réussi, échoué ou ait été interrompue. Une commande que la conversation principale ou un sous-agent en arrière-plan a démarrée continue à s'exécuter après une réponse finale, jusqu'à ce qu'elle se termine, soit arrêtée, ou atteigne sa limite de temps. En mode non interactif avec l'indicateur `-p`, [les commandes en arrière-plan se terminent peu après le résultat final de l'exécution](/docs/fr/headless#background-tasks-at-exit).202<h4 id="when-a-background-command-stops">

203 Quand une commande en arrière-plan s'arrête

204</h4>

205

206Une commande qu'un [sous-agent au premier plan](/docs/fr/sub-agents#run-subagents-in-foreground-or-background) a démarrée s'arrête quand l'exécution de ce sous-agent se termine, qu'elle ait réussi, échoué ou ait été interrompue. Une commande que la conversation principale ou un sous-agent en arrière-plan a démarrée continue à s'exécuter après une réponse finale, jusqu'à ce qu'elle se termine, soit arrêtée, ou atteigne sa [limite de temps](#time-limit-for-background-commands). En mode non interactif avec l'indicateur `-p`, [les commandes en arrière-plan se terminent peu après le résultat final de l'exécution](/docs/fr/headless#background-tasks-at-exit).

207

208<h4 id="time-limit-for-background-commands">

209 Limite de temps pour les commandes en arrière-plan

210</h4>

203 211

204Les commandes Bash et PowerShell en arrière-plan ont une limite de temps, comptée à partir du moment où la commande entre en arrière-plan :212Les commandes Bash et PowerShell en arrière-plan ont une limite de temps, comptée à partir du moment où la commande entre en arrière-plan :

205 213

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

207* Une commande qui démarre au premier plan puis passe en arrière-plan, par exemple avec `Ctrl+B` ou à son délai d'expiration, obtient 30 minutes à partir du passage215* Une commande qui démarre au premier plan puis passe en arrière-plan, par exemple avec `Ctrl+B` ou à son délai d'expiration, obtient 30 minutes à partir du passage

208 216

217Quand une commande en arrière-plan atteint sa limite de temps, Claude Code l'arrête et dit à Claude pourquoi, et Claude peut redémarrer la commande avec un `timeout` plus long si le travail en a encore besoin. L'avis d'arrêt se lit `Background command "<description>" was stopped after reaching its background time limit`.

218

219<h4 id="raise-the-time-limit-for-background-commands">

220 Augmenter la limite de temps pour les commandes en arrière-plan

221</h4>

222

209Deux [variables d'environnement](/docs/fr/env-vars) augmentent ces limites, pour les commandes Bash et PowerShell de la même manière. Les deux prennent des millisecondes, et aucune ne peut raccourcir une limite : une valeur inférieure laisse le délai par défaut de 30 minutes et le maximum de 2 heures en place.223Deux [variables d'environnement](/docs/fr/env-vars) augmentent ces limites, pour les commandes Bash et PowerShell de la même manière. Les deux prennent des millisecondes, et aucune ne peut raccourcir une limite : une valeur inférieure laisse le délai par défaut de 30 minutes et le maximum de 2 heures en place.

210 224

211* Définissez `BASH_DEFAULT_TIMEOUT_MS` au-dessus de `1800000` pour remplacer le délai par défaut de 30 minutes par cette valeur, à la fois pour les commandes que Claude démarre sans `timeout` et pour les commandes déplacées225* Définissez `BASH_DEFAULT_TIMEOUT_MS` au-dessus de `1800000` pour remplacer le délai par défaut de 30 minutes par cette valeur, à la fois pour les commandes que Claude démarre sans `timeout` et pour les commandes déplacées

212* Définissez `BASH_MAX_TIMEOUT_MS` au-dessus de `7200000` pour augmenter le maximum de 2 heures à cette valeur. Définir `BASH_DEFAULT_TIMEOUT_MS` au-dessus de `7200000` augmente le maximum de la même manière226* Définissez `BASH_MAX_TIMEOUT_MS` au-dessus de `7200000` pour augmenter le maximum de 2 heures à cette valeur. Définir `BASH_DEFAULT_TIMEOUT_MS` au-dessus de `7200000` augmente le maximum de la même manière

213 227

214Quand une commande en arrière-plan atteint sa limite de temps, Claude Code l'arrête et dit à Claude pourquoi, et Claude peut redémarrer la commande avec un `timeout` plus long si le travail en a encore besoin. L'avis d'arrêt se lit `Background command "<description>" was stopped after reaching its background time limit`.228<h4 id="foreground-commands-that-move-to-the-background">

229 Commandes au premier plan qui passent en arrière-plan

230</h4>

215 231

216Quand une commande au premier plan atteint son délai d'expiration sans se terminer, Claude Code la déplace en arrière-plan au lieu de l'arrêter, sauf si la commande commence par `sleep`. La limite de temps d'une commande déplacée est comptée à partir du déplacement, et la commande déplacée d'un sous-agent au premier plan s'arrête toujours quand l'exécution de ce sous-agent se termine.232Quand une commande au premier plan atteint son délai d'expiration sans se terminer, Claude Code la déplace en arrière-plan au lieu de l'arrêter, sauf si la commande commence par `sleep`. La [limite de temps](#time-limit-for-background-commands) d'une commande déplacée est comptée à partir du déplacement, et la commande déplacée d'un sous-agent au premier plan s'arrête toujours quand l'exécution de ce sous-agent se termine.

217 233

218Définir [`CLAUDE_CODE_DISABLE_BACKGROUND_TASKS=1`](/docs/fr/env-vars#variables) désactive la mise en arrière-plan automatique ainsi que le reste de la fonctionnalité de tâche en arrière-plan.234Définir [`CLAUDE_CODE_DISABLE_BACKGROUND_TASKS=1`](/docs/fr/env-vars#variables) désactive la mise en arrière-plan automatique ainsi que le reste de la fonctionnalité de tâche en arrière-plan.

219 235

vs-code.md +23 −3

Details

362 362

363Dans l'onglet Plugins :363Dans l'onglet Plugins :

364 364

365* Les **plugins installés** apparaissent en haut avec des commutateurs pour les activer ou les désactiver365* Les **plugins installés** apparaissent en haut avec des commutateurs pour les activer ou les désactiver.

366 * Si vous désactivez un plugin que le fichier `.claude/settings.json` partagé de votre projet active, l'extension vous demande d'abord : **Désactiver pour moi** le désactive uniquement pour vous, tandis que **Désactiver pour tout le monde** modifie le fichier partagé.

366* Les **plugins disponibles** de vos marketplaces configurées apparaissent ci-dessous367* Les **plugins disponibles** de vos marketplaces configurées apparaissent ci-dessous

367* Recherchez pour filtrer les plugins par nom ou description368* Recherchez pour filtrer les plugins par nom ou description

368* Cliquez sur **Installer** sur n'importe quel plugin disponible369* Cliquez sur **Installer** sur n'importe quel plugin disponible

373* **Installer pour ce projet** : partagé avec les collaborateurs du projet (étendue du projet)374* **Installer pour ce projet** : partagé avec les collaborateurs du projet (étendue du projet)

374* **Installer localement** : uniquement pour vous, uniquement dans ce référentiel (étendue locale)375* **Installer localement** : uniquement pour vous, uniquement dans ce référentiel (étendue locale)

375 376

377Une fois l'installation terminée, un formulaire vous demande les [options de configuration](/docs/fr/plugins/components#user-configuration) du plugin qui ne sont pas encore définies. Pour examiner ou modifier les options ultérieurement, cliquez sur l'icône d'engrenage sur la ligne du plugin.

378

379Les champs de texte sensibles sont masqués, et un secret que vous avez enregistré précédemment affiche **(inchangé)**. Laissez le champ vide pour conserver la valeur enregistrée.

380

381Après avoir enregistré les modifications, les sessions ouvertes rechargent leurs plugins et la boîte de dialogue affiche **Redémarrer Claude pour appliquer les modifications de plugin**.

382

383<h3 id="uninstall-plugins">

384 Désinstaller les plugins

385</h3>

386

387Chaque ligne installée indique l'[étendue](/docs/fr/plugins/install#choose-an-install-scope) à laquelle elle est installée. Pour désinstaller cette installation, cliquez sur l'icône de corbeille de la ligne. Une icône de corbeille estompée marque une ligne que vous ne pouvez pas désinstaller de cet espace de travail, comme un plugin que votre organisation gère ou un plugin installé pour un autre projet.

388

389L'extension vous demande d'abord dans deux cas :

390

391* **Un plugin que le fichier `.claude/settings.json` partagé de votre projet active** : choisissez **Désactiver pour moi**, qui garde le plugin installé pour vos collaborateurs, ou **Désinstaller pour tout le monde**, qui supprime l'installation du projet avec [`--keep-data`](/docs/fr/plugins/cli-reference#what-an-uninstall-deletes-and-keeps), de sorte que le répertoire de données enregistrées du plugin reste. Si vous avez déjà désactivé le plugin pour vous-même, l'icône de corbeille supprime votre propre installation sans la question.

392* **Sinon, la dernière installation d'un plugin avec des données enregistrées** : choisissez si vous souhaitez conserver ou supprimer les données ; **Conserver** est la valeur par défaut

393

376<h3 id="share-a-plugin-install-link">394<h3 id="share-a-plugin-install-link">

377 Partager un lien d'installation de plugin395 Partager un lien d'installation de plugin

378</h3>396</h3>

407 425

408* Entrez un référentiel GitHub, une URL ou un chemin local pour ajouter une nouvelle marketplace426* Entrez un référentiel GitHub, une URL ou un chemin local pour ajouter une nouvelle marketplace

409* Cliquez sur l'icône d'actualisation pour mettre à jour la liste des plugins d'une marketplace427* Cliquez sur l'icône d'actualisation pour mettre à jour la liste des plugins d'une marketplace

410* Cliquez sur l'icône de corbeille pour supprimer une marketplace428* Cliquez sur l'icône de corbeille pour supprimer une marketplace. La supprimer [désinstalle tous les plugins que vous avez installés à partir de celle-ci](/docs/fr/plugins/install#manage-marketplaces), donc une confirmation nomme d'abord ces plugins

429

430Les modifications apportées aux plugins dans la boîte de dialogue s'appliquent immédiatement aux sessions Claude Code ouvertes dans cette fenêtre VS Code.

411 431

412Les modifications apportées aux plugins dans la boîte de dialogue s'appliquent immédiatement aux sessions Claude Code ouvertes dans cette fenêtre VS Code. Si la session à partir de laquelle vous avez ouvert la boîte de dialogue ne peut pas recharger ses plugins, la boîte de dialogue vous propose de réessayer ou de redémarrer Claude dans cette session.432Si la session à partir de laquelle vous avez ouvert la boîte de dialogue ne peut pas recharger ses plugins, la boîte de dialogue vous propose de réessayer ou de redémarrer Claude dans cette session.

413 433

414<Note>434<Note>

415 La gestion des plugins dans VS Code utilise les mêmes commandes CLI en arrière-plan. Les plugins et les marketplaces que vous configurez dans l'extension sont également disponibles dans la CLI, et vice versa.435 La gestion des plugins dans VS Code utilise les mêmes commandes CLI en arrière-plan. Les plugins et les marketplaces que vous configurez dans l'extension sont également disponibles dans la CLI, et vice versa.

Documentation 2026-09-30 23:00 UTC to 2026-10-01 04:01 UTC