Documentation — Spybara

agent-sdk/agent-loop.md +6 −6

Details

111Le SDK inclut les mêmes outils qui alimentent Claude Code :111Le SDK inclut les mêmes outils qui alimentent Claude Code :

112 112

114| :-------------------------- | :----------------------------------------------- | :--------------------------------------------------------------------------------------------- |114| :-------------------------- | :-------------------------------------------------------------- | :--------------------------------------------------------------------------------------------- |

118| **Web** | `WebSearch`, `WebFetch` | Rechercher le web, récupérer et analyser des pages |118| **Web** | `WebSearch`, `WebFetch` | Rechercher le web, récupérer et analyser des pages |

120| **Orchestration** | `Agent`, `Skill`, `AskUserQuestion`, `TodoWrite` | Générer des sous-agents, invoquer des compétences, demander à l'utilisateur, suivre les tâches |120| **Orchestration** | `Agent`, `Skill`, `AskUserQuestion`, `TaskCreate`, `TaskUpdate` | Générer des sous-agents, invoquer des compétences, demander à l'utilisateur, suivre les tâches |

121 121

122Au-delà des outils intégrés, vous pouvez :122Au-delà des outils intégrés, vous pouvez :

123 123

204Voici comment chaque composant affecte le contexte dans le SDK :204Voici comment chaque composant affecte le contexte dans le SDK :

205 205

207| :------------------------------ | :------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |207| :------------------------------ | :------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

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

210| **Définitions d'outils** | Chaque requête | Chaque outil ajoute son schéma ; utilisez la [recherche d'outils MCP](/fr/agent-sdk/mcp#mcp-tool-search) pour charger les outils à la demande au lieu de tous à la fois |210| **Définitions d'outils** | Chaque requête ; schémas MCP différés par défaut | Les schémas d'outils intégrés se chargent à chaque requête. La [recherche d'outils](/fr/agent-sdk/mcp#mcp-tool-search) diffère les schémas d'outils MCP par défaut, en revenant au chargement initial sur Vertex AI ou une `ANTHROPIC_BASE_URL` non-propriétaire. Voir [Configurer la recherche d'outils](/fr/agent-sdk/tool-search#configure-tool-search) pour la matrice complète |

213 213

244Quelques stratégies pour les agents de longue durée :244Quelques stratégies pour les agents de longue durée :

245 245

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

247* **Soyez sélectif avec les outils.** Chaque définition d'outil prend de l'espace de contexte. Utilisez le champ `tools` sur [`AgentDefinition`](/fr/agent-sdk/subagents#agentdefinition-configuration) pour délimiter les sous-agents à l'ensemble minimum dont ils ont besoin, et utilisez la [recherche d'outils MCP](/fr/agent-sdk/mcp#mcp-tool-search) pour charger les outils à la demande au lieu de les précharger tous.247* **Soyez sélectif avec les outils.** Chaque définition d'outil prend de l'espace de contexte. Utilisez le champ `tools` sur [`AgentDefinition`](/fr/agent-sdk/subagents#agentdefinition-configuration) pour délimiter les sous-agents à l'ensemble minimum dont ils ont besoin.

248* **Surveillez les coûts des serveurs MCP.** Chaque serveur MCP ajoute tous ses schémas d'outils à chaque requête. Quelques serveurs avec de nombreux outils peuvent consommer un contexte significatif avant que l'agent ne fasse aucun travail. L'outil `ToolSearch` peut aider en chargeant les outils à la demande au lieu de les précharger tous. Voir [Recherche d'outils MCP](/fr/agent-sdk/mcp#mcp-tool-search) pour la configuration.248* **Surveillez les coûts des serveurs MCP.** La [recherche d'outils MCP](/fr/agent-sdk/mcp#mcp-tool-search) diffère les schémas d'outils MCP par défaut et les charge à la demande. Lorsque la recherche d'outils est désactivée, sur Vertex AI, ou derrière une `ANTHROPIC_BASE_URL` non-propriétaire, chaque serveur MCP ajoute tous ses schémas d'outils à chaque requête, donc quelques serveurs avec de nombreux outils peuvent consommer un contexte significatif avant que l'agent ne fasse aucun travail.

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

250 250

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

agent-sdk/python.md +35 −14

Details

19### Comparaison rapide19### Comparaison rapide

20 20

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

32 32

~~33### Quand utiliser `query()` (nouvelle session à chaque fois)~~33### Quand utiliser `query()` (tâches ponctuelles)

34 34

35**Idéal pour :**35**Idéal pour :**

36 36

53 53

54### `query()`54### `query()`

55 55

56Crée une nouvelle session pour chaque interaction avec Claude Code. Retourne un itérateur asynchrone qui produit les messages au fur et à mesure qu'ils arrivent. Chaque appel à `query()` recommence à zéro sans mémoire des interactions précédentes.56Crée une nouvelle session pour chaque interaction avec Claude Code par défaut. Retourne un itérateur asynchrone qui produit les messages au fur et à mesure qu'ils arrivent. Chaque appel à `query()` recommence à zéro sans mémoire des interactions précédentes, sauf si vous passez `continue_conversation=True` ou `resume` dans [`ClaudeAgentOptions`](#claudeagentoptions). Voir [Sessions](/fr/agent-sdk/sessions).

57 57

58```python theme={null}58```python theme={null}

59async def query(59async def query(

790 plugins: list[SdkPluginConfig] = field(default_factory=list)790 plugins: list[SdkPluginConfig] = field(default_factory=list)

791 max_thinking_tokens: int | None = None # Deprecated: use thinking instead791 max_thinking_tokens: int | None = None # Deprecated: use thinking instead

792 thinking: ThinkingConfig | None = None792 thinking: ThinkingConfig | None = None

793 effort: Literal["low", "medium", "high", "xhigh", "max"] | None = None793 effort: EffortLevel | None = None

794 enable_file_checkpointing: bool = False794 enable_file_checkpointing: bool = False

795 session_store: SessionStore | None = None795 session_store: SessionStore | None = None

796 session_store_flush: SessionStoreFlushMode = "batched"796 session_store_flush: SessionStoreFlushMode = "batched"

837| `skills` | `list[str] \| Literal["all"] \| None` | `None` | Compétences disponibles pour la session. Passez `"all"` pour activer chaque compétence découverte, ou une liste de noms de compétences. Quand défini, le SDK active l'outil Skill automatiquement sans le lister dans `allowed_tools`. Voir [Compétences](/fr/agent-sdk/skills) |837| `skills` | `list[str] \| Literal["all"] \| None` | `None` | Compétences disponibles pour la session. Passez `"all"` pour activer chaque compétence découverte, ou une liste de noms de compétences. Quand défini, le SDK active l'outil Skill automatiquement sans le lister dans `allowed_tools`. Voir [Compétences](/fr/agent-sdk/skills) |

841| `session_store` | [`SessionStore`](/fr/agent-sdk/session-storage#the-sessionstore-interface) ` \| None` | `None` | Miroir les transcriptions de session vers un backend externe pour que n'importe quel hôte puisse les reprendre. Voir [Persister les sessions vers un stockage externe](/fr/agent-sdk/session-storage) |841| `session_store` | [`SessionStore`](/fr/agent-sdk/session-storage#the-sessionstore-interface) ` \| None` | `None` | Miroir les transcriptions de session vers un backend externe pour que n'importe quel hôte puisse les reprendre. Voir [Persister les sessions vers un stockage externe](/fr/agent-sdk/session-storage) |

842| `session_store_flush` | `Literal["batched", "eager"]` | `"batched"` | Quand vider les entrées de transcription en miroir vers `session_store`. `"batched"` vide une fois par tour ou quand le buffer se remplit ; `"eager"` déclenche un vidage en arrière-plan après chaque frame. Ignoré quand `session_store` est `None` |842| `session_store_flush` | `Literal["batched", "eager"]` | `"batched"` | Quand vider les entrées de transcription en miroir vers `session_store`. `"batched"` vide une fois par tour ou quand le buffer se remplit ; `"eager"` déclenche un vidage en arrière-plan après chaque frame. Ignoré quand `session_store` est `None` |

843 843

1039 initialPrompt: str | None = None1039 initialPrompt: str | None = None

1040 maxTurns: int | None = None1040 maxTurns: int | None = None

1041 background: bool | None = None1041 background: bool | None = None

1042 effort: Literal["low", "medium", "high", "xhigh", "max"] | int | None = None1042 effort: EffortLevel | int | None = None

1043 permissionMode: PermissionMode | None = None1043 permissionMode: PermissionMode | None = None

1044```1044```

1045 1045

1056| `initialPrompt` | Non | Auto-soumis comme le premier tour utilisateur quand cet agent s'exécute comme l'agent du fil principal |1056| `initialPrompt` | Non | Auto-soumis comme le premier tour utilisateur quand cet agent s'exécute comme l'agent du fil principal |

1057| `maxTurns` | Non | Nombre maximum de tours agentiques avant que l'agent s'arrête |1057| `maxTurns` | Non | Nombre maximum de tours agentiques avant que l'agent s'arrête |

1058| `background` | Non | Exécutez cet agent comme une tâche de fond non-bloquante quand invoqué |1058| `background` | Non | Exécutez cet agent comme une tâche de fond non-bloquante quand invoqué |

1059| `effort` | Non | Niveau d'effort de raisonnement pour cet agent. Accepte un niveau nommé ou un entier |1059| `effort` | Non | Niveau d'effort de raisonnement pour cet agent. Accepte un niveau nommé ou un entier. Voir [`EffortLevel`](#effortlevel) |

1060| `permissionMode` | Non | Mode de permission pour l'exécution des outils dans cet agent. Voir [`PermissionMode`](#permissionmode) |1060| `permissionMode` | Non | Mode de permission pour l'exécution des outils dans cet agent. Voir [`PermissionMode`](#permissionmode) |

1061 1061

1062<Note>1062<Note>

1077]1077]

1078```1078```

1079 1079

1080### `EffortLevel`

1081

1082Niveaux d'effort pour guider la profondeur de réflexion.

1083

1084```python theme={null}

1085EffortLevel = Literal[

1086 "low", # Minimal thinking, fastest responses

1087 "medium", # Moderate thinking

1088 "high", # Deep reasoning

1089 "xhigh", # Extended reasoning (Opus 4.7 only; falls back to "high" on other models)

1090 "max", # Maximum effort

1091]

1092```

1093

1080### `CanUseTool`1094### `CanUseTool`

1081 1095

1082Alias de type pour les fonctions de callback de permission d'outil.1096Alias de type pour les fonctions de callback de permission d'outil.

1224Contrôle le comportement de la réflexion étendue. Une union de trois configurations :1238Contrôle le comportement de la réflexion étendue. Une union de trois configurations :

1225 1239

1226```python theme={null}1240```python theme={null}

1241ThinkingDisplay = Literal["summarized", "omitted"]

1242

1243

1227class ThinkingConfigAdaptive(TypedDict):1244class ThinkingConfigAdaptive(TypedDict):

1228 type: Literal["adaptive"]1245 type: Literal["adaptive"]

1246 display: NotRequired[ThinkingDisplay]

1229 1247

1230 1248

1231class ThinkingConfigEnabled(TypedDict):1249class ThinkingConfigEnabled(TypedDict):

1232 type: Literal["enabled"]1250 type: Literal["enabled"]

1233 budget_tokens: int1251 budget_tokens: int

1252 display: NotRequired[ThinkingDisplay]

1234 1253

1235 1254

1236class ThinkingConfigDisabled(TypedDict):1255class ThinkingConfigDisabled(TypedDict):

1241```1260```

1242 1261

1244| :--------- | :---------------------- | :------------------------------------------------------- |1263| :--------- | :--------------------------------- | :------------------------------------------------------- |

1248 1267

1268Le champ optionnel `display` contrôle si le texte de réflexion est retourné `"summarized"` ou `"omitted"`. Sur Claude Opus 4.7 et ultérieur, la valeur par défaut de l'API est `"omitted"`, donc définissez `"summarized"` pour recevoir le contenu de réflexion dans les sorties [`ThinkingBlock`](#thinkingblock).

1269

1249Parce que ce sont des classes `TypedDict`, ce sont des dicts simples à l'exécution. Construisez-les soit comme des littéraux dict soit appelez la classe comme un constructeur ; les deux produisent un `dict`. Accédez aux champs avec `config["budget_tokens"]`, pas `config.budget_tokens` :1270Parce que ce sont des classes `TypedDict`, ce sont des dicts simples à l'exécution. Construisez-les soit comme des littéraux dict soit appelez la classe comme un constructeur ; les deux produisent un `dict`. Accédez aux champs avec `config["budget_tokens"]`, pas `config.budget_tokens` :

1250 1271

1251```python theme={null}1272```python theme={null}

2177 hookEventName: Literal["PostToolUse"]2198 hookEventName: Literal["PostToolUse"]

2178 additionalContext: NotRequired[str]2199 additionalContext: NotRequired[str]

2179 updatedToolOutput: NotRequired[Any]2200 updatedToolOutput: NotRequired[Any]

2180 updatedMCPToolOutput: NotRequired[Any]2201 updatedMCPToolOutput: NotRequired[Any] # Deprecated: use updatedToolOutput, which works for all tools

2181 2202

2182 2203

2183class PostToolUseFailureHookSpecificOutput(TypedDict):2204class PostToolUseFailureHookSpecificOutput(TypedDict):

2646**Nom de l'outil :** `TodoWrite`2667**Nom de l'outil :** `TodoWrite`

2647 2668

2648<Note>2669<Note>

2649 `TodoWrite` est déprécié et sera supprimé dans une version future. Utilisez `TaskCreate`, `TaskGet`, `TaskUpdate` et `TaskList` à la place. Définissez `CLAUDE_CODE_ENABLE_TASKS=1` pour vous inscrire. Voir [Migrer vers les outils Task](/fr/agent-sdk/todo-tracking#migrate-to-task-tools) pour savoir comment surveiller les modifications du code.2670 À partir de Claude Code v2.1.142, `TodoWrite` est désactivé par défaut. Utilisez `TaskCreate`, `TaskGet`, `TaskUpdate` et `TaskList` à la place. Voir [Migrer vers les outils Task](/fr/agent-sdk/todo-tracking#migrate-to-task-tools) pour mettre à jour votre code de surveillance, ou définissez `CLAUDE_CODE_ENABLE_TASKS=0` pour revenir à `TodoWrite`.

2650</Note>2671</Note>

2651 2672

2652**Entrée :**2673**Entrée :**

agent-sdk/sessions.md +3 −3

Details

46 46

47### Python : `ClaudeSDKClient`47### Python : `ClaudeSDKClient`

48 48

49[`ClaudeSDKClient`](/fr/agent-sdk/python#claudesdkclient) gère les ID de session en interne. Chaque appel à `client.query()` continue automatiquement la même session. Appelez [`client.receive_response()`](/fr/agent-sdk/python#claudesdkclient) pour itérer sur les messages de la requête actuelle. Le client doit être utilisé comme gestionnaire de contexte asynchrone.49[`ClaudeSDKClient`](/fr/agent-sdk/python#claudesdkclient) gère les ID de session en interne. Chaque appel à `client.query()` continue automatiquement la même session. Appelez [`client.receive_response()`](/fr/agent-sdk/python#claudesdkclient) pour itérer sur les messages de la requête actuelle. Le client est généralement utilisé comme gestionnaire de contexte asynchrone.

50 50

51Cet exemple exécute deux requêtes contre le même `client`. La première demande à l'agent d'analyser un module ; la seconde lui demande de refactoriser ce module. Parce que les deux appels passent par la même instance de client, la deuxième requête a le contexte complet de la première sans aucun `resume` ou ID de session explicite :51Cet exemple exécute deux requêtes contre le même `client`. La première demande à l'agent d'analyser un module ; la seconde lui demande de refactoriser ce module. Parce que les deux appels passent par la même instance de client, la deuxième requête a le contexte complet de la première sans aucun `resume` ou ID de session explicite :

52 52

100 100

101### TypeScript : `continue: true`101### TypeScript : `continue: true`

102 102

103Le SDK TypeScript stable (la fonction `query()` utilisée dans tous ces documents, parfois appelée V1) n'a pas d'objet client tenant une session comme le `ClaudeSDKClient` de Python. À la place, passez `continue: true` sur chaque appel `query()` suivant et le SDK reprend la session la plus récente dans le répertoire courant. Aucun suivi d'ID requis.103Le SDK TypeScript n'a pas d'objet client tenant une session comme le `ClaudeSDKClient` de Python. À la place, passez `continue: true` sur chaque appel `query()` suivant et le SDK reprend la session la plus récente dans le répertoire courant. Aucun suivi d'ID requis.

104 104

105Cet exemple effectue deux appels `query()` séparés. Le premier crée une session nouvelle ; le second définit `continue: true`, ce qui indique au SDK de trouver et reprendre la session la plus récente sur le disque. L'agent a le contexte complet du premier appel :105Cet exemple effectue deux appels `query()` séparés. Le premier crée une session nouvelle ; le second définit `continue: true`, ce qui indique au SDK de trouver et reprendre la session la plus récente sur le disque. L'agent a le contexte complet du premier appel :

106 106

132```132```

133 133

134<Note>134<Note>

135 L'API de session V2 expérimentale]\(/fr/agent-sdk/typescript-v2-preview), qui fournissait `createSession()` avec un modèle `send` / `stream`, est dépréciée. Utilisez la fonction V1 `query()` et les options de session décrites sur cette page à la place.135 L'API de session V2 expérimentale [](/fr/agent-sdk/typescript-v2-preview), qui fournissait `createSession()` avec un modèle `send` / `stream`, a été supprimée dans TypeScript Agent SDK 0.3.142. Utilisez la fonction `query()` et les options de session décrites sur cette page à la place.

136</Note>136</Note>

137 137

138## Utiliser les options de session avec `query()`138## Utiliser les options de session avec `query()`

agent-sdk/todo-tracking.md +69 −4

Details

8 8

9Le suivi des tâches fournit un moyen structuré de gérer les tâches et d'afficher la progression aux utilisateurs. Le SDK Claude Agent inclut une fonctionnalité de tâches intégrée qui aide à organiser les flux de travail complexes et à tenir les utilisateurs informés de la progression des tâches.9Le suivi des tâches fournit un moyen structuré de gérer les tâches et d'afficher la progression aux utilisateurs. Le SDK Claude Agent inclut une fonctionnalité de tâches intégrée qui aide à organiser les flux de travail complexes et à tenir les utilisateurs informés de la progression des tâches.

10 10

11<Note>

12 À partir du TypeScript Agent SDK 0.3.142 et Claude Code v2.1.142, les sessions utilisent les outils Task structurés `TaskCreate`, `TaskUpdate`, `TaskGet` et `TaskList` à la place de `TodoWrite`. Consultez [Migrer vers les outils Task](#migrate-to-task-tools) pour savoir comment le code de surveillance change. Les exemples de cette page définissent `CLAUDE_CODE_ENABLE_TASKS=0` pour continuer à afficher `TodoWrite` pour les sessions qui n'ont pas encore migré.

13</Note>

11### Cycle de vie des tâches15### Cycle de vie des tâches

12 16

13Les tâches suivent un cycle de vie prévisible :17Les tâches suivent un cycle de vie prévisible :

36 40

37 for await (const message of query({41 for await (const message of query({

38 prompt: "Optimize my React app performance and track progress with todos",42 prompt: "Optimize my React app performance and track progress with todos",

~~39 options: { maxTurns: 15 }~~43 // Re-enable TodoWrite, which this example monitors. Without it, the SDK uses

44 // Task tools instead and these tool_use blocks never appear.

45 options: { maxTurns: 15, env: { ...process.env, CLAUDE_CODE_ENABLE_TASKS: "0" } }

40 })) {46 })) {

41 // Todo updates are reflected in the message stream47 // Todo updates are reflected in the message stream

42 if (message.type === "assistant") {48 if (message.type === "assistant") {

61 67

62 async for message in query(68 async for message in query(

63 prompt="Optimize my React app performance and track progress with todos",69 prompt="Optimize my React app performance and track progress with todos",

~~64 options=ClaudeAgentOptions(max_turns=15),~~70 # Re-enable TodoWrite, which this example monitors. Without it, the SDK uses

71 # Task tools instead and these tool_use blocks never appear.

72 options=ClaudeAgentOptions(max_turns=15, env={"CLAUDE_CODE_ENABLE_TASKS": "0"}),

65 ):73 ):

66 # Todo updates are reflected in the message stream74 # Todo updates are reflected in the message stream

67 if isinstance(message, AssistantMessage):75 if isinstance(message, AssistantMessage):

112 async trackQuery(prompt: string) {120 async trackQuery(prompt: string) {

113 for await (const message of query({121 for await (const message of query({

114 prompt,122 prompt,

115 options: { maxTurns: 20 }123 // Re-enable TodoWrite, which this tracker watches for.

124 options: { maxTurns: 20, env: { ...process.env, CLAUDE_CODE_ENABLE_TASKS: "0" } }

116 })) {125 })) {

117 if (message.type === "assistant") {126 if (message.type === "assistant") {

118 for (const block of message.message.content) {127 for (const block of message.message.content) {

167 print(f"{i + 1}. {icon} {text}")176 print(f"{i + 1}. {icon} {text}")

168 177

169 async def track_query(self, prompt: str):178 async def track_query(self, prompt: str):

170 async for message in query(prompt=prompt, options=ClaudeAgentOptions(max_turns=20)):179 async for message in query(

180 prompt=prompt,

181 # Re-enable TodoWrite, which this tracker watches for.

182 options=ClaudeAgentOptions(max_turns=20, env={"CLAUDE_CODE_ENABLE_TASKS": "0"}),

183 ):

171 if isinstance(message, AssistantMessage):184 if isinstance(message, AssistantMessage):

172 for block in message.content:185 for block in message.content:

173 if isinstance(block, ToolUseBlock) and block.name == "TodoWrite":186 if isinstance(block, ToolUseBlock) and block.name == "TodoWrite":

181 ```194 ```

182</CodeGroup>195</CodeGroup>

183 196

197## Migrer vers les outils Task

198

199Les outils Task divisent l'appel unique `TodoWrite` en `TaskCreate` pour chaque nouvel élément et `TaskUpdate` pour chaque changement de statut, avec `TaskList` et `TaskGet` disponibles pour que le modèle relise la liste actuelle. Votre code de surveillance inspecte toujours les blocs `tool_use` dans le flux assistant, mais maintient une carte indexée par ID de tâche au lieu de remplacer la liste entière à chaque appel. {/* min-version: 2.1.142 */}Les outils Task sont le défaut à partir du TypeScript Agent SDK 0.3.142 et Claude Code v2.1.142, donc aucun changement `options.env` n'est nécessaire.

200

201| Avec `TodoWrite` | Avec les outils Task |

202| --------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

203| Un appel d'outil réécrit le tableau `todos` complet | `TaskCreate` ajoute un élément, `TaskUpdate` corrige un élément par `taskId` |

204| Correspond à `block.name === "TodoWrite"` | Correspond à `block.name === "TaskCreate"` ou `"TaskUpdate"` |

205| Forme d'élément : `{ content, status, activeForm }` | Entrée `TaskCreate` : `{ subject, description, activeForm?, metadata? }`. Entrée `TaskUpdate` : `{ taskId, status?, subject?, description?, activeForm?, addBlocks?, addBlockedBy?, owner?, metadata? }`. `status` est `"pending"`, `"in_progress"` ou `"completed"` ; définissez `status: "deleted"` pour supprimer |

206| Rendre `block.input.todos` directement | Accumuler les éléments entre les appels, ou lire un instantané à partir d'un résultat d'outil `TaskList` |

207

208L'ID de tâche assigné ne se trouve pas dans l'entrée `TaskCreate`. Il revient dans le bloc `tool_result` correspondant sous la forme `{ task: { id, subject } }`, donc capturez-le à partir du bloc de résultat pour indexer votre carte. L'exemple suivant montre le changement minimal à la boucle [Surveillance des modifications des tâches](#monitoring-todo-changes). Pour rendre une liste complète, regardez un résultat d'outil `TaskList` dans le flux ou accumulez les résultats `TaskCreate` et les entrées `TaskUpdate` dans une carte :

209

210<CodeGroup>

211 ```typescript TypeScript theme={null}

212 import { query } from "@anthropic-ai/claude-agent-sdk";

213

214 for await (const message of query({

215 prompt: "Optimize my React app performance",

216 })) {

217 if (message.type !== "assistant") continue;

218 for (const block of message.message.content) {

219 if (block.type !== "tool_use") continue;

220 if (block.name === "TaskCreate") {

221 const input = block.input as { subject: string };

222 console.log(`+ ${input.subject}`);

223 } else if (block.name === "TaskUpdate") {

224 const input = block.input as { taskId: string; status?: string };

225 if (input.status) console.log(` ${input.taskId} -> ${input.status}`);

226 }

227 }

228 }

229 ```

230

231 ```python Python theme={null}

232 from claude_agent_sdk import query, AssistantMessage, ToolUseBlock

233

234 async for message in query(

235 prompt="Optimize my React app performance",

236 ):

237 if not isinstance(message, AssistantMessage):

238 continue

239 for block in message.content:

240 if not isinstance(block, ToolUseBlock):

241 continue

242 if block.name == "TaskCreate":

243 print(f"+ {block.input['subject']}")

244 elif block.name == "TaskUpdate" and block.input.get("status"):

245 print(f" {block.input['taskId']} -> {block.input['status']}")

246 ```

247</CodeGroup>

248

184## Documentation connexe249## Documentation connexe

185 250

186* [Référence du SDK TypeScript](/fr/agent-sdk/typescript)251* [Référence du SDK TypeScript](/fr/agent-sdk/typescript)

agent-sdk/typescript.md +11 −7

Details

414| `skills` | `string[] \| 'all'` | `undefined` | Compétences disponibles pour la session. Passez `'all'` pour activer chaque compétence découverte, ou une liste de noms de compétences. Quand défini, le SDK active l'outil Skill automatiquement sans le lister dans `allowedTools`. Voir [Compétences](/fr/agent-sdk/skills) |414| `skills` | `string[] \| 'all'` | `undefined` | Compétences disponibles pour la session. Passez `'all'` pour activer chaque compétence découverte, ou une liste de noms de compétences. Quand défini, le SDK active l'outil Skill automatiquement sans le lister dans `allowedTools`. Voir [Compétences](/fr/agent-sdk/skills) |

415| `spawnClaudeCodeProcess` | `(options: SpawnOptions) => SpawnedProcess` | `undefined` | Fonction personnalisée pour générer le processus Claude Code. Utilisez pour exécuter Claude Code dans des VM, des conteneurs ou des environnements distants |415| `spawnClaudeCodeProcess` | `(options: SpawnOptions) => SpawnedProcess` | `undefined` | Fonction personnalisée pour générer le processus Claude Code. Utilisez pour exécuter Claude Code dans des VM, des conteneurs ou des environnements distants |

418| `systemPrompt` | `string \| { type: 'preset'; preset: 'claude_code'; append?: string; excludeDynamicSections?: boolean }` | `undefined` (invite minimale) | Configuration de l'invite système. Passez une chaîne pour une invite personnalisée, ou `{ type: 'preset', preset: 'claude_code' }` pour utiliser l'invite système de Claude Code. Lors de l'utilisation de la forme d'objet prédéfini, ajoutez `append` pour l'étendre avec des instructions supplémentaires, et définissez `excludeDynamicSections: true` pour déplacer le contexte par session dans le premier message utilisateur pour une [meilleure réutilisation du cache d'invite sur les machines](/fr/agent-sdk/modifying-system-prompts#improve-prompt-caching-across-users-and-machines) |418| `systemPrompt` | `string \| { type: 'preset'; preset: 'claude_code'; append?: string; excludeDynamicSections?: boolean }` | `undefined` (invite minimale) | Configuration de l'invite système. Passez une chaîne pour une invite personnalisée, ou `{ type: 'preset', preset: 'claude_code' }` pour utiliser l'invite système de Claude Code. Lors de l'utilisation de la forme d'objet prédéfini, ajoutez `append` pour l'étendre avec des instructions supplémentaires, et définissez `excludeDynamicSections: true` pour déplacer le contexte par session dans le premier message utilisateur pour une [meilleure réutilisation du cache d'invite sur les machines](/fr/agent-sdk/modifying-system-prompts#improve-prompt-caching-across-users-and-machines) |

419| `thinking` | [`ThinkingConfig`](#thinkingconfig) | `{ type: 'adaptive' }` pour les modèles pris en charge | Contrôle le comportement de réflexion/raisonnement de Claude. Voir [`ThinkingConfig`](#thinkingconfig) pour les options |419| `thinking` | [`ThinkingConfig`](#thinkingconfig) | `{ type: 'adaptive' }` pour les modèles pris en charge | Contrôle le comportement de réflexion/raisonnement de Claude. Voir [`ThinkingConfig`](#thinkingconfig) pour les options |

1847Crée et gère une liste de tâches structurée pour suivre la progression.1847Crée et gère une liste de tâches structurée pour suivre la progression.

1848 1848

1849<Note>1849<Note>

1850 `TodoWrite` est déprécié et sera supprimé dans une version future. Utilisez `TaskCreate`, `TaskGet`, `TaskUpdate` et `TaskList` à la place. Définissez `CLAUDE_CODE_ENABLE_TASKS=1` pour accepter. Voir [Migrer vers les outils Task](/fr/agent-sdk/todo-tracking#migrate-to-task-tools) pour savoir comment surveiller les modifications du code.1850 À partir du TypeScript Agent SDK 0.3.142, `TodoWrite` est désactivé par défaut. Utilisez `TaskCreate`, `TaskGet`, `TaskUpdate` et `TaskList` à la place. Voir [Migrer vers les outils Task](/fr/agent-sdk/todo-tracking#migrate-to-task-tools) pour mettre à jour votre code de surveillance, ou définissez `CLAUDE_CODE_ENABLE_TASKS=0` pour revenir à `TodoWrite`.

1851</Note>1851</Note>

1852 1852

1853### TaskCreate1853### TaskCreate

2344Retourne les listes de tâches précédentes et mises à jour.2344Retourne les listes de tâches précédentes et mises à jour.

2345 2345

2346<Note>2346<Note>

2347 `TodoWrite` est déprécié et sera supprimé dans une version future. Utilisez `TaskCreate`, `TaskGet`, `TaskUpdate` et `TaskList` à la place. Définissez `CLAUDE_CODE_ENABLE_TASKS=1` pour accepter. Consultez [Migrer vers les outils Task](/fr/agent-sdk/todo-tracking#migrate-to-task-tools) pour savoir comment surveiller les modifications du code.2347 À partir du TypeScript Agent SDK 0.3.142, `TodoWrite` est désactivé par défaut. Utilisez `TaskCreate`, `TaskGet`, `TaskUpdate` et `TaskList` à la place. Consultez [Migrer vers les outils Task](/fr/agent-sdk/todo-tracking#migrate-to-task-tools) pour mettre à jour votre code de surveillance, ou définissez `CLAUDE_CODE_ENABLE_TASKS=0` pour revenir à `TodoWrite`.

2348</Note>2348</Note>

2349 2349

2350### TaskCreate2350### TaskCreate

2739Contrôle le comportement de réflexion/raisonnement de Claude. Prend la priorité sur le `maxThinkingTokens` déprécié.2739Contrôle le comportement de réflexion/raisonnement de Claude. Prend la priorité sur le `maxThinkingTokens` déprécié.

2740 2740

2741```typescript theme={null}2741```typescript theme={null}

2742type ThinkingDisplay = "summarized" | "omitted";

2743

2742type ThinkingConfig =2744type ThinkingConfig =

2743 | { type: "adaptive" } // Le modèle détermine quand et combien raisonner (Opus 4.6+)2745 | { type: "adaptive"; display?: ThinkingDisplay } // Le modèle détermine quand et combien raisonner (Opus 4.6+)

2744 | { type: "enabled"; budgetTokens?: number } // Budget de token de réflexion fixe2746 | { type: "enabled"; budgetTokens?: number; display?: ThinkingDisplay } // Budget de token de réflexion fixe

2745 | { type: "disabled" }; // Pas de réflexion étendue2747 | { type: "disabled" }; // Pas de réflexion étendue

2746```2748```

2747 2749

2750Le champ `display` optionnel contrôle si le texte de réflexion est retourné `"summarized"` ou `"omitted"`. Sur Claude Opus 4.7 et versions ultérieures, la valeur par défaut de l'API est `"omitted"`, donc définissez `"summarized"` pour recevoir le contenu de réflexion dans les blocs `thinking`.

2751

2748### `SpawnedProcess`2752### `SpawnedProcess`

2749 2753

2750Interface pour la génération de processus personnalisée (utilisée avec l'option `spawnClaudeCodeProcess`). `ChildProcess` satisfait déjà cette interface.2754Interface pour la génération de processus personnalisée (utilisée avec l'option `spawnClaudeCodeProcess`). `ChildProcess` satisfait déjà cette interface.

3158```3162```

3159 3163

3161| :------------------------ | :--------- | :---------- | :-------------------------------------------------------------------------------------------------------------- |3165| :------------------------ | :--------- | :---------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

3164| `allowManagedDomainsOnly` | `boolean` | `false` | Restreindre l'accès réseau uniquement aux domaines dans `allowedDomains` |3168| `allowManagedDomainsOnly` | `boolean` | `false` | Paramètres gérés uniquement. Quand défini dans les [paramètres gérés](/fr/permissions#managed-settings), seules les entrées `allowedDomains` des paramètres gérés sont honorées et les entrées des paramètres utilisateur, projet ou locaux sont ignorées. N'a aucun effet quand défini via les options SDK |

agent-sdk/typescript-v2-preview.md +7 −5

Details

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.3> Use this file to discover all available pages before exploring further.

4 4

~~5# API de session TypeScript SDK V2 (dépréciée)~~5# API de session TypeScript SDK V2 (supprimée)

6 6

~~7> Référence pour l'API de session dépréciée V2 du SDK Agent TypeScript, avec des modèles send/stream basés sur les sessions pour les conversations multi-tours.~~7> Référence pour l'API de session supprimée V2 du SDK Agent TypeScript, avec des modèles send/stream basés sur les sessions pour les conversations multi-tours.

8 8

9<Warning>9<Warning>

10 Les fonctions de l'API de session V2 `unstable_v2_createSession`, `unstable_v2_resumeSession` et `unstable_v2_prompt` sont dépréciées et seront supprimées dans une version future. Utilisez plutôt l'[API V1 `query()`](/fr/agent-sdk/typescript).10 L'API de session V2 n'est plus supportée. TypeScript Agent SDK 0.3.142 supprime `unstable_v2_createSession`, `unstable_v2_resumeSession`, `unstable_v2_prompt`, et les types `SDKSession` et `SDKSessionOptions`.

12 Pour migrer, utilisez l'[API `query()`](/fr/agent-sdk/typescript) et les [options de session](/fr/agent-sdk/sessions) qu'elle accepte. Passez un `AsyncIterable<SDKUserMessage>` pour les conversations multi-tours, ou `options.resume` pour continuer une session sauvegardée. Cette page est conservée à titre de référence si vous maintenez du code sur Agent SDK 0.2.x ou antérieur.

11</Warning>13</Warning>

12 14

13V2 était une API de session expérimentale qui supprimait le besoin de générateurs asynchrones et de coordination de rendement. Au lieu de gérer l'état du générateur entre les tours, chaque tour était un cycle `send()`/`stream()` séparé. La surface de l'API se réduisait à trois concepts :15V2 était une API de session expérimentale qui supprimait le besoin de générateurs asynchrones et de coordination de rendement. Au lieu de gérer l'état du générateur entre les tours, chaque tour était un cycle `send()`/`stream()` séparé. La surface de l'API se réduisait à trois concepts :

18 20

19## Installation21## Installation

20 22

~~21L'interface V2 est incluse dans le package SDK existant :~~23Agent SDK 0.2.x est la dernière version qui inclut l'interface V2. La version du package a sauté de 0.2.x directement à 0.3.142, donc la version de suppression ci-dessus et l'épingle d'installation ci-dessous décrivent la même limite. Pour installer la dernière version compatible avec V2, épinglez la version majeure et mineure :

22 24

23```bash theme={null}25```bash theme={null}

~~24npm install @anthropic-ai/claude-agent-sdk~~26npm install @anthropic-ai/claude-agent-sdk@0.2

25```27```

26 28

27<Note>29<Note>

agent-view.md +74 −23

Details

72 72

73Exécutez `claude agents` pour ouvrir la vue agent. Elle prend le contrôle du terminal complet et répertorie chaque session groupée par état, avec les sessions épinglées et celles qui ont besoin de vous en haut. Chaque ligne affiche le nom de la session, l'activité actuelle, et depuis combien de temps elle a changé pour la dernière fois.73Exécutez `claude agents` pour ouvrir la vue agent. Elle prend le contrôle du terminal complet et répertorie chaque session groupée par état, avec les sessions épinglées et celles qui ont besoin de vous en haut. Chaque ligne affiche le nom de la session, l'activité actuelle, et depuis combien de temps elle a changé pour la dernière fois.

74 74

75La liste affiche chaque session en arrière-plan que vous avez démarrée, dans tous vos projets. Une session travaillant dans un référentiel et une autre dans une worktree différente apparaissent toutes les deux ici, quel que soit le répertoire à partir duquel vous avez ouvert la vue agent. Les sessions interactives que vous avez ouvertes dans d'autres terminaux n'apparaissent pas jusqu'à ce que vous les [mettiez en arrière-plan](#from-inside-a-session). Les [sous-agents](/fr/sub-agents) et les [coéquipiers](/fr/agent-teams) qu'une session génère ne sont pas répertoriés comme des lignes séparées.75Par défaut, la liste affiche chaque session en arrière-plan que vous avez démarrée, dans tous vos projets. Une session travaillant dans un référentiel et une autre dans une worktree différente apparaissent toutes les deux ici, quel que soit le répertoire à partir duquel vous avez ouvert la vue agent. Pour limiter la liste à un projet, passez `--cwd` (nécessite Claude Code v2.1.141 ou ultérieur) :

76 76

77Pour limiter la vue à un projet, lancez avec `claude agents --cwd <path>`. Seules les sessions démarrées sous ce répertoire apparaissent, y compris celles s'exécutant dans une [worktree](/fr/worktrees) lancée à partir de celui-ci.77```bash theme={null}

78claude agents --cwd ~/projects/my-app

79```

81Cela affiche uniquement les sessions démarrées sous ce répertoire. Une session qui a [déménagé dans une worktree](#how-file-edits-are-isolated) sous `~/projects/my-app/.claude/worktrees/` compte toujours comme appartenant à `~/projects/my-app`.

83Les sessions interactives que vous avez ouvertes dans d'autres terminaux n'apparaissent pas jusqu'à ce que vous les [mettiez en arrière-plan](#from-inside-a-session). Les [sous-agents](/fr/sub-agents) et les [coéquipiers](/fr/agent-teams) qu'une session génère ne sont pas répertoriés comme des lignes séparées.

78 84

79```text theme={null}85```text theme={null}

80Épinglées86Épinglées

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

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

119 125

126Le `●` qui peut apparaître au bord droit d'une ligne est l'indicateur de [statut de la pull request](#pull-request-status), pas une partie de l'icône d'état. Un nombre avant lui est le nombre de pull requests que la session a ouvertes.

127

120Les sessions en arrière-plan n'ont besoin d'aucun terminal ouvert pour continuer à fonctionner. Un [processus superviseur](#the-supervisor-process) séparé les exécute, vous pouvez donc fermer la vue agent, fermer votre shell, ou démarrer une nouvelle session interactive et votre travail lancé continue.128Les sessions en arrière-plan n'ont besoin d'aucun terminal ouvert pour continuer à fonctionner. Un [processus superviseur](#the-supervisor-process) séparé les exécute, vous pouvez donc fermer la vue agent, fermer votre shell, ou démarrer une nouvelle session interactive et votre travail lancé continue.

121 129

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

123 131

124### Résumés des lignes132### Résumés des lignes

125 133

158 166

159Se détacher n'arrête jamais une session en arrière-plan : `←`, `Ctrl+C`, `Ctrl+D`, `Ctrl+Z`, et `/exit` la laissent toutes s'exécuter. Pour terminer une session depuis l'intérieur, exécutez `/stop`.167Se détacher n'arrête jamais une session en arrière-plan : `←`, `Ctrl+C`, `Ctrl+D`, `Ctrl+Z`, et `/exit` la laissent toutes s'exécuter. Pour terminer une session depuis l'intérieur, exécutez `/stop`.

160 168

161Une fois que vous avez lancé ou mis en arrière-plan une session, appuyer sur `←` sur une invite vide fonctionne à partir de n'importe quelle session Claude Code, pas seulement celles auxquelles vous vous êtes attaché à partir de la vue agent. Elle met en arrière-plan la session actuelle et ouvre la vue agent avec cette session pré-sélectionnée, vous pouvez donc basculer entre les sessions sans quitter le terminal. Vous pouvez désactiver ce raccourci dans `/config`.169Une fois que vous avez lancé ou mis en arrière-plan une session, appuyer sur `←` sur une invite vide fonctionne à partir de n'importe quelle session Claude Code, pas seulement celles auxquelles vous vous êtes attaché à partir de la vue agent. Elle met en arrière-plan la session actuelle et ouvre la vue agent avec cette ligne sélectionnée, vous pouvez donc basculer entre les sessions sans quitter le terminal. La ligne est créée même à partir d'une session nouvelle sans historique de conversation, donc `→` y revient. Quand cette ligne est la seule, la vue agent affiche un indice d'intégration en dessous. Vous pouvez désactiver ce raccourci dans `/config` (le paramètre `leftArrowOpensAgents`).

162 170

163### Organiser la liste171### Organiser la liste

164 172

173 181

174Pour supprimer une session de la liste, appuyez sur `Ctrl+X` pour l'arrêter et `Ctrl+X` à nouveau dans les deux secondes pour la supprimer. Appuyer sur `Ctrl+X` sur un en-tête de groupe supprime chaque session de ce groupe après confirmation.182Pour supprimer une session de la liste, appuyez sur `Ctrl+X` pour l'arrêter et `Ctrl+X` à nouveau dans les deux secondes pour la supprimer. Appuyer sur `Ctrl+X` sur un en-tête de groupe supprime chaque session de ce groupe après confirmation.

175 183

176La suppression supprime la session de la vue agent et nettoie sa [worktree](#how-file-edits-are-isolated), y compris toutes les modifications non validées qu'elle contient, donc poussez ou validez le travail que vous voulez conserver avant de supprimer. La transcription de la conversation reste sur le disque et reste disponible via `claude --resume`.184La suppression supprime la session de la vue agent et supprime sa transcription de conversation. Si Claude a [créé une worktree](#how-file-edits-are-isolated) pour la session, la suppression supprime également cette worktree, y compris toutes les modifications non validées qu'elle contient, donc poussez ou validez le travail que vous voulez conserver en premier. Une worktree que vous avez créée vous-même et dans laquelle vous avez démarré la session est laissée en place.

177 185

178Les sessions terminées plus anciennes se replient dans une ligne `… N more` pour garder la liste courte. Les échecs et les sessions avec une pull request ouverte restent toujours visibles.186Les sessions terminées plus anciennes se replient dans une ligne `… N more` pour garder la liste courte. Les échecs et les sessions avec une pull request ouverte restent toujours visibles.

179 187

200| `→` | S'attacher à la session sélectionnée |208| `→` | S'attacher à la session sélectionnée |

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

209| `Esc` | Fermer le panneau d'aperçu, effacer l'entrée, ou quitter |217| `Esc` | Fermer le panneau d'aperçu, effacer l'entrée, ou quitter |

251 259

252Mettre en arrière-plan à partir d'une session interactive démarre un processus nouveau qui reprend à partir de la conversation enregistrée, donc l'exécution de sous-agents, de [moniteurs](/fr/tools-reference#monitor-tool), et de commandes en arrière-plan ne se transfèrent pas à celui-ci. Claude vous demande de confirmer avant de mettre en arrière-plan quand l'un d'eux s'exécute. Une fois en arrière-plan, la session peut démarrer de nouveaux sous-agents, moniteurs, et commandes en arrière-plan, et ceux-ci continuent de s'exécuter lors des détachements et réattachements ultérieurs.260Mettre en arrière-plan à partir d'une session interactive démarre un processus nouveau qui reprend à partir de la conversation enregistrée, donc l'exécution de sous-agents, de [moniteurs](/fr/tools-reference#monitor-tool), et de commandes en arrière-plan ne se transfèrent pas à celui-ci. Claude vous demande de confirmer avant de mettre en arrière-plan quand l'un d'eux s'exécute. Une fois en arrière-plan, la session peut démarrer de nouveaux sous-agents, moniteurs, et commandes en arrière-plan, et ceux-ci continuent de s'exécuter lors des détachements et réattachements ultérieurs.

253 261

262Les drapeaux de configuration de la session de lancement d'origine se reportent à la session mise en arrière-plan, donc ses serveurs MCP, paramètres et modèle de secours restent en vigueur :

263

264* `--mcp-config` et `--strict-mcp-config`

265* `--settings`

266* `--add-dir`

267* `--plugin-dir`

268* `--fallback-model`

269* `--allow-dangerously-skip-permissions`

270

271Reporter `--allow-dangerously-skip-permissions` maintient `bypassPermissions` accessible dans la session mise en arrière-plan, mais cela ne confère rien de nouveau. Le mode nécessite toujours la même acceptation interactive unique décrite dans [Mode de permission, modèle et effort](#permission-mode-model-and-effort) avant que toute session puisse l'utiliser.

272

254### À partir du shell273### À partir du shell

255 274

256Passez `--bg` pour démarrer une session qui va directement en arrière-plan :275Passez `--bg` pour démarrer une session qui va directement en arrière-plan :

283 302

284### Comment les modifications de fichiers sont isolées303### Comment les modifications de fichiers sont isolées

285 304

286Chaque session en arrière-plan, qu'elle soit démarrée à partir de la vue agent, `/bg`, ou `claude --bg`, démarre dans votre répertoire de travail. Avant de modifier des fichiers, Claude déplace la session dans une [git worktree](/fr/worktrees) isolée sous `.claude/worktrees/`, afin que les sessions parallèles puissent lire le même checkout mais chacune écrit dans la sienne. Claude ignore cela quand la session est déjà sous `.claude/worktrees/`, quand le répertoire de travail n'est pas un référentiel git, ou pour les écritures en dehors du répertoire de travail.305Chaque session en arrière-plan, qu'elle soit démarrée à partir de la vue agent, `/bg`, ou `claude --bg`, démarre dans votre répertoire de travail. Avant de modifier des fichiers, Claude déplace la session dans une [git worktree](/fr/worktrees) isolée sous `.claude/worktrees/`, afin que les sessions parallèles puissent lire le même checkout mais chacune écrit dans la sienne.

306

307Claude ignore la worktree quand :

308

309* La session est déjà à l'intérieur d'une git worktree liée, que Claude l'ait créée sous `.claude/worktrees/` ou que vous l'ayez créée avec `git worktree add` ailleurs

310* Le répertoire de travail n'est pas un référentiel git

311* L'écriture est en dehors du répertoire de travail

312

313Pour désactiver l'isolation de worktree pour un référentiel où les git worktrees ne sont pas pratiques, définissez [`worktree.bgIsolation`](/fr/settings#worktree-settings) sur `"none"`. Les sessions en arrière-plan modifient alors votre copie de travail directement sans d'abord se déplacer dans une worktree. Ajoutez le paramètre au fichier `.claude/settings.json` du projet :

314

315```json theme={null}

316{

317 "worktree": {

318 "bgIsolation": "none"

319 }

320}

321```

322

323<Note>

324 Le paramètre `worktree.bgIsolation` nécessite Claude Code v2.1.143 ou ultérieur.

325</Note>

287 326

288En dehors d'un référentiel git, les sessions écrivent dans le répertoire de travail directement et ne sont pas isolées les unes des autres, donc évitez de lancer des sessions parallèles qui modifient les mêmes fichiers.327En dehors d'un référentiel git, les sessions écrivent dans le répertoire de travail directement et ne sont pas isolées les unes des autres, donc évitez de lancer des sessions parallèles qui modifient les mêmes fichiers.

289 328

290La worktree est supprimée quand vous supprimez la session, donc fusionnez ou poussez les modifications que vous voulez conserver avant de supprimer. Pour trouver le chemin de la worktree d'une session, jetez un œil à la session ou attachez-vous et vérifiez son répertoire de travail.329Supprimer une session dans la vue agent (`Ctrl+X` deux fois) supprime une worktree que Claude a créée pour elle, y compris les modifications non validées, donc fusionnez ou poussez les modifications que vous voulez conserver d'abord. Supprimer depuis le shell avec [`claude rm`](#manage-sessions-from-the-shell) conserve une worktree qui a des modifications non validées et affiche son chemin pour que vous puissiez la nettoyer vous-même. Une worktree que vous avez créée vous-même et dans laquelle vous avez démarré la session est laissée en place de toute façon.

330

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

291 332

292Pour faire en sorte qu'un sous-agent s'exécute toujours dans sa propre worktree quel que soit le mode de démarrage, définissez [`isolation: worktree`](/fr/sub-agents#supported-frontmatter-fields) dans son frontmatter.333Pour faire en sorte qu'un sous-agent s'exécute toujours dans sa propre worktree quel que soit le mode de démarrage, définissez [`isolation: worktree`](/fr/sub-agents#supported-frontmatter-fields) dans son frontmatter.

293 334

303 344

304### Mode de permission, modèle et effort345### Mode de permission, modèle et effort

305 346

306Une session lancée lit ses [paramètres](/fr/settings) à partir du répertoire dans lequel elle s'exécute, de la même manière que si vous aviez démarré `claude` là.347Une session en arrière-plan lit ses [paramètres](/fr/settings) à partir du répertoire dans lequel elle s'exécute, de la même manière que si vous aviez démarré `claude` là.

307 348

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

309 350

351Le mode de permission avec lequel vous démarrez une session en arrière-plan persiste quand le superviseur [arrête et redémarre](#the-supervisor-process) ultérieurement le processus de la session. Une session que vous avez lancée avec `claude --bg --dangerously-skip-permissions` ou `claude --bg --permission-mode bypassPermissions` reste dans `bypassPermissions` après ce redémarrage au lieu de revenir au `defaultMode` du répertoire.

352

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

311 354

312```bash theme={null}355```bash theme={null}

313claude agents --permission-mode plan --model opus --effort high356claude agents --permission-mode plan --model opus --effort high

314```357```

315 358

359`claude agents` accepte également `--dangerously-skip-permissions` comme raccourci pour `--permission-mode bypassPermissions`, et `--allow-dangerously-skip-permissions` pour rendre `bypassPermissions` disponible dans le cycle `Shift+Tab` de chaque session lancée sans démarrer dans ce mode. Les deux correspondent aux [drapeaux CLI de haut niveau](/fr/cli-reference).

360

316<Note>361<Note>

317 Passer `--permission-mode`, `--model`, ou `--effort` à `claude agents` nécessite Claude Code v2.1.142 ou ultérieur. Les versions antérieures rejettent ces drapeaux avec une erreur unknown-option.362 Passer `--permission-mode`, `--model`, `--effort`, ou `--dangerously-skip-permissions` à `claude agents` nécessite Claude Code v2.1.142 ou ultérieur. {/* min-version: 2.1.143 */}`--allow-dangerously-skip-permissions` sur `claude agents` nécessite v2.1.143 ou ultérieur. Les versions antérieures rejettent ces drapeaux avec une erreur unknown-option.

318</Note>363</Note>

319 364

320Les valeurs par défaut actives apparaissent dans le pied de page sous l'entrée de lancement.365Les valeurs par défaut actives apparaissent dans le pied de page sous l'entrée de lancement.

325 370

326### Paramètres, plugins et serveurs MCP371### Paramètres, plugins et serveurs MCP

327 372

328La vue agent accepte les mêmes drapeaux de configuration que `claude` pour charger les paramètres, les plugins, les serveurs MCP et les répertoires supplémentaires. Chaque drapeau s'applique à la vue agent elle-même et est transmis à chaque session que vous lancez à partir de celle-ci, donc un plugin ou un serveur MCP que vous chargez de cette manière est disponible dans ces sessions aussi.373La vue agent accepte les mêmes drapeaux de configuration que `claude` pour charger les paramètres, les plugins, les serveurs MCP et les répertoires supplémentaires. Ces drapeaux nécessitent Claude Code v2.1.142 ou ultérieur. Chaque drapeau s'applique à la vue agent elle-même et est transmis à chaque session que vous lancez à partir de celle-ci, donc un plugin ou un serveur MCP que vous chargez de cette manière est disponible dans ces sessions aussi.

329 374

330| Drapeau | Effet |375| Drapeau | Effet |

331| :----------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------ |376| :----------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------ |

348Chaque session en arrière-plan a un ID court que vous pouvez utiliser depuis le shell. L'ID est affiché quand vous démarrez une session avec `claude --bg`, et l'ID de chaque session est son nom de répertoire sous `~/.claude/jobs/`. Ces commandes sont utiles pour les scripts ou quand vous ne voulez pas ouvrir la vue agent.393Chaque session en arrière-plan a un ID court que vous pouvez utiliser depuis le shell. L'ID est affiché quand vous démarrez une session avec `claude --bg`, et l'ID de chaque session est son nom de répertoire sous `~/.claude/jobs/`. Ces commandes sont utiles pour les scripts ou quand vous ne voulez pas ouvrir la vue agent.

349 394

350| Commande | Objectif |395| Commande | Objectif |

351| :--------------------- | :---------------------------------------------------------------------------------------------------------- |396| :--------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

398| `claude agents --cwd <path>` | Ouvrir la vue agent limitée aux sessions démarrées sous `<path>` |

356| `claude respawn <id>` | Redémarrer une session arrêtée avec sa conversation intacte |402| `claude respawn <id>` | Redémarrer une session, en cours d'exécution ou arrêtée, avec sa conversation intacte, par exemple pour utiliser un binaire Claude Code mis à jour |

358| `claude rm <id>` | Supprimer une session de la liste. Nettoie sa worktree s'il n'y a pas de modifications non validées |404| `claude rm <id>` | Supprimer une session et sa transcription. Supprime une worktree que Claude a créée pour la session si elle n'a pas de modifications non validées ; sinon affiche le chemin de la worktree pour que vous puissiez la nettoyer. Laisse en place une worktree que vous avez créée vous-même |

405| `claude daemon status` | Afficher l'état du [superviseur](#the-supervisor-process), la version, le répertoire socket et le nombre de workers |

359 406

360## Comment les sessions en arrière-plan sont hébergées407## Comment les sessions en arrière-plan sont hébergées

361 408

383| `~/.claude/daemon/roster.json` | Liste des sessions en arrière-plan en cours d'exécution, utilisée pour se reconnecter après un redémarrage |430| `~/.claude/daemon/roster.json` | Liste des sessions en arrière-plan en cours d'exécution, utilisée pour se reconnecter après un redémarrage |

385 432

433Pour inspecter cet état sans lire les fichiers directement, exécutez `claude daemon status`. Il rapporte si le superviseur est accessible, son ID de processus et sa version, le répertoire socket, et combien de sessions en arrière-plan sont actives. `/doctor` inclut un résumé de la même vérification. Sur Windows, `claude daemon status` affiche l'erreur de fichier sous-jacente quand le fichier de clé pipe du daemon est verrouillé ou illisible au lieu de signaler un échec de connexion générique.

434

386### Désactiver la vue agent435### Désactiver la vue agent

387 436

388Pour désactiver complètement les agents en arrière-plan et la vue agent, définissez le paramètre `disableAgentView` [setting](/fr/settings) à `true` ou définissez la variable d'environnement `CLAUDE_CODE_DISABLE_AGENT_VIEW`. Les administrateurs peuvent appliquer cela via les [paramètres gérés](/fr/permissions#managed-settings).437Pour désactiver complètement les agents en arrière-plan et la vue agent, définissez le paramètre `disableAgentView` [setting](/fr/settings) à `true` ou définissez la variable d'environnement `CLAUDE_CODE_DISABLE_AGENT_VIEW`. Les administrateurs peuvent appliquer cela via les [paramètres gérés](/fr/permissions#managed-settings).

397 446

398### La vue agent s'ouvre sans sessions447### La vue agent s'ouvre sans sessions

399 448

400La vue agent est vide jusqu'à ce que vous lanciez votre première session. Tapez une invite dans l'entrée en bas et appuyez sur `Entrée`.449Avant de lancer votre première session, la vue agent affiche un court indice d'intégration avec des invites d'exemple à la place de la liste des sessions. Tapez une invite dans l'entrée en bas et appuyez sur `Entrée` pour lancer votre première session.

401 450

402### Impossible d'ouvrir les agents car des tâches en arrière-plan s'exécutent451### Impossible d'ouvrir les agents car des tâches en arrière-plan s'exécutent

403 452

407 456

408L'entrée de dispatch attend une description de tâche, pas une ouverture conversationnelle. Une invite plus courte que quatre caractères est rejetée avec un indice `Too short` pour qu'une frappe accidentelle ne démarre pas une session. Décrivez ce que vous voulez que la session fasse, par exemple `investigate the flaky checkout test`.457L'entrée de dispatch attend une description de tâche, pas une ouverture conversationnelle. Une invite plus courte que quatre caractères est rejetée avec un indice `Too short` pour qu'une frappe accidentelle ne démarre pas une session. Décrivez ce que vous voulez que la session fasse, par exemple `investigate the flaky checkout test`.

409 458

410### Les sessions s'affichent comme arrêtées après le réveil de votre machine459### Les sessions s'affichent comme échouées après l'arrêt

460

461L'arrêt ou le redémarrage de votre machine arrête les sessions en arrière-plan en cours d'exécution, elles s'affichent donc comme échouées quand vous ouvrez à nouveau la vue agent. Attachez-vous, apercevez, ou répondez à n'importe laquelle d'entre elles et la session redémarre à partir de là où elle s'était arrêtée.

411 462

412Les sessions en arrière-plan ne survivent pas à la mise en veille ou à l'arrêt. Attachez-vous, apercevez, ou répondez à n'importe quelle session arrêtée et elle redémarre à partir de là où elle s'était arrêtée. Pour les redémarrer toutes à la fois, exécutez `claude respawn --all`.463La mise en veille seule ne cause pas cela. Les sessions sont préservées lors de la mise en veille et le superviseur se reconnecte à elles au réveil.

413 464

414### Une session est lente à répondre après l'attachement465### Une session est lente à répondre après l'attachement

415 466

417 468

418### `.claude/worktrees/` se remplit469### `.claude/worktrees/` se remplit

419 470

420Les worktrees sont supprimées quand vous supprimez la session qui les a créées. Si une session s'est terminée sans nettoyer, listez les entrées restantes avec `git worktree list` dans le répertoire du projet et supprimez chacune avec `git worktree remove <path>`. Voir [Nettoyer les worktrees](/fr/worktrees#clean-up-worktrees).471Supprimer une session dans la vue agent supprime la worktree que Claude a créée pour elle. `claude rm` conserve une worktree qui a des modifications non validées et affiche son chemin. Listez les entrées restantes avec `git worktree list` dans le répertoire du projet et supprimez chacune avec `git worktree remove <path>`. Voir [Nettoyer les worktrees](/fr/worktrees#clean-up-worktrees).

421 472

422## Limitations473## Limitations

423 474

424La vue agent est en aperçu de recherche avec les limitations suivantes :475La vue agent est en aperçu de recherche avec les limitations suivantes :

425 476

426* **Les limites de débit s'appliquent** : les sessions en arrière-plan consomment votre utilisation d'abonnement de la même manière que les sessions interactives, donc exécuter dix agents en parallèle utilise le quota environ dix fois plus vite qu'en exécuter un seul.477* **Les limites de débit s'appliquent** : les sessions en arrière-plan consomment votre utilisation d'abonnement de la même manière que les sessions interactives, donc exécuter dix agents en parallèle utilise le quota environ dix fois plus vite qu'en exécuter un seul.

427* **Les sessions sont locales** : les sessions en arrière-plan s'exécutent sur votre machine et s'arrêtent si elle se met en veille ou s'éteint.478* **Les sessions sont locales** : les sessions en arrière-plan s'exécutent sur votre machine. Elles sont préservées lors de la mise en veille mais s'arrêtent si la machine s'éteint.

428* **Les worktrees sont supprimées avec la session** : fusionnez ou poussez les modifications avant de supprimer une session qui a modifié des fichiers dans sa propre worktree.479* **Les worktrees créées par Claude sont supprimées avec la session en vue agent** : fusionnez ou poussez les modifications avant de supprimer une session qui a modifié des fichiers dans sa propre worktree. `claude rm` conserve une worktree qui a des modifications non validées ; une worktree que vous avez créée vous-même est laissée en place.

429 480

430## Ressources connexes481## Ressources connexes

431 482

cli-reference.md +4 −3

Details

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

26| `claude auth status` | Afficher l'état d'authentification en JSON. Utilisez `--text` pour une sortie lisible par l'homme. Quitte avec le code 0 si connecté, 1 sinon | `claude auth status` |26| `claude auth status` | Afficher l'état d'authentification en JSON. Utilisez `--text` pour une sortie lisible par l'homme. Quitte avec le code 0 si connecté, 1 sinon | `claude auth status` |

27| `claude agents` | Ouvrir la [vue agent](/fr/agent-view) pour surveiller et dispatcher les sessions d'arrière-plan parallèles. Utilisez `--cwd <path>` pour afficher uniquement les sessions démarrées sous ce répertoire | `claude agents` |27| `claude agents` | Ouvrir la [vue agent](/fr/agent-view) pour surveiller et dispatcher les sessions d'arrière-plan parallèles. Utilisez `--cwd <path>` pour afficher uniquement les sessions démarrées sous ce répertoire. Passez `--permission-mode`, `--model`, ou `--effort` pour définir les [valeurs par défaut pour les sessions dispatched](/fr/agent-view#permission-mode-model-and-effort). Accepte `--settings`, `--add-dir`, `--plugin-dir`, et `--mcp-config` comme la commande `claude` de niveau supérieur. Nécessite un terminal interactif | `claude agents --cwd ~/projects/my-app` |

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

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

32| `claude plugin` | Gérer les [plugins](/fr/plugins) Claude Code. Alias : `claude plugins`. Voir la [référence des plugins](/fr/plugins-reference#cli-commands-reference) pour les sous-commandes | `claude plugin install code-review@claude-plugins-official` |33| `claude plugin` | Gérer les [plugins](/fr/plugins) Claude Code. Alias : `claude plugins`. Voir la [référence des plugins](/fr/plugins-reference#cli-commands-reference) pour les sous-commandes | `claude plugin install code-review@claude-plugins-official` |

33| `claude project purge [path]` | Supprimer tout l'état local de Claude Code pour un projet : transcriptions, listes de tâches, journaux de débogage, historique des modifications de fichiers, lignes d'historique des invites, et l'entrée du projet dans `~/.claude.json`. Omettez `[path]` pour choisir dans une liste interactive. Drapeaux : `--dry-run` pour prévisualiser, `-y`/`--yes` pour ignorer la confirmation, `-i`/`--interactive` pour confirmer chaque élément, `--all` pour chaque projet. Voir [Effacer les données locales](/fr/claude-directory#clear-local-data) | `claude project purge ~/work/repo --dry-run` |34| `claude project purge [path]` | Supprimer tout l'état local de Claude Code pour un projet : transcriptions, listes de tâches, journaux de débogage, historique des modifications de fichiers, lignes d'historique des invites, et l'entrée du projet dans `~/.claude.json`. Omettez `[path]` pour choisir dans une liste interactive. Drapeaux : `--dry-run` pour prévisualiser, `-y`/`--yes` pour ignorer la confirmation, `-i`/`--interactive` pour confirmer chaque élément, `--all` pour chaque projet. Voir [Effacer les données locales](/fr/claude-directory#clear-local-data) | `claude project purge ~/work/repo --dry-run` |

34| `claude remote-control` | Démarrer un serveur [Remote Control](/fr/remote-control) pour contrôler Claude Code depuis Claude.ai ou l'application Claude. S'exécute en mode serveur (pas de session interactive locale). Voir [Drapeaux du mode serveur](/fr/remote-control#start-a-remote-control-session) | `claude remote-control --name "My Project"` |35| `claude remote-control` | Démarrer un serveur [Remote Control](/fr/remote-control) pour contrôler Claude Code depuis Claude.ai ou l'application Claude. S'exécute en mode serveur (pas de session interactive locale). Voir [Drapeaux du mode serveur](/fr/remote-control#start-a-remote-control-session) | `claude remote-control --name "My Project"` |

35| `claude respawn <id>` | Redémarrer une [session d'arrière-plan](/fr/agent-view#manage-sessions-from-the-shell) arrêtée avec sa conversation intacte. Utilisez `--all` pour redémarrer chaque session arrêtée | `claude respawn 7c5dcf5d` |36| `claude respawn <id>` | Redémarrer une [session d'arrière-plan](/fr/agent-view#manage-sessions-from-the-shell), en cours d'exécution ou arrêtée, avec sa conversation intacte. Utilisez `--all` pour redémarrer chaque session en cours d'exécution, par exemple pour récupérer un binaire Claude Code mis à jour | `claude respawn 7c5dcf5d` |

37| `claude setup-token` | Générer un jeton OAuth de longue durée pour CI et les scripts. Imprime le jeton sur le terminal sans l'enregistrer. Nécessite un abonnement Claude. Voir [Générer un jeton de longue durée](/fr/authentication#generate-a-long-lived-token) | `claude setup-token` |38| `claude setup-token` | Générer un jeton OAuth de longue durée pour CI et les scripts. Imprime le jeton sur le terminal sans l'enregistrer. Nécessite un abonnement Claude. Voir [Générer un jeton de longue durée](/fr/authentication#generate-a-long-lived-token) | `claude setup-token` |

68| `--effort` | Définir le [niveau d'effort](/fr/model-config#adjust-effort-level) pour la session actuelle. Options : `low`, `medium`, `high`, `xhigh`, `max` ; les niveaux disponibles dépendent du modèle. Remplace le paramètre [`effortLevel`](/fr/settings#available-settings) pour cette session et ne persiste pas | `claude --effort high` |69| `--effort` | Définir le [niveau d'effort](/fr/model-config#adjust-effort-level) pour la session actuelle. Options : `low`, `medium`, `high`, `xhigh`, `max` ; les niveaux disponibles dépendent du modèle. Remplace le paramètre [`effortLevel`](/fr/settings#available-settings) pour cette session et ne persiste pas | `claude --effort high` |

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

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

71| `--fallback-model` | Activer le basculement automatique vers le modèle spécifié lorsque le modèle par défaut est surchargé (mode impression uniquement) | `claude -p --fallback-model sonnet "query"` |72| `--fallback-model` | Activer le basculement automatique vers un modèle spécifié lorsque le modèle par défaut est surchargé. Prend effet en mode impression (`-p`) et dans les [sessions en arrière-plan](/fr/agent-view), qui s'exécutent de manière non interactive ; ignoré dans une session interactive | `claude -p --fallback-model sonnet "query"` |

72| `--fork-session` | Lors de la reprise, créer un nouvel ID de session au lieu de réutiliser l'original (à utiliser avec `--resume` ou `--continue`) | `claude --resume abc123 --fork-session` |73| `--fork-session` | Lors de la reprise, créer un nouvel ID de session au lieu de réutiliser l'original (à utiliser avec `--resume` ou `--continue`) | `claude --resume abc123 --fork-session` |

73| `--from-pr` | Reprendre les sessions liées à une demande de tirage spécifique. Accepte un numéro de PR, une URL GitHub ou GitHub Enterprise PR, une URL de demande de fusion GitLab, ou une URL de demande de tirage Bitbucket. Les sessions sont automatiquement liées lorsque Claude crée la demande de tirage | `claude --from-pr 123` |74| `--from-pr` | Reprendre les sessions liées à une demande de tirage spécifique. Accepte un numéro de PR, une URL GitHub ou GitHub Enterprise PR, une URL de demande de fusion GitLab, ou une URL de demande de tirage Bitbucket. Les sessions sont automatiquement liées lorsque Claude crée la demande de tirage | `claude --from-pr 123` |

74| `--ide` | Se connecter automatiquement à l'IDE au démarrage s'il y a exactement un IDE valide disponible | `claude --ide` |75| `--ide` | Se connecter automatiquement à l'IDE au démarrage s'il y a exactement un IDE valide disponible | `claude --ide` |

code-review.md +6 −6

Details

29 29

30Une fois qu'un administrateur [active Code Review](#set-up-code-review) pour votre organisation, les révisions se déclenchent à l'ouverture d'une PR, à chaque push, ou sur demande manuelle, selon le comportement configuré du référentiel. Commenter `@claude review` [démarre les révisions sur une PR](#manually-trigger-reviews) dans n'importe quel mode.30Une fois qu'un administrateur [active Code Review](#set-up-code-review) pour votre organisation, les révisions se déclenchent à l'ouverture d'une PR, à chaque push, ou sur demande manuelle, selon le comportement configuré du référentiel. Commenter `@claude review` [démarre les révisions sur une PR](#manually-trigger-reviews) dans n'importe quel mode.

31 31

32Lorsqu'une révision s'exécute, plusieurs agents analysent le diff et le code environnant en parallèle sur l'infrastructure Anthropic. Chaque agent recherche une classe de problème différente, puis une étape de vérification vérifie les candidats par rapport au comportement réel du code pour filtrer les faux positifs. Les résultats sont dédupliqués, classés par gravité et publiés sous forme de commentaires en ligne sur les lignes spécifiques où les problèmes ont été trouvés, avec un résumé dans le corps de la révision. Si aucun problème n'est trouvé, Claude publie un court commentaire de confirmation sur la PR.32Lorsqu'une révision s'exécute, plusieurs agents analysent le diff et le code environnant en parallèle sur l'infrastructure Anthropic. Chaque agent recherche une classe de problème différente, puis une étape de vérification vérifie les candidats par rapport au comportement réel du code pour filtrer les faux positifs. Les résultats sont dédupliqués, classés par gravité et publiés sous forme de commentaires en ligne sur les lignes spécifiques où les problèmes ont été trouvés, avec un résumé dans le corps de la révision. Si aucun problème n'est trouvé, Code Review met à jour la vérification GitHub pour montrer qu'aucun problème n'a été détecté. Claude peut également publier un court commentaire de confirmation sur la PR.

33 33

34Les révisions s'adaptent en coût à la taille et à la complexité de la PR, se complétant en moyenne en 20 minutes. Les administrateurs peuvent surveiller l'activité de révision et les dépenses via le [tableau de bord analytique](#view-usage).34Les révisions s'adaptent en coût à la taille et à la complexité de la PR, se complétant en moyenne en 20 minutes. Les administrateurs peuvent surveiller l'activité de révision et les dépenses via le [tableau de bord analytique](#view-usage).

35 35

231 231

232## Tarification232## Tarification

233 233

234Code Review est facturé en fonction de l'utilisation des tokens. Chaque révision coûte en moyenne 15 à 25 dollars, s'adaptant à la taille de la PR, à la complexité de la base de code, et au nombre de problèmes nécessitant une vérification. L'utilisation de Code Review est facturée séparément via [extra usage](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) et ne compte pas par rapport à l'utilisation incluse de votre plan.234Code Review est facturé en fonction de l'utilisation des tokens. Chaque révision coûte en moyenne 15 à 25 dollars, s'adaptant à la taille de la PR, à la complexité de la base de code, et au nombre de problèmes nécessitant une vérification. L'utilisation de Code Review est facturée séparément via [crédits d'utilisation](https://support.claude.com/fr/articles/12429409-extra-usage-for-paid-claude-plans) et ne compte pas par rapport à l'utilisation incluse de votre plan.

235 235

236Le déclencheur de révision que vous choisissez affecte le coût total :236Le déclencheur de révision que vous choisissez affecte le coût total :

237 237

238* **Once after PR creation** : s'exécute une fois par PR238* **Une fois après la création de la PR** : s'exécute une fois par PR

239* **After every push** : s'exécute à chaque push, multipliant le coût par le nombre de pushes239* **Après chaque push** : s'exécute à chaque push, multipliant le coût par le nombre de pushes

240* **Manual** : aucune révision jusqu'à ce que quelqu'un commente `@claude review` sur une PR240* **Manuel** : aucune révision jusqu'à ce que quelqu'un commente `@claude review` sur une PR

241 241

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

243 243

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

245 245

commands.md +1 −1

Details

63| `/effort [level\|auto]` | Définir le [niveau d'effort](/fr/model-config#adjust-effort-level) du modèle. Accepte `low`, `medium`, `high`, `xhigh`, ou `max` ; les niveaux disponibles dépendent du modèle et `max` est limité à la session. `auto` réinitialise à la valeur par défaut du modèle. Sans argument, ouvre un curseur interactif ; utilisez les flèches gauche et droite pour choisir un niveau et `Entrée` pour appliquer. Prend effet immédiatement sans attendre la fin de la réponse actuelle |63| `/effort [level\|auto]` | Définir le [niveau d'effort](/fr/model-config#adjust-effort-level) du modèle. Accepte `low`, `medium`, `high`, `xhigh`, ou `max` ; les niveaux disponibles dépendent du modèle et `max` est limité à la session. `auto` réinitialise à la valeur par défaut du modèle. Sans argument, ouvre un curseur interactif ; utilisez les flèches gauche et droite pour choisir un niveau et `Entrée` pour appliquer. Prend effet immédiatement sans attendre la fin de la réponse actuelle |

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

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

66| `/extra-usage` | Configurer l'utilisation supplémentaire pour continuer à travailler lorsque les limites de débit sont atteintes |

67| `/fast [on\|off]` | Activer ou désactiver le [mode rapide](/fr/fast-mode) |66| `/fast [on\|off]` | Activer ou désactiver le [mode rapide](/fr/fast-mode) |

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

125| `/ultrareview [PR]` | Exécuter un examen de code approfondi multi-agents dans un sandbox cloud avec [ultrareview](/fr/ultrareview). Inclut 3 exécutions gratuites sur Pro et Max, puis nécessite [l'utilisation supplémentaire](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) |124| `/ultrareview [PR]` | Exécuter un examen de code approfondi multi-agents dans un sandbox cloud avec [ultrareview](/fr/ultrareview). Inclut 3 exécutions gratuites sur Pro et Max, puis nécessite [l'utilisation supplémentaire](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) |

127| `/usage` | Afficher le coût de la session, les limites d'utilisation du plan et les statistiques d'activité. Consultez le [guide de suivi des coûts](/fr/costs#using-the-%2Fusage-command) pour les détails spécifiques à l'abonnement. `/cost` et `/stats` sont des alias |126| `/usage` | Afficher le coût de la session, les limites d'utilisation du plan et les statistiques d'activité. Consultez le [guide de suivi des coûts](/fr/costs#using-the-%2Fusage-command) pour les détails spécifiques à l'abonnement. `/cost` et `/stats` sont des alias |

127| `/usage-credits` | Configurer les crédits d'utilisation pour continuer à travailler lorsque vous atteignez une limite. Anciennement `/extra-usage` |

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

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

130| `/web-setup` | Connecter votre compte GitHub à [Claude Code sur le web](/fr/web-quickstart#connect-from-your-terminal) en utilisant vos identifiants CLI `gh` locaux. `/schedule` demande cela automatiquement si GitHub n'est pas connecté |130| `/web-setup` | Connecter votre compte GitHub à [Claude Code sur le web](/fr/web-quickstart#connect-from-your-terminal) en utilisant vos identifiants CLI `gh` locaux. `/schedule` demande cela automatiquement si GitHub n'est pas connecté |

debug-your-config.md +3 −3

Details

87La plupart des surprises de configuration remontent à un petit ensemble de règles d'emplacement et de syntaxe. Vérifiez-les avant de supposer un bogue :87La plupart des surprises de configuration remontent à un petit ensemble de règles d'emplacement et de syntaxe. Vérifiez-les avant de supposer un bogue :

88 88

90| :------------------------------------------------------------------------------------ | :--------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |90| :------------------------------------------------------------------------------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

92| Le hook ne se déclenche jamais | La valeur `matcher` est en minuscules, par exemple `"bash"` | La correspondance est sensible à la casse. Les noms d'outils sont en majuscules : `Bash`, `Edit`, `Write`, `Read`. |92| Le hook ne se déclenche jamais | La valeur `matcher` est en minuscules, par exemple `"bash"` | La correspondance est sensible à la casse. Les noms d'outils sont en majuscules : `Bash`, `Edit`, `Write`, `Read`. |

93| Le hook ne se déclenche jamais | Les hooks sont dans un fichier `.claude/hooks.json` autonome | Il n'y a pas de fichier hooks autonome. Définissez les hooks sous la clé `"hooks"` dans `settings.json`. Consultez [hook configuration](/fr/hooks). |93| Le hook ne se déclenche jamais | Les hooks sont définis dans un fichier autonome au lieu de `settings.json` | Il n'y a pas de fichier hooks autonome pour la configuration du projet ou de l'utilisateur. Définissez les hooks sous la clé `"hooks"` dans `settings.json`. Seuls les [plugins](/fr/plugins-reference#hooks) chargent un fichier `hooks/hooks.json` séparé. Consultez [hook configuration](/fr/hooks). |

94| Les permissions, hooks ou env définis globalement sont ignorés | La configuration a été ajoutée à `~/.claude.json` | `~/.claude.json` contient l'état de l'application et les bascules d'interface utilisateur. `permissions`, `hooks` et `env` appartiennent à `~/.claude/settings.json`. Ce sont deux fichiers différents. |94| Les permissions, hooks ou env définis globalement sont ignorés | La configuration a été ajoutée à `~/.claude.json` | `~/.claude.json` contient l'état de l'application et les bascules d'interface utilisateur. `permissions`, `hooks` et `env` appartiennent à `~/.claude/settings.json`. Ce sont deux fichiers différents. |

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

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

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

98| Les instructions du sous-répertoire `CLAUDE.md` semblent ignorées | Les fichiers du sous-répertoire se chargent à la demande, pas au démarrage de la session | Ils se chargent quand Claude lit un fichier dans ce répertoire avec l'outil Read, pas au lancement et pas lors de l'écriture ou de la création de fichiers là-bas. Consultez [how CLAUDE.md files load](/fr/memory#how-claude-md-files-load). |98| Les instructions du sous-répertoire `CLAUDE.md` semblent ignorées | Les fichiers du sous-répertoire se chargent à la demande, pas au démarrage de la session | Ils se chargent quand Claude lit un fichier dans ce répertoire avec l'outil Read, pas au lancement et pas lors de l'écriture ou de la création de fichiers là-bas. Consultez [how CLAUDE.md files load](/fr/memory#how-claude-md-files-load). |

99| Le sous-agent ignore les instructions `CLAUDE.md` | Les sous-agents n'héritent pas toujours de la mémoire du projet | Mettez les règles critiques dans le corps du fichier agent, qui devient l'invite système du sous-agent. Consultez [subagent configuration](/fr/sub-agents). |99| Le sous-agent ignore les instructions `CLAUDE.md` | Les agents Explore et Plan intégrés ignorent `CLAUDE.md`. Les sous-agents personnalisés le chargent de la même manière que la conversation principale | Pour Explore ou Plan, reformulez l'instruction dans votre invite de délégation. Pour un sous-agent personnalisé, mettez les instructions critiques dans le corps du fichier agent, qui devient l'invite système du sous-agent. Consultez [what loads at startup](/fr/sub-agents#what-loads-at-startup). |

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

101| Les serveurs MCP dans `.mcp.json` ne se chargent jamais | Le fichier est sous `.claude/` ou utilise le format de configuration de Claude Desktop | La configuration MCP du projet va à la racine du référentiel sous `.mcp.json`, pas à l'intérieur de `.claude/`. Consultez [MCP configuration](/fr/mcp). |101| Les serveurs MCP dans `.mcp.json` ne se chargent jamais | Le fichier est sous `.claude/` ou utilise le format de configuration de Claude Desktop | La configuration MCP du projet va à la racine du référentiel sous `.mcp.json`, pas à l'intérieur de `.claude/`. Consultez [MCP configuration](/fr/mcp). |

102| Les serveurs MCP ajoutés sous `mcpServers` dans `settings.json` n'apparaissent jamais | `settings.json` ne lit pas une clé `mcpServers` | Définissez les serveurs du projet dans `.mcp.json` à la racine du référentiel, ou exécutez `claude mcp add --scope user` pour les serveurs à portée utilisateur. Consultez [MCP configuration](/fr/mcp). |102| Les serveurs MCP ajoutés sous `mcpServers` dans `settings.json` n'apparaissent jamais | `settings.json` ne lit pas une clé `mcpServers` | Définissez les serveurs du projet dans `.mcp.json` à la racine du référentiel, ou exécutez `claude mcp add --scope user` pour les serveurs à portée utilisateur. Consultez [MCP configuration](/fr/mcp). |

desktop.md +2 −1

Details

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.3> Use this file to discover all available pages before exploring further.

4 4

~~5# Utiliser Claude Code Desktop~~5# Application de bureau

6 6

7> Tirez le meilleur parti de Claude Code Desktop : sessions parallèles avec isolation Git, disposition des volets par glisser-déposer, terminal intégré et éditeur de fichiers, chats latéraux, utilisation informatique, sessions Dispatch depuis votre téléphone, examen visuel des différences, aperçus d'applications, surveillance des PR, connecteurs et configuration d'entreprise.7> Tirez le meilleur parti de Claude Code Desktop : sessions parallèles avec isolation Git, disposition des volets par glisser-déposer, terminal intégré et éditeur de fichiers, chats latéraux, utilisation informatique, sessions Dispatch depuis votre téléphone, examen visuel des différences, aperçus d'applications, surveillance des PR, connecteurs et configuration d'entreprise.

8 8

707* **Linux** : l'application de bureau est disponible sur macOS et Windows uniquement. Sur Linux, utilisez la [CLI](/fr/quickstart).707* **Linux** : l'application de bureau est disponible sur macOS et Windows uniquement. Sur Linux, utilisez la [CLI](/fr/quickstart).

708* **Suggestions de code en ligne** : Desktop ne fournit pas de suggestions de style autocomplétion. Il fonctionne via des prompts conversationnels et des modifications de code explicites.708* **Suggestions de code en ligne** : Desktop ne fournit pas de suggestions de style autocomplétion. Il fonctionne via des prompts conversationnels et des modifications de code explicites.

709* **Équipes d'agents** : l'orchestration multi-agents est disponible via la [CLI](/fr/agent-teams) et [Agent SDK](/fr/headless), pas dans Desktop.709* **Équipes d'agents** : l'orchestration multi-agents est disponible via la [CLI](/fr/agent-teams) et [Agent SDK](/fr/headless), pas dans Desktop.

710* **Commandes de dialogue terminal** : les commandes intégrées qui ouvrent un panneau interactif dans le terminal, telles que `/permissions`, `/config`, `/agents` et `/doctor`, ne sont pas disponibles dans l'onglet Code et répondent avec `n'est pas disponible dans cet environnement`. Modifiez les [fichiers de paramètres](/fr/settings) directement pour gérer les règles de permission et la configuration, ou exécutez la commande à partir de la CLI autonome.

710 711

711## Dépannage712## Dépannage

712 713

discover-plugins.md +3 −1

Details

138 </Step>138 </Step>

139 139

140 <Step title="Installer un plugin">140 <Step title="Installer un plugin">

141 Sélectionnez un plugin pour voir ses détails, puis choisissez une portée d'installation :141 Sélectionnez un plugin pour voir ses détails. {/* min-version: 2.1.143 */}Sur Claude Code v2.1.143 et versions ultérieures, le volet de détails inclut une estimation du **Coût du contexte** afin que vous puissiez voir combien de tokens le plugin ajoutera à votre [fenêtre de contexte](/fr/features-overview#understand-context-costs) à chaque tour avant de l'installer.

142

143 Choisissez une portée d'installation :

142 144

143 * **User scope** : installez pour vous-même dans tous les projets145 * **User scope** : installez pour vous-même dans tous les projets

144 * **Project scope** : installez pour tous les collaborateurs sur ce référentiel146 * **Project scope** : installez pour tous les collaborateurs sur ce référentiel

env-vars.md +14 −11

Details

100| `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` | Définissez sur `1` pour acheminer le sondage de qualité de session « Comment Claude se débrouille-t-il ? » vers votre propre [collecteur OpenTelemetry](/fr/monitoring-usage) lorsque le trafic non essentiel lié à Anthropic est bloqué. Les évaluations du sondage sont émises uniquement en tant qu'événements OTEL vers votre collecteur configuré. Aucune donnée de sondage n'est envoyée à Anthropic dans ce mode. S'applique lorsque `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, `DISABLE_TELEMETRY` ou `DO_NOT_TRACK` est défini, et n'a aucun effet autrement. `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` et la politique de rétroaction produit de l'organisation prennent la priorité |100| `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` | Définissez sur `1` pour acheminer le sondage de qualité de session « Comment Claude se débrouille-t-il ? » vers votre propre [collecteur OpenTelemetry](/fr/monitoring-usage) lorsque le trafic non essentiel lié à Anthropic est bloqué. Les évaluations du sondage sont émises uniquement en tant qu'événements OTEL vers votre collecteur configuré. Aucune donnée de sondage n'est envoyée à Anthropic dans ce mode. S'applique lorsque `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, `DISABLE_TELEMETRY` ou `DO_NOT_TRACK` est défini, et n'a aucun effet autrement. `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` et la politique de rétroaction produit de l'organisation prennent la priorité |

101| `CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING` | Contrôle si les entrées d'appel d'outil se transmettent en continu depuis l'API au fur et à mesure que Claude les génère. Avec ceci désactivé, une grande entrée d'outil telle qu'une longue écriture de fichier n'arrive qu'après que Claude ait terminé de la générer, ce qui peut sembler qu'il se bloque. Activé par défaut sur l'API Anthropic. Sur Bedrock et Vertex, activé par modèle où le conteneur déployé le prend en charge. Définissez sur `0` pour refuser. Définissez sur `1` pour forcer l'activation lors du routage via un proxy via `ANTHROPIC_BASE_URL`, `ANTHROPIC_VERTEX_BASE_URL` ou `ANTHROPIC_BEDROCK_BASE_URL`. Désactivé par défaut sur Foundry et les connexions [gateway](/fr/llm-gateway) |101| `CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING` | Contrôle si les entrées d'appel d'outil se transmettent en continu depuis l'API au fur et à mesure que Claude les génère. Avec ceci désactivé, une grande entrée d'outil telle qu'une longue écriture de fichier n'arrive qu'après que Claude ait terminé de la générer, ce qui peut sembler qu'il se bloque. Activé par défaut sur l'API Anthropic. Sur Bedrock et Vertex, activé par modèle où le conteneur déployé le prend en charge. Définissez sur `0` pour refuser. Définissez sur `1` pour forcer l'activation lors du routage via un proxy via `ANTHROPIC_BASE_URL`, `ANTHROPIC_VERTEX_BASE_URL` ou `ANTHROPIC_BEDROCK_BASE_URL`. Désactivé par défaut sur Foundry et les connexions [gateway](/fr/llm-gateway) |

102| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | Définissez sur `1` pour remplir le sélecteur `/model` à partir du point de terminaison `/v1/models` de votre passerelle lorsque `ANTHROPIC_BASE_URL` pointe vers une passerelle compatible Anthropic telle que LiteLLM, Kong ou un proxy interne. Désactivé par défaut car les passerelles soutenues par une clé API partagée afficheraient autrement à chaque utilisateur chaque modèle auquel la clé peut accéder. Les modèles découverts sont toujours filtrés par la liste d'autorisation [`availableModels`](/fr/settings#available-settings) |102| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | Définissez sur `1` pour remplir le sélecteur `/model` à partir du point de terminaison `/v1/models` de votre passerelle lorsque `ANTHROPIC_BASE_URL` pointe vers une passerelle compatible Anthropic telle que LiteLLM, Kong ou un proxy interne. Désactivé par défaut car les passerelles soutenues par une clé API partagée afficheraient autrement à chaque utilisateur chaque modèle auquel la clé peut accéder. Les modèles découverts sont toujours filtrés par la liste d'autorisation [`availableModels`](/fr/settings#available-settings) |

103| `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE` | Définissez sur `1` pour exécuter le [mode rapide](/fr/fast-mode) sur Claude Opus 4.7 au lieu d'Opus 4.6. Avec la variable définie, `/fast` bascule vers Opus 4.7 ; sans elle, `/fast` continue à utiliser Opus 4.6 |103| `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE` | {/* max-version: 2.1.141 */}Supprimé dans v2.1.142. Le [mode rapide](/fr/fast-mode) utilise par défaut Opus 4.7. Définissez `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE=1` pour conserver Opus 4.6 à la place |

104| `CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION` | Définissez sur `false` pour désactiver les suggestions d'invite (le bouton bascule « Suggestions d'invite » dans `/config`). Ce sont les prédictions grisées qui apparaissent dans votre entrée d'invite après que Claude répond. Voir [Suggestions d'invite](/fr/interactive-mode#prompt-suggestions) |104| `CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION` | Définissez sur `false` pour désactiver les suggestions d'invite (le bouton bascule « Suggestions d'invite » dans `/config`). Ce sont les prédictions grisées qui apparaissent dans votre entrée d'invite après que Claude répond. Voir [Suggestions d'invite](/fr/interactive-mode#prompt-suggestions) |

105| `CLAUDE_CODE_ENABLE_TASKS` | Définissez sur `1` pour activer le système de suivi des tâches en mode non interactif (l'indicateur `-p`). Les tâches sont activées par défaut en mode interactif. Voir [Liste des tâches](/fr/interactive-mode#task-list) |105| `CLAUDE_CODE_ENABLE_TASKS` | Contrôle si les sessions utilisent les outils Task structurés (`TaskCreate`, `TaskUpdate`, `TaskGet`, `TaskList`) ou l'outil `TodoWrite` hérité. {/* min-version: 2.1.142 */}À partir de Claude Code v2.1.142, les outils Task sont le défaut dans tous les modes. Définissez sur `0` pour revenir à `TodoWrite`. Voir [Liste des tâches](/fr/interactive-mode#task-list) et [Migrer vers les outils Task](/fr/agent-sdk/todo-tracking#migrate-to-task-tools) |

106| `CLAUDE_CODE_ENABLE_TELEMETRY` | Définissez sur `1` pour activer la collecte de données OpenTelemetry pour les métriques et la journalisation. Requis avant de configurer les exportateurs OTel. Voir [Surveillance](/fr/monitoring-usage) |106| `CLAUDE_CODE_ENABLE_TELEMETRY` | Définissez sur `1` pour activer la collecte de données OpenTelemetry pour les métriques et la journalisation. Requis avant de configurer les exportateurs OTel. Voir [Surveillance](/fr/monitoring-usage) |

107| `CLAUDE_CODE_EXIT_AFTER_STOP_DELAY` | Temps en millisecondes à attendre après que la boucle de requête devienne inactive avant de quitter automatiquement. Utile pour les flux de travail automatisés et les scripts utilisant le mode SDK |107| `CLAUDE_CODE_EXIT_AFTER_STOP_DELAY` | Temps en millisecondes à attendre après que la boucle de requête devienne inactive avant de quitter automatiquement. Utile pour les flux de travail automatisés et les scripts utilisant le mode SDK |

108| `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` | Définissez sur `1` pour activer les [équipes d'agents](/fr/agent-teams). Les équipes d'agents sont expérimentales et désactivées par défaut |108| `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` | Définissez sur `1` pour activer les [équipes d'agents](/fr/agent-teams). Les équipes d'agents sont expérimentales et désactivées par défaut |

130| `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` | Jeton d'actualisation OAuth pour l'authentification Claude.ai. Lorsqu'il est défini, `claude auth login` échange ce jeton directement au lieu d'ouvrir un navigateur. Nécessite `CLAUDE_CODE_OAUTH_SCOPES`. Utile pour provisionner l'authentification dans les environnements automatisés |130| `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` | Jeton d'actualisation OAuth pour l'authentification Claude.ai. Lorsqu'il est défini, `claude auth login` échange ce jeton directement au lieu d'ouvrir un navigateur. Nécessite `CLAUDE_CODE_OAUTH_SCOPES`. Utile pour provisionner l'authentification dans les environnements automatisés |

131| `CLAUDE_CODE_OAUTH_SCOPES` | Portées OAuth séparées par des espaces avec lesquelles le jeton d'actualisation a été émis, telles que `"user:profile user:inference user:sessions:claude_code"`. Requis lorsque `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` est défini |131| `CLAUDE_CODE_OAUTH_SCOPES` | Portées OAuth séparées par des espaces avec lesquelles le jeton d'actualisation a été émis, telles que `"user:profile user:inference user:sessions:claude_code"`. Requis lorsque `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` est défini |

132| `CLAUDE_CODE_OAUTH_TOKEN` | Jeton d'accès OAuth pour l'authentification Claude.ai. Alternative à `/login` pour le SDK et les environnements automatisés. Prend la priorité sur les identifiants stockés dans le trousseau. Générez-en un avec [`claude setup-token`](/fr/authentication#generate-a-long-lived-token) |132| `CLAUDE_CODE_OAUTH_TOKEN` | Jeton d'accès OAuth pour l'authentification Claude.ai. Alternative à `/login` pour le SDK et les environnements automatisés. Prend la priorité sur les identifiants stockés dans le trousseau. Générez-en un avec [`claude setup-token`](/fr/authentication#generate-a-long-lived-token) |

133| `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` | Définissez sur `1` pour conserver le [mode rapide](/fr/fast-mode) sur Claude Opus 4.6. Prend la priorité sur `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE`, donc définissez ceci si vous devez épingler Opus 4.6 indépendamment de la façon dont la valeur par défaut change |133| `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` | Définissez sur `1` pour épingler le [mode rapide](/fr/fast-mode) à Claude Opus 4.6 au lieu de l'Opus 4.7 par défaut. Avec la variable définie, `/fast` s'exécute sur Opus 4.6. Sans elle, `/fast` s'exécute sur Opus 4.7 |

134| `CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS` | Délai d'expiration en millisecondes pour vider les spans OpenTelemetry en attente (par défaut : 5 000). Voir [Surveillance](/fr/monitoring-usage) |134| `CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS` | Délai d'expiration en millisecondes pour vider les spans OpenTelemetry en attente (par défaut : 5 000). Voir [Surveillance](/fr/monitoring-usage) |

135| `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | Intervalle pour actualiser les en-têtes OpenTelemetry dynamiques en millisecondes (par défaut : 1 740 000 / 29 minutes). Voir [En-têtes dynamiques](/fr/monitoring-usage#dynamic-headers) |135| `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | Intervalle pour actualiser les en-têtes OpenTelemetry dynamiques en millisecondes (par défaut : 1 740 000 / 29 minutes). Voir [En-têtes dynamiques](/fr/monitoring-usage#dynamic-headers) |

136| `CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS` | Délai d'expiration en millisecondes pour que l'exportateur OpenTelemetry se termine à l'arrêt (par défaut : 2 000). Augmentez si les métriques sont supprimées à la sortie. Voir [Surveillance](/fr/monitoring-usage) |136| `CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS` | Délai d'expiration en millisecondes pour que l'exportateur OpenTelemetry se termine à l'arrêt (par défaut : 2 000). Augmentez si les métriques sont supprimées à la sortie. Voir [Surveillance](/fr/monitoring-usage) |

141| `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE` | Définissez sur `1` pour conserver le cache de la place de marché existante lorsqu'un `git pull` échoue au lieu de l'effacer et de le re-cloner. Utile dans les environnements hors ligne ou isolés où le re-clonage échouerait de la même manière. Voir [Les mises à jour de la place de marché échouent dans les environnements hors ligne](/fr/plugin-marketplaces#marketplace-updates-fail-in-offline-environments) |141| `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE` | Définissez sur `1` pour conserver le cache de la place de marché existante lorsqu'un `git pull` échoue au lieu de l'effacer et de le re-cloner. Utile dans les environnements hors ligne ou isolés où le re-clonage échouerait de la même manière. Voir [Les mises à jour de la place de marché échouent dans les environnements hors ligne](/fr/plugin-marketplaces#marketplace-updates-fail-in-offline-environments) |

142| `CLAUDE_CODE_PLUGIN_PREFER_HTTPS` | Définissez sur `1` pour cloner les sources de plugin GitHub `owner/repo` sur HTTPS au lieu de SSH. Utile dans les exécuteurs CI, les conteneurs ou tout environnement sans clé SSH configurée pour `github.com` |142| `CLAUDE_CODE_PLUGIN_PREFER_HTTPS` | Définissez sur `1` pour cloner les sources de plugin GitHub `owner/repo` sur HTTPS au lieu de SSH. Utile dans les exécuteurs CI, les conteneurs ou tout environnement sans clé SSH configurée pour `github.com` |

143| `CLAUDE_CODE_PLUGIN_SEED_DIR` | Chemin d'accès à un ou plusieurs répertoires de seed de plugins en lecture seule, séparés par `:` sur Unix ou `;` sur Windows. Utilisez ceci pour regrouper un répertoire de plugins pré-rempli dans une image de conteneur. Claude Code enregistre les places de marché à partir de ces répertoires au démarrage et utilise les plugins pré-mis en cache sans re-cloner. Voir [Pré-remplir les plugins pour les conteneurs](/fr/plugin-marketplaces#pre-populate-plugins-for-containers) |143| `CLAUDE_CODE_PLUGIN_SEED_DIR` | Chemin d'accès à un ou plusieurs répertoires de seed de plugins en lecture seule, séparés par `:` sur Unix ou `;` sur Windows. Utilisez ceci pour regrouper un répertoire de plugins pré-rempli dans une image de conteneur. Claude Code enregistre les places de marché à partir de ces répertoires au démarrage et utilise les plugins pré-mis en cache sans re-cloner. Voir [Pré-remplir les plugins pour les conteneurs](/fr/plugin-marketplaces#pre-populate-plugins-for-containers) |

144| `CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY` | Définissez sur `1` pour arrêter Claude Code de passer `-ExecutionPolicy Bypass` lors du lancement de PowerShell pour les appels d'outils, les hooks et les commandes de ligne d'état, et respecter la politique d'exécution effective de la machine à la place. Par défaut, Claude Code contourne la politique d'exécution au niveau du processus pour que les scripts `.ps1` et les importations de modules fonctionnent sur les installations Windows par défaut avec Restricted. Le contournement au niveau du processus ne remplace jamais la `MachinePolicy` ou `UserPolicy` de Group Policy indépendamment de ce paramètre |

144| `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` | Défini par les plates-formes hôtes qui intègrent Claude Code et gèrent le routage du fournisseur de modèles en son nom. Lorsqu'elle est définie, la sélection du fournisseur, le point de terminaison et les variables d'authentification telles que `CLAUDE_CODE_USE_BEDROCK`, `ANTHROPIC_BASE_URL` et `ANTHROPIC_API_KEY` dans les fichiers de paramètres sont ignorés pour que les paramètres utilisateur ne puissent pas remplacer le routage de l'hôte. L'opt-out automatique de la télémétrie pour Bedrock, Vertex et Foundry est également ignoré, de sorte que la télémétrie suit l'opt-out standard `DISABLE_TELEMETRY`. Voir [Comportements par défaut par fournisseur API](/fr/data-usage#default-behaviors-by-api-provider) |145| `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` | Défini par les plates-formes hôtes qui intègrent Claude Code et gèrent le routage du fournisseur de modèles en son nom. Lorsqu'elle est définie, la sélection du fournisseur, le point de terminaison et les variables d'authentification telles que `CLAUDE_CODE_USE_BEDROCK`, `ANTHROPIC_BASE_URL` et `ANTHROPIC_API_KEY` dans les fichiers de paramètres sont ignorés pour que les paramètres utilisateur ne puissent pas remplacer le routage de l'hôte. L'opt-out automatique de la télémétrie pour Bedrock, Vertex et Foundry est également ignoré, de sorte que la télémétrie suit l'opt-out standard `DISABLE_TELEMETRY`. Voir [Comportements par défaut par fournisseur API](/fr/data-usage#default-behaviors-by-api-provider) |

145| `CLAUDE_CODE_PROXY_RESOLVES_HOSTS` | Définissez sur `1` pour permettre au proxy d'effectuer la résolution DNS au lieu de l'appelant. Opt-in pour les environnements où le proxy doit gérer la résolution du nom d'hôte |146| `CLAUDE_CODE_PROXY_RESOLVES_HOSTS` | Définissez sur `1` pour permettre au proxy d'effectuer la résolution DNS au lieu de l'appelant. Opt-in pour les environnements où le proxy doit gérer la résolution du nom d'hôte |

146| `CLAUDE_CODE_REMOTE` | Défini automatiquement sur `true` lorsque Claude Code s'exécute en tant que [session cloud](/fr/claude-code-on-the-web). Lisez ceci à partir d'un hook ou d'un script de configuration pour détecter si vous êtes dans un environnement cloud |147| `CLAUDE_CODE_REMOTE` | Défini automatiquement sur `true` lorsque Claude Code s'exécute en tant que [session cloud](/fr/claude-code-on-the-web). Lisez ceci à partir d'un hook ou d'un script de configuration pour détecter si vous êtes dans un environnement cloud |

153| `CLAUDE_CODE_SESSION_ID` | Défini automatiquement dans les sous-processus des outils Bash et PowerShell à l'ID de session actuel. Correspond au champ `session_id` passé aux [hooks](/fr/hooks). Mis à jour sur `/clear`. À utiliser pour corréler les scripts et les outils externes avec la session Claude Code qui les a lancés |154| `CLAUDE_CODE_SESSION_ID` | Défini automatiquement dans les sous-processus des outils Bash et PowerShell à l'ID de session actuel. Correspond au champ `session_id` passé aux [hooks](/fr/hooks). Mis à jour sur `/clear`. À utiliser pour corréler les scripts et les outils externes avec la session Claude Code qui les a lancés |

154| `CLAUDE_CODE_SHELL` | Remplacer la détection automatique du shell. Utile lorsque votre shell de connexion diffère de votre shell de travail préféré (par exemple, `bash` vs `zsh`) |155| `CLAUDE_CODE_SHELL` | Remplacer la détection automatique du shell. Utile lorsque votre shell de connexion diffère de votre shell de travail préféré (par exemple, `bash` vs `zsh`) |

155| `CLAUDE_CODE_SHELL_PREFIX` | Préfixe de commande pour envelopper les commandes shell que Claude Code génère : appels d'outil Bash, commandes [hook](/fr/hooks) et commandes de démarrage du serveur MCP [stdio](/fr/mcp). Utile pour la journalisation ou l'audit. Exemple : la définition de `/path/to/logger.sh` exécute chaque commande en tant que `/path/to/logger.sh <command>` |156| `CLAUDE_CODE_SHELL_PREFIX` | Préfixe de commande pour envelopper les commandes shell que Claude Code génère : appels d'outil Bash, commandes [hook](/fr/hooks) et commandes de démarrage du serveur MCP [stdio](/fr/mcp). Utile pour la journalisation ou l'audit. Exemple : la définition de `/path/to/logger.sh` exécute chaque commande en tant que `/path/to/logger.sh <command>` |

156| `CLAUDE_CODE_SIMPLE` | Définissez sur `1` pour exécuter avec une invite système minimale et uniquement les outils Bash, lecture de fichier et édition de fichier. Les outils MCP de `--mcp-config` sont toujours disponibles. Désactive la découverte automatique des hooks, skills, plugins, serveurs MCP, mémoire automatique et CLAUDE.md. L'indicateur CLI [`--bare`](/fr/headless#start-faster-with-bare-mode) définit ceci |157| `CLAUDE_CODE_SIMPLE` | Définissez sur `1` pour exécuter avec une invite système minimale et uniquement les outils Bash, lecture de fichier et édition de fichier. Les outils MCP de `--mcp-config` sont toujours disponibles. Désactive la découverte automatique des hooks, skills, plugins, serveurs MCP, mémoire automatique et CLAUDE.md. Les jetons OAuth et les identifiants du trousseau ne sont pas lus, donc l'authentification Anthropic doit provenir de `ANTHROPIC_API_KEY` ou d'un `apiKeyHelper` dans `--settings`. Équivalent à la transmission de [`--bare`](/fr/headless#start-faster-with-bare-mode) |

157| `CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT` | Définissez sur `1` pour utiliser l'invite système minimale et les descriptions d'outils réduites sur n'importe quel modèle. Définissez sur `0`, `false`, `no` ou `off` pour refuser même sur les modèles où l'expérience ou la configuration du serveur l'activerait autrement. L'ensemble complet d'outils, les hooks, les serveurs MCP et la découverte CLAUDE.md restent activés |158| `CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT` | Définissez sur `1` pour utiliser une invite système plus courte et des descriptions d'outils abrégées sur n'importe quel modèle. Définissez sur `0`, `false`, `no` ou `off` pour refuser même sur les modèles où l'expérience ou la configuration du serveur l'activerait autrement. L'ensemble complet d'outils, les hooks, les serveurs MCP et la découverte CLAUDE.md restent activés |

158| `CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH` | Ignorer l'authentification côté client pour [Claude Platform on AWS](/fr/claude-platform-on-aws), pour les passerelles qui signent les requêtes elles-mêmes |159| `CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH` | Ignorer l'authentification côté client pour [Claude Platform on AWS](/fr/claude-platform-on-aws), pour les passerelles qui signent les requêtes elles-mêmes |

159| `CLAUDE_CODE_SKIP_BEDROCK_AUTH` | Ignorer l'authentification AWS pour Bedrock (par exemple, lors de l'utilisation d'une passerelle LLM) |160| `CLAUDE_CODE_SKIP_BEDROCK_AUTH` | Ignorer l'authentification AWS pour Bedrock (par exemple, lors de l'utilisation d'une passerelle LLM) |

160| `CLAUDE_CODE_SKIP_FOUNDRY_AUTH` | Ignorer l'authentification Azure pour Microsoft Foundry (par exemple, lors de l'utilisation d'une passerelle LLM) |161| `CLAUDE_CODE_SKIP_FOUNDRY_AUTH` | Ignorer l'authentification Azure pour Microsoft Foundry (par exemple, lors de l'utilisation d'une passerelle LLM) |

161| `CLAUDE_CODE_SKIP_MANTLE_AUTH` | Ignorer l'authentification AWS pour Bedrock Mantle (par exemple, lors de l'utilisation d'une passerelle LLM) |162| `CLAUDE_CODE_SKIP_MANTLE_AUTH` | Ignorer l'authentification AWS pour Bedrock Mantle (par exemple, lors de l'utilisation d'une passerelle LLM) |

162| `CLAUDE_CODE_SKIP_PROMPT_HISTORY` | Définissez sur `1` pour ignorer l'écriture de l'historique des invites et des transcriptions de session sur le disque. Les sessions démarrées avec cette variable définie n'apparaissent pas dans `--resume`, `--continue` ou l'historique de la flèche vers le haut. Utile pour les sessions scriptées éphémères |163| `CLAUDE_CODE_SKIP_PROMPT_HISTORY` | Définissez sur `1` pour ignorer l'écriture de l'historique des invites et des transcriptions de session sur le disque. Les sessions démarrées avec cette variable définie n'apparaissent pas dans `--resume`, `--continue` ou l'historique de la flèche vers le haut. Utile pour les sessions scriptées éphémères |

163| `CLAUDE_CODE_SKIP_VERTEX_AUTH` | Ignorer l'authentification Google pour Vertex (par exemple, lors de l'utilisation d'une passerelle LLM) |164| `CLAUDE_CODE_SKIP_VERTEX_AUTH` | Ignorer l'authentification Google pour Vertex (par exemple, lors de l'utilisation d'une passerelle LLM) |

165| `CLAUDE_CODE_STOP_HOOK_BLOCK_CAP` | Nombre maximal de fois consécutives qu'un hook [Stop](/fr/hooks#stop) ou [SubagentStop](/fr/hooks#subagentstop) peut bloquer la fin du tour avant que Claude Code le remplace et termine le tour de toute façon (par défaut : 8). Définissez sur `0` pour désactiver le plafond. Augmentez ceci si votre hook a légitimement besoin de plus d'itérations pour se résoudre |

165| `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` | Définissez sur `1` pour supprimer les identifiants Anthropic et des fournisseurs de cloud des environnements de sous-processus (outil Bash, hooks, serveurs MCP stdio). Le processus Claude parent conserve ces identifiants pour les appels API, mais les processus enfants ne peuvent pas les lire, réduisant l'exposition aux attaques par injection de prompt qui tentent d'exfiltrer les secrets via l'expansion du shell. Sur Linux, cela exécute également les sous-processus Bash dans un espace de noms PID isolé pour qu'ils ne puissent pas lire les environnements de processus hôte via `/proc` ; en conséquence, `ps`, `pgrep` et `kill` ne peuvent pas voir ou signaler les processus hôte. `claude-code-action` définit ceci automatiquement lorsque `allowed_non_write_users` est configuré |167| `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` | Définissez sur `1` pour supprimer les identifiants Anthropic et des fournisseurs de cloud des environnements de sous-processus (outil Bash, hooks, serveurs MCP stdio). Le processus Claude parent conserve ces identifiants pour les appels API, mais les processus enfants ne peuvent pas les lire, réduisant l'exposition aux attaques par injection de prompt qui tentent d'exfiltrer les secrets via l'expansion du shell. Sur Linux, cela exécute également les sous-processus Bash dans un espace de noms PID isolé pour qu'ils ne puissent pas lire les environnements de processus hôte via `/proc` ; en conséquence, `ps`, `pgrep` et `kill` ne peuvent pas voir ou signaler les processus hôte. `claude-code-action` définit ceci automatiquement lorsque `allowed_non_write_users` est configuré |

166| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL` | Définissez sur `1` en mode non interactif (l'indicateur `-p`) pour attendre que l'installation du plugin se termine avant la première requête. Sans cela, les plugins s'installent en arrière-plan et peuvent ne pas être disponibles au premier tour. Combinez avec `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` pour limiter l'attente |168| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL` | Définissez sur `1` en mode non interactif (l'indicateur `-p`) pour attendre que l'installation du plugin se termine avant la première requête. Sans cela, les plugins s'installent en arrière-plan et peuvent ne pas être disponibles au premier tour. Combinez avec `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` pour limiter l'attente |

180| `CLAUDE_CONFIG_DIR` | Remplacer le répertoire de configuration (par défaut : `~/.claude`). Tous les paramètres, identifiants, historique de session et plugins sont stockés sous ce chemin. Utile pour exécuter plusieurs comptes côte à côte : par exemple, `alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'` |182| `CLAUDE_CONFIG_DIR` | Remplacer le répertoire de configuration (par défaut : `~/.claude`). Tous les paramètres, identifiants, historique de session et plugins sont stockés sous ce chemin. Utile pour exécuter plusieurs comptes côte à côte : par exemple, `alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'` |

181| `CLAUDE_EFFORT` | Défini automatiquement dans les sous-processus des outils Bash et les commandes hook au [niveau d'effort](/fr/model-config#adjust-effort-level) actif pour le tour : `low`, `medium`, `high`, `xhigh` ou `max`. Correspond au champ `effort.level` passé aux [hooks](/fr/hooks). Défini uniquement lorsque le modèle actuel prend en charge le paramètre d'effort |183| `CLAUDE_EFFORT` | Défini automatiquement dans les sous-processus des outils Bash et les commandes hook au [niveau d'effort](/fr/model-config#adjust-effort-level) actif pour le tour : `low`, `medium`, `high`, `xhigh` ou `max`. Correspond au champ `effort.level` passé aux [hooks](/fr/hooks). Défini uniquement lorsque le modèle actuel prend en charge le paramètre d'effort |

182| `CLAUDE_ENABLE_BYTE_WATCHDOG` | Définissez sur `1` pour forcer l'activation du chien de garde d'inactivité au niveau des octets, ou définissez sur `0` pour forcer la désactivation. Lorsqu'il n'est pas défini, le chien de garde est activé par défaut pour les connexions API Anthropic. Le chien de garde d'octets abandonne une connexion lorsqu'aucun octet n'arrive sur le fil pendant la durée définie par `CLAUDE_STREAM_IDLE_TIMEOUT_MS`, avec un minimum de 5 minutes, indépendamment du chien de garde au niveau des événements |184| `CLAUDE_ENABLE_BYTE_WATCHDOG` | Définissez sur `1` pour forcer l'activation du chien de garde d'inactivité au niveau des octets, ou définissez sur `0` pour forcer la désactivation. Lorsqu'il n'est pas défini, le chien de garde est activé par défaut pour les connexions API Anthropic. Le chien de garde d'octets abandonne une connexion lorsqu'aucun octet n'arrive sur le fil pendant la durée définie par `CLAUDE_STREAM_IDLE_TIMEOUT_MS`, avec un minimum de 5 minutes, indépendamment du chien de garde au niveau des événements |

183| `CLAUDE_ENABLE_STREAM_WATCHDOG` | Définissez sur `1` pour activer le chien de garde d'inactivité de streaming au niveau des événements. Désactivé par défaut. Pour Bedrock, Vertex et Foundry, c'est le seul chien de garde d'inactivité disponible. Configurez le délai d'expiration avec `CLAUDE_STREAM_IDLE_TIMEOUT_MS` |185| `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK` | Définissez sur `1` pour activer le chien de garde d'inactivité de streaming au niveau des octets sur les réponses Amazon Bedrock `vnd.amazon.eventstream`. Désactivé par défaut. Configurez le délai d'expiration avec `CLAUDE_STREAM_IDLE_TIMEOUT_MS` |

186| `CLAUDE_ENABLE_STREAM_WATCHDOG` | Définissez sur `1` pour activer le chien de garde d'inactivité de streaming au niveau des événements. Désactivé par défaut. S'applique à tous les fournisseurs, y compris Bedrock. Pour Vertex et Foundry, c'est le seul chien de garde d'inactivité disponible. Sur Bedrock, vous pouvez également activer le chien de garde indépendant au niveau des octets avec `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK` ; les deux s'exécutent ensemble lorsque les deux sont définis. Configurez le délai d'expiration avec `CLAUDE_STREAM_IDLE_TIMEOUT_MS` |

184| `CLAUDE_ENV_FILE` | Chemin d'accès à un script shell dont le contenu Claude Code exécute avant chaque commande Bash dans le même processus shell, de sorte que les exports du fichier sont visibles pour la commande. À utiliser pour persister l'activation de virtualenv ou conda entre les commandes. Également rempli dynamiquement par les hooks [SessionStart](/fr/hooks#persist-environment-variables), [Setup](/fr/hooks#setup), [CwdChanged](/fr/hooks#cwdchanged) et [FileChanged](/fr/hooks#filechanged) |187| `CLAUDE_ENV_FILE` | Chemin d'accès à un script shell dont le contenu Claude Code exécute avant chaque commande Bash dans le même processus shell, de sorte que les exports du fichier sont visibles pour la commande. À utiliser pour persister l'activation de virtualenv ou conda entre les commandes. Également rempli dynamiquement par les hooks [SessionStart](/fr/hooks#persist-environment-variables), [Setup](/fr/hooks#setup), [CwdChanged](/fr/hooks#cwdchanged) et [FileChanged](/fr/hooks#filechanged) |

185| `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` | Préfixe pour les noms de session [Contrôle à distance](/fr/remote-control) générés automatiquement lorsqu'aucun nom explicite n'est fourni. Par défaut, le nom d'hôte de votre machine, produisant des noms comme `myhost-graceful-unicorn`. L'indicateur CLI `--remote-control-session-name-prefix` définit la même valeur pour une seule invocation |188| `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` | Préfixe pour les noms de session [Contrôle à distance](/fr/remote-control) générés automatiquement lorsqu'aucun nom explicite n'est fourni. Par défaut, le nom d'hôte de votre machine, produisant des noms comme `myhost-graceful-unicorn`. L'indicateur CLI `--remote-control-session-name-prefix` définit la même valeur pour une seule invocation |

186| `CLAUDE_STREAM_IDLE_TIMEOUT_MS` | Délai d'expiration en millisecondes avant que le chien de garde d'inactivité de streaming ferme une connexion bloquée. Par défaut et minimum `300000` (5 minutes) pour les deux chiens de garde au niveau des octets et au niveau des événements ; les valeurs inférieures sont silencieusement limitées pour absorber les pauses de réflexion étendue et la mise en mémoire tampon du proxy. Pour les fournisseurs tiers, nécessite `CLAUDE_ENABLE_STREAM_WATCHDOG=1` |189| `CLAUDE_STREAM_IDLE_TIMEOUT_MS` | Délai d'expiration en millisecondes avant que le chien de garde d'inactivité de streaming ferme une connexion bloquée. Par défaut et minimum `300000` (5 minutes) pour les deux chiens de garde au niveau des octets et au niveau des événements ; les valeurs inférieures sont silencieusement limitées pour absorber les pauses de réflexion étendue et la mise en mémoire tampon du proxy. Pour les fournisseurs tiers, nécessite `CLAUDE_ENABLE_STREAM_WATCHDOG=1`. Sur Bedrock, s'applique également lorsque `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1` |

187| `DEBUG` | Définissez sur `1` pour activer le mode débogage, équivalent au lancement avec [`--debug`](/fr/cli-reference#cli-flags). Les journaux de débogage sont écrits dans `~/.claude/debug/<session-id>.txt`, ou dans le chemin défini par `CLAUDE_CODE_DEBUG_LOGS_DIR`. Seules les valeurs véridiques `1`, `true`, `yes` et `on` activent le mode débogage, donc les modèles d'espace de noms comme `DEBUG=express:*` définis pour d'autres outils ne le déclenchent pas |190| `DEBUG` | Définissez sur `1` pour activer le mode débogage, équivalent au lancement avec [`--debug`](/fr/cli-reference#cli-flags). Les journaux de débogage sont écrits dans `~/.claude/debug/<session-id>.txt`, ou dans le chemin défini par `CLAUDE_CODE_DEBUG_LOGS_DIR`. Seules les valeurs véridiques `1`, `true`, `yes` et `on` activent le mode débogage, donc les modèles d'espace de noms comme `DEBUG=express:*` définis pour d'autres outils ne le déclenchent pas |

188| `DISABLE_AUTOUPDATER` | Définissez sur `1` pour désactiver les mises à jour automatiques en arrière-plan. La commande manuelle `claude update` fonctionne toujours. Utilisez `DISABLE_UPDATES` pour bloquer les deux |191| `DISABLE_AUTOUPDATER` | Définissez sur `1` pour désactiver les mises à jour automatiques en arrière-plan. La commande manuelle `claude update` fonctionne toujours. Utilisez `DISABLE_UPDATES` pour bloquer les deux |

189| `DISABLE_AUTO_COMPACT` | Définissez sur `1` pour désactiver le compactage automatique lorsque vous approchez de la limite de contexte. La commande manuelle `/compact` reste disponible. À utiliser lorsque vous souhaitez un contrôle explicite sur le moment du compactage |192| `DISABLE_AUTO_COMPACT` | Définissez sur `1` pour désactiver le compactage automatique lorsque vous approchez de la limite de contexte. La commande manuelle `/compact` reste disponible. À utiliser lorsque vous souhaitez un contrôle explicite sur le moment du compactage |

192| `DISABLE_DOCTOR_COMMAND` | Définissez sur `1` pour masquer la commande `/doctor`. Utile pour les déploiements gérés où les utilisateurs ne doivent pas exécuter les diagnostics d'installation |195| `DISABLE_DOCTOR_COMMAND` | Définissez sur `1` pour masquer la commande `/doctor`. Utile pour les déploiements gérés où les utilisateurs ne doivent pas exécuter les diagnostics d'installation |

194| `DISABLE_EXTRA_USAGE_COMMAND` | Définissez sur `1` pour masquer la commande `/extra-usage` qui permet aux utilisateurs d'acheter une utilisation supplémentaire au-delà des limites de débit |197| `DISABLE_EXTRA_USAGE_COMMAND` | Définissez sur `1` pour masquer la commande `/usage-credits` qui permet aux utilisateurs d'acheter une utilisation supplémentaire au-delà des limites de débit |

195| `DISABLE_FEEDBACK_COMMAND` | Définissez sur `1` pour désactiver la commande `/feedback`. Le nom plus ancien `DISABLE_BUG_COMMAND` est également accepté |198| `DISABLE_FEEDBACK_COMMAND` | Définissez sur `1` pour désactiver la commande `/feedback`. Le nom plus ancien `DISABLE_BUG_COMMAND` est également accepté |

196| `DISABLE_GROWTHBOOK` | Définissez sur `1` pour désactiver la récupération des drapeaux de fonctionnalités GrowthBook et utiliser les valeurs par défaut du code pour chaque drapeau. La journalisation des événements de télémétrie reste activée sauf si `DISABLE_TELEMETRY` est également défini |199| `DISABLE_GROWTHBOOK` | Définissez sur `1` pour désactiver la récupération des drapeaux de fonctionnalités GrowthBook et utiliser les valeurs par défaut du code pour chaque drapeau. La journalisation des événements de télémétrie reste activée sauf si `DISABLE_TELEMETRY` est également défini |

197| `DISABLE_INSTALLATION_CHECKS` | Définissez sur `1` pour désactiver les avertissements d'installation. À utiliser uniquement lors de la gestion manuelle de l'emplacement d'installation, car cela peut masquer les problèmes avec les installations standard |200| `DISABLE_INSTALLATION_CHECKS` | Définissez sur `1` pour désactiver les avertissements d'installation. À utiliser uniquement lors de la gestion manuelle de l'emplacement d'installation, car cela peut masquer les problèmes avec les installations standard |

210| `ENABLE_CLAUDEAI_MCP_SERVERS` | Définissez sur `false` pour désactiver les [serveurs MCP claude.ai](/fr/mcp#use-mcp-servers-from-claude-ai) dans Claude Code. Activé par défaut pour les utilisateurs connectés |213| `ENABLE_CLAUDEAI_MCP_SERVERS` | Définissez sur `false` pour désactiver les [serveurs MCP claude.ai](/fr/mcp#use-mcp-servers-from-claude-ai) dans Claude Code. Activé par défaut pour les utilisateurs connectés |

211| `ENABLE_PROMPT_CACHING_1H` | Définissez sur `1` pour demander une TTL de cache d'invite d'une heure au lieu des 5 minutes par défaut. Destiné aux utilisateurs de clé API, [Bedrock](/fr/amazon-bedrock), [Vertex](/fr/google-vertex-ai), [Foundry](/fr/microsoft-foundry) et [Claude Platform on AWS](/fr/claude-platform-on-aws). Les utilisateurs d'abonnement reçoivent automatiquement une TTL d'une heure. Les écritures de cache d'une heure sont facturées à un taux plus élevé |214| `ENABLE_PROMPT_CACHING_1H` | Définissez sur `1` pour demander une TTL de cache d'invite d'une heure au lieu des 5 minutes par défaut. Destiné aux utilisateurs de clé API, [Bedrock](/fr/amazon-bedrock), [Vertex](/fr/google-vertex-ai), [Foundry](/fr/microsoft-foundry) et [Claude Platform on AWS](/fr/claude-platform-on-aws). Les utilisateurs d'abonnement reçoivent automatiquement une TTL d'une heure. Les écritures de cache d'une heure sont facturées à un taux plus élevé |

213| `ENABLE_TOOL_SEARCH` | Contrôle la [recherche d'outils MCP](/fr/mcp#scale-with-mcp-tool-search). Non défini : tous les outils MCP différés par défaut, mais chargés en amont sur Vertex AI ou lorsque `ANTHROPIC_BASE_URL` pointe vers un hôte non-first-party. Valeurs : `true` (toujours différer et envoyer l'en-tête bêta, les requêtes échouent sur Vertex AI ou les proxies qui ne prennent pas en charge `tool_reference`), `auto` (mode seuil : charger en amont si les outils s'ajustent dans 10 % du contexte), `auto:N` (seuil personnalisé, par exemple, `auto:5` pour 5 %), `false` (charger tous en amont) |216| `ENABLE_TOOL_SEARCH` | Contrôle la [recherche d'outils MCP](/fr/mcp#scale-with-mcp-tool-search). Non défini : tous les outils MCP différés par défaut, mais chargés en amont sur Vertex AI ou lorsque `ANTHROPIC_BASE_URL` pointe vers un hôte non-first-party. Valeurs : `true` (toujours différer et envoyer l'en-tête bêta, les requêtes échouent sur les modèles Vertex AI antérieurs à Sonnet 4.5 ou Opus 4.5, ou sur les proxies qui ne prennent pas en charge `tool_reference`), `auto` (mode seuil : charger en amont si les outils s'ajustent dans 10 % du contexte), `auto:N` (seuil personnalisé, par exemple, `auto:5` pour 5 %), `false` (charger tous en amont) |

214| `FALLBACK_FOR_ALL_PRIMARY_MODELS` | Définissez sur n'importe quelle valeur non vide pour déclencher le basculement vers [`--fallback-model`](/fr/cli-reference#cli-flags) après des erreurs de surcharge répétées sur n'importe quel modèle principal. Par défaut, seuls les modèles Opus déclenchent le basculement |217| `FALLBACK_FOR_ALL_PRIMARY_MODELS` | Définissez sur n'importe quelle valeur non vide pour déclencher le basculement vers [`--fallback-model`](/fr/cli-reference#cli-flags) après des erreurs de surcharge répétées sur n'importe quel modèle principal. Par défaut, seuls les modèles Opus déclenchent le basculement |

215| `FORCE_AUTOUPDATE_PLUGINS` | Définissez sur `1` pour forcer les mises à jour automatiques des plugins même lorsque la mise à jour automatique principale est désactivée via `DISABLE_AUTOUPDATER` |218| `FORCE_AUTOUPDATE_PLUGINS` | Définissez sur `1` pour forcer les mises à jour automatiques des plugins même lorsque la mise à jour automatique principale est désactivée via `DISABLE_AUTOUPDATER` |

216| `FORCE_PROMPT_CACHING_5M` | Définissez sur `1` pour forcer la TTL de cache d'invite de 5 minutes même lorsque la TTL d'une heure s'appliquerait autrement. Remplace `ENABLE_PROMPT_CACHING_1H` |219| `FORCE_PROMPT_CACHING_5M` | Définissez sur `1` pour forcer la TTL de cache d'invite de 5 minutes même lorsque la TTL d'une heure s'appliquerait autrement. Remplace `ENABLE_PROMPT_CACHING_1H` |

221| `MAX_STRUCTURED_OUTPUT_RETRIES` | Nombre de fois pour réessayer lorsque la réponse du modèle échoue la validation par rapport au [`--json-schema`](/fr/cli-reference#cli-flags) en mode non interactif (l'indicateur `-p`). Par défaut 5 |224| `MAX_STRUCTURED_OUTPUT_RETRIES` | Nombre de fois pour réessayer lorsque la réponse du modèle échoue la validation par rapport au [`--json-schema`](/fr/cli-reference#cli-flags) en mode non interactif (l'indicateur `-p`). Par défaut 5 |

222| `MAX_THINKING_TOKENS` | Remplacer le budget de tokens de [réflexion étendue](https://platform.claude.com/docs/en/build-with-claude/extended-thinking). Le plafond est le [max output tokens](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison) du modèle moins un. Définissez sur `0` pour désactiver complètement la réflexion. Sur les modèles avec [raisonnement adaptatif](/fr/model-config#adjust-effort-level), le budget est ignoré sauf si le raisonnement adaptatif est désactivé via `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` |225| `MAX_THINKING_TOKENS` | Remplacer le budget de tokens de [réflexion étendue](https://platform.claude.com/docs/en/build-with-claude/extended-thinking). Le plafond est le [max output tokens](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison) du modèle moins un. Définissez sur `0` pour désactiver complètement la réflexion. Sur les modèles avec [raisonnement adaptatif](/fr/model-config#adjust-effort-level), le budget est ignoré sauf si le raisonnement adaptatif est désactivé via `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` |

223| `MCP_CLIENT_SECRET` | Secret client OAuth pour les serveurs MCP qui nécessitent des [identifiants préconfigurés](/fr/mcp#use-pre-configured-oauth-credentials). Évite l'invite interactive lors de l'ajout d'un serveur avec `--client-secret` |226| `MCP_CLIENT_SECRET` | Secret client OAuth pour les serveurs MCP qui nécessitent des [identifiants préconfigurés](/fr/mcp#use-pre-configured-oauth-credentials). Évite l'invite interactive lors de l'ajout d'un serveur avec `--client-secret` |

224| `MCP_CONNECTION_NONBLOCKING` | Définissez sur `true` en mode non interactif (`-p`) pour ignorer complètement l'attente de connexion MCP. Utile pour les pipelines scriptés où les outils MCP ne sont pas nécessaires. Sans cette variable, la première requête attend jusqu'à 5 secondes pour les connexions du serveur `--mcp-config`. Les serveurs configurés avec [`alwaysLoad: true`](/fr/mcp#exempt-a-server-from-deferral) bloquent toujours le démarrage indépendamment de cette variable, car leurs outils doivent être présents lorsque la première invite est construite |227| `MCP_CONNECTION_NONBLOCKING` | Contrôle si le démarrage attend les serveurs MCP pour se connecter avant la première requête. {/* min-version: 2.1.142 */}À partir de Claude Code v2.1.142, le démarrage MCP est non-bloquant par défaut : les serveurs se connectent en arrière-plan et leurs outils deviennent disponibles au fur et à mesure qu'ils se terminent. Définissez sur `0` pour restaurer l'attente de connexion bloquante de 5 secondes. Les serveurs configurés avec [`alwaysLoad: true`](/fr/mcp#exempt-a-server-from-deferral) bloquent toujours le démarrage indépendamment, car leurs outils doivent être présents lorsque la première invite est construite |

225| `MCP_CONNECT_TIMEOUT_MS` | Combien de temps la première requête attend, en millisecondes, pour le lot de connexion MCP avant de prendre un instantané de la liste d'outils (par défaut : 5 000). Les serveurs toujours en attente à la date limite continuent à se connecter en arrière-plan mais n'apparaîtront pas jusqu'à la requête suivante. Distinct de `MCP_TIMEOUT`, qui limite la tentative de connexion d'un serveur individuel. Plus pertinent pour les sessions non interactives qui émettent une seule requête et ont besoin que les serveurs à connexion lente soient visibles |228| `MCP_CONNECT_TIMEOUT_MS` | Combien de temps l'attente de démarrage bloquante pour MCP, en millisecondes, pour le lot de connexion avant de prendre un instantané de la liste d'outils (par défaut : 5 000). S'applique lorsque `MCP_CONNECTION_NONBLOCKING=0` ou pour les serveurs marqués [`alwaysLoad: true`](/fr/mcp#exempt-a-server-from-deferral). Les serveurs toujours en attente à la date limite continuent à se connecter en arrière-plan mais n'apparaîtront pas jusqu'à la requête suivante. Distinct de `MCP_TIMEOUT`, qui limite la tentative de connexion d'un serveur individuel |

226| `MCP_OAUTH_CALLBACK_PORT` | Port fixe pour le rappel de redirection OAuth, comme alternative à `--callback-port` lors de l'ajout d'un serveur MCP avec des [identifiants préconfigurés](/fr/mcp#use-pre-configured-oauth-credentials) |229| `MCP_OAUTH_CALLBACK_PORT` | Port fixe pour le rappel de redirection OAuth, comme alternative à `--callback-port` lors de l'ajout d'un serveur MCP avec des [identifiants préconfigurés](/fr/mcp#use-pre-configured-oauth-credentials) |

227| `MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZE` | Nombre maximal de serveurs MCP distants (HTTP/SSE) à connecter en parallèle au démarrage (par défaut : 20) |230| `MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZE` | Nombre maximal de serveurs MCP distants (HTTP/SSE) à connecter en parallèle au démarrage (par défaut : 20) |

228| `MCP_SERVER_CONNECTION_BATCH_SIZE` | Nombre maximal de serveurs MCP locaux (stdio) à connecter en parallèle au démarrage (par défaut : 3) |231| `MCP_SERVER_CONNECTION_BATCH_SIZE` | Nombre maximal de serveurs MCP locaux (stdio) à connecter en parallèle au démarrage (par défaut : 3) |

errors.md +9 −7

Details

162 162

163Ces erreurs signifient qu'un quota lié à votre compte ou à votre plan a été atteint. Elles sont distinctes des [erreurs serveur](#server-errors), qui affectent tout le monde.163Ces erreurs signifient qu'un quota lié à votre compte ou à votre plan a été atteint. Elles sont distinctes des [erreurs serveur](#server-errors), qui affectent tout le monde.

164 164

165### You've hit your session limit165### Vous avez atteint votre limite de session

166 166

167Les plans d'abonnement incluent une allocation d'utilisation roulante. Lorsqu'elle s'épuise, vous voyez l'un de ces messages :167Les plans d'abonnement incluent une allocation d'utilisation roulante. Lorsqu'elle s'épuise, vous voyez l'un de ces messages :

168 168

178 178

179* Attendez l'heure de réinitialisation indiquée dans l'erreur179* Attendez l'heure de réinitialisation indiquée dans l'erreur

180* Exécutez `/usage` pour voir les limites de votre plan et quand elles se réinitialisent180* Exécutez `/usage` pour voir les limites de votre plan et quand elles se réinitialisent

181* Exécutez `/extra-usage` pour acheter une utilisation supplémentaire sur Pro et Max, ou pour la demander à votre administrateur sur Team et Enterprise. Consultez [Extra usage for paid plans](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) pour savoir comment cela est facturé.181* Exécutez `/usage-credits` pour acheter une utilisation supplémentaire sur Pro et Max, ou pour la demander à votre administrateur sur Team et Enterprise. Consultez [usage credits for paid plans](https://support.claude.com/fr/articles/12429409-extra-usage-for-paid-claude-plans) pour savoir comment cela est facturé.

182* Pour mettre à niveau votre plan pour des limites de base plus élevées, consultez [claude.com/pricing](https://claude.com/pricing)182* Pour mettre à niveau votre plan pour des limites de base plus élevées, consultez [claude.com/pricing](https://claude.com/pricing)

183 183

184Pour surveiller votre allocation restante avant d'atteindre la limite, ajoutez les champs `rate_limits` à une [ligne d'état personnalisée](/fr/statusline#rate-limit-usage), ou dans l'application Desktop cliquez sur l'[anneau d'utilisation](/fr/desktop#check-usage) à côté du sélecteur de modèle.184Pour surveiller votre allocation restante avant d'atteindre la limite, ajoutez les champs `rate_limits` à une [ligne d'état personnalisée](/fr/statusline#rate-limit-usage), ou dans l'application Desktop cliquez sur l'[anneau d'utilisation](/fr/desktop#check-usage) à côté du sélecteur de modèle.

185 185

186### Server is temporarily limiting requests186### Le serveur limite temporairement les demandes

187 187

188L'API a appliqué un accélérateur de courte durée qui n'est pas lié à votre quota de plan.188L'API a appliqué un accélérateur de courte durée qui n'est pas lié à votre quota de plan.

189 189

198* Attendez brièvement et réessayez198* Attendez brièvement et réessayez

199* Vérifiez [status.claude.com](https://status.claude.com) si cela persiste199* Vérifiez [status.claude.com](https://status.claude.com) si cela persiste

200 200

201### Request rejected (429)201### Demande rejetée (429)

202 202

203Vous avez atteint la limite de débit configurée pour votre clé API, votre projet Amazon Bedrock ou votre projet Google Vertex AI.203Vous avez atteint la limite de débit configurée pour votre clé API, votre projet Amazon Bedrock ou votre projet Google Vertex AI.

204 204

205```text theme={null}205```text theme={null}

206API Error: Request rejected (429) · this may be a temporary capacity issue206API Error: Request rejected (429) · this may be a temporary capacity issue. If it persists, check status.claude.com.

207```207```

208 208

209La phrase de fin indique où vérifier l'état du service et varie selon le fournisseur. Les configurations Bedrock et Vertex AI indiquent plutôt la page d'état du service de ce fournisseur au lieu de la page d'état Anthropic.

210

209**Que faire :**211**Que faire :**

210 212

211* Exécutez `/status` et confirmez que les identifiants actifs sont ceux que vous attendez. Une `ANTHROPIC_API_KEY` égarée dans votre environnement peut acheminer les requêtes via une clé de niveau inférieur au lieu de votre abonnement.213* Exécutez `/status` et confirmez que les identifiants actifs sont ceux que vous attendez. Une `ANTHROPIC_API_KEY` égarée dans votre environnement peut acheminer les requêtes via une clé de niveau inférieur au lieu de votre abonnement.

212* Vérifiez la console de votre fournisseur pour les limites actives et demandez un niveau supérieur si nécessaire214* Vérifiez la console de votre fournisseur pour les limites actives et demandez un niveau supérieur si nécessaire

213* Pour les clés API Anthropic, consultez la [référence des limites de débit](https://platform.claude.com/docs/en/api/rate-limits) pour savoir comment fonctionnent les niveaux et comment définir des plafonds par espace de travail215* Pour les clés API Anthropic, consultez la [référence des limites de débit](https://platform.claude.com/docs/fr/api/rate-limits) pour savoir comment fonctionnent les niveaux et comment définir des plafonds par espace de travail

214* Réduisez la concurrence : réduisez [`CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY`](/fr/env-vars), évitez d'exécuter de nombreux sous-agents parallèles, ou basculez vers un modèle plus petit avec `/model` pour les exécutions scriptées à haut volume216* Réduisez la concurrence : réduisez [`CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY`](/fr/env-vars), évitez d'exécuter de nombreux sous-agents parallèles, ou basculez vers un modèle plus petit avec `/model` pour les exécutions scriptées à haut volume

215 217

216### Credit balance is too low218### Le solde de crédits est trop faible

217 219

218Votre organisation Console a épuisé ses crédits prépayés.220Votre organisation Console a épuisé ses crédits prépayés.

219 221

fast-mode.md +13 −47

Details

12 12

13Le mode rapide est une configuration haute vitesse pour Claude Opus, rendant le modèle 2,5 fois plus rapide à un coût par jeton plus élevé. Activez-le avec `/fast` quand vous avez besoin de vitesse pour un travail interactif comme l'itération rapide ou le débogage en direct, et désactivez-le quand le coût importe plus que la latence.13Le mode rapide est une configuration haute vitesse pour Claude Opus, rendant le modèle 2,5 fois plus rapide à un coût par jeton plus élevé. Activez-le avec `/fast` quand vous avez besoin de vitesse pour un travail interactif comme l'itération rapide ou le débogage en direct, et désactivez-le quand le coût importe plus que la latence.

14 14

15Le mode rapide n'est pas un modèle différent. Il utilise Claude Opus avec une configuration API différente qui priorise la vitesse plutôt que l'efficacité des coûts. Vous obtenez une qualité et des capacités identiques, juste des réponses plus rapides. Le mode rapide est pris en charge sur Opus 4.6 et Opus 4.7. Il n'est pas disponible sur Sonnet, Haiku ou d'autres modèles.15Le mode rapide n'est pas un modèle différent. Il utilise Claude Opus avec une configuration API différente qui priorise la vitesse plutôt que l'efficacité des coûts. Vous obtenez une qualité et des capacités identiques avec des réponses plus rapides. Le mode rapide est pris en charge sur Opus 4.7 et Opus 4.6. Il n'est pas disponible sur Sonnet, Haiku ou d'autres modèles.

16 16

17<Note>17<Note>

18 Le mode rapide nécessite Claude Code v2.1.36 ou ultérieur. Vérifiez votre version avec `claude --version`.18 Le mode rapide nécessite Claude Code v2.1.36 ou ultérieur. Vérifiez votre version avec `claude --version`.

21Ce qu'il faut savoir :21Ce qu'il faut savoir :

22 22

23* Utilisez `/fast` pour activer/désactiver le mode rapide dans Claude Code CLI. Également disponible via `/fast` dans l'extension Claude Code VS Code.23* Utilisez `/fast` pour activer/désactiver le mode rapide dans Claude Code CLI. Également disponible via `/fast` dans l'extension Claude Code VS Code.

24* Par défaut, `/fast` s'exécute sur Opus 4.6. Pour exécuter le mode rapide sur Opus 4.7 à la place, définissez la variable d'environnement [`CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE`](#use-fast-mode-on-opus-4-7).24* La tarification du mode rapide est de 30 \$/150 MTok sur Opus 4.7 et Opus 4.6.

~~25* La tarification du mode rapide est de 30 \$/150 MTok sur Opus 4.6 et Opus 4.7.~~

26* Disponible pour tous les utilisateurs de Claude Code sur les plans d'abonnement (Pro/Max/Team/Enterprise) et Claude Console.25* Disponible pour tous les utilisateurs de Claude Code sur les plans d'abonnement (Pro/Max/Team/Enterprise) et Claude Console.

27* Pour les utilisateurs de Claude Code sur les plans d'abonnement (Pro/Max/Team/Enterprise), le mode rapide est disponible via l'utilisation supplémentaire uniquement et n'est pas inclus dans les limites de taux d'utilisation de l'abonnement.26* Pour les utilisateurs de Claude Code sur les plans d'abonnement (Pro/Max/Team/Enterprise), le mode rapide est disponible via l'utilisation supplémentaire uniquement et n'est pas inclus dans les limites de taux d'utilisation de l'abonnement.

28 27

29Cette page couvre comment [activer le mode rapide](#toggle-fast-mode), [utiliser le mode rapide sur Opus 4.7](#use-fast-mode-on-opus-4-7), le [compromis de coût](#understand-the-cost-tradeoff), [quand l'utiliser](#decide-when-to-use-fast-mode), les [exigences](#requirements), l'[opt-in par session](#require-per-session-opt-in), et le [comportement des limites de taux](#handle-rate-limits).28Cette page couvre comment [activer le mode rapide](#toggle-fast-mode), son [compromis de coût](#understand-the-cost-tradeoff), [quand l'utiliser](#decide-when-to-use-fast-mode), les [exigences](#requirements), l'[opt-in par session](#require-per-session-opt-in), et le [comportement des limites de taux](#handle-rate-limits).

30 29

31## Activer le mode rapide30## Activer le mode rapide

32 31

41 40

42Quand vous activez le mode rapide :41Quand vous activez le mode rapide :

43 42

44* Si vous êtes sur un modèle différent, Claude Code bascule automatiquement vers le modèle du mode rapide : Opus 4.6 par défaut, ou Opus 4.7 quand [`CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE`](#use-fast-mode-on-opus-4-7) est défini.43* Si vous êtes sur un modèle différent, Claude Code bascule automatiquement vers Opus

45* Vous verrez un message de confirmation : « Mode rapide ACTIVÉ »44* Vous verrez un message de confirmation : « Mode rapide ACTIVÉ »

46* Une petite icône `↯` apparaît à côté de l'invite pendant que le mode rapide est actif45* Une petite icône `↯` apparaît à côté de l'invite pendant que le mode rapide est actif

47* Exécutez `/fast` à nouveau à tout moment pour vérifier si le mode rapide est activé ou désactivé46* Exécutez `/fast` à nouveau à tout moment pour vérifier si le mode rapide est activé ou désactivé

48 47

49Quand vous désactivez le mode rapide avec `/fast` à nouveau, vous restez sur la même version d'Opus que celle sur laquelle le mode rapide s'exécutait. Le modèle ne revient pas à votre modèle précédent. Pour basculer vers un modèle différent, utilisez `/model`.48Quand vous désactivez le mode rapide avec `/fast` à nouveau, vous restez sur Opus. Le modèle ne revient pas à votre modèle précédent. Pour basculer vers un modèle différent, utilisez `/model`.

50 49

~~51## Utiliser le mode rapide sur Opus 4.7~~50Opus 4.7 est le mode rapide par défaut dans Claude Code v2.1.142 et ultérieur. Pour épingler le mode rapide à Opus 4.6 à la place, définissez `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE=1`.

~~53<Note>~~

~~54 Le mode rapide sur Opus 4.7 nécessite Claude Code v2.1.139 ou ultérieur.~~

~~55</Note>~~

~~57Le mode rapide pour Claude Opus 4.7 est en aperçu de recherche. Il s'exécute à la même vitesse 2,5x et au même prix que le mode rapide pour Opus 4.6, sans autres changements de comportement.~~

~~59<Note>~~

~~60 Le 14 mai 2026, Opus 4.7 devient le modèle du mode rapide par défaut. Jusqu'à présent, optez en définissant `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE=1`.~~

~~61</Note>~~

63Pour opter, définissez `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE=1` avant de lancer Claude Code. Avec la variable définie, `/fast` s'exécute sur Opus 4.7. Sans elle, `/fast` continue à s'exécuter sur Opus 4.6.

~~65Vous pouvez définir la variable comme une exportation shell :~~

~~67```bash theme={null}~~

~~68export CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE=1~~

~~69```~~

~~71Ou dans n'importe quel [fichier de paramètres](/fr/settings#settings-files) de Claude Code, y compris les paramètres utilisateur, projet et gérés, pour délimiter l'opt-in :~~

~~73```json theme={null}~~

~~74{~~

~~75 "env": {~~

~~76 "CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE": "1"~~

~~77 }~~

~~78}~~

~~79```~~

81Le mode rapide pour Opus 4.6 reste disponible aux côtés d'Opus 4.7. Les deux partagent le même pool de limites de taux du mode rapide : l'utilisation sur l'un ou l'autre modèle puise dans les mêmes limites.

83Pour épingler le mode rapide à Opus 4.6 explicitement, définissez `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE=1`. Cette variable a la priorité, donc le mode rapide s'exécute sur Opus 4.6 indépendamment du fait que `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE` soit défini.

84 51

85## Comprendre le compromis de coût52## Comprendre le compromis de coût

86 53

87Le mode rapide a une tarification par jeton plus élevée que l'Opus standard :54Le mode rapide a une tarification par jeton plus élevée que l'Opus standard :

88 55

~~90| ------------------------ | ------------- | ------------- |~~57| ----------- | ------------- | ------------- |

~~91| Mode rapide sur Opus 4.6 | 30 \$ | 150 \$ |~~58| Mode rapide | 30 \$ | 150 \$ |

~~92| Mode rapide sur Opus 4.7 | 30 \$ | 150 \$ |~~

93 59

94La tarification du mode rapide est plate sur toute la fenêtre de contexte de 1 million de jetons.60La tarification du mode rapide est plate sur toute la fenêtre de contexte de 1 million de jetons.

95 61

124 90

125Le mode rapide nécessite tous les éléments suivants :91Le mode rapide nécessite tous les éléments suivants :

126 92

127* **Non disponible sur les fournisseurs cloud tiers** : le mode rapide n'est pas disponible sur Amazon Bedrock, Google Vertex AI ou Microsoft Azure Foundry. Le mode rapide est disponible via l'API Anthropic Console et pour les plans d'abonnement Claude utilisant l'utilisation supplémentaire.93* **Non disponible sur les fournisseurs cloud tiers** : le mode rapide n'est pas disponible sur Amazon Bedrock, Google Vertex AI ou Microsoft Azure Foundry. Le mode rapide est disponible via l'API Anthropic Console et pour les plans d'abonnement Claude utilisant les crédits d'utilisation.

128* **Utilisation supplémentaire activée** : votre compte doit avoir l'utilisation supplémentaire activée, ce qui permet la facturation au-delà de l'utilisation incluse dans votre plan. Pour les comptes individuels, activez ceci dans vos [paramètres de facturation Console](https://platform.claude.com/settings/organization/billing). Pour Teams et Enterprise, un administrateur doit activer l'utilisation supplémentaire pour l'organisation.94* **Crédits d'utilisation activés** : votre compte doit avoir les crédits d'utilisation activés, ce qui permet la facturation au-delà de l'utilisation incluse dans votre plan. Pour les comptes individuels, activez ceci dans vos [paramètres de facturation Console](https://platform.claude.com/settings/organization/billing). Pour Teams et Enterprise, un administrateur doit activer les crédits d'utilisation pour l'organisation.

129 95

130<Note>96<Note>

131 L'utilisation du mode rapide est facturée directement à l'utilisation supplémentaire, même si vous avez une utilisation restante sur votre plan. Cela signifie que les jetons du mode rapide ne comptent pas par rapport à l'utilisation incluse de votre plan et sont facturés au tarif du mode rapide à partir du premier jeton.97 L'utilisation du mode rapide est facturée directement à partir des crédits d'utilisation, même si vous avez une utilisation restante sur votre plan. Cela signifie que les jetons du mode rapide ne comptent pas par rapport à l'utilisation incluse de votre plan et sont facturés au tarif du mode rapide à partir du premier jeton.

132</Note>98</Note>

133 99

134* **Activation par l'administrateur pour Teams et Enterprise** : le mode rapide est désactivé par défaut pour les organisations Teams et Enterprise. Un administrateur doit explicitement [activer le mode rapide](#enable-fast-mode-for-your-organization) avant que les utilisateurs puissent y accéder.100* **Activation par l'administrateur pour Teams et Enterprise** : le mode rapide est désactivé par défaut pour les organisations Teams et Enterprise. Un administrateur doit explicitement [activer le mode rapide](#enable-fast-mode-for-your-organization) avant que les utilisateurs puissent y accéder.

160 126

161## Gérer les limites de taux127## Gérer les limites de taux

162 128

163Le mode rapide a des limites de taux séparées de l'Opus standard. Le mode rapide pour Opus 4.6 et Opus 4.7 partagent le même pool de limites de taux : l'utilisation sur l'un ou l'autre modèle puise dans les mêmes limites. Quand vous atteignez la limite de taux du mode rapide ou que vous manquez d'utilisation supplémentaire :129Le mode rapide a des limites de taux séparées de l'Opus standard. Le mode rapide pour Opus 4.7 et Opus 4.6 partagent le même pool de limites de taux : l'utilisation sur l'un ou l'autre modèle puise dans les mêmes limites. Quand vous atteignez la limite de taux du mode rapide ou que vous manquez de crédits d'utilisation :

164 130

1651. Le mode rapide bascule automatiquement vers la vitesse standard sur la même version d'Opus1311. Le mode rapide bascule automatiquement vers la vitesse standard

1662. L'icône `↯` devient grise pour indiquer le refroidissement1322. L'icône `↯` devient grise pour indiquer le refroidissement

1673. Vous continuez à travailler à la vitesse et à la tarification standard1333. Vous continuez à travailler à la vitesse et à la tarification standard

1684. Quand le refroidissement expire, le mode rapide se réactive automatiquement1344. Quand le refroidissement expire, le mode rapide se réactive automatiquement

features-overview.md +2 −2

Details

271 271

272 **Ce qui se charge :** Contexte frais et isolé contenant :272 **Ce qui se charge :** Contexte frais et isolé contenant :

273 273

274 * L'invite système (partagée avec le parent pour l'efficacité du cache)274 * L'invite système, pas l'invite système complète de Claude Code

275 * Contenu complet des skills listées dans le champ `skills:` de l'agent275 * Contenu complet des skills listées dans le champ `skills:` de l'agent

276 * CLAUDE.md et statut git (hérité du parent)276 * CLAUDE.md et statut git, sauf les agents Explore et Plan intégrés [qui omettent les deux](/fr/sub-agents#what-loads-at-startup)

277 * Quel que soit le contexte que l'agent principal transmet dans l'invite277 * Quel que soit le contexte que l'agent principal transmet dans l'invite

278 278

279 **Coût du contexte :** Isolé de la session principale. Les subagents n'héritent pas de votre historique de conversation ou des skills invoquées.279 **Coût du contexte :** Isolé de la session principale. Les subagents n'héritent pas de votre historique de conversation ou des skills invoquées.

hooks.md +2 −2

Details

732# Hook de notification : ping le bureau lorsque Claude Code a besoin d'attention.732# Hook de notification : ping le bureau lorsque Claude Code a besoin d'attention.

733input=$(cat)733input=$(cat)

734title="Claude Code'734title="Claude Code'

735body=$(jq -r '.message // 'Needs your attention"' <<<"$input")735body=$(jq -r '.message // 'Needs your attention'' <<<"$input")

736seq=$(printf '\033]777;notify;%s;%s\007' "$title" "$body")736seq=$(printf '\033]777;notify;%s;%s\007' "$title" "$body")

737jq -nc --arg seq "$seq" '{terminalSequence: $seq}'737jq -nc --arg seq "$seq" '{terminalSequence: $seq}'

738```738```

2771 2771

2772Pour plus de détails granulaires sur la correspondance des hooks, définissez `CLAUDE_CODE_DEBUG_LOG_LEVEL=verbose` pour voir des lignes de journal supplémentaires telles que les comptes de matcher de hook et la correspondance de requête.2772Pour plus de détails granulaires sur la correspondance des hooks, définissez `CLAUDE_CODE_DEBUG_LOG_LEVEL=verbose` pour voir des lignes de journal supplémentaires telles que les comptes de matcher de hook et la correspondance de requête.

2773 2773

2774Pour dépanner les problèmes courants comme les hooks qui ne se déclenchent pas, les boucles infinies de hook Stop ou les erreurs de configuration, consultez [Limitations et dépannage](/fr/hooks-guide#limitations-and-troubleshooting) dans le guide. Pour une procédure de diagnostic plus large couvrant `/context`, `/doctor` et la précédence des paramètres, consultez [Déboguer votre configuration](/fr/debug-your-config).2774Pour dépanner les problèmes courants comme les hooks qui ne se déclenchent pas, les hooks Stop qui continuent à bloquer, ou les erreurs de configuration, consultez [Limitations et dépannage](/fr/hooks-guide#limitations-and-troubleshooting) dans le guide. Pour une procédure de diagnostic plus large couvrant `/context`, `/doctor` et la précédence des paramètres, consultez [Déboguer votre configuration](/fr/debug-your-config).

hooks-guide.md +5 −3

Details

910* Vérifiez que votre JSON est valide (les virgules finales et les commentaires ne sont pas autorisés)910* Vérifiez que votre JSON est valide (les virgules finales et les commentaires ne sont pas autorisés)

911* Confirmez que le fichier de paramètres est au bon emplacement : `.claude/settings.json` pour les hooks de projet, `~/.claude/settings.json` pour les hooks globaux911* Confirmez que le fichier de paramètres est au bon emplacement : `.claude/settings.json` pour les hooks de projet, `~/.claude/settings.json` pour les hooks globaux

912 912

913### Le hook Stop s'exécute indéfiniment913### Le hook Stop atteint le plafond de blocage

914 914

915Claude continue à travailler dans une boucle infinie au lieu de s'arrêter.915Claude continue à travailler au lieu de s'arrêter, puis termine le tour avec un avertissement selon lequel le hook Stop a bloqué trop de fois consécutives.

916 916

917Votre script de hook Stop doit vérifier s'il a déjà déclenché une continuation. Analysez le champ `stop_hook_active` de l'entrée JSON et quittez tôt s'il est `true` :917Claude Code remplace un hook Stop après qu'il ait bloqué 8 fois de suite sans progrès. Votre script de hook doit vérifier s'il a déjà déclenché une continuation. Analysez le champ `stop_hook_active` de l'entrée JSON et quittez tôt s'il est `true` :

918 918

919```bash theme={null}919```bash theme={null}

920#!/bin/bash920#!/bin/bash

925# ... rest of your hook logic925# ... rest of your hook logic

926```926```

927 927

928Si votre hook a légitimement besoin de plus de huit itérations pour converger, augmentez le plafond avec [`CLAUDE_CODE_STOP_HOOK_BLOCK_CAP`](/fr/env-vars).

929

928### Validation JSON échouée930### Validation JSON échouée

929 931

930Claude Code affiche une erreur d'analyse JSON même si votre script de hook produit du JSON valide.932Claude Code affiche une erreur d'analyse JSON même si votre script de hook produit du JSON valide.

mcp.md +3 −1

Details

143 143

144Le panneau `/mcp` affiche le nombre d'outils à côté de chaque serveur connecté et signale les serveurs qui annoncent la capacité des outils mais n'exposent aucun outil.144Le panneau `/mcp` affiche le nombre d'outils à côté de chaque serveur connecté et signale les serveurs qui annoncent la capacité des outils mais n'exposent aucun outil.

145 145

146Si votre demande a besoin d'outils d'un serveur qui se connecte toujours en arrière-plan, Claude attend que ce serveur se connecte avant de continuer. Avec la [recherche d'outils](#scale-with-mcp-tool-search) activée, qui est l'option par défaut, l'attente se produit à l'intérieur de l'appel `ToolSearch`. Dans les configurations sans recherche d'outils, telles que Vertex AI, une `ANTHROPIC_BASE_URL` personnalisée, ou `ENABLE_TOOL_SEARCH=false`, Claude utilise plutôt l'outil `WaitForMcpServers`.

147

146Le nom du serveur `workspace` est réservé à un usage interne. Si votre configuration définit un serveur avec ce nom, Claude Code le saute au chargement et affiche un avertissement vous demandant de le renommer.148Le nom du serveur `workspace` est réservé à un usage interne. Si votre configuration définit un serveur avec ce nom, Claude Code le saute au chargement et affiche un avertissement vous demandant de le renommer.

147 149

148### Mises à jour dynamiques des outils150### Mises à jour dynamiques des outils

1007 1009

1008Le champ `alwaysLoad` est disponible sur tous les types de serveurs et nécessite Claude Code v2.1.121 ou ultérieur. Un serveur MCP peut également marquer les outils individuels comme toujours chargés en incluant `"anthropic/alwaysLoad": true` dans l'objet `_meta` de l'outil, ce qui a le même effet pour cet outil uniquement.1010Le champ `alwaysLoad` est disponible sur tous les types de serveurs et nécessite Claude Code v2.1.121 ou ultérieur. Un serveur MCP peut également marquer les outils individuels comme toujours chargés en incluant `"anthropic/alwaysLoad": true` dans l'objet `_meta` de l'outil, ce qui a le même effet pour cet outil uniquement.

1009 1011

1010La définition de `alwaysLoad: true` bloque également le démarrage jusqu'à ce que le serveur se connecte, limité au délai d'expiration de connexion standard de 5 secondes. Cela s'applique même lorsque [`MCP_CONNECTION_NONBLOCKING=1`](/fr/env-vars) est défini, car les outils doivent être présents lors de la construction de la première invite. Les autres serveurs se connectent toujours en arrière-plan lorsque le mode non-bloquant est activé.1012La définition de `alwaysLoad: true` bloque également le démarrage jusqu'à ce que le serveur se connecte, limité au délai d'expiration de connexion standard de 5 secondes. Cela s'applique même lorsque MCP startup est autrement [non-bloquant par défaut](/fr/env-vars), car les outils doivent être présents lors de la construction de la première invite. Les autres serveurs continuent à se connecter en arrière-plan.

1011 1013

1012## Utiliser les prompts MCP comme commandes1014## Utiliser les prompts MCP comme commandes

1013 1015

model-config.md +2 −2

Details

286Vous pouvez utiliser les variables d'environnement suivantes, qui doivent être des **noms de modèle** complets (ou équivalents pour votre fournisseur d'API), pour contrôler les noms de modèle auxquels les alias sont mappés.286Vous pouvez utiliser les variables d'environnement suivantes, qui doivent être des **noms de modèle** complets (ou équivalents pour votre fournisseur d'API), pour contrôler les noms de modèle auxquels les alias sont mappés.

287 287

288| Variable d'environnement | Description |288| Variable d'environnement | Description |

289| -------------------------------- | ------------------------------------------------------------------------------------------------------- |289| -------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

291| `ANTHROPIC_DEFAULT_SONNET_MODEL` | Le modèle à utiliser pour `sonnet`, ou pour `opusplan` lorsque le mode Plan n'est pas actif. |291| `ANTHROPIC_DEFAULT_SONNET_MODEL` | Le modèle à utiliser pour `sonnet`, ou pour `opusplan` lorsque le mode Plan n'est pas actif. |

292| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | Le modèle à utiliser pour `haiku`, ou [fonctionnalité d'arrière-plan](/fr/costs#background-token-usage) |292| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | Le modèle à utiliser pour `haiku`, ou [fonctionnalité d'arrière-plan](/fr/costs#background-token-usage) |

293| `CLAUDE_CODE_SUBAGENT_MODEL` | Le modèle à utiliser pour les [subagents](/fr/sub-agents) |293| `CLAUDE_CODE_SUBAGENT_MODEL` | Le modèle à utiliser pour tous les [subagents](/fr/sub-agents#choose-a-model). Remplace à la fois le paramètre `model` par invocation et le frontmatter `model` de la définition du subagent |

294 294

295Remarque : `ANTHROPIC_SMALL_FAST_MODEL` est déprécié au profit de `ANTHROPIC_DEFAULT_HAIKU_MODEL`.295Remarque : `ANTHROPIC_SMALL_FAST_MODEL` est déprécié au profit de `ANTHROPIC_DEFAULT_HAIKU_MODEL`.

296 296

overview.md +1 −1

Details

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.3> Use this file to discover all available pages before exploring further.

4 4

~~5# Aperçu de Claude Code~~5# Aperçu

6 6

7> Claude Code est un outil de codage agentique qui lit votre base de code, modifie les fichiers, exécute des commandes et s'intègre à vos outils de développement. Disponible dans votre terminal, IDE, application de bureau et navigateur.7> Claude Code est un outil de codage agentique qui lit votre base de code, modifie les fichiers, exécute des commandes et s'intègre à vos outils de développement. Disponible dans votre terminal, IDE, application de bureau et navigateur.

8 8

permission-modes.md +3 −1

Details

73 | Mode auto | `auto` |73 | Mode auto | `auto` |

74 | Ignorer les permissions | `bypassPermissions` |74 | Ignorer les permissions | `bypassPermissions` |

75 75

76 Le mode auto apparaît dans l'indicateur de mode après que vous ayez activé **Autoriser l'ignorance dangereuse des permissions** dans les paramètres de l'extension, mais il reste indisponible jusqu'à ce que votre compte réponde à chaque exigence listée dans la [section mode auto](#eliminate-prompts-with-auto-mode). Le paramètre `claudeCode.initialPermissionMode` n'accepte pas `auto` ; pour démarrer en mode auto par défaut, définissez `defaultMode` dans votre [`settings.json`](/fr/settings#settings-files) Claude Code à la place.76 Le mode auto apparaît dans l'indicateur de mode après que vous ayez activé **Autoriser l'ignorance dangereuse des permissions** dans les paramètres de l'extension, mais il reste indisponible jusqu'à ce que votre compte réponde à chaque exigence listée dans la [section mode auto](#eliminate-prompts-with-auto-mode). Le paramètre `claudeCode.initialPermissionMode` n'accepte pas `auto`. Pour démarrer en mode auto par défaut, définissez `defaultMode` dans vos [paramètres utilisateur](/fr/settings#settings-files) à la place. Claude Code ignore `defaultMode: "auto"` dans les paramètres de projet et locaux.

77 77

78 Ignorer les permissions nécessite également le bouton **Autoriser l'ignorance dangereuse des permissions** avant qu'il n'apparaisse dans l'indicateur de mode.78 Ignorer les permissions nécessite également le bouton **Autoriser l'ignorance dangereuse des permissions** avant qu'il n'apparaisse dans l'indicateur de mode.

79 79

179 179

180Si Claude Code signale le mode auto comme indisponible, l'une de ces exigences n'est pas remplie ; ce n'est pas une panne transitoire. Un message séparé qui nomme un modèle et dit que le mode auto « ne peut pas déterminer la sécurité » d'une action est une panne transitoire du classificateur ; consultez la [référence d'erreur](/fr/errors#auto-mode-cannot-determine-the-safety-of-an-action).180Si Claude Code signale le mode auto comme indisponible, l'une de ces exigences n'est pas remplie ; ce n'est pas une panne transitoire. Un message séparé qui nomme un modèle et dit que le mode auto « ne peut pas déterminer la sécurité » d'une action est une panne transitoire du classificateur ; consultez la [référence d'erreur](/fr/errors#auto-mode-cannot-determine-the-safety-of-an-action).

181 181

182Si vous définissez `defaultMode: "auto"` dans les [paramètres](/fr/settings#available-settings) et que la session démarre en mode `default` sans erreur, le paramètre se trouve probablement dans `.claude/settings.json` ou `.claude/settings.local.json`. Claude Code ignore `auto` de ces fichiers afin qu'un dépôt ne puisse pas s'accorder le mode auto. Déplacez-le vers `~/.claude/settings.json`.

183

182### Ce que le classificateur bloque par défaut184### Ce que le classificateur bloque par défaut

183 185

184Le classificateur fait confiance à votre répertoire de travail et aux télécommandes configurées de votre dépôt. Tout le reste est traité comme externe jusqu'à ce que vous [configuriez l'infrastructure de confiance](/fr/auto-mode-config).186Le classificateur fait confiance à votre répertoire de travail et aux télécommandes configurées de votre dépôt. Tout le reste est traité comme externe jusqu'à ce que vous [configuriez l'infrastructure de confiance](/fr/auto-mode-config).

plugin-dependencies.md +24 −0

Details

114 114

115Lorsque vous désinstallez le dernier plugin qui contraint une dépendance, la dépendance n'est plus maintenue et reprend le suivi de son entrée marketplace lors de la prochaine mise à jour.115Lorsque vous désinstallez le dernier plugin qui contraint une dépendance, la dépendance n'est plus maintenue et reprend le suivi de son entrée marketplace lors de la prochaine mise à jour.

116 116

117## Activer ou désactiver un plugin avec des dépendances

118

119L'activation d'un plugin active également les plugins dont il dépend, et la désactivation d'un plugin est bloquée si un autre plugin activé en a toujours besoin. Les deux comportements nécessitent Claude Code v2.1.143 ou version ultérieure. Les versions antérieures activent ou désactivent uniquement le plugin nommé et affichent une erreur `dependency-unsatisfied` au prochain chargement.

120

121Lorsque vous activez un plugin, Claude Code active également ses dépendances au même scope. Si une dépendance a ses propres dépendances, Claude Code les active également. Le message de succès liste ce qui d'autre a été activé avec le plugin que vous avez nommé. Si une dépendance ne peut pas être activée, la commande refuse et vous dit ce qui bloque et comment corriger :

122

123| Condition | Résultat |

124| :------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------- |

125| Une dépendance n'est pas installée | L'activation échoue et affiche la commande `claude plugin install` pour chaque dépendance manquante. |

126| Une dépendance est bloquée par la politique de plugin de votre organisation | L'activation échoue et nomme la dépendance bloquée. |

127| Une dépendance est définie sur `false` à un scope avec une priorité plus élevée que le scope cible | L'activation échoue. Activez la dépendance à ce scope, ou passez `--scope` pour écrire là. |

128| Toutes les dépendances sont installées et autorisées | L'activation réussit et écrit `true` pour le plugin et chaque dépendance qui n'était pas déjà activée au scope cible. |

129

130Lorsque vous désactivez un plugin, Claude Code refuse si un autre plugin activé en dépend toujours. L'erreur nomme les plugins qui en dépendent et vous donne une commande chaînée qui les désactive dans le bon ordre, se terminant par celui que vous avez demandé.

131

132Par exemple, si `deploy-kit` dépend de `secrets-vault`, la désactivation de `secrets-vault` seule échoue avec une sortie similaire à ce qui suit :

133

134```text theme={null}

135secrets-vault is still required by deploy-kit. Disable that plugin first, or

136disable everything together: claude plugin disable deploy-kit@acme-tools && claude plugin disable secrets-vault@acme-tools

137```

138

139Copiez la commande chaînée de l'erreur pour désactiver l'ensemble complet en une seule étape.

140

117## Supprimer les dépendances auto-installées orphelines141## Supprimer les dépendances auto-installées orphelines

118 142

119Les dépendances auto-installées restent sur le disque après la désinstallation des plugins qui les ont installées, au cas où vous réinstalliez un plugin dépendant ou souhaiteriez continuer à utiliser la dépendance directement. Pour les nettoyer, exécutez `claude plugin prune` pour lister les dépendances auto-installées qui n'ont plus aucun plugin installé les exigeant et les supprimer après une invite de confirmation. Cela nécessite Claude Code v2.1.121 ou version ultérieure.143Les dépendances auto-installées restent sur le disque après la désinstallation des plugins qui les ont installées, au cas où vous réinstalliez un plugin dépendant ou souhaiteriez continuer à utiliser la dépendance directement. Pour les nettoyer, exécutez `claude plugin prune` pour lister les dépendances auto-installées qui n'ont plus aucun plugin installé les exigeant et les supprimer après une invite de confirmation. Cela nécessite Claude Code v2.1.121 ou version ultérieure.

plugin-marketplaces.md +3 −2

Details

162 162

163<Note>163<Note>

164 **Noms réservés** : Les noms de place de marché suivants sont réservés à l'usage officiel d'Anthropic et ne peuvent pas être utilisés par les places de marché tierces : `claude-code-marketplace`, `claude-code-plugins`, `claude-plugins-official`, `anthropic-marketplace`, `anthropic-plugins`, `agent-skills`, `knowledge-work-plugins`, `life-sciences`. Les noms qui usurpent l'identité de places de marché officielles (comme `official-claude-plugins` ou `anthropic-tools-v2`) sont également bloqués.164 **Noms réservés** : Les noms de place de marché suivants sont réservés à l'usage officiel d'Anthropic et ne peuvent pas être utilisés par les places de marché tierces : `claude-code-marketplace`, `claude-code-plugins`, `claude-plugins-official`, `anthropic-marketplace`, `anthropic-plugins`, `agent-skills`, `anthropic-agent-skills`, `knowledge-work-plugins`, `life-sciences`. Les noms qui usurpent l'identité de places de marché officielles, comme `official-claude-plugins` ou `anthropic-tools-v2`, sont également bloqués.

165</Note>165</Note>

166 166

167### Champs du propriétaire167### Champs du propriétaire

199**Champs de métadonnées standard :**199**Champs de métadonnées standard :**

200 200

202| :------------ | :------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |202| :------------ | :------ | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

203| `displayName` | string | {/* min-version: 2.1.143 */}Nom lisible affiché dans les surfaces de l'interface utilisateur. Revient à `name` lorsqu'il est omis. Peut contenir des espaces et n'importe quelle casse. Non utilisé pour l'espace de noms ou la recherche. Nécessite Claude Code v2.1.143 ou version ultérieure. |

204| `version` | string | Version du plugin. Si défini (ici ou dans `plugin.json`), le plugin est épinglé à cette chaîne et les utilisateurs ne reçoivent des mises à jour que lorsqu'elle change. Omettez pour revenir au SHA du commit git. Voir [Résolution de version](#version-resolution-and-release-channels). |205| `version` | string | Version du plugin. Si défini (ici ou dans `plugin.json`), le plugin est épinglé à cette chaîne et les utilisateurs ne reçoivent des mises à jour que lorsqu'elle change. Omettez pour revenir au SHA du commit git. Voir [Résolution de version](#version-resolution-and-release-channels). |

plugins-reference.md +9 −4

Details

20 20

21Les plugins ajoutent des skills à Claude Code, créant des raccourcis `/name` que vous ou Claude pouvez invoquer.21Les plugins ajoutent des skills à Claude Code, créant des raccourcis `/name` que vous ou Claude pouvez invoquer.

22 22

~~23**Emplacement** : répertoire `skills/` ou `commands/` à la racine du plugin~~23**Emplacement** : répertoire `skills/` ou `commands/` à la racine du plugin, ou un seul fichier `SKILL.md` à la racine du plugin

24 24

25**Format de fichier** : Les skills sont des répertoires avec `SKILL.md` ; les commandes sont des fichiers markdown simples25**Format de fichier** : Les skills sont des répertoires avec `SKILL.md` ; les commandes sont des fichiers markdown simples

26 26

367```json theme={null}367```json theme={null}

368{368{

369 "name": "plugin-name",369 "name": "plugin-name",

370 "displayName": "Plugin Name",

370 "version": "1.2.0",371 "version": "1.2.0",

371 "description": "Brief plugin description",372 "description": "Brief plugin description",

372 "author": {373 "author": {

412| :------------ | :----- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------- |413| :------------ | :----- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------- |

413| `$schema` | string | URL du schéma JSON pour l'autocomplétion et la validation de l'éditeur. Claude Code ignore ce champ au moment du chargement. | `"https://json.schemastore.org/claude-code-plugin-manifest.json"` |414| `$schema` | string | URL du schéma JSON pour l'autocomplétion et la validation de l'éditeur. Claude Code ignore ce champ au moment du chargement. | `"https://json.schemastore.org/claude-code-plugin-manifest.json"` |

415| `displayName` | string | {/* min-version: 2.1.143 */}Nom lisible affiché dans le sélecteur `/plugin` et autres surfaces de l'interface utilisateur. Revient à `name` quand omis. Contrairement à `name`, peut contenir des espaces et n'importe quelle casse. Non utilisé pour l'espace de noms ou la recherche. Nécessite Claude Code v2.1.143 ou ultérieur. | `"Deployment Tools"` |

414| `version` | string | Optionnel. Version sémantique. La définir épingle le plugin à cette chaîne de version, de sorte que les utilisateurs ne reçoivent des mises à jour que lorsque vous la modifiez. Si elle est omise, Claude Code revient au SHA du commit git, de sorte que chaque commit est traité comme une nouvelle version. Si elle est également définie dans l'entrée de la marketplace, `plugin.json` a la priorité. Consultez [Gestion des versions](#version-management). | `"2.1.0"` |416| `version` | string | Optionnel. Version sémantique. La définir épingle le plugin à cette chaîne de version, de sorte que les utilisateurs ne reçoivent des mises à jour que lorsque vous la modifiez. Si elle est omise, Claude Code revient au SHA du commit git, de sorte que chaque commit est traité comme une nouvelle version. Si elle est également définie dans l'entrée de la marketplace, `plugin.json` a la priorité. Consultez [Gestion des versions](#version-management). | `"2.1.0"` |

416| `author` | object | Informations sur l'auteur | `{"name": "Dev Team", "email": "dev@company.com"}` |418| `author` | object | Informations sur l'auteur | `{"name": "Dev Team", "email": "dev@company.com"}` |

525* Plusieurs chemins peuvent être spécifiés sous forme de tableaux527* Plusieurs chemins peuvent être spécifiés sous forme de tableaux

526* Quand un chemin de skill pointe vers un répertoire qui contient directement un `SKILL.md`, par exemple `"skills": ["./"]` pointant vers la racine du plugin, le champ frontmatter `name` dans `SKILL.md` détermine le nom d'invocation de la skill. Cela donne un nom stable indépendamment du répertoire d'installation. Si `name` n'est pas défini dans le frontmatter, le nom de base du répertoire est utilisé comme secours.528* Quand un chemin de skill pointe vers un répertoire qui contient directement un `SKILL.md`, par exemple `"skills": ["./"]` pointant vers la racine du plugin, le champ frontmatter `name` dans `SKILL.md` détermine le nom d'invocation de la skill. Cela donne un nom stable indépendamment du répertoire d'installation. Si `name` n'est pas défini dans le frontmatter, le nom de base du répertoire est utilisé comme secours.

527 529

530Un plugin qui a un `SKILL.md` à sa racine, aucun sous-répertoire `skills/`, et aucun champ de manifeste `skills` est automatiquement chargé en tant que plugin à une seule skill dans Claude Code v2.1.142 et versions ultérieures. Vous n'avez pas besoin de définir `"skills": ["./"]` dans `plugin.json` pour cette disposition. Le nom d'invocation de la skill suit la même règle que ci-dessus : le champ frontmatter `name`, ou le nom de base du répertoire comme secours.

531

528**Exemples de chemins** :532**Exemples de chemins** :

529 533

530```json theme={null}534```json theme={null}

814 818

815### plugin enable819### plugin enable

816 820

817Activez un plugin désactivé.821Activez un plugin désactivé. Si le plugin déclare des [dépendances](/fr/plugin-dependencies), Claude Code les active transitivement à la même portée, et la commande échoue quand une dépendance n'est pas installée.

818 822

819```bash theme={null}823```bash theme={null}

820claude plugin enable <plugin> [options]824claude plugin enable <plugin> [options]

833 837

834### plugin disable838### plugin disable

835 839

836Désactivez un plugin sans le désinstaller.840Désactivez un plugin sans le désinstaller. Échoue quand un autre plugin activé [dépend de](/fr/plugin-dependencies#enable-or-disable-a-plugin-with-dependencies) la cible. Le message d'erreur inclut une commande chaînée qui désactive d'abord chaque dépendant.

837 841

838```bash theme={null}842```bash theme={null}

839claude plugin disable <plugin> [options]843claude plugin disable <plugin> [options]

889 893

890### plugin details894### plugin details

891 895

892Afficher l'inventaire des composants d'un plugin et le coût en tokens projeté. La sortie liste tous les composants que le plugin contribue, regroupés en tant que Skills (compétences et commandes), Agents, Hooks, et serveurs MCP, ainsi qu'une estimation du nombre de tokens qu'il ajoute à chaque session.896Afficher l'inventaire des composants d'un plugin et le coût en tokens projeté. La sortie liste tous les composants que le plugin contribue, regroupés en tant que Skills, Agents, Hooks, serveurs MCP et serveurs LSP, ainsi qu'une estimation du nombre de tokens qu'il ajoute à chaque session. Le groupe Skills inclut à la fois les entrées `skills/` et `commands/`.

893 897

894```bash theme={null}898```bash theme={null}

895claude plugin details <name>899claude plugin details <name>

922 Agents (0)926 Agents (0)

923 Hooks (1) (harness-only — no model context cost)927 Hooks (1) (harness-only — no model context cost)

924 MCP servers (0)928 MCP servers (0)

929 LSP servers (0)

925 930

926Projected token cost931Projected token cost

927 Always-on: ~180 tok added to every session932 Always-on: ~180 tok added to every session

remote-control.md +1 −1

Details

188* **Le processus local doit continuer à s'exécuter** : Remote Control s'exécute en tant que processus local. Si vous fermez le terminal, quittez VS Code, ou arrêtez autrement le processus `claude`, la session se termine.188* **Le processus local doit continuer à s'exécuter** : Remote Control s'exécute en tant que processus local. Si vous fermez le terminal, quittez VS Code, ou arrêtez autrement le processus `claude`, la session se termine.

189* **Panne réseau prolongée** : si votre machine est allumée mais incapable d'atteindre le réseau pendant plus de dix minutes environ, la session expire et le processus se termine. Exécutez `claude remote-control` à nouveau pour démarrer une nouvelle session.189* **Panne réseau prolongée** : si votre machine est allumée mais incapable d'atteindre le réseau pendant plus de dix minutes environ, la session expire et le processus se termine. Exécutez `claude remote-control` à nouveau pour démarrer une nouvelle session.

190* **Ultraplan déconnecte Remote Control** : le démarrage d'une session [ultraplan](/fr/ultraplan) déconnecte toute session Remote Control active car les deux fonctionnalités occupent l'interface claude.ai/code et une seule peut être connectée à la fois.190* **Ultraplan déconnecte Remote Control** : le démarrage d'une session [ultraplan](/fr/ultraplan) déconnecte toute session Remote Control active car les deux fonctionnalités occupent l'interface claude.ai/code et une seule peut être connectée à la fois.

191* **Certaines commandes sont locales uniquement** : les commandes qui ouvrent un sélecteur interactif dans le terminal, telles que `/mcp`, `/plugin`, ou `/resume`, fonctionnent uniquement à partir de la CLI locale. Les commandes qui produisent une sortie textuelle, y compris `/compact`, `/clear`, `/context`, `/usage`, `/exit`, `/extra-usage`, `/recap`, et `/reload-plugins`, fonctionnent à partir du mobile et du web.191* **Certaines commandes sont locales uniquement** : les commandes qui ouvrent un sélecteur interactif dans le terminal, telles que `/mcp`, `/plugin`, ou `/resume`, fonctionnent uniquement à partir de la CLI locale. Les commandes qui produisent une sortie textuelle, y compris `/compact`, `/clear`, `/context`, `/usage`, `/exit`, `/usage-credits`, `/recap`, et `/reload-plugins`, fonctionnent à partir du mobile et du web.

192 192

193## Dépannage193## Dépannage

194 194

routines.md +1 −1

Details

360 360

361Les routines réduisent l'utilisation de l'abonnement de la même manière que les sessions interactives. En plus des limites d'abonnement standard, les routines ont un plafond quotidien sur le nombre d'exécutions qui peuvent démarrer par compte. Consultez votre consommation actuelle et vos exécutions de routine quotidiennes restantes sur [claude.ai/code/routines](https://claude.ai/code/routines) ou [claude.ai/settings/usage](https://claude.ai/settings/usage).361Les routines réduisent l'utilisation de l'abonnement de la même manière que les sessions interactives. En plus des limites d'abonnement standard, les routines ont un plafond quotidien sur le nombre d'exécutions qui peuvent démarrer par compte. Consultez votre consommation actuelle et vos exécutions de routine quotidiennes restantes sur [claude.ai/code/routines](https://claude.ai/code/routines) ou [claude.ai/settings/usage](https://claude.ai/settings/usage).

362 362

363Lorsqu'une routine atteint le plafond quotidien ou votre limite d'utilisation d'abonnement, les organisations avec utilisation supplémentaire activée peuvent continuer à exécuter les routines sur dépassement mesuré. Sans utilisation supplémentaire, les exécutions supplémentaires sont rejetées jusqu'à la réinitialisation de la fenêtre. Activez l'utilisation supplémentaire à partir de **Settings > Billing** sur claude.ai.363Lorsqu'une routine atteint le plafond quotidien ou votre limite d'utilisation d'abonnement, les organisations avec crédits d'utilisation activés peuvent continuer à exécuter les routines sur dépassement mesuré. Sans crédits d'utilisation, les exécutions supplémentaires sont rejetées jusqu'à la réinitialisation de la fenêtre. Activez les crédits d'utilisation à partir de **Settings > Billing** sur claude.ai.

364 364

365Les exécutions ponctuelles ne comptent pas par rapport au plafond quotidien des routines. Elles réduisent votre utilisation d'abonnement régulière comme toute autre session, mais elles sont exemptes de l'allocation quotidienne d'exécutions de routine par compte.365Les exécutions ponctuelles ne comptent pas par rapport au plafond quotidien des routines. Elles réduisent votre utilisation d'abonnement régulière comme toute autre session, mais elles sont exemptes de l'allocation quotidienne d'exécutions de routine par compte.

366 366

scheduled-tasks.md +1 −1

Details

12 12

13Les tâches planifiées permettent à Claude de réexécuter automatiquement un prompt à intervalles réguliers. Utilisez-les pour interroger un déploiement, surveiller une PR, vérifier une compilation longue ou vous rappeler de faire quelque chose plus tard dans la session. Pour réagir aux événements au fur et à mesure qu'ils se produisent au lieu d'interroger, consultez [Channels](/fr/channels) : votre CI peut pousser l'échec directement dans la session. Pour maintenir la session en fonctionnement tour après tour jusqu'à ce qu'une condition soit remplie plutôt que sur un intervalle, consultez [`/goal`](/fr/goal).13Les tâches planifiées permettent à Claude de réexécuter automatiquement un prompt à intervalles réguliers. Utilisez-les pour interroger un déploiement, surveiller une PR, vérifier une compilation longue ou vous rappeler de faire quelque chose plus tard dans la session. Pour réagir aux événements au fur et à mesure qu'ils se produisent au lieu d'interroger, consultez [Channels](/fr/channels) : votre CI peut pousser l'échec directement dans la session. Pour maintenir la session en fonctionnement tour après tour jusqu'à ce qu'une condition soit remplie plutôt que sur un intervalle, consultez [`/goal`](/fr/goal).

14 14

15Les tâches sont limitées à la session : elles vivent dans la conversation actuelle et s'arrêtent quand vous en commencez une nouvelle. La reprise avec `--resume` ou `--continue` ramène toute tâche qui n'a pas [expiré](#seven-day-expiry) : une tâche récurrente créée au cours des 7 derniers jours, ou une tâche ponctuelle dont l'heure planifiée n'a pas encore passé. Pour une planification qui survit indépendamment de toute session, utilisez [Routines](/fr/routines), [Tâches planifiées sur le bureau](/fr/desktop-scheduled-tasks) ou [GitHub Actions](/fr/github-actions).15Les tâches sont limitées à la session : elles vivent dans la conversation actuelle et s'arrêtent quand vous en commencez une nouvelle. La reprise avec `--resume` ou `--continue` ramène toute tâche qui n'a pas [expiré](#seven-day-expiry) : une tâche récurrente créée au cours des 7 derniers jours, ou une tâche ponctuelle dont l'heure planifiée n'a pas encore passé. Pour une planification qui survit indépendamment de toute session, utilisez [Routines](/fr/routines) pour créer une routine sur l'infrastructure gérée par Anthropic, configurez une [Tâche planifiée sur le bureau](/fr/desktop-scheduled-tasks) ou utilisez [GitHub Actions](/fr/github-actions).

16 16

17## Comparer les options de planification17## Comparer les options de planification

18 18

settings.md +6 −5

Details

224| `prUrlTemplate` | Modèle d'URL pour le badge PR affiché dans le pied de page et dans les résumés de résultats d'outils. Substitue `{host}`, `{owner}`, `{repo}`, `{number}`, et `{url}` à partir de l'URL PR rapportée par `gh`. Utilisez pour pointer les liens PR vers un outil d'examen de code interne au lieu de `github.com`. N'affecte pas les autolinks `#123` dans la prose de Claude | `"https://reviews.example.com/{owner}/{repo}/pull/{number}"` |224| `prUrlTemplate` | Modèle d'URL pour le badge PR affiché dans le pied de page et dans les résumés de résultats d'outils. Substitue `{host}`, `{owner}`, `{repo}`, `{number}`, et `{url}` à partir de l'URL PR rapportée par `gh`. Utilisez pour pointer les liens PR vers un outil d'examen de code interne au lieu de `github.com`. N'affecte pas les autolinks `#123` dans la prose de Claude | `"https://reviews.example.com/{owner}/{repo}/pull/{number}"` |

225| `respectGitignore` | Contrôler si le sélecteur de fichier `@` respecte les modèles `.gitignore`. Quand `true` (par défaut), les fichiers correspondant aux modèles `.gitignore` sont exclus des suggestions | `false` |225| `respectGitignore` | Contrôler si le sélecteur de fichier `@` respecte les modèles `.gitignore`. Quand `true` (par défaut), les fichiers correspondant aux modèles `.gitignore` sont exclus des suggestions | `false` |

226| `showClearContextOnPlanAccept` | Afficher l'option « effacer le contexte » sur l'écran d'acceptation du plan. Par défaut : `false`. Définir à `true` pour restaurer l'option | `true` |226| `showClearContextOnPlanAccept` | Afficher l'option « effacer le contexte » sur l'écran d'acceptation du plan. Par défaut : `false`. Définir à `true` pour restaurer l'option | `true` |

227| `showThinkingSummaries` | Afficher les résumés de [réflexion étendue](/fr/model-config#extended-thinking) dans les sessions interactives. Quand non défini ou `false` (par défaut en mode interactif), les blocs de réflexion sont redactés par l'API et affichés comme un stub réduit. La redaction change uniquement ce que vous voyez, pas ce que le modèle génère : pour réduire les dépenses de réflexion, [réduisez le budget ou désactivez la réflexion](/fr/model-config#extended-thinking) à la place. Le mode non interactif (`-p`) et les appelants SDK reçoivent toujours les résumés indépendamment de ce paramètre | `true` |227| `showThinkingSummaries` | Afficher les résumés de [réflexion étendue](/fr/model-config#extended-thinking) dans les sessions interactives. Quand non défini ou `false` (par défaut en mode interactif), les blocs de réflexion sont redactés par l'API et affichés comme un stub réduit. La redaction change uniquement ce que vous voyez, pas ce que le modèle génère : pour réduire les dépenses de réflexion, [réduisez le budget ou désactivez la réflexion](/fr/model-config#extended-thinking) à la place. Ce paramètre n'a aucun effet en mode non interactif (`-p`), l'Agent SDK, ou les extensions IDE telles que VS Code | `true` |

228| `showTurnDuration` | Afficher les messages de durée de tour après les réponses, par exemple « Cooked for 1m 6s ». Par défaut : `true`. Apparaît dans `/config` comme **Show turn duration** | `false` |228| `showTurnDuration` | Afficher les messages de durée de tour après les réponses, par exemple « Cooked for 1m 6s ». Par défaut : `true`. Apparaît dans `/config` comme **Show turn duration** | `false` |

229| `skillListingBudgetFraction` | {/* min-version: 2.1.105 */}Fraction de la fenêtre de contexte du modèle réservée à l'[énumération des skills](/fr/skills#skill-descriptions-are-cut-short) que Claude voit à chaque tour (par défaut : `0.01` = 1 %). Quand l'énumération dépasse le budget, les descriptions pour les skills les moins utilisés sont réduites à des noms seuls pour que Claude puisse toujours les invoquer mais ne verra pas pourquoi. Augmentez pour garder plus de descriptions visibles au prix de plus de contexte par tour. `/doctor` affiche le nombre de troncatures actuel et quels skills sont affectés. Nécessite Claude Code v2.1.105 ou ultérieur | `0.02` |229| `skillListingBudgetFraction` | {/* min-version: 2.1.105 */}Fraction de la fenêtre de contexte du modèle réservée à l'[énumération des skills](/fr/skills#skill-descriptions-are-cut-short) que Claude voit à chaque tour (par défaut : `0.01` = 1 %). Quand l'énumération dépasse le budget, les descriptions pour les skills les moins utilisés sont réduites à des noms seuls pour que Claude puisse toujours les invoquer mais ne verra pas pourquoi. Augmentez pour garder plus de descriptions visibles au prix de plus de contexte par tour. `/doctor` affiche le nombre de troncatures actuel et quels skills sont affectés. Nécessite Claude Code v2.1.105 ou ultérieur | `0.02` |

230| `skillOverrides` | {/* min-version: 2.1.129 */}Remplacements de visibilité par skill indexés par nom de skill. La valeur est `"on"`, `"name-only"`, `"user-invocable-only"`, ou `"off"`. Vous permet de masquer ou de réduire un skill sans éditer son SKILL.md. Ne s'applique pas aux skills de plugin, qui sont gérés via `/plugin`. Le menu `/skills` écrit ceux-ci dans `.claude/settings.local.json`. Voir [Remplacer la visibilité du skill à partir des paramètres](/fr/skills#override-skill-visibility-from-settings). Nécessite Claude Code v2.1.129 ou ultérieur | `{"legacy-context": "name-only", "deploy": "off"}` |230| `skillOverrides` | {/* min-version: 2.1.129 */}Remplacements de visibilité par skill indexés par nom de skill. La valeur est `"on"`, `"name-only"`, `"user-invocable-only"`, ou `"off"`. Vous permet de masquer ou de réduire un skill sans éditer son SKILL.md. Ne s'applique pas aux skills de plugin, qui sont gérés via `/plugin`. Le menu `/skills` écrit ceux-ci dans `.claude/settings.local.json`. Voir [Remplacer la visibilité du skill à partir des paramètres](/fr/skills#override-skill-visibility-from-settings). Nécessite Claude Code v2.1.129 ou ultérieur | `{"legacy-context": "name-only", "deploy": "off"}` |

268| :---------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------ |268| :---------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------ |

269| `worktree.baseRef` | Quelle ref les nouveaux worktrees branchent. `"fresh"` (par défaut) branche à partir de `origin/<default-branch>` pour un arbre propre correspondant au distant. `"head"` branche à partir de votre `HEAD` local actuel, donc les commits non poussés et l'état de la branche de fonctionnalité sont présents dans le worktree. S'applique à `--worktree`, l'outil `EnterWorktree`, et l'isolation du subagent | `"head"` |269| `worktree.baseRef` | Quelle ref les nouveaux worktrees branchent. `"fresh"` (par défaut) branche à partir de `origin/<default-branch>` pour un arbre propre correspondant au distant. `"head"` branche à partir de votre `HEAD` local actuel, donc les commits non poussés et l'état de la branche de fonctionnalité sont présents dans le worktree. S'applique à `--worktree`, l'outil `EnterWorktree`, et l'isolation du subagent | `"head"` |

270| `worktree.symlinkDirectories` | Répertoires à créer en lien symbolique à partir du référentiel principal dans chaque worktree pour éviter de dupliquer les grands répertoires sur le disque. Aucun répertoire n'est créé en lien symbolique par défaut | `["node_modules", ".cache"]` |270| `worktree.symlinkDirectories` | Répertoires à créer en lien symbolique à partir du référentiel principal dans chaque worktree pour éviter de dupliquer les grands répertoires sur le disque. Aucun répertoire n'est créé en lien symbolique par défaut | `["node_modules", ".cache"]` |

271| `worktree.sparsePaths` | Répertoires à extraire dans chaque worktree via git sparse-checkout (mode cone). Seuls les chemins listés sont écrits sur le disque, ce qui est plus rapide dans les grands monorepos | `["packages/my-app", "shared/utils"]` |271| `worktree.sparsePaths` | Répertoires à extraire dans chaque worktree via git sparse-checkout. Seuls les chemins listés plus les fichiers au niveau racine sont écrits sur le disque, ce qui est plus rapide dans les grands monorepos | `["packages/my-app", "shared/utils"]` |

272| `worktree.bgIsolation` | {/* min-version: 2.1.143 */}Mode d'isolation pour les [sessions de fond](/fr/agent-view#how-file-edits-are-isolated). `"worktree"` (par défaut) bloque `Edit`/`Write` dans le checkout principal jusqu'à ce que `EnterWorktree` soit appelé. `"none"` permet aux tâches de fond d'éditer la copie de travail directement. Nécessite Claude Code v2.1.143 ou ultérieur | `"none"` |

272 273

273Pour copier les fichiers ignorés par git comme `.env` dans les nouveaux worktrees, utilisez un [fichier `.worktreeinclude`](/fr/worktrees#copy-gitignored-files-into-worktrees) dans la racine de votre projet à la place d'un paramètre.274Pour copier les fichiers ignorés par git comme `.env` dans les nouveaux worktrees, utilisez un [fichier `.worktreeinclude`](/fr/worktrees#copy-gitignored-files-into-worktrees) dans la racine de votre projet à la place d'un paramètre.

274 275

275### Paramètres de permission276### Paramètres de permission

276 277

278| :---------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------- |279| :---------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :--------------------------------------------------------------------- |

279| `allow` | Tableau de règles de permission pour autoriser l'utilisation d'outils. Voir [Syntaxe de règle de permission](#permission-rule-syntax) ci-dessous pour les détails de correspondance de modèle | `[ "Bash(git diff *)" ]` |280| `allow` | Tableau de règles de permission pour autoriser l'utilisation d'outils. Voir [Syntaxe de règle de permission](#permission-rule-syntax) ci-dessous pour les détails de correspondance de modèle | `[ "Bash(git diff *)" ]` |

280| `ask` | Tableau de règles de permission pour demander une confirmation lors de l'utilisation d'outils. Voir [Syntaxe de règle de permission](#permission-rule-syntax) ci-dessous | `[ "Bash(git push *)" ]` |281| `ask` | Tableau de règles de permission pour demander une confirmation lors de l'utilisation d'outils. Voir [Syntaxe de règle de permission](#permission-rule-syntax) ci-dessous | `[ "Bash(git push *)" ]` |

281| `deny` | Tableau de règles de permission pour refuser l'utilisation d'outils. Utilisez ceci pour exclure les fichiers sensibles de l'accès de Claude Code. Voir [Syntaxe de règle de permission](#permission-rule-syntax) et [Limitations de permission Bash](/fr/permissions#tool-specific-permission-rules) | `[ "WebFetch", "Bash(curl *)", "Read(./.env)", "Read(./secrets/**)" ]` |282| `deny` | Tableau de règles de permission pour refuser l'utilisation d'outils. Utilisez ceci pour exclure les fichiers sensibles de l'accès de Claude Code. Voir [Syntaxe de règle de permission](#permission-rule-syntax) et [Limitations de permission Bash](/fr/permissions#tool-specific-permission-rules) | `[ "WebFetch", "Bash(curl *)", "Read(./.env)", "Read(./secrets/**)" ]` |

282| `additionalDirectories` | [Répertoires de travail](/fr/permissions#working-directories) supplémentaires pour l'accès aux fichiers. La plupart de la configuration `.claude/` n'est [pas découverte](/fr/permissions#additional-directories-grant-file-access-not-configuration) à partir de ces répertoires | `[ "../docs/" ]` |283| `additionalDirectories` | [Répertoires de travail](/fr/permissions#working-directories) supplémentaires pour l'accès aux fichiers. La plupart de la configuration `.claude/` n'est [pas découverte](/fr/permissions#additional-directories-grant-file-access-not-configuration) à partir de ces répertoires | `[ "../docs/" ]` |

283| `defaultMode` | [Mode de permission](/fr/permission-modes) par défaut lors de l'ouverture de Claude Code. Valeurs valides : `default`, `acceptEdits`, `plan`, `auto`, `dontAsk`, `bypassPermissions`. L'indicateur CLI `--permission-mode` remplace ce paramètre pour une seule session | `"acceptEdits"` |284| `defaultMode` | [Mode de permission](/fr/permission-modes) par défaut lors de l'ouverture de Claude Code. Valeurs valides : `default`, `acceptEdits`, `plan`, `auto`, `dontAsk`, `bypassPermissions`. {/* min-version: 2.1.142 */}À partir de Claude Code v2.1.142, `auto` est ignoré quand défini dans les paramètres de projet ou locaux (`.claude/settings.json`, `.claude/settings.local.json`) pour qu'un référentiel ne puisse pas se donner le mode auto. Définissez-le dans `~/.claude/settings.json` à la place. L'indicateur CLI `--permission-mode` remplace ce paramètre pour une seule session | `"acceptEdits"` |

284| `disableBypassPermissionsMode` | Définir à `"disable"` pour empêcher l'activation du mode `bypassPermissions`. Ceci désactive l'indicateur de ligne de commande `--dangerously-skip-permissions`. Généralement placé dans les [paramètres gérés](/fr/permissions#managed-settings) pour appliquer la politique organisationnelle, mais fonctionne à partir de n'importe quelle portée | `"disable"` |285| `disableBypassPermissionsMode` | Définir à `"disable"` pour empêcher l'activation du mode `bypassPermissions`. Ceci désactive l'indicateur de ligne de commande `--dangerously-skip-permissions`. Généralement placé dans les [paramètres gérés](/fr/permissions#managed-settings) pour appliquer la politique organisationnelle, mais fonctionne à partir de n'importe quelle portée | `"disable"` |

285| `skipDangerousModePermissionPrompt` | Ignorer l'invite de confirmation affichée avant d'entrer en mode bypass permissions via `--dangerously-skip-permissions` ou `defaultMode: "bypassPermissions"`. Ignoré quand défini dans les paramètres de projet (`.claude/settings.json`) pour empêcher les référentiels non fiables d'auto-contourner l'invite | `true` |286| `skipDangerousModePermissionPrompt` | Ignorer l'invite de confirmation affichée avant d'entrer en mode bypass permissions via `--dangerously-skip-permissions` ou `defaultMode: "bypassPermissions"`. Ignoré quand défini dans les paramètres de projet (`.claude/settings.json`) pour empêcher les référentiels non fiables d'auto-contourner l'invite | `true` |

286 287

525 526

526Cette hiérarchie garantit que les politiques organisationnelles sont toujours appliquées tout en permettant aux équipes et aux individus de personnaliser leur expérience. La même précédence s'applique que vous exécutiez Claude Code à partir de la CLI, de l'[extension VS Code](/fr/vs-code), ou d'un [IDE JetBrains](/fr/jetbrains).527Cette hiérarchie garantit que les politiques organisationnelles sont toujours appliquées tout en permettant aux équipes et aux individus de personnaliser leur expérience. La même précédence s'applique que vous exécutiez Claude Code à partir de la CLI, de l'[extension VS Code](/fr/vs-code), ou d'un [IDE JetBrains](/fr/jetbrains).

527 528

528Par exemple, si vos paramètres utilisateur autorisent `Bash(npm run *)` mais que les paramètres partagés d'un projet le refusent, le paramètre de projet a la priorité et la commande est bloquée.529Par exemple, si vos paramètres utilisateur définissent `permissions.defaultMode` à `acceptEdits` et que les paramètres partagés d'un projet le définissent à `default`, la valeur du projet s'applique. L'exemple ci-dessous couvre comment les paramètres avec valeur de tableau tels que les règles de permission se combinent à la place.

529 530

530<Note>531<Note>

531 **Les paramètres de tableau fusionnent entre les portées.** Quand le même paramètre avec valeur de tableau (tel que `sandbox.filesystem.allowWrite` ou `permissions.allow`) apparaît dans plusieurs portées, les tableaux sont **concaténés et dédupliqués**, non remplacés. Cela signifie que les portées de priorité inférieure peuvent ajouter des entrées sans remplacer celles définies par les portées de priorité supérieure, et vice versa. Par exemple, si les paramètres gérés définissent `allowWrite` à `["/opt/company-tools"]` et qu'un utilisateur ajoute `["~/.kube"]`, les deux chemins sont inclus dans la configuration finale.532 **Les paramètres de tableau fusionnent entre les portées.** Quand le même paramètre avec valeur de tableau (tel que `sandbox.filesystem.allowWrite` ou `permissions.allow`) apparaît dans plusieurs portées, les tableaux sont **concaténés et dédupliqués**, non remplacés. Cela signifie que les portées de priorité inférieure peuvent ajouter des entrées sans remplacer celles définies par les portées de priorité supérieure, et vice versa. Par exemple, si les paramètres gérés définissent `allowWrite` à `["/opt/company-tools"]` et qu'un utilisateur ajoute `["~/.kube"]`, les deux chemins sont inclus dans la configuration finale.

skills.md +3 −3

Details

437Les skills et les [subagents](/fr/sub-agents) fonctionnent ensemble dans deux directions :437Les skills et les [subagents](/fr/sub-agents) fonctionnent ensemble dans deux directions :

438 438

440| :--------------------------- | :---------------------------------------- | :------------------------------ | :----------------------------- |440| :--------------------------- | :------------------------- | :------------------------------ | :------------------------------------------------ |

443 443

444Avec `context: fork`, vous écrivez la tâche dans votre skill et choisissez un type d'agent pour l'exécuter. Pour l'inverse (définir un subagent personnalisé qui utilise les skills comme matériel de référence), voir [Subagents](/fr/sub-agents#preload-skills-into-subagents).444Avec `context: fork`, vous écrivez la tâche dans votre skill et choisissez un type d'agent pour l'exécuter. Les agents intégrés Explore et Plan [ignorent CLAUDE.md et git status](/fr/sub-agents#what-loads-at-startup) pour garder leur contexte petit, donc une skill forquée utilisant `agent: Explore` ne voit que le contenu de SKILL.md et le prompt système propre de l'agent. Pour l'inverse, où vous définissez un subagent personnalisé qui utilise les skills comme matériel de référence, voir [Subagents](/fr/sub-agents#preload-skills-into-subagents).

445 445

446#### Exemple : Skill de recherche utilisant l'agent Explore446#### Exemple : Skill de recherche utilisant l'agent Explore

447 447

statusline.md +6 −1

Details

916 916

917### Configuration Windows917### Configuration Windows

918 918

919Sur Windows, Claude Code exécute les commandes de barre de statut via Git Bash quand Git Bash est installé, ou via PowerShell quand Git Bash est absent. Pour exécuter un script PowerShell comme votre barre de statut, invoquez-le via `powershell` ; cela fonctionne à partir de l'un ou l'autre shell :919Sur Windows, Claude Code exécute les commandes de barre de statut via Git Bash quand Git Bash est installé, ou via PowerShell quand Git Bash est absent.

920

921Git Bash traite les barres obliques inverses non échappées comme des caractères d'échappement, donc un chemin de style Windows comme `C:\Users\username\script.mjs` atteint le script runner avec ses séparateurs supprimés et la commande échoue sans erreur visible. Écrivez les chemins de fichiers dans la chaîne `command` avec des barres obliques avant, comme indiqué dans les exemples ci-dessous. Le raccourci `~` fonctionne également et se développe dans votre répertoire personnel Windows.

922

923Pour exécuter un script PowerShell comme votre barre de statut, invoquez-le via `powershell`. Cela fonctionne que Claude Code achemine la commande via Git Bash ou PowerShell :

920 924

921<CodeGroup>925<CodeGroup>

922 ```json settings.json theme={null}926 ```json settings.json theme={null}

999* Vérifiez que votre script est exécutable : `chmod +x ~/.claude/statusline.sh`1003* Vérifiez que votre script est exécutable : `chmod +x ~/.claude/statusline.sh`

1000* Vérifiez que votre script affiche sur stdout, pas stderr1004* Vérifiez que votre script affiche sur stdout, pas stderr

1001* Exécutez votre script manuellement pour vérifier qu'il produit une sortie1005* Exécutez votre script manuellement pour vérifier qu'il produit une sortie

1006* Sur Windows avec Git Bash installé, les barres obliques inverses dans le chemin `command` sont probablement consommées comme caractères d'échappement avant l'exécution du script. Utilisez des barres obliques avant dans le chemin. Voir [Configuration Windows](#windows-configuration).

1002* Si `disableAllHooks` est défini sur `true` dans vos paramètres, la barre de statut est également désactivée. Supprimez ce paramètre ou définissez-le sur `false` pour le réactiver.1007* Si `disableAllHooks` est défini sur `true` dans vos paramètres, la barre de statut est également désactivée. Supprimez ce paramètre ou définissez-le sur `false` pour le réactiver.

1003* Exécutez `claude --debug` pour enregistrer le code de sortie et stderr de la première invocation de barre de statut dans une session1008* Exécutez `claude --debug` pour enregistrer le code de sortie et stderr de la première invocation de barre de statut dans une session

1004* Demandez à Claude de lire votre fichier de paramètres et d'exécuter la commande `statusLine` directement pour afficher les erreurs1009* Demandez à Claude de lire votre fichier de paramètres et d'exécuter la commande `statusLine` directement pour afficher les erreurs

sub-agents.md +31 −1

Details

37 37

38Claude Code inclut des sous-agents intégrés que Claude utilise automatiquement le cas échéant. Chacun hérite des permissions de la conversation parent avec des restrictions d'outils supplémentaires.38Claude Code inclut des sous-agents intégrés que Claude utilise automatiquement le cas échéant. Chacun hérite des permissions de la conversation parent avec des restrictions d'outils supplémentaires.

39 39

40Explore et Plan ignorent vos fichiers CLAUDE.md et l'état git de la session parent pour maintenir la recherche rapide et économique. Tous les autres sous-agents intégrés et [sous-agents personnalisés](#configure-subagents) chargent les deux. Pour la ventilation complète de ce qui atteint un sous-agent, consultez [ce qui se charge au démarrage](#what-loads-at-startup).

40<Tabs>42<Tabs>

41 <Tab title="Explore">43 <Tab title="Explore">

42 Un agent rapide et en lecture seule optimisé pour la recherche et l'analyse de bases de code.44 Un agent rapide et en lecture seule optimisé pour la recherche et l'analyse de bases de code.

652 654

653Cela fonctionne avec les sous-agents intégrés et personnalisés, et le choix persiste lorsque vous reprenez la session.655Cela fonctionne avec les sous-agents intégrés et personnalisés, et le choix persiste lorsque vous reprenez la session.

654 656

655Pour un sous-agent fourni par un plugin, passez le nom délimité : `claude --agent <plugin-name>:<agent-name>`. Si le plugin place l'agent dans un sous-dossier de son répertoire `agents/`, incluez le sous-dossier dans le nom délimité, par exemple `claude --agent my-plugin:review:security`.657Pour un sous-agent fourni par un plugin, vous pouvez passer simplement le nom de l'agent et Claude Code le trouvera :

658

659```bash theme={null}

660claude --agent security-reviewer

661```

662

663Si plusieurs plugins fournissent des agents avec le même nom, passez le nom délimité pour lever l'ambiguïté :

664

665```bash theme={null}

666claude --agent my-plugin:security-reviewer

667```

668

669Si le plugin place l'agent dans un sous-dossier de son répertoire `agents/`, incluez le sous-dossier dans le nom délimité, par exemple `claude --agent my-plugin:review:security`.

656 670

657Pour en faire la valeur par défaut pour chaque session dans un projet, définissez `agent` dans `.claude/settings.json` :671Pour en faire la valeur par défaut pour chaque session dans un projet, définissez `agent` dans `.claude/settings.json` :

658 672

741 755

742### Gérer le contexte du sous-agent756### Gérer le contexte du sous-agent

743 757

758#### Ce qui se charge au démarrage

759

760Chaque sous-agent démarre avec une fenêtre de contexte fraîche et isolée. Il ne voit pas votre historique de conversation, les skills que vous avez déjà invoqués, ou les fichiers que Claude a déjà lus. Claude compose un message de délégation qui résume la tâche, et le sous-agent travaille à partir de là. L'exception est un [fork](#fork-the-current-conversation), qui hérite de la conversation parent au lieu de commencer à zéro.

761

762Le contexte initial d'un sous-agent non-fork contient :

763

764* **Invite système** : l'invite propre de l'agent plus les détails d'environnement que Claude Code ajoute, pas l'invite système complète de Claude Code. Les sous-agents personnalisés définissent la leur dans le [corps markdown](#write-subagent-files) ou le champ `prompt`. Les agents intégrés ont des invites prédéfinies.

765* **Message de tâche** : l'invite de délégation que Claude écrit lorsqu'il confie le travail.

766* **CLAUDE.md et mémoire** : chaque niveau de la [hiérarchie de mémoire](/fr/memory#how-claude-md-files-load) que la conversation principale charge, y compris `~/.claude/CLAUDE.md`, les règles du projet, `CLAUDE.local.md`, et les fichiers de politique gérés. Les agents Explore et Plan intégrés ignorent cela.

767* **Statut Git** : un instantané pris au début de la session parent. Absent lorsque le répertoire de travail n'est pas un référentiel Git ou lorsque [`includeGitInstructions`](/fr/settings#available-settings) est `false`. Explore et Plan l'ignorent de toute façon.

768* **Skills préchargés** : contenu complet de tout skill nommé dans le champ [`skills`](#preload-skills-into-subagents) de l'agent. Les agents intégrés ne préchargent pas les skills.

769

770Explore et Plan sont les seuls sous-agents qui omettent CLAUDE.md et le statut git. Il n'y a pas de champ frontmatter ou de paramètre par agent pour modifier les agents qui les ignorent.

771

772La conversation principale lit les résultats d'Explore et Plan avec le contexte CLAUDE.md complet, donc la plupart des règles n'ont pas besoin d'atteindre le sous-agent lui-même. Si une règle doit le faire, comme « ignorer le répertoire `vendor/` », reformulez-la dans l'invite que vous donnez à Claude lors de la délégation.

773

744#### Reprendre les sous-agents774#### Reprendre les sous-agents

745 775

746Chaque invocation de sous-agent crée une nouvelle instance avec un contexte frais. Pour continuer le travail d'un sous-agent existant au lieu de recommencer, demandez à Claude de le reprendre.776Chaque invocation de sous-agent crée une nouvelle instance avec un contexte frais. Pour continuer le travail d'un sous-agent existant au lieu de recommencer, demandez à Claude de le reprendre.

tools-reference.md +2 −1

Details

45| `TaskUpdate` | Met à jour le statut de la tâche, les dépendances, les détails, ou supprime les tâches | Non |45| `TaskUpdate` | Met à jour le statut de la tâche, les dépendances, les détails, ou supprime les tâches | Non |

46| `TeamCreate` | Crée une [équipe d'agents](/fr/agent-teams) avec plusieurs coéquipiers. Disponible uniquement quand `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` est défini | Non |46| `TeamCreate` | Crée une [équipe d'agents](/fr/agent-teams) avec plusieurs coéquipiers. Disponible uniquement quand `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` est défini | Non |

47| `TeamDelete` | Dissout une équipe d'agents et nettoie les processus des coéquipiers. Disponible uniquement quand `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` est défini | Non |47| `TeamDelete` | Dissout une équipe d'agents et nettoie les processus des coéquipiers. Disponible uniquement quand `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` est défini | Non |

48| `TodoWrite` | Gère la liste de contrôle des tâches de la session. Disponible en mode non interactif et dans le [SDK Agent](/fr/headless) ; les sessions interactives utilisent TaskCreate, TaskGet, TaskList et TaskUpdate à la place | Non |48| `TodoWrite` | {/* min-version: 2.1.142 */}Gère la liste de contrôle des tâches de la session. Désactivé par défaut à partir de v2.1.142 en faveur de `TaskCreate`, `TaskGet`, `TaskList`, et `TaskUpdate`. Définissez `CLAUDE_CODE_ENABLE_TASKS=0` pour réactiver | Non |

49| `ToolSearch` | Recherche et charge les outils différés quand la [recherche d'outils](/fr/mcp#scale-with-mcp-tool-search) est activée | Non |49| `ToolSearch` | Recherche et charge les outils différés quand la [recherche d'outils](/fr/mcp#scale-with-mcp-tool-search) est activée | Non |

50| `WaitForMcpServers` | {/* min-version: 2.1.142 */}Attend un ou plusieurs [serveurs MCP](/fr/mcp) qui se connectent toujours en arrière-plan, afin qu'une demande puisse utiliser leurs outils sans redémarrer la session. Claude l'appelle quand un serveur nécessaire n'est pas encore connecté. N'apparaît que quand la [recherche d'outils](/fr/mcp#scale-with-mcp-tool-search) est désactivée, puisque `ToolSearch` gère l'attente quand elle est activée | Non |

50| `WebFetch` | Récupère le contenu d'une URL spécifiée. Voir [comportement de l'outil WebFetch](#webfetch-tool-behavior) | Oui |51| `WebFetch` | Récupère le contenu d'une URL spécifiée. Voir [comportement de l'outil WebFetch](#webfetch-tool-behavior) | Oui |

51| `WebSearch` | Effectue des recherches web. Voir [comportement de l'outil WebSearch](#websearch-tool-behavior) | Oui |52| `WebSearch` | Effectue des recherches web. Voir [comportement de l'outil WebSearch](#websearch-tool-behavior) | Oui |

52| `Write` | Crée ou remplace des fichiers. Voir [comportement de l'outil Write](#write-tool-behavior) | Oui |53| `Write` | Crée ou remplace des fichiers. Voir [comportement de l'outil Write](#write-tool-behavior) | Oui |

ultrareview.md +1 −1

Details

56 56

57Les abonnés Pro et Max reçoivent trois exécutions ultrareview gratuites pour essayer la fonctionnalité. Ces trois exécutions sont une allocation unique par compte et ne se renouvellent pas. Après les avoir utilisées ou après la fin de la période d'exécutions gratuites, chaque révision est facturée à l'utilisation supplémentaire et coûte généralement entre 5 et 20 dollars selon la taille du changement. Une exécution compte une fois que la session à distance démarre, donc une révision que vous arrêtez tôt ou qui ne se termine pas utilise quand même une exécution gratuite. Pour une révision payante, l'utilisation supplémentaire est facturée uniquement pour la portion qui a été exécutée.57Les abonnés Pro et Max reçoivent trois exécutions ultrareview gratuites pour essayer la fonctionnalité. Ces trois exécutions sont une allocation unique par compte et ne se renouvellent pas. Après les avoir utilisées ou après la fin de la période d'exécutions gratuites, chaque révision est facturée à l'utilisation supplémentaire et coûte généralement entre 5 et 20 dollars selon la taille du changement. Une exécution compte une fois que la session à distance démarre, donc une révision que vous arrêtez tôt ou qui ne se termine pas utilise quand même une exécution gratuite. Pour une révision payante, l'utilisation supplémentaire est facturée uniquement pour la portion qui a été exécutée.

58 58

59Parce que ultrareview facture toujours l'utilisation supplémentaire en dehors des exécutions gratuites, votre compte ou organisation doit avoir l'utilisation supplémentaire activée avant de pouvoir lancer une révision payante. Si l'utilisation supplémentaire n'est pas activée, Claude Code bloque le lancement et vous renvoie aux paramètres de facturation où vous pouvez l'activer. Vous pouvez également exécuter `/extra-usage` pour vérifier ou modifier votre paramètre actuel.59Parce que ultrareview facture toujours l'utilisation supplémentaire en dehors des exécutions gratuites, votre compte ou organisation doit avoir l'utilisation supplémentaire activée avant de pouvoir lancer une révision payante. Si l'utilisation supplémentaire n'est pas activée, Claude Code bloque le lancement et vous renvoie aux paramètres de facturation où vous pouvez l'activer. Vous pouvez également exécuter `/usage-credits` pour vérifier ou modifier votre paramètre actuel.

60 60

61## Suivre une révision en cours61## Suivre une révision en cours

62 62

Documentation 2026-05-17 01:01 UTC to 2026-05-18 23:59 UTC