Documentation — Spybara

admin-setup.md +1 −0

Details

74| [Contrôle du serveur MCP](/fr/mcp#managed-mcp-configuration) | Restreindre les serveurs MCP que les utilisateurs peuvent ajouter ou connecter | `allowedMcpServers`, `deniedMcpServers`, `allowManagedMcpServersOnly` |74| [Contrôle du serveur MCP](/fr/mcp#managed-mcp-configuration) | Restreindre les serveurs MCP que les utilisateurs peuvent ajouter ou connecter | `allowedMcpServers`, `deniedMcpServers`, `allowManagedMcpServersOnly` |

75| [Contrôle de la place de marché des plugins](/fr/plugin-marketplaces#managed-marketplace-restrictions) | Restreindre les sources de place de marché que les utilisateurs peuvent ajouter et installer | `strictKnownMarketplaces`, `blockedMarketplaces` |75| [Contrôle de la place de marché des plugins](/fr/plugin-marketplaces#managed-marketplace-restrictions) | Restreindre les sources de place de marché que les utilisateurs peuvent ajouter et installer | `strictKnownMarketplaces`, `blockedMarketplaces` |

76| [Restrictions des hooks](/fr/settings#hook-configuration) | Seuls les hooks gérés se chargent ; restreindre les URL des hooks HTTP | `allowManagedHooksOnly`, `allowedHttpHookUrls` |76| [Restrictions des hooks](/fr/settings#hook-configuration) | Seuls les hooks gérés se chargent ; restreindre les URL des hooks HTTP | `allowManagedHooksOnly`, `allowedHttpHookUrls` |

77| [Désactiver la vue agent](/fr/agent-view#how-background-sessions-are-hosted) | Désactiver `claude agents`, `--bg`, `/background`, et le superviseur à la demande | `disableAgentView` |

78 79

79Les règles de permission et le sandboxing couvrent différentes couches. Refuser WebFetch bloque l'outil fetch de Claude, mais si Bash est autorisé, `curl` et `wget` peuvent toujours atteindre n'importe quelle URL. Le sandboxing ferme cette lacune avec une liste blanche de domaines réseau appliquée au niveau du système d'exploitation.80Les règles de permission et le sandboxing couvrent différentes couches. Refuser WebFetch bloque l'outil fetch de Claude, mais si Bash est autorisé, `curl` et `wget` peuvent toujours atteindre n'importe quelle URL. Le sandboxing ferme cette lacune avec une liste blanche de domaines réseau appliquée au niveau du système d'exploitation.

agent-sdk/overview.md +2 −1

Details

90 Le SDK prend également en charge l'authentification via des fournisseurs d'API tiers :90 Le SDK prend également en charge l'authentification via des fournisseurs d'API tiers :

91 91

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

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

93 * **Google Vertex AI** : définissez la variable d'environnement `CLAUDE_CODE_USE_VERTEX=1` et configurez les identifiants Google Cloud94 * **Google Vertex AI** : définissez la variable d'environnement `CLAUDE_CODE_USE_VERTEX=1` et configurez les identifiants Google Cloud

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

95 96

~~96 Consultez les guides de configuration pour [Bedrock](/fr/amazon-bedrock), [Vertex AI](/fr/google-vertex-ai), ou [Azure AI Foundry](/fr/microsoft-foundry) pour plus de détails.~~97 Consultez les guides de configuration pour [Bedrock](/fr/amazon-bedrock), [Claude Platform on AWS](/fr/claude-platform-on-aws), [Vertex AI](/fr/google-vertex-ai), ou [Azure AI Foundry](/fr/microsoft-foundry) pour plus de détails.

97 98

98 <Note>99 <Note>

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

agent-sdk/python.md +8 −6

Details

2608 2608

2609```python theme={null}2609```python theme={null}

2610{2610{

2611 "response": str, # AI model's response to the prompt2611 "bytes": int, # Size of the fetched content in bytes

2612 "code": int, # HTTP response code

2613 "codeText": str, # HTTP response code text

2614 "result": str, # Processed result from applying the prompt to the content

2615 "durationMs": int, # Time to fetch and process the content, in milliseconds

2612 "url": str, # URL that was fetched2616 "url": str, # URL that was fetched

2613 "final_url": str | None, # Final URL after redirects

2614 "status_code": int | None, # HTTP status code

2615}2617}

2616```2618```

2617 2619

2633 2635

2634```python theme={null}2636```python theme={null}

2635{2637{

2636 "results": [{"title": str, "url": str, "snippet": str, "metadata": dict | None}],2638 "query": str, # The search query

2637 "total_results": int,2639 "results": list[str | {"tool_use_id": str, "content": list[{"title": str, "url": str}]}],

2638 "query": str,2640 "durationSeconds": float, # Search duration in seconds

2639}2641}

2640```2642```

2641 2643

agent-sdk/quickstart.md +3 −2

Details

75 Le SDK prend également en charge l'authentification via des fournisseurs d'API tiers :75 Le SDK prend également en charge l'authentification via des fournisseurs d'API tiers :

76 76

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

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

78 * **Google Vertex AI** : définissez la variable d'environnement `CLAUDE_CODE_USE_VERTEX=1` et configurez les identifiants Google Cloud79 * **Google Vertex AI** : définissez la variable d'environnement `CLAUDE_CODE_USE_VERTEX=1` et configurez les identifiants Google Cloud

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

80 81

~~81 Consultez les guides de configuration pour [Bedrock](/fr/amazon-bedrock), [Vertex AI](/fr/google-vertex-ai) ou [Azure AI Foundry](/fr/microsoft-foundry) pour plus de détails.~~82 Consultez les guides de configuration pour [Bedrock](/fr/amazon-bedrock), [Claude Platform on AWS](/fr/claude-platform-on-aws), [Vertex AI](/fr/google-vertex-ai) ou [Azure AI Foundry](/fr/microsoft-foundry) pour plus de détails.

82 83

83 <Note>84 <Note>

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

173 174

1742. **`prompt`** : ce que vous voulez que Claude fasse. Claude détermine les outils à utiliser en fonction de la tâche.1752. **`prompt`** : ce que vous voulez que Claude fasse. Claude détermine les outils à utiliser en fonction de la tâche.

175 176

1763. **`options`** : configuration de l'agent. Cet exemple utilise `allowedTools` pour pré-approuver `Read`, `Edit` et `Glob`, et `permissionMode: "acceptEdits"` pour approuver automatiquement les modifications de fichiers. Les autres options incluent `systemPrompt`, `mcpServers` et bien d'autres. Consultez toutes les options pour [Python](/fr/agent-sdk/python#claude-agent-options) ou [TypeScript](/fr/agent-sdk/typescript#options).1773. **`options`** : configuration de l'agent. Cet exemple utilise `allowedTools` pour pré-approuver `Read`, `Edit` et `Glob`, et `permissionMode: "acceptEdits"` pour approuver automatiquement les modifications de fichiers. Les autres options incluent `systemPrompt`, `mcpServers` et bien d'autres. Consultez toutes les options pour [Python](/fr/agent-sdk/python#claudeagentoptions) ou [TypeScript](/fr/agent-sdk/typescript#options).

177 178

178La boucle `async for` continue de s'exécuter tandis que Claude réfléchit, appelle des outils, observe les résultats et décide de la prochaine étape. Chaque itération produit un message : le raisonnement de Claude, un appel d'outil, un résultat d'outil ou le résultat final. Le SDK gère l'orchestration (exécution des outils, gestion du contexte, tentatives) afin que vous consommiez simplement le flux. La boucle se termine lorsque Claude termine la tâche ou rencontre une erreur.179La boucle `async for` continue de s'exécuter tandis que Claude réfléchit, appelle des outils, observe les résultats et décide de la prochaine étape. Chaque itération produit un message : le raisonnement de Claude, un appel d'outil, un résultat d'outil ou le résultat final. Le SDK gère l'orchestration (exécution des outils, gestion du contexte, tentatives) afin que vous consommiez simplement le flux. La boucle se termine lorsque Claude termine la tâche ou rencontre une erreur.

179 180

agent-view.md +293 −0 created

Details

1> ## Documentation Index

2> 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.

5# Gérer plusieurs agents avec la vue agent

7> Lancez et gérez plusieurs sessions Claude Code à partir d'un seul écran. La vue agent affiche ce que chaque session fait et lesquelles ont besoin de votre intervention.

9La vue agent, ouverte avec `claude agents`, est un seul écran pour toutes vos sessions en arrière-plan : ce qui s'exécute, ce qui a besoin de votre intervention, et ce qui est terminé. Lancez de nouvelles sessions, observez leur état en un coup d'œil au lieu de faire défiler les transcriptions, et intervenez uniquement quand l'une d'elles a besoin de vous. Les sessions continuent de s'exécuter en arrière-plan sans terminal attaché.

11Utilisez la vue agent quand vous avez plusieurs tâches indépendantes sur lesquelles Claude peut travailler simultanément, comme corriger un bug, examiner une pull request, ou enquêter sur un journal. Quand vous voulez résoudre un problème ensemble, attachez-vous à une session et utilisez Claude Code de manière interactive comme d'habitude. Les sessions dans la vue agent s'exécutent indépendamment et ne rapportent qu'à vous. Pour comparer avec les sous-agents, les équipes d'agents et les worktrees, consultez [Exécuter les agents en parallèle](/fr/agents).

13<Note>

14 La vue agent est un aperçu de recherche et nécessite Claude Code v2.1.139 ou ultérieur. Vérifiez votre version avec `claude --version`. L'interface et les raccourcis clavier peuvent changer à mesure que la fonctionnalité évolue, et les administrateurs peuvent désactiver la vue agent pour une organisation avec le paramètre géré [`disableAgentView`](#how-background-sessions-are-hosted).

15</Note>

17Cette page couvre :

19* [Démarrage rapide](#quick-start)

20* [Surveiller les sessions avec la vue agent](#monitor-sessions-with-agent-view), y compris les icônes d'état, l'aperçu et la réponse, l'attachement, l'organisation et les raccourcis clavier

21* [Lancer de nouveaux agents](#dispatch-new-agents) à partir de la vue agent, depuis l'intérieur d'une session, ou depuis le shell

22* [Gérer les sessions depuis le shell](#manage-sessions-from-the-shell)

23* [Comment les sessions en arrière-plan sont hébergées](#how-background-sessions-are-hosted) par le processus superviseur

25## Démarrage rapide

27Cette procédure pas à pas ouvre la vue agent, lance une session, répond depuis le panneau d'aperçu, et s'attache pour la conversation complète.

29<Steps>

30 <Step title="Ouvrir la vue agent">

31 Depuis votre shell, exécutez :

33 ```bash theme={null}

34 claude agents

35 ```

37 La vue agent s'ouvre avec une entrée en bas et un tableau qui se remplit au fur et à mesure que les sessions commencent. Appuyez sur `Esc` à tout moment pour quitter. Vos sessions continuent de s'exécuter.

38 </Step>

40 <Step title="Lancer une session">

41 Tapez une invite dans l'entrée et appuyez sur `Entrée`. Une nouvelle session démarre et apparaît sous forme de ligne indiquant si elle fonctionne, attend votre intervention, ou est terminée. Répétez pour exécuter autant de sessions en parallèle que vous le souhaitez.

42 </Step>

44 <Step title="Aperçu et réponse">

45 Sélectionnez une ligne avec les touches fléchées et appuyez sur `Espace` pour voir ce que la session fait ou ce qu'elle a besoin de vous. Tapez une réponse et appuyez sur `Entrée` pour l'envoyer sans quitter la vue agent.

46 </Step>

48 <Step title="Attacher et détacher">

49 Appuyez sur `Entrée` ou `→` sur une ligne pour vous attacher quand vous voulez la conversation complète. La session prend le contrôle du terminal exactement comme si vous aviez exécuté `claude`. Appuyez sur `←` sur une invite vide pour vous détacher et revenir au tableau.

50 </Step>

51</Steps>

53Pour amener une session interactive existante dans la vue agent, exécutez `/bg` à l'intérieur, ou appuyez sur `←` sur une invite vide pour mettre la session en arrière-plan et ouvrir la vue agent en une seule étape. La session continue de s'exécuter en arrière-plan et apparaît sous forme de ligne. Pour démarrer une nouvelle session en arrière-plan directement depuis le shell, exécutez `claude --bg "<prompt>"`.

55Vous pouvez utiliser `claude agents` comme point d'entrée principal au lieu de `claude` : lancez chaque tâche à partir de la vue agent, attachez-vous quand vous voulez la conversation complète, et appuyez sur `←` pour revenir au tableau.

57## Surveiller les sessions avec la vue agent

59Exé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.

61La liste est globale à votre machine et inclut chaque session en arrière-plan quel que soit le projet ou la worktree sur laquelle elle travaille. 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), et les [sous-agents](/fr/sub-agents) s'exécutant à l'intérieur d'une session ne sont pas répertoriés comme des lignes séparées.

63```text theme={null}

64Épinglées

65 ✽ clawd walk cycle Write assets/sprites/clawd-walk.png 3m

67Prêtes pour examen

68 ∙ jump physics github.com/anthropics/example/pull/2048 2h

70Nécessite une intervention

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

73En cours

74 ✽ collision detection Edit src/physics/CollisionSystem.ts 2m

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

77Terminées

78 ✻ title screen result: menu, options, and credits done 9m

79 ∙ sound effects result: 14 SFX exported to assets/audio 4h

80 … 6 more

81```

83L'icône vous indique l'état de la session :

85| Icône | État | Ce que cela signifie |

86| :------- | :------------------------- | :--------------------------------------------------------------------------------------- |

87| Animée | En cours | Claude exécute activement des outils ou génère une réponse |

88| Jaune | Nécessite une intervention | Claude attend votre intervention, généralement une décision de permission ou une réponse |

89| Estompée | Inactif | La session attend une intervention mais n'est pas bloquée sur une question spécifique |

90| Verte | Terminée | La tâche s'est terminée avec succès |

91| Rouge | Échouée | La tâche s'est terminée avec une erreur |

92| Grise | Arrêtée | La session a été arrêtée avec `Ctrl+X` ou `claude stop` |

94La forme de l'icône vous indique si le processus sous-jacent s'exécute toujours. Un `✻`, ou un `✽` animé pendant que Claude travaille, signifie que la session est active et vous pouvez lui répondre immédiatement. Un `∙` signifie que le processus a quitté, mais vous pouvez toujours apercevoir, répondre, ou vous attacher : Claude redémarre la session à partir de là où elle s'était arrêtée. Un `✢` est une session [`/loop`](/fr/commands) dormant entre les itérations, la ligne affichant son nombre d'exécutions et un compte à rebours jusqu'à la prochaine itération.

96Les sessions en arrière-plan n'ont besoin d'aucun terminal ouvert pour continuer à fonctionner. Un [processus superviseur](#how-background-sessions-are-hosted) 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.

98Les sessions persistent sur le disque : fermer votre terminal ou une mise à jour automatique ne les perd pas, et rouvrir `claude agents` les affiche toutes. Si votre machine se met en veille ou s'éteint, les sessions en cours s'arrêtent ; redémarrez-les avec `claude respawn --all`.

100Le résumé d'une ligne dans chaque ligne est généré par votre [modèle de classe Haiku](/fr/model-config) configuré afin que la ligne puisse vous dire ce que la session fait, ce qu'elle a besoin, ou ce qu'elle a produit sans ouvrir la transcription. Chaque résumé est une courte demande de classe Haiku via votre fournisseur normal, facturée et traitée selon les mêmes [conditions d'utilisation des données](/fr/data-usage) que la session elle-même.

101

102Quand une session ouvre une pull request, la ligne affiche le lien PR et un indicateur d'état pour ses vérifications CI. Pour la plupart des tâches, cette ligne est comment vous collectez le travail : examinez et fusionnez la pull request quand ses vérifications réussissent.

103

104### Aperçu et réponse

105

106Appuyez sur `Espace` sur une ligne sélectionnée pour ouvrir le panneau d'aperçu. Il affiche ce que la session a besoin de vous, sa sortie la plus récente, et toutes les pull requests qu'elle a ouvertes. La plupart du temps, c'est suffisant, et vous n'avez jamais besoin d'ouvrir la transcription complète.

107

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

109

110Utilisez `↑` et `↓` pour apercevoir les sessions adjacentes sans fermer le panneau, ou `→` pour vous attacher.

111

112### S'attacher à une session

113

114Appuyez sur `Entrée` ou `→` sur une ligne sélectionnée pour vous attacher, ou appuyez sur `Alt+1` à `Alt+9` pour vous attacher directement à la Nième session du groupe ciblé. La vue agent est remplacée par la session interactive complète, exactement comme si vous aviez exécuté `claude` dans ce répertoire. Quand vous vous attachez, Claude affiche un court récapitulatif de ce qui s'est passé pendant que vous étiez absent.

115

116Pendant que vous êtes attaché, la session se comporte comme n'importe quelle autre session Claude Code : chaque [commande](/fr/commands), raccourci clavier, et fonctionnalité fonctionne.

117

118Appuyez sur `←` sur une invite vide pour vous détacher et revenir à la vue agent. Si une boîte de dialogue a le focus et ne répond pas à `←`, appuyez sur `Ctrl+Z` pour vous détacher immédiatement.

119

120Se 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`.

121

122Une fois que vous avez utilisé la vue agent, appuyer sur `←` sur une invite vide fonctionne à partir de n'importe quelle session Claude Code, pas seulement celles auxquelles vous vous êtes attaché. Elle ouvre la vue agent avec votre session actuelle pré-sélectionnée, vous pouvez donc basculer entre les sessions sans quitter le terminal.

123

124### Organiser la liste

125

126La vue agent groupe les sessions par état, avec les sessions qui ont besoin d'une intervention au-dessus des sessions qui fonctionnent ou sont terminées. Appuyez sur `Ctrl+S` pour basculer vers un groupement par répertoire à la place. Votre choix est enregistré entre les exécutions. Dans un groupe, épinglez une session en haut avec `Ctrl+T`, réorganisez avec `Shift+↑` et `Shift+↓`, ou appuyez sur `Entrée` sur un en-tête de groupe pour le réduire. Pour supprimer une session, 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.

127

128Les 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.

129

130### Filtrer la liste

131

132Tapez dans l'entrée de lancement pour filtrer au lieu de lancer :

133

134| Filtre | Affiche |

135| :------------------------ | :------------------------------------------------------------------------------------- |

136| `a:<name>` | Sessions exécutant l'agent nommé |

137| `s:<state>` | Sessions dans l'état donné, comme `s:blocked` pour les sessions qui ont besoin de vous |

138| `#<number>` ou une URL PR | La session travaillant sur cette pull request |

139

140### Raccourcis clavier

141

142Appuyez sur `?` dans la vue agent pour voir chaque raccourci. Les plus courants :

143

144| Raccourci | Action |

145| :-------------------- | :------------------------------------------------------------------------------ |

146| `↑` / `↓` | Se déplacer entre les lignes |

147| `Entrée` | S'attacher à la session sélectionnée, ou lancer si du texte est dans l'entrée |

148| `Espace` | Ouvrir ou fermer le panneau d'aperçu pour la session sélectionnée |

149| `Shift+Entrée` | Lancer et s'attacher immédiatement |

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

151| `Alt+1`..`Alt+9` | S'attacher à la Nième session du groupe ciblé |

152| `Tab` | Parcourir tous les sous-agents, ou appliquer la suggestion en surbrillance |

153| `Ctrl+S` | Basculer le groupement entre l'état et le répertoire |

154| `Ctrl+T` | Épingler ou dépingler la session sélectionnée |

155| `Ctrl+R` | Renommer la session sélectionnée |

156| `Ctrl+G` | Ouvrir l'invite de lancement dans votre `$EDITOR` |

157| `Ctrl+X` | Arrêter la session ; appuyez à nouveau dans les deux secondes pour la supprimer |

158| `Shift+↑` / `Shift+↓` | Réorganiser la session sélectionnée |

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

160| `Ctrl+C` | Effacer l'entrée ; appuyez deux fois pour quitter |

161| `?` | Afficher tous les raccourcis |

162

163## Lancer de nouveaux agents

164

165Vous pouvez lancer de nouvelles sessions en arrière-plan à partir de la vue agent, envoyer une session interactive existante en arrière-plan, ou en démarrer une directement depuis le shell.

166

167### À partir de la vue agent

168

169Tapez une invite dans l'entrée en bas de la vue agent et appuyez sur `Entrée` pour démarrer une nouvelle session en arrière-plan. La session est nommée automatiquement à partir de l'invite. Vous pouvez la renommer plus tard avec `Ctrl+R`. Collez une image dans l'invite pour inclure une capture d'écran ou un diagramme avec la tâche.

170

171Préfixez ou mentionnez des parties de l'invite pour contrôler comment la session démarre :

172

173| Entrée | Effet |

174| :------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

175| `<agent-name> <prompt>` | Si le premier mot correspond à un nom de [sous-agent](/fr/sub-agents) personnalisé, ce sous-agent s'exécute comme l'agent principal de la session avec la configuration de son frontmatter |

176| `@<agent-name>` | Mentionnez un sous-agent personnalisé n'importe où dans l'invite pour l'exécuter comme l'agent principal |

177| `@<repo>` | Mentionnez un référentiel sous le répertoire à partir duquel vous avez ouvert la vue agent pour exécuter la session là |

178| `/<skill>` | Suggérez des [skills](/fr/skills) à lancer comme l'invite |

179| `#<number>` ou une URL de pull request | Si une session travaille déjà sur cette PR, sélectionnez-la au lieu de lancer |

180| `Shift+Entrée` | Lancer et s'attacher immédiatement à la nouvelle session |

181

182Tapez `/` pour lancer un [skill](/fr/skills). Empaqueter une tâche récurrente comme un skill vous permet de démarrer le même workflow plusieurs fois à partir de la vue agent sans retaper l'invite. Appuyez sur `Tab` sur une entrée vide pour parcourir chaque sous-agent dispatchable, ou pour appliquer la suggestion en surbrillance quand les suggestions s'affichent.

183

184#### Lancer vers un répertoire spécifique

185

186Une nouvelle session s'exécute dans le répertoire à partir duquel vous avez ouvert la vue agent. Pour cibler un répertoire différent :

187

188* Ouvrez `claude agents` dans ce répertoire.

189* Ouvrez `claude agents` dans un répertoire parent qui contient plusieurs référentiels et mentionnez-en un avec `@<repo>` dans l'invite pour exécuter la session là.

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

191

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

193

194#### Isoler les modifications de fichiers dans une worktree

195

196Les sessions lancées à partir de la vue agent partagent votre répertoire de travail par défaut, donc deux agents modifiant les mêmes fichiers peuvent entrer en conflit. Pour éviter cela, Claude Code bloque une session lancée à partir de la vue agent d'écrire des fichiers jusqu'à ce qu'elle se déplace dans une [git worktree](/fr/worktrees) isolée. Claude gère cela automatiquement quand il a besoin de modifier des fichiers. La worktree est créée sous `.claude/worktrees/` à l'intérieur du répertoire du projet et supprimée quand vous supprimez la session. Supprimer une session supprime aussi sa worktree, donc fusionnez ou poussez les modifications que vous voulez conserver avant de supprimer.

197

198Pour 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.

199

200### À partir d'une session

201

202Exécutez `/background` ou son alias `/bg` pour détacher la conversation actuelle et la laisser s'exécuter. Passez une invite comme `/bg run the test suite and fix any failures` pour envoyer une instruction supplémentaire avant de détacher.

203

204### À partir du shell

205

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

207

208```bash theme={null}

209claude --bg "investigate the flaky SettingsChangeDetector test"

210```

211

212Pour exécuter un sous-agent spécifique comme l'agent principal de la session, combinez `--bg` avec `--agent` :

213

214```bash theme={null}

215claude --agent code-reviewer --bg "address review comments on PR 1234"

216```

217

218Après avoir mis en arrière-plan, Claude affiche l'ID court de la session et les commandes pour la gérer :

219

220```text theme={null}

221backgrounded · 7c5dcf5d

222 claude agents list sessions

223 claude attach 7c5dcf5d open in this terminal

224 claude logs 7c5dcf5d show recent output

225 claude stop 7c5dcf5d stop this session

226```

227

228## Gérer les sessions depuis le shell

229

230Chaque session en arrière-plan a un ID court que vous pouvez utiliser depuis le shell. Ces commandes sont utiles pour les scripts ou quand vous ne voulez pas ouvrir la vue agent.

231

232| Commande | Objectif |

233| :--------------------- | :---------------------------------------------------------- |

234| `claude agents` | Ouvrir la vue agent |

235| `claude attach <id>` | S'attacher à une session dans ce terminal |

236| `claude logs <id>` | Afficher la sortie récente de la session |

237| `claude stop <id>` | Arrêter une session. Accepte aussi `claude kill` |

238| `claude respawn <id>` | Redémarrer une session arrêtée avec sa conversation intacte |

239| `claude respawn --all` | Redémarrer chaque session arrêtée |

240| `claude rm <id>` | Supprimer une session de la liste |

241

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

243

244Les sessions en arrière-plan sont hébergées par un processus superviseur par utilisateur, séparé de votre terminal et de la vue agent. Il démarre automatiquement la première fois que vous mettez une session en arrière-plan ou ouvrez la vue agent, et vous ne le gérez pas directement. Le superviseur et ses sessions s'authentifient avec les mêmes identifiants que vos sessions interactives et ne font aucune connexion réseau supplémentaire au-delà de l'API du modèle.

245

246Chaque session en arrière-plan est son propre processus Claude Code, parent du superviseur plutôt que de votre terminal. Une session qui fonctionne activement, attend votre intervention, ou a un terminal attaché garde son processus en cours d'exécution. Une fois qu'une session se termine et reste non attachée pendant environ une heure, le superviseur arrête son processus pour libérer des ressources. La transcription et l'état restent sur le disque, et la prochaine fois que vous vous attachez, apercevez, ou répondez, le superviseur démarre un processus frais à partir de là où il s'était arrêté. Quand chaque session s'est terminée et qu'aucun terminal n'est connecté, le superviseur lui-même quitte et redémarre la prochaine fois que vous mettez une session en arrière-plan ou ouvrez la vue agent.

247

248Le superviseur regarde le binaire Claude Code installé sur le disque et redémarre dans la nouvelle version après que le [mise à jour automatique](/fr/setup#auto-updates) régulière le remplace. C'est une montre de fichier local, pas une vérification réseau. Les sessions en arrière-plan sont des processus détachés, donc elles continuent de s'exécuter pendant le redémarrage et le nouveau superviseur se reconnecte à elles.

249

250L'état de la session est stocké sous votre répertoire de configuration Claude Code. Si vous définissez [`CLAUDE_CONFIG_DIR`](/fr/env-vars), le superviseur utilise ce répertoire à la place de `~/.claude` et s'exécute comme une instance séparée avec ses propres sessions.

251

252| Chemin | Contenu |

253| :------------------------------- | :--------------------------------------------------------------------------------------------------------- |

254| `~/.claude/daemon.log` | Journal du superviseur |

255| `~/.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 |

256| `~/.claude/jobs/<id>/state.json` | État par session affiché dans la vue agent |

257

258Pour 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).

259

260## Dépannage

261

262### La vue agent s'ouvre sans sessions

263

264La 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`.

265

266### Les sessions s'affichent comme arrêtées après le réveil de votre machine

267

268Les 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`.

269

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

271

272Une fois qu'une session s'est terminée et reste non attachée pendant environ une heure, le superviseur arrête son processus pour libérer des ressources. S'attacher démarre un processus frais à partir de là où il s'était arrêté, ce qui prend un moment. Les sessions qui fonctionnent ou attendent votre intervention ne sont jamais arrêtées de cette façon.

273

274### `.claude/worktrees/` se remplit

275

276Les 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).

277

278## Limitations

279

280La vue agent est un aperçu de recherche. Les limitations actuelles à connaître :

281

282* **Les limites de débit s'appliquent** : les sessions en arrière-plan réduisent 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 dix fois plus vite.

283* **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.

284* **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.

285

286## Prochaines étapes

287

288Maintenant que vous comprenez la vue agent, explorez ces fonctionnalités connexes :

289

290* [Exécuter les agents en parallèle](/fr/agents) : comparez la vue agent avec les sous-agents, les équipes d'agents, et les worktrees

291* [Sous-agents](/fr/sub-agents) : définissez des configurations d'agent réutilisables avec des invites personnalisées, des outils, et l'isolation

292* [Équipes d'agents](/fr/agent-teams) : coordonnez plusieurs sessions qui se messagent mutuellement

293* [Claude Code sur le web](/fr/claude-code-on-the-web) : exécutez les sessions dans un environnement cloud géré au lieu de localement

agents.md +52 −0 created

Details

1> ## Documentation Index

2> 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.

5# Exécuter des agents en parallèle

7> Comparez les façons dont Claude Code peut gérer plusieurs tâches à la fois : sous-agents, vue agent, équipes d'agents et sessions worktree isolées.

9[Les sous-agents](/fr/sub-agents), [la vue agent](/fr/agent-view), [les équipes d'agents](/fr/agent-teams) et [les worktrees](/fr/worktrees) parallélisent chacun le travail d'une manière différente. Le bon choix dépend de si vous voulez rester dans chaque conversation vous-même, déléguer des tâches et revérifier plus tard, ou laisser Claude coordonner un groupe de travailleurs pour vous.

11| Approche | Ce qu'elle vous offre | Utilisez-la quand |

12| :---------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

13| [Sous-agents](/fr/sub-agents) | Des travailleurs délégués dans une session qui effectuent une tâche secondaire dans leur propre contexte et retournent un résumé | Une tâche secondaire inonderait votre conversation principale avec des résultats de recherche, des journaux ou des contenus de fichiers que vous ne référencerez plus |

14| [Vue agent](/fr/agent-view) | Un écran pour dispatcher et surveiller les sessions s'exécutant en arrière-plan, ouvert avec `claude agents`. Aperçu de recherche | Vous avez plusieurs tâches indépendantes et voulez les déléguer, vérifier l'état en un coup d'œil et intervenir uniquement quand l'une d'elles a besoin de vous |

15| [Équipes d'agents](/fr/agent-teams) | Plusieurs sessions coordonnées avec une liste de tâches partagée et une messagerie inter-agents, gérées par un responsable. Expérimental et désactivé par défaut | Vous voulez que Claude divise un projet en morceaux, les assigne et maintient les travailleurs synchronisés |

16| [Worktrees](/fr/worktrees) | Des checkouts git séparés pour que les sessions parallèles ne touchent jamais les fichiers les unes des autres | Vous exécutez plusieurs sessions vous-même, ou vos sous-agents modifient des fichiers qui se chevauchent |

17| [`/batch`](/fr/commands) | Une division planifiée d'un grand changement en 5 à 30 sous-agents isolés par worktree qui ouvrent chacun une pull request | Une migration à l'échelle du repo ou une refonte mécanique que vous pouvez décrire en une seule instruction |

19Dans chaque approche, les travailleurs sont des sessions Claude. Pour impliquer un outil différent, exposez-le à Claude en tant que [serveur MCP](/fr/mcp).

21Vous pouvez combiner ces approches. La vue agent déplace automatiquement chaque session dispatched dans son propre worktree quand elle a besoin de modifier des fichiers, et une session sur laquelle vous travaillez peut générer des sous-agents qui obtiennent chacun leur propre worktree.

23<Note>

24 L'exécution de plusieurs sessions ou sous-agents à la fois multiplie l'utilisation des tokens. Consultez [Coûts](/fr/costs) pour les détails d'utilisation et de limite de débit.

25</Note>

27## Choisir une approche

29La bonne approche dépend de qui coordonne le travail, si les travailleurs ont besoin de communiquer et s'ils modifient les mêmes fichiers :

31* **Qui coordonne le travail ?** Si vous voulez que Claude délègue et collecte les résultats dans une conversation, utilisez [les sous-agents](/fr/sub-agents). Si vous déléguez des tâches indépendantes et les revérifiez, utilisez [la vue agent](/fr/agent-view). Si vous voulez que Claude planifie, assigne et supervise un groupe de travailleurs, utilisez [les équipes d'agents](/fr/agent-teams), qui sont expérimentales et désactivées par défaut.

32* **Les travailleurs ont-ils besoin de se parler ?** Les sous-agents rapportent les résultats à la conversation qui les a générés, et les sessions de vue agent rapportent uniquement à vous. Les coéquipiers dans une équipe d'agents partagent une liste de tâches et se envoient des messages directement.

33* **Les tâches touchent-elles les mêmes fichiers ?** Isolez le travail avec [les worktrees](/fr/worktrees). Les sous-agents et les sessions que vous exécutez vous-même peuvent chacun utiliser un worktree séparé. Les équipes d'agents n'isolent pas les coéquipiers dans les worktrees, donc [partitionnez le travail](/fr/agent-teams#avoid-file-conflicts) pour que chaque coéquipier possède un ensemble différent de fichiers.

35## Vérifier le travail en cours

37La commande pour vérifier le travail en cours dépend de l'approche que vous avez utilisée :

39* Pour les sessions en arrière-plan, `claude agents` ouvre [la vue agent](/fr/agent-view) : un écran montrant chaque session, son état et lesquelles ont besoin de votre entrée.

40* Pour les sous-agents dans la session actuelle, `/agents` ouvre un panneau avec un onglet **Running** listant les sous-agents actifs et un onglet **Library** où vous [créez et modifiez des sous-agents personnalisés](/fr/sub-agents#use-the-%2Fagents-command). Malgré le nom similaire, c'est séparé de `claude agents`.

41* Pour tout ce qui s'exécute en arrière-plan de la session actuelle, `/tasks` liste chaque élément et vous permet de le vérifier, de vous y attacher ou de l'arrêter.

43Pour une vue de bureau de toutes vos sessions, consultez [les sessions parallèles dans l'application de bureau](/fr/desktop#work-in-parallel-with-sessions).

45## En savoir plus

47Chaque guide ci-dessous couvre la configuration et la configuration pour une approche :

49* [Créer des sous-agents personnalisés](/fr/sub-agents) : définissez des spécialistes réutilisables et contrôlez les outils qu'ils peuvent utiliser.

50* [Gérer les agents avec la vue agent](/fr/agent-view) : dispatchez les sessions, regardez leur état et attachez-vous quand l'une d'elles a besoin de vous.

51* [Orchestrer les équipes d'agents](/fr/agent-teams) : configurez un responsable et des coéquipiers, assignez des tâches et examinez leur travail.

52* [Exécuter les sessions parallèles avec les worktrees](/fr/worktrees) : démarrez Claude dans un checkout isolé, contrôlez ce qui est copié et nettoyez après.

claude-platform-on-aws.md +341 −0 created

Details

1> ## Documentation Index

2> 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.

5# Claude Code sur Claude Platform on AWS

7> Configurez Claude Code pour utiliser l'API Claude exploitée par Anthropic avec l'authentification AWS, le contrôle d'accès IAM et la facturation AWS Marketplace.

9export const ContactSalesCard = ({surface}) => {

10 const utm = content => `utm_source=claude_code&utm_medium=docs&utm_content=${surface}_${content}`;

11 const iconArrowRight = (size = 13) => <svg width={size} height={size} viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2.5" strokeLinecap="round" strokeLinejoin="round" aria-hidden="true">

12 <line x1="5" y1="12" x2="19" y2="12" />

13 <polyline points="12 5 19 12 12 19" />

14 </svg>;

15 const STYLES = `

16.cc-cs {

17 --cs-slate: #141413;

18 --cs-clay: #d97757;

19 --cs-clay-deep: #c6613f;

20 --cs-gray-000: #ffffff;

21 --cs-gray-700: #3d3d3a;

22 --cs-border-default: rgba(31, 30, 29, 0.15);

23 font-family: inherit;

24}

25.dark .cc-cs {

26 --cs-slate: #f0eee6;

27 --cs-gray-000: #262624;

28 --cs-gray-700: #bfbdb4;

29 --cs-border-default: rgba(240, 238, 230, 0.14);

30}

31.cc-cs-card {

32 display: flex; align-items: center; justify-content: space-between;

33 gap: 16px; padding: 14px 16px; margin: 0;

34 background: var(--cs-gray-000); border: 0.5px solid var(--cs-border-default);

35 border-radius: 8px; flex-wrap: wrap;

36}

37.cc-cs-text { font-size: 13px; color: var(--cs-gray-700); line-height: 1.5; flex: 1; min-width: 240px; }

38.cc-cs-text strong { font-weight: 550; color: var(--cs-slate); }

39.cc-cs-actions { display: flex; align-items: center; gap: 8px; flex-shrink: 0; }

40.cc-cs-btn-clay {

41 display: inline-flex; align-items: center; gap: 8px;

42 background: var(--cs-clay-deep); color: #fff; border: none;

43 border-radius: 8px; padding: 8px 14px;

44 font-size: 13px; font-weight: 500;

45 transition: background-color 0.15s; white-space: nowrap;

46}

47.cc-cs-btn-clay:hover { background: var(--cs-clay); }

48.cc-cs-btn-ghost {

49 display: inline-flex; align-items: center; gap: 8px;

50 background: transparent; color: var(--cs-gray-700);

51 border: 0.5px solid var(--cs-border-default);

52 border-radius: 8px; padding: 8px 14px;

53 font-size: 13px; font-weight: 500;

54}

55.cc-cs-btn-ghost:hover { background: rgba(0, 0, 0, 0.04); }

56.dark .cc-cs-btn-ghost:hover { background: rgba(255, 255, 255, 0.04); }

57@media (max-width: 720px) {

58 .cc-cs-actions { width: 100%; }

59}

60`;

61 return <div className="cc-cs not-prose">

62 <style>{STYLES}</style>

63 <div className="cc-cs-card">

64 <div className="cc-cs-text">

65 <strong>Deploying Claude Code across your organization?</strong> Talk to sales about enterprise plans, SSO, and centralized billing.

66 </div>

67 <div className="cc-cs-actions">

68 <a href={`https://claude.com/pricing?${utm('view_plans')}#plans-business`} className="cc-cs-btn-ghost">

69 View plans

70 </a>

71 <a href={`https://claude.com/contact-sales?${utm('contact_sales')}`} className="cc-cs-btn-clay">

72 Contact sales {iconArrowRight()}

73 </a>

74 </div>

75 </div>

76 </div>;

77};

79export const Experiment = ({flag, treatment, children}) => {

80 const VID_KEY = 'exp_vid';

81 const CONSENT_COUNTRIES = new Set(['AT', 'BE', 'BG', 'HR', 'CY', 'CZ', 'DK', 'EE', 'FI', 'FR', 'DE', 'GR', 'HU', 'IE', 'IT', 'LV', 'LT', 'LU', 'MT', 'NL', 'PL', 'PT', 'RO', 'SK', 'SI', 'ES', 'SE', 'RE', 'GP', 'MQ', 'GF', 'YT', 'BL', 'MF', 'PM', 'WF', 'PF', 'NC', 'AW', 'CW', 'SX', 'FO', 'GL', 'AX', 'GB', 'UK', 'AI', 'BM', 'IO', 'VG', 'KY', 'FK', 'GI', 'MS', 'PN', 'SH', 'TC', 'GG', 'JE', 'IM', 'CA', 'BR', 'IN']);

82 const fnv1a = s => {

83 let h = 0x811c9dc5;

84 for (let i = 0; i < s.length; i++) {

85 h ^= s.charCodeAt(i);

86 h += (h << 1) + (h << 4) + (h << 7) + (h << 8) + (h << 24);

87 }

88 return h >>> 0;

89 };

90 const bucket = (seed, vid) => fnv1a(fnv1a(seed + vid) + '') % 10000 < 5000 ? 'control' : 'treatment';

91 const [decision] = useState(() => {

92 const params = new URLSearchParams(location.search);

93 const preBucketed = document.documentElement.dataset['gb_' + flag.replace(/-/g, '_')];

94 const force = params.get('gb-force');

95 if (force) {

96 for (const p of force.split(',')) {

97 const [k, v] = p.split(':');

98 if (k === flag) return {

99 variant: v || 'treatment',

100 track: false

101 };

102 }

103 }

104 if (navigator.globalPrivacyControl) {

105 return {

106 variant: 'control',

107 track: false

108 };

109 }

110 const prefsMatch = document.cookie.match(/(?:^|; )anthropic-consent-preferences=([^;]+)/);

111 if (prefsMatch) {

112 try {

113 if (JSON.parse(decodeURIComponent(prefsMatch[1])).analytics !== true) {

114 return {

115 variant: 'control',

116 track: false

117 };

118 }

119 } catch {

120 return {

121 variant: 'control',

122 track: false

123 };

124 }

125 } else {

126 const country = params.get('country')?.toUpperCase() || (document.cookie.match(/(?:^|; )cf_geo=([A-Z]{2})/) || [])[1];

127 if (!country || CONSENT_COUNTRIES.has(country)) {

128 return {

129 variant: 'control',

130 track: false

131 };

132 }

133 }

134 let vid;

135 try {

136 const ajsMatch = document.cookie.match(/(?:^|; )ajs_anonymous_id=([^;]+)/);

137 if (ajsMatch) {

138 vid = decodeURIComponent(ajsMatch[1]).replace(/^"|"$/g, '');

139 } else {

140 vid = localStorage.getItem(VID_KEY);

141 if (!vid) {

142 vid = crypto.randomUUID();

143 }

144 document.cookie = `ajs_anonymous_id=${vid}; domain=.claude.com; path=/; Secure; SameSite=Lax; max-age=31536000`;

145 }

146 try {

147 localStorage.setItem(VID_KEY, vid);

148 } catch {}

149 } catch {

150 return {

151 variant: 'control',

152 track: false

153 };

154 }

155 const variant = preBucketed === '1' ? 'treatment' : preBucketed === '0' ? 'control' : bucket(flag, vid);

156 return {

157 variant,

158 track: true,

159 vid

160 };

161 });

162 useEffect(() => {

163 if (!decision.track) return;

164 fetch('https://api.anthropic.com/api/event_logging/v2/batch', {

165 method: 'POST',

166 headers: {

167 'Content-Type': 'application/json',

168 'x-service-name': 'claude_code_docs'

169 },

170 body: JSON.stringify({

171 events: [{

172 event_type: 'GrowthbookExperimentEvent',

173 event_data: {

174 device_id: decision.vid,

175 anonymous_id: decision.vid,

176 timestamp: new Date().toISOString(),

177 experiment_id: flag,

178 variation_id: decision.variant === 'treatment' ? 1 : 0,

179 environment: 'production'

180 }

181 }]

182 }),

183 keepalive: true

184 }).catch(() => {});

185 }, []);

186 return decision.variant === 'treatment' ? treatment : children;

187};

188

189<Experiment flag="docs-contact-sales-cta" treatment={<ContactSalesCard surface="claude_platform_on_aws" />} />

190

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

192

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

194

195<Note>

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

197</Note>

198

199## Prérequis

200

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

202

203* Un abonnement actif à Claude Platform on AWS via AWS Marketplace

204* Un espace de travail dans votre organisation Anthropic liée à AWS, avec son ID d'espace de travail

205* Un principal IAM avec la permission d'invoquer le service Anthropic, ou une clé API limitée à l'espace de travail

206* Des identifiants AWS dans votre environnement, dans `~/.aws/credentials`, ou à partir d'un rôle IAM attaché si vous souhaitez l'authentification SigV4. L'AWS CLI n'est requis que pour le flux de connexion SSO.

207

208## Configuration

209

210### 1. Configurez les identifiants AWS

211

212Claude Code prend en charge deux méthodes d'authentification pour Claude Platform on AWS. Choisissez la méthode qui correspond à la façon dont votre équipe gère l'accès.

213

214**Option A : Identifiants AWS avec SigV4**

215

216Claude Code signe les requêtes avec SigV4 en utilisant la chaîne d'identifiants AWS standard : variables d'environnement, identifiants partagés dans `~/.aws/credentials`, rôles IAM, sessions AWS SSO et toute autre source que le SDK AWS prend en charge.

217

218Pour une utilisation locale, connectez-vous avec l'AWS CLI avant de démarrer Claude Code. L'exemple ci-dessous utilise un profil SSO, mais toute méthode qui produit des identifiants aux emplacements standard fonctionne.

219

220```bash theme={null}

221aws sso login --profile my-profile

222export AWS_PROFILE=my-profile

223```

224

225Pour l'intégration continue et l'automatisation, donnez au runner un rôle IAM avec la permission d'invoquer le service Anthropic et définissez `AWS_REGION`. La chaîne d'identifiants récupère automatiquement le rôle.

226

227Si vos identifiants SSO expirent en cours de session, configurez [`awsAuthRefresh`](/fr/amazon-bedrock#advanced-credential-configuration) pour que Claude Code réexécute votre commande de connexion et réessaie au lieu d'échouer. Ajoutez la commande à votre `settings.json` :

228

229```json theme={null}

230{

231 "awsAuthRefresh": "aws sso login --profile my-profile"

232}

233```

234

235**Option B : Clé API d'espace de travail**

236

237Une clé API d'espace de travail est un secret de longue durée, utile lorsque vous ne souhaitez pas gérer les identifiants AWS fédérés. Générez-en une dans la console AWS sous **Claude Platform on AWS → API keys** et définissez-la comme `ANTHROPIC_AWS_API_KEY` :

238

239```bash theme={null}

240export ANTHROPIC_AWS_API_KEY=sk-ant-xxxxx

241```

242

243La clé est envoyée en tant que `x-api-key` et prend la priorité sur SigV4, donc tous les identifiants AWS dans votre environnement sont ignorés. Les clés API d'une organisation Claude Console distincte ne fonctionneront pas ici.

244

245Traitez les clés API d'espace de travail comme toute autre identifiant de production. Le bloc `env` du [fichier de paramètres utilisateur](/fr/settings) est un moyen pratique de limiter la clé à votre machine sans l'exporter globalement.

246

247<Note>

248 Les commandes `/login` et `/logout` ne modifient pas l'authentification Claude Platform on AWS. L'authentification s'effectue via vos identifiants AWS ou votre clé API d'espace de travail, et non via un abonnement Claude.ai.

249</Note>

250

251### 2. Configurez Claude Code

252

253Définissez les variables d'environnement qui acheminent Claude Code via Claude Platform on AWS au lieu de l'API Anthropic par défaut.

254

255```bash theme={null}

256export CLAUDE_CODE_USE_ANTHROPIC_AWS=1

257export ANTHROPIC_AWS_WORKSPACE_ID=wrkspc_01ABCDEFGHIJKLMN

258export AWS_REGION=us-east-1

259```

260

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

262

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

264

265### 3. Épinglez les versions de modèle

266

267Claude Platform on AWS utilise les mêmes ID de modèle que l'API Claude directe. Les alias par défaut `opus`, `sonnet` et `haiku` se résolvent aux dernières versions disponibles dans votre espace de travail.

268

269Si vous déployez Claude Code pour une équipe, épinglez explicitement les ID de modèle pour qu'une nouvelle version ne déplace pas tout le monde à la fois :

270

271```bash theme={null}

272export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-4-7

273export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-4-6

274export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5

275```

276

277Pour la liste complète des ID de modèle et des alias, consultez [Aperçu des modèles](https://platform.claude.com/docs/en/about-claude/models/overview). Pour d'autres variables liées aux modèles, consultez [Configuration du modèle](/fr/model-config).

278

279[La mise en cache des invites](https://platform.claude.com/docs/en/build-with-claude/prompt-caching) est activée automatiquement. Les écritures en cache d'1 heure sont facturées à un taux plus élevé que les écritures de 5 minutes. Pour demander un TTL de cache d'1 heure au lieu de la valeur par défaut de 5 minutes, définissez `ENABLE_PROMPT_CACHING_1H=1`.

280

281## Utilisez le SDK Agent

282

283Le [SDK Agent](/fr/agent-sdk/overview) lit les mêmes variables d'environnement que l'interface de ligne de commande, donc tout programme qui lance le sous-processus Claude Code peut cibler Claude Platform on AWS en exportant `CLAUDE_CODE_USE_ANTHROPIC_AWS`, `ANTHROPIC_AWS_WORKSPACE_ID` et soit `ANTHROPIC_AWS_API_KEY` soit les identifiants AWS avant l'appel.

284

285```typescript theme={null}

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

287

288process.env.CLAUDE_CODE_USE_ANTHROPIC_AWS = "1";

289process.env.ANTHROPIC_AWS_WORKSPACE_ID = "wrkspc_01ABCDEFGHIJKLMN";

290process.env.AWS_REGION = "us-east-1";

291

292for await (const msg of query({ prompt: "What's in this repo?" })) {

293 console.log(msg);

294}

295```

296

297Cet exemple s'appuie sur la chaîne d'identifiants AWS ambiante pour SigV4. Pour vous authentifier avec une clé API d'espace de travail à la place, définissez `ANTHROPIC_AWS_API_KEY` de la même manière. Pour la surface plus large du SDK Agent, consultez [Aperçu du SDK Agent](/fr/agent-sdk/overview).

298

299## Acheminez via un proxy d'entreprise

300

301Pour acheminer le trafic via un proxy ou une [passerelle LLM](/fr/llm-gateway), définissez `ANTHROPIC_AWS_BASE_URL` sur l'adresse du proxy. Claude Code envoie les requêtes à cette URL avec les mêmes en-têtes d'espace de travail et d'authentification, donc toute passerelle qui les transfère inchangés fonctionne.

302

303```bash theme={null}

304export CLAUDE_CODE_USE_ANTHROPIC_AWS=1

305export ANTHROPIC_AWS_WORKSPACE_ID=wrkspc_01ABCDEFGHIJKLMN

306export ANTHROPIC_AWS_BASE_URL=https://anthropic-proxy.example.com

307```

308

309Si votre passerelle signe elle-même les requêtes, définissez `CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH=1` pour que Claude Code envoie des requêtes non signées et laisse la passerelle ajouter les en-têtes SigV4 avant de les transférer à AWS. Si la passerelle nécessite son propre jeton, définissez-le dans `ANTHROPIC_AUTH_TOKEN`.

310

311```bash theme={null}

312export CLAUDE_CODE_USE_ANTHROPIC_AWS=1

313export CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH=1

314export ANTHROPIC_AWS_WORKSPACE_ID=wrkspc_01ABCDEFGHIJKLMN

315export ANTHROPIC_AWS_BASE_URL=https://anthropic-proxy.example.com

316```

317

318## Dépannage

319

320Exécutez `/status` pour voir le fournisseur résolu et tout ID d'espace de travail explicitement configuré, région, remplacement d'URL de base et paramètre d'authentification ignorée. C'est le moyen le plus rapide de confirmer que Claude Code cible Claude Platform on AWS.

321

322### `403 Forbidden` ou `AccessDenied` à chaque requête

323

324Le principal IAM que Claude Code a résolu manque probablement de la permission d'invoquer le service Anthropic dans votre espace de travail. Vérifiez le rôle attaché à votre profil AWS ou au runner qui a démarré Claude Code, et vérifiez qu'il dispose des actions `aws-external-anthropic` documentées dans la [référence des actions IAM](https://platform.claude.com/docs/en/api/claude-platform-on-aws-iam-actions).

325

326Si vous avez défini `ANTHROPIC_AWS_API_KEY`, la clé prend la priorité sur SigV4 et une clé obsolète produit la même erreur. Régénérez la clé dans la console AWS sous **Claude Platform on AWS → API keys** ou désactivez la variable pour revenir à vos identifiants AWS.

327

328### Les requêtes échouent avec une erreur d'espace de travail manquant

329

330`ANTHROPIC_AWS_WORKSPACE_ID` est probablement non défini ou vide. Chaque requête Claude Platform on AWS doit inclure l'ID d'espace de travail. Il n'est pas implicite par vos identifiants AWS. Trouvez l'ID sous **Workspaces** sur la page du service de la console AWS et exportez-le avant de démarrer Claude Code.

331

332### Les requêtes vont toujours à `api.anthropic.com`

333

334`CLAUDE_CODE_USE_ANTHROPIC_AWS` est probablement non défini ou défini sur une valeur qui ne s'analyse pas comme vraie. Définissez-le sur `1` et exécutez `/status` pour confirmer le fournisseur résolu. Si `CLAUDE_CODE_USE_BEDROCK` ou `CLAUDE_CODE_USE_FOUNDRY` est également défini, ceux-ci prennent la priorité sur Claude Platform on AWS.

335

336## Ressources supplémentaires

337

338L'abonnement Claude Platform on AWS, la configuration de l'espace de travail et d'IAM qui précèdent la configuration de Claude Code sont couverts dans la documentation de la plateforme :

339

340* [Aperçu de Claude Platform on AWS](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws) : abonnement, configuration de l'espace de travail et référence du produit

341* [Référence des actions IAM](https://platform.claude.com/docs/en/api/claude-platform-on-aws-iam-actions) : permissions et politiques gérées

cli-reference.md +7 −1

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` | Lister tous les [subagents](/fr/sub-agents) configurés, groupés par source | `claude agents` |27| `claude agents` | Ouvrir la [vue agent](/fr/agent-view) pour surveiller et dispatcher les sessions d'arrière-plan parallèles. Lorsque la sortie est canalisée, liste les [sous-agents](/fr/sub-agents) configurés à la place | `claude agents` |

28| `claude attach <id>` | Attacher à une [session d'arrière-plan](/fr/agent-view#manage-sessions-from-the-shell) dans ce terminal | `claude attach 7c5dcf5d` |

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

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

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

32| `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"` |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 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 rm <id>` | Supprimer une [session d'arrière-plan](/fr/agent-view#manage-sessions-from-the-shell) de la liste | `claude rm 7c5dcf5d` |

33| `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` |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 stop <id>` | Arrêter une [session d'arrière-plan](/fr/agent-view#manage-sessions-from-the-shell). Accepte également `claude kill` | `claude stop 7c5dcf5d` |

34| `claude ultrareview [target]` | Exécuter [ultrareview](/fr/ultrareview#run-ultrareview-non-interactively) de manière non interactive. Imprime les résultats sur stdout et quitte avec 0 en cas de succès ou 1 en cas d'échec. Utilisez `--json` pour la charge utile brute et `--timeout <minutes>` pour remplacer la valeur par défaut de 30 minutes | `claude ultrareview 1234 --json` |39| `claude ultrareview [target]` | Exécuter [ultrareview](/fr/ultrareview#run-ultrareview-non-interactively) de manière non interactive. Imprime les résultats sur stdout et quitte avec 0 en cas de succès ou 1 en cas d'échec. Utilisez `--json` pour la charge utile brute et `--timeout <minutes>` pour remplacer la valeur par défaut de 30 minutes | `claude ultrareview 1234 --json` |

35 40

36Si vous tapez mal une sous-commande, Claude Code suggère la correspondance la plus proche et quitte sans démarrer une session. Par exemple, `claude udpate` imprime `Did you mean claude update?`.41Si vous tapez mal une sous-commande, Claude Code suggère la correspondance la plus proche et quitte sans démarrer une session. Par exemple, `claude udpate` imprime `Did you mean claude update?`.

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

51| `--bare` | Mode minimal : ignorer la découverte automatique des hooks, skills, plugins, serveurs MCP, mémoire automatique et CLAUDE.md afin que les appels scriptés démarrent plus rapidement. Claude a accès aux outils Bash, lecture de fichier et édition de fichier. Définit [`CLAUDE_CODE_SIMPLE`](/fr/env-vars). Voir [mode bare](/fr/headless#start-faster-with-bare-mode) | `claude --bare -p "query"` |56| `--bare` | Mode minimal : ignorer la découverte automatique des hooks, skills, plugins, serveurs MCP, mémoire automatique et CLAUDE.md afin que les appels scriptés démarrent plus rapidement. Claude a accès aux outils Bash, lecture de fichier et édition de fichier. Définit [`CLAUDE_CODE_SIMPLE`](/fr/env-vars). Voir [mode bare](/fr/headless#start-faster-with-bare-mode) | `claude --bare -p "query"` |

58| `--bg` | Démarrer la session en tant qu'[agent en arrière-plan](/fr/agent-view) et revenir immédiatement. Affiche l'ID de session et les commandes de gestion. Combinez avec `--agent` pour exécuter un subagent spécifique | `claude --bg "investigate the flaky test"` |

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

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

commands.md +6 −1

Details

20 20

21**Pendant une tâche.** `/plan` bascule en mode plan avant une modification importante. `/model` et `/effort` ajustent le temps de réflexion que vous dépensez. Lorsque la conversation devient longue, `/context` montre où la fenêtre va et `/compact` la résume ; utilisez `/btw` pour une question rapide qui ne devrait pas gonfler l'historique.21**Pendant une tâche.** `/plan` bascule en mode plan avant une modification importante. `/model` et `/effort` ajustent le temps de réflexion que vous dépensez. Lorsque la conversation devient longue, `/context` montre où la fenêtre va et `/compact` la résume ; utilisez `/btw` pour une question rapide qui ne devrait pas gonfler l'historique.

22 22

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

23**Avant de livrer.** `/diff` montre ce qui a changé, `/simplify` examine les fichiers récents et applique des corrections de qualité et d'efficacité, et `/review` ou `/security-review` donnent une lecture plus approfondie en lecture seule.25**Avant de livrer.** `/diff` montre ce qui a changé, `/simplify` examine les fichiers récents et applique des corrections de qualité et d'efficacité, et `/review` ou `/security-review` donnent une lecture plus approfondie en lecture seule.

24 26

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

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

43| `/autofix-pr [prompt]` | Générer une session [Claude Code sur le web](/fr/claude-code-on-the-web#auto-fix-pull-requests) qui surveille la PR de la branche actuelle et pousse les corrections lorsque la CI échoue ou que les relecteurs laissent des commentaires. Détecte la PR ouverte de votre branche extraite avec `gh pr view` ; pour surveiller une PR différente, extrayez d'abord sa branche. Par défaut, la session distante est invitée à corriger chaque échec de CI et commentaire de révision ; passez une invite pour lui donner des instructions différentes, par exemple `/autofix-pr only fix lint and type errors`. Nécessite le CLI `gh` et l'accès à [Claude Code sur le web](/fr/claude-code-on-the-web#who-can-use-claude-code-on-the-web) |45| `/autofix-pr [prompt]` | Générer une session [Claude Code sur le web](/fr/claude-code-on-the-web#auto-fix-pull-requests) qui surveille la PR de la branche actuelle et pousse les corrections lorsque la CI échoue ou que les relecteurs laissent des commentaires. Détecte la PR ouverte de votre branche extraite avec `gh pr view` ; pour surveiller une PR différente, extrayez d'abord sa branche. Par défaut, la session distante est invitée à corriger chaque échec de CI et commentaire de révision ; passez une invite pour lui donner des instructions différentes, par exemple `/autofix-pr only fix lint and type errors`. Nécessite le CLI `gh` et l'accès à [Claude Code sur le web](/fr/claude-code-on-the-web#who-can-use-claude-code-on-the-web) |

44| `/batch <instruction>` | **[Skill](/fr/skills#bundled-skills).** Orchestrer des changements à grande échelle dans une base de code en parallèle. Recherche la base de code, décompose le travail en 5 à 30 unités indépendantes et présente un plan. Une fois approuvé, génère un agent d'arrière-plan par unité dans un [git worktree](/fr/worktrees) isolé. Chaque agent implémente son unité, exécute les tests et ouvre une demande de tirage. Nécessite un référentiel git. Exemple : `/batch migrate src/ from Solid to React` |46| `/background [prompt]` | Détacher la session actuelle pour s'exécuter en tant qu'[agent d'arrière-plan](/fr/agent-view) et libérer ce terminal. Passez une invite pour envoyer une instruction supplémentaire avant de détacher. Surveillez la session avec `claude agents`. Alias : `/bg` |

47| `/batch <instruction>` | **[Skill](/fr/skills#bundled-skills).** Orchestrer des changements à grande échelle dans une base de code en parallèle. Recherche la base de code, décompose le travail en 5 à 30 unités indépendantes et présente un plan. Une fois approuvé, génère un [sous-agent d'arrière-plan](/fr/sub-agents#run-subagents-in-foreground-or-background) par unité dans un [git worktree](/fr/worktrees) isolé. Chaque sous-agent implémente son unité, exécute les tests et ouvre une demande de tirage. Nécessite un référentiel git. Exemple : `/batch migrate src/ from Solid to React` |

45| `/branch [name]` | Créer une branche de la conversation actuelle à ce stade. Vous bascule dans la branche et préserve l'original, auquel vous pouvez revenir avec `/resume`. Alias : `/fork`. Lorsque [`CLAUDE_CODE_FORK_SUBAGENT`](/fr/env-vars) est défini, `/fork` génère à la place un [sous-agent forké](/fr/sub-agents#fork-the-current-conversation) et n'est plus un alias pour cette commande |48| `/branch [name]` | Créer une branche de la conversation actuelle à ce stade. Vous bascule dans la branche et préserve l'original, auquel vous pouvez revenir avec `/resume`. Alias : `/fork`. Lorsque [`CLAUDE_CODE_FORK_SUBAGENT`](/fr/env-vars) est défini, `/fork` génère à la place un [sous-agent forké](/fr/sub-agents#fork-the-current-conversation) et n'est plus un alias pour cette commande |

46| `/btw <question>` | Poser une [question rapide](/fr/interactive-mode#side-questions-with-%2Fbtw) sans l'ajouter à la conversation |49| `/btw <question>` | Poser une [question rapide](/fr/interactive-mode#side-questions-with-%2Fbtw) sans l'ajouter à la conversation |

66| `/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 |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 |

67| `/focus` | Activer/désactiver la vue de focus, qui affiche uniquement votre dernière invite, un résumé d'appel d'outil d'une ligne avec les statistiques de diff d'édition, et la réponse finale. La sélection persiste entre les sessions ; définissez [`viewMode`](/fr/settings#available-settings) dans les paramètres pour la remplacer. Disponible uniquement dans le [rendu en plein écran](/fr/fullscreen) |70| `/focus` | Activer/désactiver la vue de focus, qui affiche uniquement votre dernière invite, un résumé d'appel d'outil d'une ligne avec les statistiques de diff d'édition, et la réponse finale. La sélection persiste entre les sessions ; définissez [`viewMode`](/fr/settings#available-settings) dans les paramètres pour la remplacer. Disponible uniquement dans le [rendu en plein écran](/fr/fullscreen) |

71| `/goal [condition\|clear]` | Définir un [objectif](/fr/goal) : Claude continue à travailler entre les tours jusqu'à ce que la condition soit remplie. Sans argument, affiche l'objectif actuel ou le plus récemment atteint. `clear`, `stop`, `off`, `reset`, `none`, ou `cancel` supprime un objectif actif plus tôt |

68| `/heapdump` | Écrire un snapshot de tas JavaScript et une ventilation de la mémoire vers `~/Desktop`, ou votre répertoire personnel sur Linux sans dossier Desktop, pour diagnostiquer une utilisation élevée de la mémoire. Consultez le [dépannage](/fr/troubleshooting#high-cpu-or-memory-usage) |72| `/heapdump` | Écrire un snapshot de tas JavaScript et une ventilation de la mémoire vers `~/Desktop`, ou votre répertoire personnel sur Linux sans dossier Desktop, pour diagnostiquer une utilisation élevée de la mémoire. Consultez le [dépannage](/fr/troubleshooting#high-cpu-or-memory-usage) |

109| `/status` | Ouvrir l'interface des Paramètres (onglet Statut) affichant la version, le modèle, le compte et la connectivité. Fonctionne pendant que Claude répond, sans attendre la fin de la réponse actuelle |113| `/status` | Ouvrir l'interface des Paramètres (onglet Statut) affichant la version, le modèle, le compte et la connectivité. Fonctionne pendant que Claude répond, sans attendre la fin de la réponse actuelle |

110| `/statusline` | Configurer la [ligne de statut](/fr/statusline) de Claude Code. Décrivez ce que vous voulez, ou exécutez sans arguments pour auto-configurer à partir de votre invite shell |114| `/statusline` | Configurer la [ligne de statut](/fr/statusline) de Claude Code. Décrivez ce que vous voulez, ou exécutez sans arguments pour auto-configurer à partir de votre invite shell |

116| `/stop` | Arrêter la [session d'arrière-plan](/fr/agent-view) actuelle. Disponible uniquement lors de l'attachement à une session d'arrière-plan ; la transcription et tout worktree sont conservés. Pour détacher sans arrêter, utilisez `/exit` ou appuyez sur `←` |

113| `/team-onboarding` | Générer un guide d'intégration d'équipe à partir de votre historique d'utilisation de Claude Code. Claude analyse vos sessions, commandes et utilisation du serveur MCP des 30 derniers jours et produit un guide markdown qu'un coéquipier peut coller comme premier message pour se configurer rapidement. Pour les abonnés claude.ai aux plans Pro, Max, Team et Enterprise, retourne également un lien de partage que les coéquipiers peuvent ouvrir directement dans Claude Code |118| `/team-onboarding` | Générer un guide d'intégration d'équipe à partir de votre historique d'utilisation de Claude Code. Claude analyse vos sessions, commandes et utilisation du serveur MCP des 30 derniers jours et produit un guide markdown qu'un coéquipier peut coller comme premier message pour se configurer rapidement. Pour les abonnés claude.ai aux plans Pro, Max, Team et Enterprise, retourne également un lien de partage que les coéquipiers peuvent ouvrir directement dans Claude Code |

114| `/teleport` | Extraire une session [Claude Code sur le web](/fr/claude-code-on-the-web#from-web-to-terminal) dans ce terminal : ouvre un sélecteur, puis récupère la branche et la conversation. Également disponible sous `/tp`. Nécessite un abonnement claude.ai |119| `/teleport` | Extraire une session [Claude Code sur le web](/fr/claude-code-on-the-web#from-web-to-terminal) dans ce terminal : ouvre un sélecteur, puis récupère la branche et la conversation. Également disponible sous `/tp`. Nécessite un abonnement claude.ai |

common-workflows.md +86 −590

Details

6 6

7> Guides étape par étape pour explorer les bases de code, corriger les bogues, refactoriser, tester et autres tâches quotidiennes avec Claude Code.7> Guides étape par étape pour explorer les bases de code, corriger les bogues, refactoriser, tester et autres tâches quotidiennes avec Claude Code.

8 8

9Cette page couvre les flux de travail pratiques pour le développement quotidien : explorer du code inconnu, déboguer, refactoriser, écrire des tests, créer des PR et gérer les sessions. Chaque section inclut des exemples de prompts que vous pouvez adapter à vos propres projets. Pour des modèles et des conseils de plus haut niveau, consultez [Bonnes pratiques](/fr/best-practices).9Cette page rassemble de courtes recettes pour le développement quotidien. Pour des conseils de plus haut niveau sur les prompts et la gestion du contexte, consultez [Bonnes pratiques](/fr/best-practices).

10 10

~~11## Comprendre les nouvelles bases de code~~11Cette page couvre :

12 12

~~13### Obtenir un aperçu rapide de la base de code~~13* [Recettes de prompts](#prompt-recipes) pour explorer le code, corriger les bogues, refactoriser, tester, les PR et la documentation

14* [Reprendre les conversations précédentes](#resume-previous-conversations) pour qu'une tâche puisse s'étendre sur plusieurs sessions

15* [Exécuter des sessions parallèles avec worktrees](#run-parallel-sessions-with-worktrees) pour que les modifications concurrentes ne se heurtent pas

16* [Planifier avant de modifier](#plan-before-editing) pour examiner les modifications avant qu'elles ne touchent le disque

17* [Déléguer la recherche à des subagents](#delegate-research-to-subagents) pour garder votre contexte principal propre

18* [Canaliser Claude dans des scripts](#pipe-claude-into-scripts) pour CI et le traitement par lot

20## Recettes de prompts

22Ce sont des modèles de prompts pour les tâches quotidiennes comme explorer du code inconnu, déboguer, refactoriser, écrire des tests et créer des PR. Chacun fonctionne sur n'importe quelle surface Claude Code ; adaptez la formulation à votre projet.

24### Comprendre les nouvelles bases de code

26#### Obtenir un aperçu rapide de la base de code

14 27

15Supposons que vous venez de rejoindre un nouveau projet et que vous devez comprendre rapidement sa structure.28Supposons que vous venez de rejoindre un nouveau projet et que vous devez comprendre rapidement sa structure.

16 29

56 * Demandez un glossaire des termes spécifiques au projet69 * Demandez un glossaire des termes spécifiques au projet

57</Tip>70</Tip>

58 71

~~59### Trouver du code pertinent~~72#### Trouver du code pertinent

60 73

61Supposons que vous ayez besoin de localiser du code lié à une fonctionnalité ou une capacité spécifique.74Supposons que vous ayez besoin de localiser du code lié à une fonctionnalité ou une capacité spécifique.

62 75

90 103

91***104***

92 105

~~93## Corriger les bogues efficacement~~106### Corriger les bogues efficacement

94 107

95Supposons que vous ayez rencontré un message d'erreur et que vous ayez besoin de trouver et de corriger sa source.108Supposons que vous ayez rencontré un message d'erreur et que vous ayez besoin de trouver et de corriger sa source.

96 109

124 137

125***138***

126 139

127## Refactoriser le code140### Refactoriser le code

128 141

129Supposons que vous ayez besoin de mettre à jour du code ancien pour utiliser des modèles et des pratiques modernes.142Supposons que vous ayez besoin de mettre à jour du code ancien pour utiliser des modèles et des pratiques modernes.

130 143

164 177

165***178***

166 179

167## Utiliser des subagents spécialisés180### Travailler avec les tests

~~168~~

169Supposons que vous souhaitiez utiliser des subagents IA spécialisés pour gérer des tâches spécifiques plus efficacement.

~~170~~

171<Steps>

172 <Step title="Afficher les subagents disponibles">

173 ```text theme={null}

174 /agents

175 ```

~~176~~

177 Cela affiche tous les subagents disponibles et vous permet d'en créer de nouveaux.

178 </Step>

~~179~~

180 <Step title="Utiliser les subagents automatiquement">

181 Claude Code délègue automatiquement les tâches appropriées aux subagents spécialisés :

~~182~~

183 ```text theme={null}

184 review my recent code changes for security issues

185 ```

~~186~~

187 ```text theme={null}

188 run all tests and fix any failures

189 ```

190 </Step>

~~191~~

192 <Step title="Demander explicitement des subagents spécifiques">

193 ```text theme={null}

194 use the code-reviewer subagent to check the auth module

195 ```

~~196~~

197 ```text theme={null}

198 have the debugger subagent investigate why users can't log in

199 ```

200 </Step>

~~201~~

202 <Step title="Créer des subagents personnalisés pour votre flux de travail">

203 ```text theme={null}

204 /agents

205 ```

~~206~~

207 Sélectionnez ensuite « Créer un nouveau subagent » et suivez les invites pour définir :

~~208~~

209 * Un identifiant unique qui décrit l'objectif du subagent (par exemple, `code-reviewer`, `api-designer`).

210 * Quand Claude doit utiliser cet agent

211 * Quels outils il peut accéder

212 * Une invite système décrivant le rôle et le comportement de l'agent

213 </Step>

214</Steps>

~~215~~

216<Tip>

217 Conseils :

~~218~~

219 * Créez des subagents spécifiques au projet dans `.claude/agents/` pour le partage en équipe

220 * Utilisez des champs `description` descriptifs pour activer la délégation automatique

221 * Limitez l'accès aux outils à ce dont chaque subagent a réellement besoin

222 * Consultez la [documentation des subagents](/fr/sub-agents) pour des exemples détaillés

223</Tip>

~~224~~

225***

~~226~~

227## Utiliser le Plan Mode pour une analyse de code sûre

~~228~~

229Plan Mode demande à Claude de créer un plan en analysant la base de code avec des opérations en lecture seule, parfait pour explorer les bases de code, planifier des modifications complexes ou examiner le code en toute sécurité. En Plan Mode, Claude utilise [`AskUserQuestion`](/fr/tools-reference) pour recueillir les exigences et clarifier vos objectifs avant de proposer un plan.

~~230~~

231### Quand utiliser Plan Mode

~~232~~

233* **Implémentation multi-étapes** : Quand votre fonctionnalité nécessite de faire des modifications à de nombreux fichiers

234* **Exploration de code** : Quand vous souhaitez rechercher la base de code en profondeur avant de modifier quoi que ce soit

235* **Développement interactif** : Quand vous souhaitez itérer sur la direction avec Claude

~~236~~

237### Comment utiliser Plan Mode

~~238~~

239**Activez Plan Mode pendant une session**

~~240~~

241Vous pouvez basculer en Plan Mode pendant une session en utilisant **Maj+Tab** pour parcourir les modes de permission.

~~242~~

243Si vous êtes en Mode Normal, **Maj+Tab** bascule d'abord en Mode Auto-Accept, indiqué par `⏵⏵ accept edits on` en bas du terminal. Un **Maj+Tab** ultérieur basculera en Plan Mode, indiqué par `⏸ plan mode on`.

~~244~~

245**Démarrez une nouvelle session en Plan Mode**

~~246~~

247Pour démarrer une nouvelle session en Plan Mode, utilisez le drapeau `--permission-mode plan` :

~~248~~

249```bash theme={null}

250claude --permission-mode plan

251```

~~252~~

253**Exécutez des requêtes « headless » en Plan Mode**

~~254~~

255Vous pouvez également exécuter une requête en Plan Mode directement avec `-p` (c'est-à-dire en [« mode headless »](/fr/headless)) :

~~256~~

257```bash theme={null}

258claude --permission-mode plan -p "Analyze the authentication system and suggest improvements"

259```

~~260~~

261### Exemple : Planifier une refactorisation complexe

~~262~~

263```bash theme={null}

264claude --permission-mode plan

265```

~~266~~

267```text theme={null}

268I need to refactor our authentication system to use OAuth2. Create a detailed migration plan.

269```

~~270~~

271Claude analyse l'implémentation actuelle et crée un plan complet. Affinez avec des suites :

~~272~~

273```text theme={null}

274What about backward compatibility?

275```

~~276~~

277```text theme={null}

278How should we handle database migration?

279```

~~280~~

281<Tip>Appuyez sur `Ctrl+G` pour ouvrir le plan dans votre éditeur de texte par défaut, où vous pouvez le modifier directement avant que Claude ne procède.</Tip>

~~282~~

283Lorsque vous acceptez un plan, Claude nomme automatiquement la session à partir du contenu du plan. Le nom apparaît sur la barre de prompt et dans le sélecteur de session. Si vous avez déjà défini un nom avec `--name` ou `/rename`, accepter un plan ne le remplacera pas.

~~284~~

285### Configurer Plan Mode par défaut

~~286~~

287```json theme={null}

288// .claude/settings.json

289{

290 "permissions": {

291 "defaultMode": "plan"

292 }

293}

294```

~~295~~

296Consultez la [documentation des paramètres](/fr/settings#available-settings) pour plus d'options de configuration.

~~297~~

298***

~~299~~

300## Travailler avec les tests

301 181

302Supposons que vous ayez besoin d'ajouter des tests pour du code non couvert.182Supposons que vous ayez besoin d'ajouter des tests pour du code non couvert.

303 183

333 213

334***214***

335 215

336## Créer des demandes de tirage216### Créer des demandes de tirage

337 217

338Vous pouvez créer des demandes de tirage en demandant directement à Claude (« créer une pr pour mes modifications »), ou guider Claude à travers cela étape par étape :218Vous pouvez créer des demandes de tirage en demandant directement à Claude (« créer une pr pour mes modifications »), ou guider Claude à travers cela étape par étape :

339 219

357 </Step>237 </Step>

358</Steps>238</Steps>

359 239

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

361 241

362<Tip>242<Tip>

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

364</Tip>244</Tip>

365 245

366## Gérer la documentation246### Gérer la documentation

367 247

368Supposons que vous ayez besoin d'ajouter ou de mettre à jour la documentation de votre code.248Supposons que vous ayez besoin d'ajouter ou de mettre à jour la documentation de votre code.

369 249

403 283

404***284***

405 285

406## Travailler dans les notes et les dossiers non-code286### Travailler dans les notes et les dossiers non-code

407 287

408Claude Code fonctionne dans n'importe quel répertoire. Exécutez-le à l'intérieur d'un coffre-fort de notes, d'un dossier de documentation ou de toute collection de fichiers markdown pour rechercher, modifier et réorganiser le contenu de la même manière que vous le feriez pour du code.288Claude Code fonctionne dans n'importe quel répertoire. Exécutez-le à l'intérieur d'un coffre-fort de notes, d'un dossier de documentation ou de toute collection de fichiers markdown pour rechercher, modifier et réorganiser le contenu de la même manière que vous le feriez pour du code.

409 289

411 291

412***292***

413 293

414## Travailler avec les images294### Travailler avec les images

415 295

416Supposons que vous ayez besoin de travailler avec des images dans votre base de code et que vous souhaitiez l'aide de Claude pour analyser le contenu des images.296Supposons que vous ayez besoin de travailler avec des images dans votre base de code et que vous souhaitiez l'aide de Claude pour analyser le contenu des images.

417 297

471 351

472***352***

473 353

474## Référencer les fichiers et répertoires354### Référencer les fichiers et répertoires

475 355

476Utilisez @ pour inclure rapidement des fichiers ou des répertoires sans attendre que Claude les lise.356Utilisez @ pour inclure rapidement des fichiers ou des répertoires sans attendre que Claude les lise.

477 357

512 392

513***393***

514 394

515## Utiliser la réflexion étendue (mode de réflexion)395### Exécuter Claude selon un calendrier

~~516~~

517[La réflexion étendue](https://platform.claude.com/docs/fr/build-with-claude/extended-thinking) est activée par défaut, donnant à Claude l'espace pour raisonner à travers des problèmes complexes étape par étape avant de répondre. Ce raisonnement est visible en mode verbeux, que vous pouvez activer avec `Ctrl+O`. Pendant la réflexion étendue, l'indicateur de progression affiche des indices de progression en ligne tels que « still thinking » et « almost done thinking » pour indiquer que Claude travaille activement.

~~518~~

519De plus, les [modèles qui prennent en charge l'effort](/fr/model-config#adjust-effort-level) utilisent le raisonnement adaptatif : au lieu d'un budget de jetons de réflexion fixe, le modèle décide dynamiquement s'il faut penser et combien en fonction de votre paramètre de niveau d'effort et de la tâche à accomplir. Le raisonnement adaptatif permet à Claude de répondre plus rapidement aux prompts de routine et de réserver une réflexion plus profonde pour les étapes qui en bénéficient.

~~520~~

521La réflexion étendue est particulièrement précieuse pour les décisions architecturales complexes, les bogues difficiles, la planification de l'implémentation multi-étapes et l'évaluation des compromis entre différentes approches.

~~522~~

523<Note>

524 Les phrases comme « think », « think hard » et « think more » sont interprétées comme des instructions de prompt régulières et n'allouent pas de jetons de réflexion.

525</Note>

~~526~~

527### Configurer le mode de réflexion

~~528~~

529La réflexion est activée par défaut, mais vous pouvez l'ajuster ou la désactiver.

~~530~~

531| Portée | Comment configurer | Détails |

532| ------------------------------- | --------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

533| **Niveau d'effort** | Exécutez `/effort`, ajustez dans `/model`, ou définissez [`CLAUDE_CODE_EFFORT_LEVEL`](/fr/env-vars) | Contrôlez la profondeur de la réflexion sur les [modèles pris en charge](/fr/model-config#adjust-effort-level) |

534| **Mot-clé `ultrathink`** | Incluez « ultrathink » n'importe où dans votre prompt | Ajoute une instruction en contexte indiquant au modèle de raisonner davantage sur ce tour. Ne change pas le niveau d'effort lui-même ; consultez [Ajuster le niveau d'effort](/fr/model-config#adjust-effort-level) pour cela |

535| **Raccourci de basculement** | Appuyez sur `Option+T` (macOS) ou `Alt+T` (Windows/Linux) | Basculez la réflexion activée/désactivée pour la session actuelle (tous les modèles). Peut nécessiter une [configuration du terminal](/fr/terminal-config) pour activer les raccourcis de la touche Option |

536| **Défaut global** | Utilisez `/config` pour basculer le mode de réflexion | Définit votre défaut sur tous les projets (tous les modèles).<br />Enregistré comme `alwaysThinkingEnabled` dans `~/.claude/settings.json` |

537| **Limiter le budget de jetons** | Définissez la variable d'environnement [`MAX_THINKING_TOKENS`](/fr/env-vars) | Limitez le budget de réflexion à un nombre spécifique de jetons. Sur les modèles avec raisonnement adaptatif, seul `0` s'applique sauf si le raisonnement adaptatif est désactivé. Exemple : `export MAX_THINKING_TOKENS=10000` |

~~538~~

539Pour afficher le processus de réflexion de Claude, appuyez sur `Ctrl+O` pour basculer le mode verbeux et voir le raisonnement interne affiché en texte gris italique.

~~540~~

541### Comment fonctionne la réflexion étendue

~~542~~

543La réflexion étendue contrôle la quantité de raisonnement interne que Claude effectue avant de répondre. Plus de réflexion fournit plus d'espace pour explorer les solutions, analyser les cas limites et corriger les erreurs.

~~544~~

545Sur les [modèles qui prennent en charge l'effort](/fr/model-config#adjust-effort-level), la réflexion utilise le raisonnement adaptatif : le modèle alloue dynamiquement les jetons de réflexion en fonction du niveau d'effort que vous sélectionnez. C'est la façon recommandée d'ajuster le compromis entre la vitesse et la profondeur du raisonnement. Si vous souhaitez que Claude pense plus ou moins souvent que votre niveau d'effort ne le produirait autrement, vous pouvez également le dire directement dans votre prompt ou dans `CLAUDE.md`.

~~546~~

547Avec les modèles plus anciens, la réflexion utilise un budget fixe de jetons tiré de votre allocation de sortie. Le budget varie selon le modèle ; consultez [`MAX_THINKING_TOKENS`](/fr/env-vars) pour les plafonds par modèle. Vous pouvez limiter le budget avec cette variable d'environnement, ou désactiver complètement la réflexion via `/config` ou le basculement `Option+T`/`Alt+T`.

~~548~~

549Sur les modèles avec raisonnement adaptatif, `MAX_THINKING_TOKENS` ne s'applique que lorsqu'il est défini à `0` pour désactiver la réflexion, ou lorsque `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1` revient à ces modèles au budget fixe. `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` s'applique à Opus 4.6 et Sonnet 4.6 uniquement. Opus 4.7 utilise toujours le raisonnement adaptatif et ne prend pas en charge un budget de réflexion fixe. Consultez [variables d'environnement](/fr/env-vars).

~~550~~

551<Warning>

552 Vous êtes facturé pour tous les jetons de réflexion utilisés, même si les résumés de réflexion sont redactés. En mode interactif, la réflexion apparaît comme un stub réduit par défaut. Définissez `showThinkingSummaries: true` dans `settings.json` pour afficher les résumés complets.

553</Warning>

~~554~~

555***

~~556~~

557## Reprendre les conversations précédentes

~~558~~

559Lors du démarrage de Claude Code, vous pouvez reprendre une session précédente :

~~560~~

561* `claude --continue` continue la conversation la plus récente dans le répertoire actuel

562* `claude --resume` ouvre un sélecteur de conversation ou reprend par nom

563* `claude --from-pr 123` reprend les sessions liées à une demande de tirage spécifique

~~564~~

565À partir d'une session active, utilisez `/resume` pour basculer vers une conversation différente.

~~566~~

567Lorsque la session sélectionnée est ancienne et suffisamment volumineuse pour que sa relecture consommerait une part substantielle de vos limites d'utilisation, `--resume`, `--continue` et `/resume` proposent de reprendre à partir d'un résumé au lieu de charger la transcription complète. Cette invite n'est pas disponible sur Amazon Bedrock, Google Cloud Vertex AI ou Microsoft Foundry.

~~568~~

569Les sessions sont stockées par répertoire de projet. Par défaut, le sélecteur `/resume` affiche les sessions interactives du worktree actuel, avec des raccourcis clavier pour élargir la liste à d'autres worktrees ou projets, rechercher, prévisualiser et renommer. Consultez [Utiliser le sélecteur de session](#use-the-session-picker) ci-dessous pour la référence complète des raccourcis.

~~570~~

571Lorsque vous sélectionnez une session à partir d'un autre worktree du même référentiel, Claude Code la reprend directement sans vous obliger à d'abord basculer les répertoires. La sélection d'une session à partir d'un projet non lié copie une commande `cd` et de reprise dans votre presse-papiers à la place.

~~572~~

573La reprise par nom se résout dans le référentiel actuel et ses worktrees. À la fois `claude --resume <name>` et `/resume <name>` recherchent une correspondance exacte et la reprennent directement, même si la session se trouve dans un worktree différent.

~~574~~

575Lorsque le nom est ambigu, `claude --resume <name>` ouvre le sélecteur avec le nom pré-rempli comme terme de recherche. `/resume <name>` à partir d'une session signale une erreur à la place, donc exécutez `/resume` sans argument pour ouvrir le sélecteur et choisir.

~~576~~

577Les sessions créées par `claude -p` ou les invocations SDK n'apparaissent pas dans le sélecteur, mais vous pouvez toujours en reprendre une en passant son ID de session directement à `claude --resume <session-id>`.

~~578~~

579### Nommez vos sessions

~~580~~

581Donnez aux sessions des noms descriptifs pour les trouver plus tard. C'est une bonne pratique lorsque vous travaillez sur plusieurs tâches ou fonctionnalités.

~~582~~

583<Steps>

584 <Step title="Nommez la session">

585 Nommez une session au démarrage avec `-n` :

~~586~~

587 ```bash theme={null}

588 claude -n auth-refactor

589 ```

~~590~~

591 Ou utilisez `/rename` pendant une session, qui affiche également le nom sur la barre de prompt :

~~592~~

593 ```text theme={null}

594 /rename auth-refactor

595 ```

~~596~~

597 Vous pouvez également renommer n'importe quelle session à partir du sélecteur : exécutez `/resume`, accédez à une session et appuyez sur `Ctrl+R`.

598 </Step>

~~599~~

600 <Step title="Reprenez par nom plus tard">

601 À partir de la ligne de commande :

~~602~~

603 ```bash theme={null}

604 claude --resume auth-refactor

605 ```

~~606~~

607 Ou à partir d'une session active :

~~608~~

609 ```text theme={null}

610 /resume auth-refactor

611 ```

612 </Step>

613</Steps>

~~614~~

615### Utilisez le sélecteur de session

~~616~~

617La commande `/resume` (ou `claude --resume` sans arguments) ouvre un sélecteur de session interactif avec ces fonctionnalités :

~~618~~

619**Raccourcis clavier dans le sélecteur :**

~~620~~

621| Raccourci | Action |

622| :-------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

623| `↑` / `↓` | Naviguer entre les sessions |

624| `→` / `←` | Développer ou réduire les sessions groupées |

625| `Entrée` | Sélectionner et reprendre la session en surbrillance |

626| `Espace` | Aperçu du contenu de la session. `Ctrl+V` fonctionne également sur les terminaux qui ne le capturent pas comme collage |

627| `Ctrl+R` | Renommer la session en surbrillance |

628| `/` ou tout caractère imprimable autre que `Espace` | Entrer en mode de recherche et filtrer les sessions |

629| `Ctrl+A` | Afficher les sessions de tous les projets sur cette machine. Appuyez à nouveau pour restaurer le référentiel actuel |

630| `Ctrl+W` | Afficher les sessions de tous les worktrees du référentiel actuel. Appuyez à nouveau pour restaurer le worktree actuel. Affiché uniquement dans les référentiels multi-worktrees |

631| `Ctrl+B` | Filtrer les sessions de votre branche git actuelle. Appuyez à nouveau pour afficher les sessions de toutes les branches |

632| `Échap` | Quitter le sélecteur ou le mode de recherche |

~~633~~

634**Organisation des sessions :**

~~635~~

636Le sélecteur affiche les sessions avec des métadonnées utiles :

~~637~~

638* Nom de la session s'il est défini, sinon le résumé de la conversation ou le premier prompt utilisateur

639* Temps écoulé depuis la dernière activité

640* Nombre de messages

641* Branche Git (le cas échéant)

642* Chemin du projet, affiché après élargissement à tous les projets avec `Ctrl+A`

~~643~~

644Les sessions bifurquées (créées avec `/branch`, `/rewind` ou `--fork-session`) sont groupées ensemble sous leur session racine, ce qui facilite la recherche de conversations connexes.

~~645~~

646<Tip>

647 Conseils :

~~648~~

649 * **Nommez les sessions tôt** : Utilisez `/rename` au démarrage du travail sur une tâche distincte — il est beaucoup plus facile de trouver « payment-integration » que « explain this function » plus tard

650 * Utilisez `--continue` pour un accès rapide à votre conversation la plus récente dans le répertoire actuel

651 * Utilisez `--resume session-name` quand vous savez quelle session vous avez besoin

652 * Utilisez `--resume` (sans nom) quand vous avez besoin de parcourir et de sélectionner

653 * Pour les scripts, utilisez `claude --continue --print "prompt"` pour reprendre en mode non interactif

654 * Appuyez sur `Espace` dans le sélecteur pour prévisualiser une session avant de la reprendre

655 * La conversation reprise démarre avec le même modèle et la même configuration que l'original

~~656~~

657 Comment cela fonctionne :

~~658~~

659 1. **Stockage des conversations** : Toutes les conversations sont automatiquement enregistrées localement avec leur historique complet des messages

660 2. **Désérialisation des messages** : Lors de la reprise, l'historique complet des messages est restauré pour maintenir le contexte

661 3. **État des outils** : L'utilisation des outils et les résultats de la conversation précédente sont préservés

662 4. **Restauration du contexte** : La conversation reprend avec tout le contexte précédent intact

663</Tip>

~~664~~

665***

~~666~~

667## Exécuter des sessions Claude Code parallèles avec Git worktrees

~~668~~

669Lorsque vous travaillez sur plusieurs tâches à la fois, vous avez besoin que chaque session Claude ait sa propre copie de la base de code afin que les modifications ne se heurtent pas. Les worktrees Git résolvent ce problème en créant des répertoires de travail séparés qui ont chacun leurs propres fichiers et branche, tout en partageant le même historique de référentiel et les mêmes connexions distantes. Cela signifie que vous pouvez avoir Claude travaillant sur une fonctionnalité dans un worktree tout en corrigeant un bogue dans un autre, sans que l'une ou l'autre session n'interfère avec l'autre.

~~670~~

671Utilisez le drapeau `--worktree` (`-w`) pour créer un worktree isolé et démarrer Claude dedans. La valeur que vous transmettez devient le nom du répertoire worktree et le nom de la branche :

~~672~~

673```bash theme={null}

674# Démarrez Claude dans un worktree nommé « feature-auth »

675# Crée .claude/worktrees/feature-auth/ avec une nouvelle branche

676claude --worktree feature-auth

~~677~~

678# Démarrez une autre session dans un worktree séparé

679claude --worktree bugfix-123

680```

~~681~~

682Si vous omettez le nom, Claude en génère un automatiquement :

~~683~~

684```bash theme={null}

685# Génère automatiquement un nom comme « bright-running-fox »

686claude --worktree

687```

~~688~~

689Les worktrees sont créés à `<repo>/.claude/worktrees/<name>` et se ramifient à partir de la branche distante par défaut, qui est celle vers laquelle `origin/HEAD` pointe. La branche worktree est nommée `worktree-<name>`.

~~690~~

691La branche de base n'est pas configurable via un drapeau ou un paramètre Claude Code. `origin/HEAD` est une référence stockée dans votre répertoire `.git` local que Git a définie une fois lorsque vous avez cloné. Si la branche par défaut du référentiel change plus tard sur GitHub ou GitLab, votre `origin/HEAD` local continue de pointer vers l'ancienne, et les worktrees se ramifieront à partir de là. Pour resynchroniser votre référence locale avec ce que le distant considère actuellement comme son défaut :

~~692~~

693```bash theme={null}

694git remote set-head origin -a

695```

~~696~~

697C'est une commande Git standard qui met à jour uniquement votre répertoire `.git` local. Rien sur le serveur distant ne change. Si vous souhaitez que les worktrees se basent sur une branche spécifique plutôt que sur le défaut du distant, définissez-le explicitement avec `git remote set-head origin your-branch-name`.

~~698~~

699Pour un contrôle total sur la façon dont les worktrees sont créés, y compris le choix d'une base différente par invocation, configurez un hook [WorktreeCreate](/fr/hooks#worktreecreate). Le hook remplace complètement la logique `git worktree` par défaut de Claude Code, afin que vous puissiez récupérer et vous ramifier à partir de la ref dont vous avez besoin.

~~700~~

701Vous pouvez également demander à Claude de « travailler dans un worktree » ou « démarrer un worktree » pendant une session, et il en créera un automatiquement.

~~702~~

703### Worktrees des subagents

~~704~~

705Les subagents peuvent également utiliser l'isolation worktree pour travailler en parallèle sans conflits. Demandez à Claude d'« utiliser les worktrees pour vos agents » ou configurez-le dans un [subagent personnalisé](/fr/sub-agents#supported-frontmatter-fields) en ajoutant `isolation: worktree` au frontmatter de l'agent. Chaque subagent obtient son propre worktree qui est automatiquement nettoyé quand le subagent se termine sans modifications.

~~706~~

707### Nettoyage des worktrees

~~708~~

709Lorsque vous quittez une session worktree, Claude gère le nettoyage en fonction de si vous avez apporté des modifications :

~~710~~

711* **Pas de modifications** : le worktree et sa branche sont supprimés automatiquement

712* **Les modifications ou les commits existent** : Claude vous demande de conserver ou de supprimer le worktree. La conservation préserve le répertoire et la branche afin que vous puissiez revenir plus tard. La suppression supprime le répertoire worktree et sa branche, en supprimant toutes les modifications non validées et les commits

~~713~~

714Les worktrees des subagents orphelins causés par un crash ou une exécution parallèle interrompue sont supprimés automatiquement au démarrage une fois qu'ils sont plus anciens que votre paramètre [`cleanupPeriodDays`](/fr/settings#available-settings), à condition qu'ils n'aient pas de modifications non validées, pas de fichiers non suivis et pas de commits non poussés. Les worktrees que vous créez avec `--worktree` ne sont jamais supprimés par ce balayage.

~~715~~

716Pour nettoyer les worktrees en dehors d'une session Claude, utilisez la [gestion manuelle des worktrees](#manage-worktrees-manually).

~~717~~

718<Tip>

719 Ajoutez `.claude/worktrees/` à votre `.gitignore` pour empêcher le contenu des worktrees d'apparaître comme des fichiers non suivis dans votre référentiel principal.

720</Tip>

~~721~~

722### Copier les fichiers ignorés par git vers les worktrees

~~723~~

724Les worktrees Git sont des checkouts frais, donc ils n'incluent pas les fichiers non suivis comme `.env` ou `.env.local` de votre référentiel principal. Pour copier automatiquement ces fichiers lorsque Claude crée un worktree, ajoutez un fichier `.worktreeinclude` à la racine de votre projet.

~~725~~

726Le fichier utilise la syntaxe `.gitignore` pour lister les fichiers à copier. Seuls les fichiers qui correspondent à un modèle et qui sont également ignorés par git sont copiés, donc les fichiers suivis ne sont jamais dupliqués.

~~727~~

728```text .worktreeinclude theme={null}

729.env

730.env.local

731config/secrets.json

732```

~~733~~

734Cela s'applique aux worktrees créés avec `--worktree`, aux worktrees des subagents et aux sessions parallèles dans l'[application de bureau](/fr/desktop#work-in-parallel-with-sessions).

~~735~~

736### Gérer les worktrees manuellement

~~737~~

738Pour plus de contrôle sur l'emplacement du worktree et la configuration de la branche, créez des worktrees directement avec Git. C'est utile quand vous avez besoin de vérifier une branche existante spécifique ou de placer le worktree en dehors du référentiel.

~~739~~

740```bash theme={null}

741# Créez un worktree avec une nouvelle branche

742git worktree add ../project-feature-a -b feature-a

~~743~~

744# Créez un worktree avec une branche existante

745git worktree add ../project-bugfix bugfix-123

~~746~~

747# Démarrez Claude dans le worktree

748cd ../project-feature-a && claude

~~749~~

750# Nettoyez quand vous avez terminé

751git worktree list

752git worktree remove ../project-feature-a

753```

~~754~~

755En savoir plus dans la [documentation officielle de Git worktree](https://git-scm.com/docs/git-worktree).

~~756~~

757<Tip>

758 N'oubliez pas d'initialiser votre environnement de développement dans chaque nouveau worktree selon la configuration de votre projet. Selon votre pile, cela peut inclure l'exécution de l'installation des dépendances (`npm install`, `yarn`), la configuration des environnements virtuels ou le suivi du processus de configuration standard de votre projet.

759</Tip>

~~760~~

761### Contrôle de version non-git

~~762~~

763L'isolation worktree fonctionne avec git par défaut. Pour d'autres systèmes de contrôle de version comme SVN, Perforce ou Mercurial, configurez les hooks [WorktreeCreate et WorktreeRemove](/fr/hooks#worktreecreate) pour fournir une logique personnalisée de création et de nettoyage des worktrees. Lorsqu'ils sont configurés, ces hooks remplacent le comportement git par défaut lorsque vous utilisez `--worktree`, donc [`.worktreeinclude`](#copy-gitignored-files-to-worktrees) n'est pas traité. Copiez les fichiers de configuration locaux à l'intérieur de votre script de hook à la place.

~~764~~

765Pour la coordination automatisée des sessions parallèles avec des tâches partagées et la messagerie, consultez [équipes d'agents](/fr/agent-teams).

~~766~~

767***

~~768~~

769## Recevez une notification quand Claude a besoin de votre attention

~~770~~

771Lorsque vous lancez une tâche longue et que vous basculez vers une autre fenêtre, vous pouvez configurer des notifications de bureau afin de savoir quand Claude se termine ou a besoin de votre entrée. Cela utilise l'événement de hook `Notification` [hook event](/fr/hooks-guide#get-notified-when-claude-needs-input), qui se déclenche chaque fois que Claude attend une permission, est inactif et prêt pour un nouveau prompt, ou complète l'authentification.

~~772~~

773<Steps>

774 <Step title="Ajoutez le hook à vos paramètres">

775 Ouvrez `~/.claude/settings.json` et ajoutez un hook `Notification` qui appelle la commande de notification native de votre plateforme :

~~776~~

777 <Tabs>

778 <Tab title="macOS">

779 ```json theme={null}

780 {

781 "hooks": {

782 "Notification": [

783 {

784 "matcher": "",

785 "hooks": [

786 {

787 "type": "command",

788 "command": "osascript -e 'display notification \"Claude Code needs your attention\" with title \"Claude Code\"'"

789 }

790 ]

791 }

792 ]

793 }

794 }

795 ```

796 </Tab>

~~797~~

798 <Tab title="Linux">

799 ```json theme={null}

800 {

801 "hooks": {

802 "Notification": [

803 {

804 "matcher": "",

805 "hooks": [

806 {

807 "type": "command",

808 "command": "notify-send 'Claude Code' 'Claude Code needs your attention'"

809 }

810 ]

811 }

812 ]

813 }

814 }

815 ```

816 </Tab>

~~817~~

818 <Tab title="Windows">

819 ```json theme={null}

820 {

821 "hooks": {

822 "Notification": [

823 {

824 "matcher": "",

825 "hooks": [

826 {

827 "type": "command",

828 "command": "powershell.exe -Command \"[System.Reflection.Assembly]::LoadWithPartialName('System.Windows.Forms'); [System.Windows.Forms.MessageBox]::Show('Claude Code needs your attention', 'Claude Code')\""

829 }

830 ]

831 }

832 ]

833 }

834 }

835 ```

836 </Tab>

837 </Tabs>

~~838~~

839 Si votre fichier de paramètres a déjà une clé `hooks`, fusionnez l'entrée `Notification` dedans plutôt que de la remplacer. Vous pouvez également demander à Claude d'écrire le hook pour vous en décrivant ce que vous voulez dans l'interface CLI.

840 </Step>

~~841~~

842 <Step title="Affinez éventuellement le matcher">

843 Par défaut, le hook se déclenche sur tous les types de notifications. Pour se déclencher uniquement pour des événements spécifiques, définissez le champ `matcher` sur l'une de ces valeurs :

~~844~~

845 | Matcher | Se déclenche quand |

846 | :--------------------- | :---------------------------------------------------------- |

847 | `permission_prompt` | Claude a besoin que vous approuviez une utilisation d'outil |

848 | `idle_prompt` | Claude a terminé et attend votre prochain prompt |

849 | `auth_success` | L'authentification se termine |

850 | `elicitation_dialog` | Un serveur MCP ouvre un formulaire d'élicitation |

851 | `elicitation_complete` | Un formulaire d'élicitation MCP est soumis ou fermé |

852 | `elicitation_response` | Une réponse d'élicitation MCP est renvoyée au serveur |

853 </Step>

~~854~~

855 <Step title="Vérifiez le hook">

856 Tapez `/hooks` et sélectionnez `Notification` pour confirmer que le hook apparaît. Le sélectionner affiche la commande qui s'exécutera. Pour le tester de bout en bout, demandez à Claude d'exécuter une commande qui nécessite une permission et éloignez-vous du terminal, ou demandez à Claude de déclencher une notification directement.

857 </Step>

858</Steps>

~~859~~

860Pour le schéma d'événement complet et les types de notifications, consultez la [référence Notification](/fr/hooks#notification).

~~861~~

862***

~~863~~

864## Utiliser Claude comme un utilitaire de style unix

~~865~~

866### Ajoutez Claude à votre processus de vérification

~~867~~

868Supposons que vous souhaitiez utiliser Claude Code comme linter ou examinateur de code.

~~869~~

870**Ajoutez Claude à votre script de construction :**

~~871~~

872```json theme={null}

873// package.json

874{

875 ...

876 "scripts": {

877 ...

878 "lint:claude": "claude -p 'you are a linter. please look at the changes vs. main and report any issues related to typos. report the filename and line number on one line, and a description of the issue on the second line. do not return any other text.'"

879 }

880}

881```

~~882~~

883<Tip>

884 Conseils :

~~885~~

886 * Utilisez Claude pour l'examen automatisé du code dans votre pipeline CI/CD

887 * Personnalisez le prompt pour vérifier les problèmes spécifiques pertinents pour votre projet

888 * Envisagez de créer plusieurs scripts pour différents types de vérification

889</Tip>

~~890~~

891### Tuyau entrant, tuyau sortant

~~892~~

893Supposons que vous souhaitiez canaliser les données dans Claude et récupérer les données dans un format structuré.

~~894~~

895**Canalisez les données via Claude :**

~~896~~

897```bash theme={null}

898cat build-error.txt | claude -p 'concisely explain the root cause of this build error' > output.txt

899```

~~900~~

901<Tip>

902 Conseils :

~~903~~

904 * Utilisez les tuyaux pour intégrer Claude dans les scripts shell existants

905 * Combinez avec d'autres outils Unix pour des flux de travail puissants

906 * Envisagez d'utiliser `--output-format` pour une sortie structurée

907</Tip>

~~908~~

909### Contrôler le format de sortie

~~910~~

911Supposons que vous ayez besoin de la sortie de Claude dans un format spécifique, en particulier lors de l'intégration de Claude Code dans des scripts ou d'autres outils.

~~912~~

913<Steps>

914 <Step title="Utilisez le format texte (par défaut)">

915 ```bash theme={null}

916 cat data.txt | claude -p 'summarize this data' --output-format text > summary.txt

917 ```

~~918~~

919 Cela génère uniquement la réponse en texte brut de Claude (comportement par défaut).

920 </Step>

~~921~~

922 <Step title="Utilisez le format JSON">

923 ```bash theme={null}

924 cat code.py | claude -p 'analyze this code for bugs' --output-format json > analysis.json

925 ```

~~926~~

927 Cela génère un tableau JSON de messages avec des métadonnées incluant le coût et la durée.

928 </Step>

~~929~~

930 <Step title="Utilisez le format JSON en continu">

931 ```bash theme={null}

932 cat log.txt | claude -p 'parse this log file for errors' --output-format stream-json

933 ```

~~934~~

935 Cela génère une série d'objets JSON en temps réel au fur et à mesure que Claude traite la demande. Chaque message est un objet JSON valide, mais la sortie entière n'est pas un JSON valide s'il est concaténé.

936 </Step>

937</Steps>

~~938~~

939<Tip>

940 Conseils :

~~941~~

942 * Utilisez `--output-format text` pour les intégrations simples où vous avez juste besoin de la réponse de Claude

943 * Utilisez `--output-format json` quand vous avez besoin du journal de conversation complet

944 * Utilisez `--output-format stream-json` pour la sortie en temps réel de chaque tour de conversation

945</Tip>

~~946~~

947***

~~948~~

949## Exécuter Claude selon un calendrier

950 396

951Supposons que vous souhaitiez que Claude gère une tâche automatiquement de manière récurrente, comme examiner les PR ouvertes chaque matin, auditer les dépendances chaque semaine ou vérifier les échecs CI pendant la nuit.397Supposons que vous souhaitiez que Claude gère une tâche automatiquement de manière récurrente, comme examiner les PR ouvertes chaque matin, auditer les dépendances chaque semaine ou vérifier les échecs CI pendant la nuit.

952 398

960| [`/loop`](/fr/scheduled-tasks) | La session CLI actuelle | L'interrogation rapide pendant qu'une session est ouverte. Les tâches s'arrêtent quand vous commencez une nouvelle conversation ; `--resume` et `--continue` restaurent les tâches non expirées. |406| [`/loop`](/fr/scheduled-tasks) | La session CLI actuelle | L'interrogation rapide pendant qu'une session est ouverte. Les tâches s'arrêtent quand vous commencez une nouvelle conversation ; `--resume` et `--continue` restaurent les tâches non expirées. |

961 407

962<Tip>408<Tip>

963 Lors de la rédaction de prompts pour les tâches planifiées, soyez explicite sur ce que signifie le succès et ce qu'il faut faire avec les résultats. La tâche s'exécute de manière autonome, elle ne peut donc pas poser de questions de clarification. Par exemple : ' Examinez les PR ouvertes étiquetées `needs-review`, laissez des commentaires en ligne sur les problèmes et publiez un résumé dans le canal Slack `#eng-reviews`. '409 Lors de la rédaction de prompts pour les tâches planifiées, soyez explicite sur ce que signifie le succès et ce qu'il faut faire avec les résultats. La tâche s'exécute de manière autonome, elle ne peut donc pas poser de questions de clarification. Par exemple : « Examinez les PR ouvertes étiquetées `needs-review`, laissez des commentaires en ligne sur les problèmes et publiez un résumé dans le canal Slack `#eng-reviews`. »

964</Tip>410</Tip>

965 411

966***412***

967 413

968## Demandez à Claude ses capacités414### Demandez à Claude ses capacités

969 415

970Claude a un accès intégré à sa documentation et peut répondre à des questions sur ses propres fonctionnalités et limitations.416Claude a un accès intégré à sa documentation et peut répondre à des questions sur ses propres fonctionnalités et limitations.

971 417

972### Exemples de questions418#### Exemples de questions

973 419

974```text theme={null}420```text theme={null}

975can Claude Code create pull requests?421can Claude Code create pull requests?

1009 455

1010***456***

1011 457

458## Reprendre les conversations précédentes

459

460Quand une tâche s'étend sur plusieurs sessions, reprenez là où vous avez laissé au lieu de réexpliquer le contexte. Claude Code enregistre chaque conversation localement.

461

462```bash theme={null}

463claude --continue

464```

465

466Cela reprend la session la plus récente dans le répertoire actuel ; s'il n'y en a pas encore, il affiche `No conversation found to continue` et se termine. Utilisez `claude --resume` pour choisir dans une liste, ou `/resume` depuis une session en cours. Consultez [Gérer les sessions](/fr/sessions) pour nommer, créer des branches et la référence complète du sélecteur.

467

468## Exécuter des sessions parallèles avec worktrees

469

470Travaillez sur une fonctionnalité dans un terminal tandis que Claude corrige un bogue dans un autre, sans que les modifications ne se heurtent. Chaque worktree est un checkout séparé sur sa propre branche.

471

472```bash theme={null}

473claude --worktree feature-auth

474```

475

476Exécutez la même commande avec un nom différent dans un deuxième terminal pour démarrer une session parallèle isolée. Consultez [Worktrees](/fr/worktrees) pour le nettoyage, `.worktreeinclude` et le support VCS non-git. Pour surveiller les sessions parallèles à partir d'un seul écran au lieu de terminaux séparés, consultez [agents en arrière-plan](/fr/agent-view).

477

478## Planifier avant de modifier

479

480Pour les modifications que vous souhaitez examiner avant qu'elles ne touchent le disque, basculez en mode plan. Claude lit les fichiers et propose un plan mais ne fait aucune modification jusqu'à ce que vous approuviez.

481

482```bash theme={null}

483claude --permission-mode plan

484```

485

486Vous pouvez également appuyer sur `Shift+Tab` pendant une session pour basculer en mode plan. Consultez [Mode plan](/fr/permission-modes#analyze-before-you-edit-with-plan-mode) pour le flux d'approbation et la modification du plan dans votre éditeur de texte.

487

488## Déléguer la recherche à des subagents

489

490Explorer une grande base de code remplit votre contexte avec des lectures de fichiers. Déléguez l'exploration pour que seules les conclusions reviennent.

491

492```text theme={null}

493use a subagent to investigate how our auth system handles token refresh

494```

495

496Le subagent lit les fichiers dans sa propre fenêtre de contexte et rapporte un résumé. Consultez [Subagents](/fr/sub-agents) pour définir des agents personnalisés avec leurs propres outils et prompts.

497

498## Canaliser Claude dans des scripts

499

500Exécutez Claude de manière non-interactive pour CI, les hooks de pré-commit ou le traitement par lot. Stdin et stdout fonctionnent comme n'importe quel outil Unix.

501

502```bash theme={null}

503git log --oneline -20 | claude -p "summarize these recent commits"

504```

505

506Consultez [Mode non-interactif](/fr/headless) pour les formats de sortie, les drapeaux de permission et les modèles de fan-out.

507

1012## Étapes suivantes508## Étapes suivantes

1013 509

1014<CardGroup cols={2}>510<CardGroup cols={2}>

1016 Modèles pour tirer le meilleur parti de Claude Code512 Modèles pour tirer le meilleur parti de Claude Code

1017 </Card>513 </Card>

1018 514

1019 <Card title="Comment fonctionne Claude Code" icon="gear" href="/fr/how-claude-code-works">515 <Card title="Gérer les sessions" icon="rotate-left" href="/fr/sessions">

1020 Comprendre la boucle agentique et la gestion du contexte516 Reprendre, nommer et créer des branches de conversations

1021 </Card>517 </Card>

1022 518

1023 <Card title="Étendre Claude Code" icon="puzzle-piece" href="/fr/features-overview">519 <Card title="Worktrees" icon="code-branch" href="/fr/worktrees">

1024 Ajouter des skills, des hooks, MCP, des subagents et des plugins520 Exécuter des sessions parallèles isolées

1025 </Card>521 </Card>

1026 522

1027 <Card title="Implémentation de référence" icon="code" href="https://github.com/anthropics/claude-code/tree/main/.devcontainer">523 <Card title="Étendre Claude Code" icon="puzzle-piece" href="/fr/features-overview">

1028 Clonez l'implémentation de référence du conteneur de développement524 Ajouter des skills, des hooks, MCP, des subagents et des plugins

1029 </Card>525 </Card>

1030</CardGroup>526</CardGroup>

data-usage.md +12 −12

Details

67 67

68Le diagramme ci-dessous montre comment Claude Code se connecte aux services externes lors de l'installation et du fonctionnement normal. Les lignes pleines indiquent les connexions requises, tandis que les lignes pointillées représentent les flux de données optionnels ou initiés par l'utilisateur.68Le diagramme ci-dessous montre comment Claude Code se connecte aux services externes lors de l'installation et du fonctionnement normal. Les lignes pleines indiquent les connexions requises, tandis que les lignes pointillées représentent les flux de données optionnels ou initiés par l'utilisateur.

69 69

70<img src="https://mintcdn.com/claude-code/RcOyXc06Ja8cuvMZ/images/claude-code-data-flow.svg?fit=max&auto=format&n=RcOyXc06Ja8cuvMZ&q=85&s=b5be40abf333defe984993af89546c19" alt="Diagramme montrant les connexions externes de Claude Code : l'installation/mise à jour se connecte au serveur de distribution, et les demandes des utilisateurs se connectent aux services Anthropic, y compris l'authentification Console, l'API publique, et optionnellement Statsig, Sentry et les rapports de bogues" width="720" height="520" data-path="images/claude-code-data-flow.svg" />70<img src="https://mintcdn.com/claude-code/RcOyXc06Ja8cuvMZ/images/claude-code-data-flow.svg?fit=max&auto=format&n=RcOyXc06Ja8cuvMZ&q=85&s=b5be40abf333defe984993af89546c19" alt="Diagramme montrant les connexions externes de Claude Code : l'installation/mise à jour se connecte au serveur de distribution, et les demandes des utilisateurs se connectent aux services Anthropic, y compris l'authentification Console, l'API publique, et optionnellement les métriques, Sentry et les rapports de bogues" width="720" height="520" data-path="images/claude-code-data-flow.svg" />

71 71

72Claude Code s'exécute localement. Pour interagir avec le LLM, Claude Code envoie des données sur le réseau. Ces données incluent tous les invites utilisateur et les sorties du modèle, chiffrées en transit via TLS 1.2+. Claude Code est compatible avec la plupart des VPN et proxies LLM populaires.72Claude Code s'exécute localement. Pour interagir avec le LLM, Claude Code envoie des données sur le réseau. Ces données incluent tous les invites utilisateur et les sorties du modèle, chiffrées en transit via TLS 1.2+. Claude Code est compatible avec la plupart des VPN et proxies LLM populaires.

73 73

95 95

96## Services de télémétrie96## Services de télémétrie

97 97

98Claude Code se connecte à partir des machines des utilisateurs au service Statsig pour enregistrer les métriques opérationnelles telles que la latence, la fiabilité et les modèles d'utilisation. Cet enregistrement n'inclut aucun code ni chemin de fichier. Les données sont chiffrées en transit à l'aide de TLS et au repos à l'aide du chiffrement AES 256 bits. Lisez-en plus dans la [documentation de sécurité Statsig](https://www.statsig.com/trust/security). Pour refuser la télémétrie Statsig, définissez la variable d'environnement `DISABLE_TELEMETRY`.98Claude Code se connecte à partir des machines des utilisateurs à Anthropic pour enregistrer les métriques opérationnelles telles que la latence, la fiabilité et les modèles d'utilisation. Cet enregistrement n'inclut aucun code ni chemin de fichier. Les données sont chiffrées en transit et au repos. Pour refuser la télémétrie, définissez la variable d'environnement `DISABLE_TELEMETRY`.

99 99

100Claude Code se connecte à partir des machines des utilisateurs à Sentry pour la journalisation des erreurs opérationnelles. Les données sont chiffrées en transit à l'aide de TLS et au repos à l'aide du chiffrement AES 256 bits. Lisez-en plus dans la [documentation de sécurité Sentry](https://sentry.io/security/). Pour refuser la journalisation des erreurs, définissez la variable d'environnement `DISABLE_ERROR_REPORTING`.100Claude Code se connecte à partir des machines des utilisateurs à Sentry pour la journalisation des erreurs opérationnelles. Les données sont chiffrées en transit à l'aide de TLS et au repos à l'aide du chiffrement AES 256 bits. Lisez-en plus dans la [documentation de sécurité Sentry](https://sentry.io/security/). Pour refuser la journalisation des erreurs, définissez la variable d'environnement `DISABLE_ERROR_REPORTING`.

101 101

102Lorsque les utilisateurs exécutent la commande `/feedback`, une copie de leur historique de conversation complet, y compris le code, est envoyée à Anthropic. Les données sont chiffrées en transit à l'aide de TLS. Optionnellement, un problème GitHub est créé dans le référentiel public. Pour refuser, définissez la variable d'environnement `DISABLE_FEEDBACK_COMMAND` sur `1`.102Lorsque les utilisateurs exécutent la commande `/feedback`, une copie de leur historique de conversation complet, y compris le code, est envoyée à Anthropic. Les données sont chiffrées en transit via TLS. Optionnellement, un problème GitHub est créé dans le référentiel public. Pour refuser, définissez la variable d'environnement `DISABLE_FEEDBACK_COMMAND` sur `1`.

103 103

104## Comportements par défaut par fournisseur d'API104## Comportements par défaut par fournisseur d'API

105 105

106Par défaut, les rapports d'erreurs, la télémétrie et les rapports de bogues sont désactivés lors de l'utilisation de Bedrock, Vertex ou Foundry. Les sondages de qualité de session et la vérification de sécurité du domaine WebFetch font exception et s'exécutent quel que soit le fournisseur. Vous pouvez refuser tout le trafic non essentiel, y compris les sondages, à la fois en définissant `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`. Cette variable n'affecte pas la vérification WebFetch, qui a sa propre option de refus. Voici les comportements par défaut complets :106Par défaut, les rapports d'erreurs, la télémétrie et les rapports de bogues sont désactivés lors de l'utilisation de Bedrock, Vertex, Foundry ou Claude Platform sur AWS. Les sondages de qualité de session et la vérification de sécurité du domaine WebFetch font exception et s'exécutent quel que soit le fournisseur. Vous pouvez refuser tout le trafic non essentiel, y compris les sondages, à la fois en définissant `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`. Cette variable n'affecte pas la vérification WebFetch, qui a sa propre option de refus. Voici les comportements par défaut complets :

107 107

109| ------------------------------------------------ | ------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------ |109| ------------------------------------------------ | ------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------ |

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

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

112| **Claude API (rapports `/feedback`)** | Activé par défaut.<br />`DISABLE_FEEDBACK_COMMAND=1` pour désactiver. | Désactivé par défaut.<br />`CLAUDE_CODE_USE_VERTEX` doit être 1. | Désactivé par défaut.<br />`CLAUDE_CODE_USE_BEDROCK` doit être 1. | Désactivé par défaut.<br />`CLAUDE_CODE_USE_FOUNDRY` doit être 1. |112| **Claude API (rapports `/feedback`)** | Activé par défaut.<br />`DISABLE_FEEDBACK_COMMAND=1` pour désactiver. | Désactivé par défaut.<br />`CLAUDE_CODE_USE_VERTEX` doit être 1. | Désactivé par défaut.<br />`CLAUDE_CODE_USE_BEDROCK` doit être 1. | Désactivé par défaut.<br />`CLAUDE_CODE_USE_FOUNDRY` doit être 1. | Désactivé par défaut.<br />`CLAUDE_CODE_USE_ANTHROPIC_AWS` doit être 1. |

113| **Sondages de qualité de session** | Activé par défaut.<br />`CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY=1` pour désactiver. | Activé par défaut.<br />`CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY=1` pour désactiver. | Activé par défaut.<br />`CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY=1` pour désactiver. | Activé par défaut.<br />`CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY=1` pour désactiver. |113| **Sondages de qualité de session** | Activé par défaut.<br />`CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY=1` pour désactiver. | Activé par défaut.<br />`CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY=1` pour désactiver. | Activé par défaut.<br />`CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY=1` pour désactiver. | Activé par défaut.<br />`CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY=1` pour désactiver. | Activé par défaut.<br />`CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY=1` pour désactiver. |

114| **Vérification de sécurité du domaine WebFetch** | Activé par défaut.<br />`skipWebFetchPreflight: true` dans [paramètres](/fr/settings) pour désactiver. | Activé par défaut.<br />`skipWebFetchPreflight: true` dans [paramètres](/fr/settings) pour désactiver. | Activé par défaut.<br />`skipWebFetchPreflight: true` dans [paramètres](/fr/settings) pour désactiver. | Activé par défaut.<br />`skipWebFetchPreflight: true` dans [paramètres](/fr/settings) pour désactiver. |114| **Vérification de sécurité du domaine WebFetch** | Activé par défaut.<br />`skipWebFetchPreflight: true` dans [paramètres](/fr/settings) pour désactiver. | Activé par défaut.<br />`skipWebFetchPreflight: true` dans [paramètres](/fr/settings) pour désactiver. | Activé par défaut.<br />`skipWebFetchPreflight: true` dans [paramètres](/fr/settings) pour désactiver. | Activé par défaut.<br />`skipWebFetchPreflight: true` dans [paramètres](/fr/settings) pour désactiver. | Activé par défaut.<br />`skipWebFetchPreflight: true` dans [paramètres](/fr/settings) pour désactiver. |

115 115

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

117 117

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

119 119

120### Vérification de sécurité du domaine WebFetch120### Vérification de sécurité du domaine WebFetch

121 121

env-vars.md +10 −4

Details

12| :------------------------------------------------------ | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |12| :------------------------------------------------------ | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

13| `ANTHROPIC_API_KEY` | Clé API envoyée en tant qu'en-tête `X-Api-Key`. Lorsqu'elle est définie, cette clé est utilisée à la place de votre abonnement Claude Pro, Max, Team ou Enterprise, même si vous êtes connecté. En mode non interactif (`-p`), la clé est toujours utilisée lorsqu'elle est présente. En mode interactif, vous êtes invité à approuver la clé une fois avant qu'elle ne remplace votre abonnement. Pour utiliser votre abonnement à la place, exécutez `unset ANTHROPIC_API_KEY` |13| `ANTHROPIC_API_KEY` | Clé API envoyée en tant qu'en-tête `X-Api-Key`. Lorsqu'elle est définie, cette clé est utilisée à la place de votre abonnement Claude Pro, Max, Team ou Enterprise, même si vous êtes connecté. En mode non interactif (`-p`), la clé est toujours utilisée lorsqu'elle est présente. En mode interactif, vous êtes invité à approuver la clé une fois avant qu'elle ne remplace votre abonnement. Pour utiliser votre abonnement à la place, exécutez `unset ANTHROPIC_API_KEY` |

14| `ANTHROPIC_AUTH_TOKEN` | Valeur personnalisée pour l'en-tête `Authorization` (la valeur que vous définissez ici sera préfixée par `Bearer `) |14| `ANTHROPIC_AUTH_TOKEN` | Valeur personnalisée pour l'en-tête `Authorization` (la valeur que vous définissez ici sera préfixée par `Bearer `) |

15| `ANTHROPIC_AWS_API_KEY` | Clé API de l'espace de travail pour [Claude Platform on AWS](/fr/claude-platform-on-aws), générée dans la console AWS. Envoyée en tant que `x-api-key` et prend la priorité sur AWS SigV4 |

16| `ANTHROPIC_AWS_BASE_URL` | Remplacer l'URL du point de terminaison [Claude Platform on AWS](/fr/claude-platform-on-aws). À utiliser pour les régions personnalisées ou lors du routage via une [passerelle LLM](/fr/llm-gateway). Par défaut `https://aws-external-anthropic.{AWS_REGION}.api.aws` |

17| `ANTHROPIC_AWS_WORKSPACE_ID` | Requis pour [Claude Platform on AWS](/fr/claude-platform-on-aws). Envoyé à chaque requête en tant qu'en-tête `anthropic-workspace-id` |

15| `ANTHROPIC_BASE_URL` | Remplacer le point de terminaison de l'API pour acheminer les requêtes via un proxy ou une passerelle. Lorsqu'elle est définie sur un hôte non-first-party, la [recherche d'outils MCP](/fr/mcp#scale-with-mcp-tool-search) est désactivée par défaut. Définissez `ENABLE_TOOL_SEARCH=true` si votre proxy transfère les blocs `tool_reference` |18| `ANTHROPIC_BASE_URL` | Remplacer le point de terminaison de l'API pour acheminer les requêtes via un proxy ou une passerelle. Lorsqu'elle est définie sur un hôte non-first-party, la [recherche d'outils MCP](/fr/mcp#scale-with-mcp-tool-search) est désactivée par défaut. Définissez `ENABLE_TOOL_SEARCH=true` si votre proxy transfère les blocs `tool_reference` |

16| `ANTHROPIC_BEDROCK_BASE_URL` | Remplacer l'URL du point de terminaison Bedrock. À utiliser pour les points de terminaison Bedrock personnalisés ou lors du routage via une [passerelle LLM](/fr/llm-gateway). Voir [Amazon Bedrock](/fr/amazon-bedrock) |19| `ANTHROPIC_BEDROCK_BASE_URL` | Remplacer l'URL du point de terminaison Bedrock. À utiliser pour les points de terminaison Bedrock personnalisés ou lors du routage via une [passerelle LLM](/fr/llm-gateway). Voir [Amazon Bedrock](/fr/amazon-bedrock) |

17| `ANTHROPIC_BEDROCK_MANTLE_BASE_URL` | Remplacer l'URL du point de terminaison Bedrock Mantle. Voir [Point de terminaison Mantle](/fr/amazon-bedrock#use-the-mantle-endpoint) |20| `ANTHROPIC_BEDROCK_MANTLE_BASE_URL` | Remplacer l'URL du point de terminaison Bedrock Mantle. Voir [Point de terminaison Mantle](/fr/amazon-bedrock#use-the-mantle-endpoint) |

45| `API_TIMEOUT_MS` | Délai d'expiration pour les requêtes API en millisecondes (par défaut : 600 000, ou 10 minutes ; maximum : 2 147 483 647). Augmentez ceci lorsque les requêtes expirent sur les réseaux lents ou lors du routage via un proxy. Les valeurs au-dessus du maximum dépassent le minuteur sous-jacent et provoquent l'échec immédiat des requêtes |48| `API_TIMEOUT_MS` | Délai d'expiration pour les requêtes API en millisecondes (par défaut : 600 000, ou 10 minutes ; maximum : 2 147 483 647). Augmentez ceci lorsque les requêtes expirent sur les réseaux lents ou lors du routage via un proxy. Les valeurs au-dessus du maximum dépassent le minuteur sous-jacent et provoquent l'échec immédiat des requêtes |

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

47| `BASH_DEFAULT_TIMEOUT_MS` | Délai d'expiration par défaut pour les commandes bash longues (par défaut : 120 000, ou 2 minutes) |50| `BASH_DEFAULT_TIMEOUT_MS` | Délai d'expiration par défaut pour les commandes bash longues (par défaut : 120 000, ou 2 minutes) |

48| `BASH_MAX_OUTPUT_LENGTH` | Nombre maximum de caractères dans les sorties bash avant qu'elles ne soient tronquées au milieu |51| `BASH_MAX_OUTPUT_LENGTH` | Nombre maximum de caractères dans les sorties bash avant que la sortie complète soit enregistrée dans un fichier et que Claude reçoive le chemin plus un court aperçu. Voir [Comportement de l'outil Bash](/fr/tools-reference#bash-tool-behavior) |

49| `BASH_MAX_TIMEOUT_MS` | Délai d'expiration maximal que le modèle peut définir pour les commandes bash longues (par défaut : 600 000, ou 10 minutes) |52| `BASH_MAX_TIMEOUT_MS` | Délai d'expiration maximal que le modèle peut définir pour les commandes bash longues (par défaut : 600 000, ou 10 minutes) |

50| `CCR_FORCE_BUNDLE` | Définissez sur `1` pour forcer [`claude --remote`](/fr/claude-code-on-the-web#send-local-repositories-without-github) à regrouper et télécharger votre référentiel local même lorsque l'accès à GitHub est disponible |53| `CCR_FORCE_BUNDLE` | Définissez sur `1` pour forcer [`claude --remote`](/fr/claude-code-on-the-web#send-local-repositories-without-github) à regrouper et télécharger votre référentiel local même lorsque l'accès à GitHub est disponible |

51| `CLAUDECODE` | Défini sur `1` dans les environnements shell que Claude Code génère (outil Bash, sessions tmux). Non défini dans les [hooks](/fr/hooks) ou les commandes de [ligne d'état](/fr/statusline). Utilisez pour détecter quand un script s'exécute à l'intérieur d'un shell généré par Claude Code |54| `CLAUDECODE` | Défini sur `1` dans les environnements shell que Claude Code génère (outil Bash, sessions tmux). Non défini dans les [hooks](/fr/hooks) ou les commandes de [ligne d'état](/fr/statusline). Utilisez pour détecter quand un script s'exécute à l'intérieur d'un shell généré par Claude Code |

69| `CLAUDE_CODE_DEBUG_LOG_LEVEL` | Niveau de journal minimum écrit dans le fichier journal de débogage. Valeurs : `verbose`, `debug` (par défaut), `info`, `warn`, `error`. Définissez sur `verbose` pour inclure les diagnostics à haut volume comme la sortie complète de la commande de ligne d'état, ou augmentez à `error` pour réduire le bruit |72| `CLAUDE_CODE_DEBUG_LOG_LEVEL` | Niveau de journal minimum écrit dans le fichier journal de débogage. Valeurs : `verbose`, `debug` (par défaut), `info`, `warn`, `error`. Définissez sur `verbose` pour inclure les diagnostics à haut volume comme la sortie complète de la commande de ligne d'état, ou augmentez à `error` pour réduire le bruit |

70| `CLAUDE_CODE_DISABLE_1M_CONTEXT` | Définissez sur `1` pour désactiver la prise en charge de la [fenêtre de contexte 1 M](/fr/model-config#extended-context). Lorsqu'elle est définie, les variantes de modèle 1 M ne sont pas disponibles dans le sélecteur de modèle. Utile pour les environnements d'entreprise avec des exigences de conformité |73| `CLAUDE_CODE_DISABLE_1M_CONTEXT` | Définissez sur `1` pour désactiver la prise en charge de la [fenêtre de contexte 1 M](/fr/model-config#extended-context). Lorsqu'elle est définie, les variantes de modèle 1 M ne sont pas disponibles dans le sélecteur de modèle. Utile pour les environnements d'entreprise avec des exigences de conformité |

71| `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` | Définissez sur `1` pour désactiver le [raisonnement adaptatif](/fr/model-config#adjust-effort-level) sur Opus 4.6 et Sonnet 4.6 et revenir au budget de réflexion fixe contrôlé par `MAX_THINKING_TOKENS`. {/* min-version: 2.1.111 */}N'a aucun effet sur Opus 4.7, qui utilise toujours le raisonnement adaptatif |74| `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` | Définissez sur `1` pour désactiver le [raisonnement adaptatif](/fr/model-config#adjust-effort-level) sur Opus 4.6 et Sonnet 4.6 et revenir au budget de réflexion fixe contrôlé par `MAX_THINKING_TOKENS`. {/* min-version: 2.1.111 */}N'a aucun effet sur Opus 4.7, qui utilise toujours le raisonnement adaptatif |

75| `CLAUDE_CODE_DISABLE_AGENT_VIEW` | Définissez sur `1` pour désactiver les [agents en arrière-plan et la vue des agents](/fr/agent-view) : `claude agents`, `--bg`, `/background` et le superviseur à la demande. Équivalent au paramètre [`disableAgentView`](/fr/settings#available-settings) |

72| `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN` | Définissez sur `1` pour désactiver le [rendu en plein écran](/fr/fullscreen) et utiliser le rendu classique de l'écran principal. La conversation reste dans le défilement natif de votre terminal pour que `Cmd+f` et le mode copie tmux fonctionnent comme d'habitude. Prend la priorité sur `CLAUDE_CODE_NO_FLICKER` et le paramètre [`tui`](/fr/settings#available-settings). Vous pouvez également basculer avec `/tui default` |76| `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN` | Définissez sur `1` pour désactiver le [rendu en plein écran](/fr/fullscreen) et utiliser le rendu classique de l'écran principal. La conversation reste dans le défilement natif de votre terminal pour que `Cmd+f` et le mode copie tmux fonctionnent comme d'habitude. Prend la priorité sur `CLAUDE_CODE_NO_FLICKER` et le paramètre [`tui`](/fr/settings#available-settings). Vous pouvez également basculer avec `/tui default` |

73| `CLAUDE_CODE_DISABLE_ATTACHMENTS` | Définissez sur `1` pour désactiver le traitement des pièces jointes. Les mentions de fichiers avec la syntaxe `@` sont envoyées en tant que texte brut au lieu d'être développées dans le contenu du fichier |77| `CLAUDE_CODE_DISABLE_ATTACHMENTS` | Définissez sur `1` pour désactiver le traitement des pièces jointes. Les mentions de fichiers avec la syntaxe `@` sont envoyées en tant que texte brut au lieu d'être développées dans le contenu du fichier |

74| `CLAUDE_CODE_DISABLE_AUTO_MEMORY` | Définissez sur `1` pour désactiver la [mémoire automatique](/fr/memory#auto-memory). Définissez sur `0` pour forcer la mémoire automatique même lorsque le mode `--bare` ou [`autoMemoryEnabled: false`](/fr/settings#available-settings) la désactiverait autrement. Lorsqu'elle est désactivée, Claude ne crée ni ne charge les fichiers de mémoire automatique |78| `CLAUDE_CODE_DISABLE_AUTO_MEMORY` | Définissez sur `1` pour désactiver la [mémoire automatique](/fr/memory#auto-memory). Définissez sur `0` pour forcer la mémoire automatique même lorsque le mode `--bare` ou [`autoMemoryEnabled: false`](/fr/settings#available-settings) la désactiverait autrement. Lorsqu'elle est désactivée, Claude ne crée ni ne charge les fichiers de mémoire automatique |

104| `CLAUDE_CODE_FORCE_SYNC_OUTPUT` | Définissez sur `1` pour forcer l'activation du mode privé DEC 2026 [synchronized output](https://gist.github.com/christianparpart/d8a62cc1ab659194337d73e399004036) lorsque votre terminal le prend en charge mais n'est pas détecté automatiquement. Utile pour les émulateurs tels que Emacs `eat` qui implémentent BSU/ESU mais ne répondent pas à la sonde de capacité. N'a aucun effet sous tmux |108| `CLAUDE_CODE_FORCE_SYNC_OUTPUT` | Définissez sur `1` pour forcer l'activation du mode privé DEC 2026 [synchronized output](https://gist.github.com/christianparpart/d8a62cc1ab659194337d73e399004036) lorsque votre terminal le prend en charge mais n'est pas détecté automatiquement. Utile pour les émulateurs tels que Emacs `eat` qui implémentent BSU/ESU mais ne répondent pas à la sonde de capacité. N'a aucun effet sous tmux |

105| `CLAUDE_CODE_FORK_SUBAGENT` | Définissez sur `1` pour activer les [subagents forked](/fr/sub-agents#fork-the-current-conversation). Un subagent forked hérite du contexte de conversation complet de la session principale au lieu de commencer à zéro. Lorsqu'elle est activée, `/fork` génère un subagent forked plutôt que d'agir comme un alias pour [`/branch`](/fr/commands), et tous les spawns de subagent s'exécutent en arrière-plan. Fonctionne en mode interactif et via le SDK ou `claude -p` |109| `CLAUDE_CODE_FORK_SUBAGENT` | Définissez sur `1` pour activer les [subagents forked](/fr/sub-agents#fork-the-current-conversation). Un subagent forked hérite du contexte de conversation complet de la session principale au lieu de commencer à zéro. Lorsqu'elle est activée, `/fork` génère un subagent forked plutôt que d'agir comme un alias pour [`/branch`](/fr/commands), et tous les spawns de subagent s'exécutent en arrière-plan. Fonctionne en mode interactif et via le SDK ou `claude -p` |

106| `CLAUDE_CODE_GIT_BASH_PATH` | Windows uniquement : chemin d'accès à l'exécutable Git Bash (`bash.exe`). À utiliser lorsque Git Bash est installé mais pas dans votre PATH. Voir [Configuration Windows](/fr/setup#set-up-on-windows) |110| `CLAUDE_CODE_GIT_BASH_PATH` | Windows uniquement : chemin d'accès à l'exécutable Git Bash (`bash.exe`). À utiliser lorsque Git Bash est installé mais pas dans votre PATH. Voir [Configuration Windows](/fr/setup#set-up-on-windows) |

107| `CLAUDE_CODE_GLOB_HIDDEN` | Définissez sur `false` pour exclure les fichiers pointés des résultats lorsque Claude appelle l'[outil Glob](/fr/tools-reference). Inclus par défaut. N'affecte pas l'autocomplétion de fichier `@`, `ls`, Grep ou Read |111| `CLAUDE_CODE_GLOB_HIDDEN` | Définissez sur `false` pour exclure les fichiers pointés des résultats lorsque Claude appelle l'[outil Glob](/fr/tools-reference#glob-tool-behavior). Inclus par défaut. N'affecte pas l'autocomplétion de fichier `@`, `ls`, Grep ou Read |

108| `CLAUDE_CODE_GLOB_NO_IGNORE` | Définissez sur `false` pour faire respecter à l'[outil Glob](/fr/tools-reference) les modèles `.gitignore`. Par défaut, Glob retourne tous les fichiers correspondants, y compris ceux ignorés par git. N'affecte pas l'autocomplétion de fichier `@`, qui a son propre paramètre [`respectGitignore`](/fr/settings#available-settings) |112| `CLAUDE_CODE_GLOB_NO_IGNORE` | Définissez sur `false` pour faire respecter à l'[outil Glob](/fr/tools-reference#glob-tool-behavior) les modèles `.gitignore`. Par défaut, Glob retourne tous les fichiers correspondants, y compris ceux ignorés par git. N'affecte pas l'autocomplétion de fichier `@`, qui a son propre paramètre [`respectGitignore`](/fr/settings#available-settings) |

109| `CLAUDE_CODE_GLOB_TIMEOUT_SECONDS` | Délai d'expiration en secondes pour la découverte de fichiers de l'outil Glob. Par défaut 20 secondes sur la plupart des plates-formes et 60 secondes sur WSL |113| `CLAUDE_CODE_GLOB_TIMEOUT_SECONDS` | Délai d'expiration en secondes pour la découverte de fichiers de l'outil Glob. Par défaut 20 secondes sur la plupart des plates-formes et 60 secondes sur WSL |

110| `CLAUDE_CODE_HIDE_CWD` | Définissez sur `1` pour masquer le répertoire de travail dans le logo de démarrage. Utile pour les partages d'écran ou les enregistrements où le chemin expose votre nom d'utilisateur du système d'exploitation |114| `CLAUDE_CODE_HIDE_CWD` | Définissez sur `1` pour masquer le répertoire de travail dans le logo de démarrage. Utile pour les partages d'écran ou les enregistrements où le chemin expose votre nom d'utilisateur du système d'exploitation |

111| `CLAUDE_CODE_IDE_HOST_OVERRIDE` | Remplacer l'adresse d'hôte utilisée pour se connecter à l'extension IDE. Par défaut, Claude Code détecte automatiquement l'adresse correcte, y compris le routage WSL vers Windows |115| `CLAUDE_CODE_IDE_HOST_OVERRIDE` | Remplacer l'adresse d'hôte utilisée pour se connecter à l'extension IDE. Par défaut, Claude Code détecte automatiquement l'adresse correcte, y compris le routage WSL vers Windows |

144| `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>` |148| `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>` |

145| `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 |149| `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 |

146| `CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT` | Définissez sur `1` pour utiliser l'invite système minimale et les descriptions d'outils réduites sur Opus 4.7. N'a aucun effet sur les autres modèles. L'ensemble complet d'outils, les hooks, les serveurs MCP et la découverte CLAUDE.md restent activés |150| `CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT` | Définissez sur `1` pour utiliser l'invite système minimale et les descriptions d'outils réduites sur Opus 4.7. N'a aucun effet sur les autres modèles. L'ensemble complet d'outils, les hooks, les serveurs MCP et la découverte CLAUDE.md restent activés |

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

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

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

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

158| `CLAUDE_CODE_TEAM_NAME` | Nom de l'équipe d'agents à laquelle appartient ce coéquipier. Défini automatiquement sur les membres de l'[équipe d'agents](/fr/agent-teams) |163| `CLAUDE_CODE_TEAM_NAME` | Nom de l'équipe d'agents à laquelle appartient ce coéquipier. Défini automatiquement sur les membres de l'[équipe d'agents](/fr/agent-teams) |

159| `CLAUDE_CODE_TMPDIR` | Remplacer le répertoire temporaire utilisé pour les fichiers temporaires internes. Claude Code ajoute `/claude-{uid}/` (Unix) ou `/claude/` (Windows) à ce chemin. Par défaut : `/tmp` sur macOS, `os.tmpdir()` sur Linux/Windows |164| `CLAUDE_CODE_TMPDIR` | Remplacer le répertoire temporaire utilisé pour les fichiers temporaires internes. Claude Code ajoute `/claude-{uid}/` (Unix) ou `/claude/` (Windows) à ce chemin. Par défaut : `/tmp` sur macOS, `os.tmpdir()` sur Linux/Windows |

160| `CLAUDE_CODE_TMUX_TRUECOLOR` | Définissez sur `1` pour permettre la sortie truecolor 24 bits à l'intérieur de tmux. Par défaut, Claude Code limite à 256 couleurs lorsque `$TMUX` est défini car tmux ne transmet pas les séquences d'échappement truecolor à moins d'être configuré. Définissez ceci après avoir ajouté `set -ga terminal-overrides ',*:Tc'` à votre `~/.tmux.conf`. Voir [Configuration du terminal](/fr/terminal-config) pour d'autres paramètres tmux |165| `CLAUDE_CODE_TMUX_TRUECOLOR` | Définissez sur `1` pour permettre la sortie truecolor 24 bits à l'intérieur de tmux. Par défaut, Claude Code limite à 256 couleurs lorsque `$TMUX` est défini car tmux ne transmet pas les séquences d'échappement truecolor à moins d'être configuré. Définissez ceci après avoir ajouté `set -ga terminal-overrides ',*:Tc'` à votre `~/.tmux.conf`. Voir [Configuration du terminal](/fr/terminal-config) pour d'autres paramètres tmux |

166| `CLAUDE_CODE_USE_ANTHROPIC_AWS` | Utiliser [Claude Platform on AWS](/fr/claude-platform-on-aws) |

163| `CLAUDE_CODE_USE_MANTLE` | Utiliser le [point de terminaison Mantle](/fr/amazon-bedrock#use-the-mantle-endpoint) de Bedrock |169| `CLAUDE_CODE_USE_MANTLE` | Utiliser le [point de terminaison Mantle](/fr/amazon-bedrock#use-the-mantle-endpoint) de Bedrock |

195| `DO_NOT_TRACK` | Définissez sur `1` pour refuser la télémétrie. Équivalent à la définition de `DISABLE_TELEMETRY`. Honoré en tant que [convention standard inter-outils](https://consoledonottrack.com/) |201| `DO_NOT_TRACK` | Définissez sur `1` pour refuser la télémétrie. Équivalent à la définition de `DISABLE_TELEMETRY`. Honoré en tant que [convention standard inter-outils](https://consoledonottrack.com/) |

196| `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 |202| `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 |

197| `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) et [Foundry](/fr/microsoft-foundry). 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é |203| `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é |

199| `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 y compris les proxies et Vertex AI), `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) |205| `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 y compris les proxies et Vertex AI), `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) |

200| `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 |206| `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 |

glossary.md +8 −2

Details

126 126

127Un raisonnement étape par étape visible que le modèle effectue avant de répondre. Vous pouvez plafonner les tokens de réflexion avec `MAX_THINKING_TOKENS` ou ajuster le [effort level](#effort-level). La réflexion apparaît en texte gris italique dans le terminal.127Un raisonnement étape par étape visible que le modèle effectue avant de répondre. Vous pouvez plafonner les tokens de réflexion avec `MAX_THINKING_TOKENS` ou ajuster le [effort level](#effort-level). La réflexion apparaît en texte gris italique dans le terminal.

128 128

129En savoir plus : [Use extended thinking](/fr/common-workflows#use-extended-thinking-thinking-mode)129En savoir plus : [Use extended thinking](/fr/model-config#extended-thinking)

130 130

131## H131## H

132 132

286 286

287En savoir plus : [Tools available to Claude](/fr/tools-reference)287En savoir plus : [Tools available to Claude](/fr/tools-reference)

288 288

289### Turn

290

291Une réponse complète de Claude au sein d'une [session](#session). Un turn commence quand vous envoyez un message et se termine quand Claude finit de répondre, avec un nombre quelconque d'appels [tool](#tool) entre les deux. Les [stop hooks](#hook) se déclenchent à la fin de chaque turn. Une session se compose de nombreux turns, et la [agentic loop](#agentic-loop) décrit ce qui se passe à l'intérieur d'un.

292

293En savoir plus : [How Claude Code works](/fr/how-claude-code-works#the-agentic-loop)

294

289## W295## W

290 296

291### Worktree isolation297### Worktree isolation

292 298

293Un mode d'isolation qui exécute Claude dans un worktree git séparé sous `.claude/worktrees/`, activé avec le drapeau `-w` ou `isolation: worktree` dans la configuration du subagent. Les modifications restent sur une branche séparée dans un répertoire séparé, afin que les agents parallèles ne se remplacent pas les fichiers les uns des autres.299Un mode d'isolation qui exécute Claude dans un worktree git séparé sous `.claude/worktrees/`, activé avec le drapeau `-w` ou `isolation: worktree` dans la configuration du subagent. Les modifications restent sur une branche séparée dans un répertoire séparé, afin que les agents parallèles ne se remplacent pas les fichiers les uns des autres.

294 300

295En savoir plus : [Run parallel sessions with git worktrees](/fr/common-workflows#run-parallel-claude-code-sessions-with-git-worktrees)301En savoir plus : [Run parallel sessions with git worktrees](/fr/worktrees)

296 302

297***303***

298 304

goal.md +138 −0 created

Details

1> ## Documentation Index

2> 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.

5# Garder Claude orienté vers un objectif

7> Définissez une condition d'achèvement avec /goal et Claude continue de travailler sur plusieurs tours jusqu'à ce que la condition soit satisfaite.

9La commande `/goal` définit une condition d'achèvement et Claude continue de travailler vers celle-ci sans que vous ayez besoin de le relancer à chaque étape. Après chaque tour, un petit modèle rapide vérifie si la condition est satisfaite. Si ce n'est pas le cas, Claude commence un autre tour au lieu de vous rendre le contrôle. L'objectif s'efface automatiquement une fois la condition satisfaite.

11Utilisez un objectif pour un travail substantiel avec un état final vérifiable :

13* Migrer un module vers une nouvelle API jusqu'à ce que chaque site d'appel se compile et que les tests réussissent

14* Implémenter un document de conception jusqu'à ce que tous les critères d'acceptation soient satisfaits

15* Diviser un grand fichier en modules ciblés jusqu'à ce que chacun soit en dessous d'un budget de taille

16* Traiter une file d'attente de problèmes étiquetés jusqu'à ce que la queue soit vide

18Cette page couvre comment :

20* [Comparer les approches de flux de travail autonome](#compare-to-other-autonomous-workflows) : `/loop`, Stop hooks, et mode auto

21* [Définir un objectif](#set-a-goal) et [écrire une condition efficace](#write-an-effective-condition)

22* [Vérifier le statut](#check-status), [effacer rapidement](#clear-a-goal), et [exécuter de manière non-interactive](#run-non-interactively)

23* Voir [comment fonctionne l'évaluation](#how-evaluation-works) et [les exigences](#requirements)

25## Comparer à d'autres flux de travail autonomes

27Trois approches maintiennent la session actuelle en cours entre les invites. Choisissez en fonction de ce qui devrait démarrer le tour suivant :

29| Approche | Le tour suivant commence quand | S'arrête quand |

30| :------------------------------------------------------------------ | :------------------------------ | :---------------------------------------------------------- |

31| `/goal` | Le tour précédent se termine | Un modèle confirme que la condition est satisfaite |

32| [`/loop`](/fr/scheduled-tasks#run-a-prompt-repeatedly-with-%2Floop) | Un intervalle de temps s'écoule | Vous l'arrêtez, ou Claude décide que le travail est terminé |

33| [Stop hook](/fr/hooks-guide#prompt-based-hooks) | Le tour précédent se termine | Votre propre script ou invite décide |

35`/goal` et un Stop hook se déclenchent tous les deux après chaque tour. `/goal` est un raccourci limité à la session : vous tapez une condition et elle est active pour la session actuelle uniquement. Un Stop hook réside dans votre fichier de paramètres, s'applique à chaque session dans sa portée, et peut exécuter un script pour des vérifications déterministes ou une invite pour des vérifications évaluées par le modèle.

37[Le mode auto](/fr/auto-mode-config) en lui-même approuve les appels d'outils au sein d'un seul tour mais ne démarre pas un nouveau. Claude s'arrête quand il juge le travail terminé. `/goal` ajoute un évaluateur séparé qui vérifie votre condition après chaque tour, donc l'achèvement est décidé par un modèle frais plutôt que par celui qui effectue le travail. Les deux sont complémentaires : le mode auto supprime les invites par outil, et `/goal` supprime les invites par tour.

39<Tip>

40 Les approches ci-dessus maintiennent la session actuelle en cours. Vous pouvez également planifier un travail qui s'exécute indépendamment de toute session ouverte, comme des tests nocturnes ou un triage matinal. Voir [les options de planification](/fr/scheduled-tasks#compare-scheduling-options) pour les routines cloud et les tâches planifiées de bureau.

41</Tip>

43## Utiliser `/goal`

45Un seul objectif peut être actif par session. La même commande le définit, le vérifie et l'efface selon l'argument.

47### Définir un objectif

49Exécutez `/goal` suivi de la condition que vous souhaitez satisfaire. Si un objectif est déjà actif, le nouveau le remplace.

51```text theme={null}

52/goal all tests in test/auth pass and the lint step is clean

53```

55Définir un objectif démarre immédiatement un tour, avec la condition elle-même comme directive. Vous n'avez pas besoin d'envoyer une invite séparée. Pendant que l'objectif est actif, un indicateur `◎ /goal active` montre depuis combien de temps l'objectif s'exécute.

57Après chaque tour, l'évaluateur retourne une courte raison expliquant pourquoi la condition est ou n'est pas satisfaite. La raison la plus récente apparaît dans la vue de statut et dans la transcription afin que vous puissiez voir vers quoi Claude travaille ensuite.

59<Note>

60 Un objectif continue de s'exécuter jusqu'à ce que la condition soit satisfaite ou que vous exécutiez `/goal clear`. Exécutez `/goal` sans argument pour voir les tours et les jetons dépensés jusqu'à présent.

61</Note>

63### Écrire une condition efficace

65L'[évaluateur](#how-evaluation-works) juge votre condition par rapport à ce que Claude a présenté dans la conversation. Il n'exécute pas les commandes ou ne lit pas les fichiers indépendamment, donc écrivez la condition comme quelque chose que la propre sortie de Claude peut démontrer. « Tous les tests dans `test/auth` réussissent » fonctionne parce que Claude exécute les tests et le résultat se retrouve dans la transcription pour que l'évaluateur le lise.

67Une condition qui tient sur plusieurs tours a généralement :

69* **Un état final mesurable** : un résultat de test, un code de sortie de build, un nombre de fichiers, une queue vide

70* **Une vérification énoncée** : comment Claude devrait le prouver, comme « `npm test` sort 0 » ou « `git status` est propre »

71* **Des contraintes qui importent** : tout ce qui ne doit pas changer en chemin, comme « aucun autre fichier de test n'est modifié »

73La condition peut contenir jusqu'à 4 000 caractères.

75Pour limiter la durée d'exécution d'un objectif, incluez une clause de tour ou de temps dans la condition, comme `or stop after 20 turns`. Claude rapporte la progression par rapport à cette clause à chaque tour et l'évaluateur la juge à partir de la conversation.

77### Vérifier le statut

79Exécutez `/goal` sans arguments pour voir l'état actuel.

81```text theme={null}

82/goal

83```

85Si un objectif est actif, le statut affiche :

87* La condition

88* Depuis combien de temps il s'exécute

89* Combien de tours ont été évalués

90* La dépense de jetons actuelle

91* La raison la plus récente de l'évaluateur

93Si aucun objectif n'est actif mais qu'un a été atteint plus tôt dans la session, le statut affiche la condition atteinte ainsi que sa durée, son nombre de tours et sa dépense de jetons.

95### Effacer un objectif

97Exécutez `/goal clear` pour supprimer un objectif actif avant que sa condition soit satisfaite.

99```text theme={null}

100/goal clear

101```

102

103`stop`, `off`, `reset`, `none`, et `cancel` sont acceptés comme alias pour `clear`. L'exécution de `/clear` pour démarrer une nouvelle conversation supprime également tout objectif actif.

104

105### Reprendre avec un objectif actif

106

107Un objectif qui était encore actif quand une session s'est terminée est restauré quand vous reprenez cette session avec `--resume` ou `--continue`. La condition est conservée, mais le nombre de tours, le minuteur et la ligne de base de dépense de jetons se réinitialisent à la reprise. Un objectif qui était déjà atteint ou effacé n'est pas restauré.

108

109### Exécuter de manière non-interactive

110

111`/goal` fonctionne en [mode non-interactive](/fr/headless) et via [Remote Control](/fr/remote-control). Définir un objectif avec `-p` exécute la boucle jusqu'à l'achèvement en une seule invocation :

112

113```bash theme={null}

114claude -p "/goal CHANGELOG.md has an entry for every PR merged this week"

115```

116

117Interrompez le processus avec Ctrl+C pour arrêter un objectif non-interactive avant que la condition soit satisfaite.

118

119## Comment fonctionne l'évaluation

120

121`/goal` est un wrapper autour d'un [Stop hook basé sur une invite](/fr/hooks#prompt-based-hooks) limité à la session. Chaque fois que Claude termine un tour, la condition et la conversation jusqu'à présent sont envoyées à votre [petit modèle rapide](/fr/model-config) configuré, qui par défaut est Haiku. Le modèle retourne une décision oui ou non et une courte raison. Un « non » indique à Claude de continuer à travailler et inclut la raison comme guidance pour le tour suivant. Un « oui » efface l'objectif et enregistre une entrée atteinte dans la transcription.

122

123L'évaluateur s'exécute sur le fournisseur pour lequel votre session est configurée. Il n'appelle pas les outils, donc il ne peut juger que ce que Claude a déjà présenté dans la conversation.

124

125<Note>

126 Les jetons d'évaluation sont facturés sur le petit modèle rapide configuré pour votre fournisseur et sont généralement négligeables par rapport à la dépense du tour principal.

127</Note>

128

129## Exigences

130

131`/goal` s'exécute uniquement dans les espaces de travail où vous avez accepté la boîte de dialogue de confiance, car l'évaluateur fait partie du système de hooks. Si [`disableAllHooks`](/fr/hooks#disable-or-remove-hooks) est défini dans les paramètres de politique gérée, `/goal` n'est pas disponible. Dans les deux cas, la commande vous indique pourquoi au lieu de ne rien faire silencieusement.

132

133## Voir aussi

134

135* [Exécuter une invite à plusieurs reprises avec `/loop`](/fr/scheduled-tasks#run-a-prompt-repeatedly-with-%2Floop) : réexécuter sur un intervalle de temps au lieu de jusqu'à ce qu'une condition soit satisfaite

136* [Hooks basés sur une invite](/fr/hooks-guide#prompt-based-hooks) : écrivez votre propre Stop hook quand vous avez besoin d'une logique d'évaluation personnalisée

137* [Mode auto](/fr/auto-mode-config) : approuvez les appels d'outils automatiquement afin que chaque tour d'objectif s'exécute sans surveillance

138* [Comparaison de planification](/fr/scheduled-tasks#compare-scheduling-options) : exécutez un travail selon un calendrier indépendant de toute session ouverte

hooks.md +4 −0

Details

1768 1768

1769S'exécute lorsque l'agent Claude Code principal a terminé sa réponse. Ne s'exécute pas si l'arrêt s'est produit en raison d'une interruption utilisateur. Les erreurs API déclenchent [StopFailure](#stopfailure) à la place.1769S'exécute lorsque l'agent Claude Code principal a terminé sa réponse. Ne s'exécute pas si l'arrêt s'est produit en raison d'une interruption utilisateur. Les erreurs API déclenchent [StopFailure](#stopfailure) à la place.

1770 1770

1771<Tip>

1772 La commande [`/goal`](/fr/goal) est un raccourci intégré pour un hook Stop basé sur un prompt limité à la session. Utilisez-la lorsque vous voulez que Claude continue à travailler jusqu'à ce qu'une condition soit remplie sans écrire de configuration de hook.

1773</Tip>

1774

1771#### Entrée Stop1775#### Entrée Stop

1772 1776

1773En plus des [champs d'entrée communs](#common-input-fields), les hooks Stop reçoivent `stop_hook_active` et `last_assistant_message`. Le champ `stop_hook_active` est `true` lorsque Claude Code continue déjà en raison d'un hook stop. Vérifiez cette valeur ou traitez la transcription pour empêcher Claude Code de s'exécuter indéfiniment. Le champ `last_assistant_message` contient le contenu textuel de la réponse finale de Claude, donc les hooks peuvent y accéder sans analyser le fichier de transcription.1777En plus des [champs d'entrée communs](#common-input-fields), les hooks Stop reçoivent `stop_hook_active` et `last_assistant_message`. Le champ `stop_hook_active` est `true` lorsque Claude Code continue déjà en raison d'un hook stop. Vérifiez cette valeur ou traitez la transcription pour empêcher Claude Code de s'exécuter indéfiniment. Le champ `last_assistant_message` contient le contenu textuel de la réponse finale de Claude, donc les hooks peuvent y accéder sans analyser le fichier de transcription.

interactive-mode.md +2 −2

Details

23### Contrôles généraux23### Contrôles généraux

24 24

26| :------------------------------------------------ | :-------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |26| :------------------------------------------------ | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

28| `Ctrl+X Ctrl+K` | Arrêter tous les agents en arrière-plan. Appuyez deux fois dans les 3 secondes pour confirmer | Contrôle des agents en arrière-plan |28| `Ctrl+X Ctrl+K` | Arrêter tous les [sous-agents en arrière-plan](/fr/sub-agents#run-subagents-in-foreground-or-background) dans cette session. Appuyez deux fois dans les 3 secondes pour confirmer | Contrôle des sous-agents |

30| `Ctrl+G` ou `Ctrl+X Ctrl+E` | Ouvrir dans l'éditeur de texte par défaut | Modifiez votre invite ou réponse personnalisée dans votre éditeur de texte par défaut. `Ctrl+X Ctrl+E` est la liaison readline native. Activez Afficher la dernière réponse dans l'éditeur externe dans `/config` pour ajouter la réponse précédente de Claude en tant que contexte commenté avec `#` au-dessus de votre invite ; le bloc de commentaire est supprimé lorsque vous enregistrez |30| `Ctrl+G` ou `Ctrl+X Ctrl+E` | Ouvrir dans l'éditeur de texte par défaut | Modifiez votre invite ou réponse personnalisée dans votre éditeur de texte par défaut. `Ctrl+X Ctrl+E` est la liaison readline native. Activez Afficher la dernière réponse dans l'éditeur externe dans `/config` pour ajouter la réponse précédente de Claude en tant que contexte commenté avec `#` au-dessus de votre invite ; le bloc de commentaire est supprimé lorsque vous enregistrez |

31| `Ctrl+L` | Redessiner l'écran | Force un redessinage complet du terminal. L'entrée et l'historique de la conversation sont conservés. Utilisez ceci pour récupérer si l'affichage devient brouillé ou partiellement vide |31| `Ctrl+L` | Redessiner l'écran | Force un redessinage complet du terminal. L'entrée et l'historique de la conversation sont conservés. Utilisez ceci pour récupérer si l'affichage devient brouillé ou partiellement vide |

keybindings.md +1 −1

Details

105| `chat:clearInput` | Ctrl+L | Forcer un redessinage complet de l'écran, en préservant l'entrée. Dans le [rendu plein écran](/fr/fullscreen#clear-the-conversation), appuyez deux fois en deux secondes pour exécuter `/clear` |105| `chat:clearInput` | Ctrl+L | Forcer un redessinage complet de l'écran, en préservant l'entrée. Dans le [rendu plein écran](/fr/fullscreen#clear-the-conversation), appuyez deux fois en deux secondes pour exécuter `/clear` |

llm-gateway.md +11 −0

Details

186export CLOUD_ML_REGION=us-east5186export CLOUD_ML_REGION=us-east5

187```187```

188 188

189##### Claude Platform sur AWS via une passerelle

190

191Acheminez vers une passerelle qui transfère au point de terminaison [Claude Platform sur AWS](/fr/claude-platform-on-aws) :

192

193```bash theme={null}

194export ANTHROPIC_AWS_BASE_URL=https://litellm-server:4000/anthropic-aws

195export ANTHROPIC_AWS_WORKSPACE_ID=wrkspc_01ABCDEFGHIJKLMN

196export CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH=1

197export CLAUDE_CODE_USE_ANTHROPIC_AWS=1

198```

199

189Pour plus d'informations détaillées, consultez la [documentation de LiteLLM](https://docs.litellm.ai/).200Pour plus d'informations détaillées, consultez la [documentation de LiteLLM](https://docs.litellm.ai/).

190 201

191## Ressources supplémentaires202## Ressources supplémentaires

model-config.md +2 −2

Details

36| **`opus[1m]`** | Utilise Opus avec une [fenêtre de contexte de 1 million de tokens](https://platform.claude.com/docs/fr/build-with-claude/context-windows#1m-token-context-window) pour les sessions longues |36| **`opus[1m]`** | Utilise Opus avec une [fenêtre de contexte de 1 million de tokens](https://platform.claude.com/docs/fr/build-with-claude/context-windows#1m-token-context-window) pour les sessions longues |

38 38

39Sur l'API Anthropic, `opus` se résout en Opus 4.7 et `sonnet` se résout en Sonnet 4.6. Sur Bedrock, Vertex et Foundry, `opus` se résout en Opus 4.6 et `sonnet` se résout en Sonnet 4.5 ; les modèles plus récents sont disponibles sur ces fournisseurs en sélectionnant le nom de modèle complet explicitement ou en définissant `ANTHROPIC_DEFAULT_OPUS_MODEL` ou `ANTHROPIC_DEFAULT_SONNET_MODEL`.39Sur l'API Anthropic et [Claude Platform on AWS](/fr/claude-platform-on-aws), `opus` se résout en Opus 4.7 et `sonnet` se résout en Sonnet 4.6. Sur Bedrock, Vertex et Foundry, `opus` se résout en Opus 4.6 et `sonnet` se résout en Sonnet 4.5 ; les modèles plus récents sont disponibles sur ces fournisseurs en sélectionnant le nom de modèle complet explicitement ou en définissant `ANTHROPIC_DEFAULT_OPUS_MODEL` ou `ANTHROPIC_DEFAULT_SONNET_MODEL`.

40 40

41Les alias pointent vers la version recommandée pour votre fournisseur et se mettent à jour au fil du temps. Pour épingler une version spécifique, utilisez le nom de modèle complet (par exemple, `claude-opus-4-7`) ou définissez la variable d'environnement correspondante comme `ANTHROPIC_DEFAULT_OPUS_MODEL`.41Les alias pointent vers la version recommandée pour votre fournisseur et se mettent à jour au fil du temps. Pour épingler une version spécifique, utilisez le nom de modèle complet (par exemple, `claude-opus-4-7`) ou définissez la variable d'environnement correspondante comme `ANTHROPIC_DEFAULT_OPUS_MODEL`.

42 42

294 294

295### Épingler les modèles pour les déploiements tiers295### Épingler les modèles pour les déploiements tiers

296 296

297Lors du déploiement de Claude Code via [Bedrock](/fr/amazon-bedrock), [Vertex AI](/fr/google-vertex-ai) ou [Foundry](/fr/microsoft-foundry), épinglez les versions de modèle avant de les déployer auprès des utilisateurs.297Lors du déploiement de Claude Code via [Bedrock](/fr/amazon-bedrock), [Vertex AI](/fr/google-vertex-ai), [Foundry](/fr/microsoft-foundry) ou [Claude Platform on AWS](/fr/claude-platform-on-aws), épinglez les versions de modèle avant de les déployer auprès des utilisateurs.

298 298

299Sans épinglage, Claude Code utilise les alias de modèle (`sonnet`, `opus`, `haiku`) qui se résolvent à la dernière version. Lorsqu'Anthropic publie un nouveau modèle qui n'est pas encore activé dans le compte d'un utilisateur, les utilisateurs de Bedrock et Vertex AI voient un avis et reviennent à la version précédente pour cette session, tandis que les utilisateurs de Foundry voient des erreurs car Foundry n'a pas de vérification de démarrage équivalente.299Sans épinglage, Claude Code utilise les alias de modèle (`sonnet`, `opus`, `haiku`) qui se résolvent à la dernière version. Lorsqu'Anthropic publie un nouveau modèle qui n'est pas encore activé dans le compte d'un utilisateur, les utilisateurs de Bedrock et Vertex AI voient un avis et reviennent à la version précédente pour cette session, tandis que les utilisateurs de Foundry voient des erreurs car Foundry n'a pas de vérification de démarrage équivalente.

300 300

overview.md +1 −1

Details

172 <Accordion title="Exécuter des équipes d'agents et créer des agents personnalisés" icon="users">172 <Accordion title="Exécuter des équipes d'agents et créer des agents personnalisés" icon="users">

173 Lancez [plusieurs agents Claude Code](/fr/sub-agents) qui travaillent sur différentes parties d'une tâche simultanément. Un agent principal coordonne le travail, assigne les sous-tâches et fusionne les résultats.173 Lancez [plusieurs agents Claude Code](/fr/sub-agents) qui travaillent sur différentes parties d'une tâche simultanément. Un agent principal coordonne le travail, assigne les sous-tâches et fusionne les résultats.

174 174

175 Pour les flux de travail entièrement personnalisés, le [Agent SDK](/fr/agent-sdk/overview) vous permet de créer vos propres agents alimentés par les outils et capacités de Claude Code, avec un contrôle total sur l'orchestration, l'accès aux outils et les permissions.175 Pour exécuter plusieurs sessions complètes en parallèle et les regarder depuis un seul écran, utilisez les [agents en arrière-plan](/fr/agent-view). Pour les flux de travail entièrement personnalisés, le [Agent SDK](/fr/agent-sdk/overview) vous permet de créer vos propres agents alimentés par les outils et capacités de Claude Code, avec un contrôle total sur l'orchestration, l'accès aux outils et les permissions.

176 </Accordion>176 </Accordion>

177 177

178 <Accordion title="Piping, scripts et automatisation avec le CLI" icon="terminal">178 <Accordion title="Piping, scripts et automatisation avec le CLI" icon="terminal">

permissions.md +1 −1

Details

185Les règles `Edit` s'appliquent à tous les outils intégrés qui éditent les fichiers. Claude fait un effort raisonnable pour appliquer les règles `Read` à tous les outils intégrés qui lisent les fichiers comme Grep et Glob.185Les règles `Edit` s'appliquent à tous les outils intégrés qui éditent les fichiers. Claude fait un effort raisonnable pour appliquer les règles `Read` à tous les outils intégrés qui lisent les fichiers comme Grep et Glob.

186 186

187<Warning>187<Warning>

188 Les règles de refus Read et Edit s'appliquent aux outils de fichiers intégrés de Claude, pas aux sous-processus Bash. Une règle de refus `Read(./.env)` bloque l'outil Read mais n'empêche pas `cat .env` dans Bash. Pour une application au niveau du système d'exploitation qui bloque tous les processus d'accéder à un chemin, [activez le sandbox](/fr/sandboxing).188 Les règles de refus Read et Edit s'appliquent aux outils de fichiers intégrés de Claude et aux commandes de fichiers que Claude Code reconnaît dans Bash, tels que `cat`, `head`, `tail` et `sed`. Elles ne s'appliquent pas aux sous-processus arbitraires qui lisent ou écrivent des fichiers indirectement, comme un script Python ou Node qui ouvre des fichiers lui-même. Pour une application au niveau du système d'exploitation qui bloque tous les processus d'accéder à un chemin, [activez le sandbox](/fr/sandboxing).

189</Warning>189</Warning>

190 190

191Les règles Read et Edit suivent toutes deux la spécification [gitignore](https://git-scm.com/docs/gitignore) avec quatre types de modèles distincts :191Les règles Read et Edit suivent toutes deux la spécification [gitignore](https://git-scm.com/docs/gitignore) avec quatre types de modèles distincts :

scheduled-tasks.md +4 −2

Details

10 Les tâches planifiées nécessitent Claude Code v2.1.72 ou version ultérieure. Vérifiez votre version avec `claude --version`.10 Les tâches planifiées nécessitent Claude Code v2.1.72 ou version ultérieure. Vérifiez votre version avec `claude --version`.

11</Note>11</Note>

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.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), [Tâches planifiées sur le bureau](/fr/desktop-scheduled-tasks) ou [GitHub Actions](/fr/github-actions).

16 16

122 122

123Pour arrêter un `/loop` pendant qu'il attend la prochaine itération, appuyez sur `Esc`. Cela efface le réveil en attente afin que la boucle ne se déclenche pas à nouveau. Les tâches que vous avez planifiées en [demandant directement à Claude](#manage-scheduled-tasks) ne sont pas affectées par `Esc` et restent en place jusqu'à ce que vous les supprimiez.123Pour arrêter un `/loop` pendant qu'il attend la prochaine itération, appuyez sur `Esc`. Cela efface le réveil en attente afin que la boucle ne se déclenche pas à nouveau. Les tâches que vous avez planifiées en [demandant directement à Claude](#manage-scheduled-tasks) ne sont pas affectées par `Esc` et restent en place jusqu'à ce que vous les supprimiez.

124 124

125En [mode autonome](#let-claude-choose-the-interval), Claude peut également terminer la boucle de lui-même en ne planifiant pas le prochain réveil une fois que la tâche est manifestement terminée. Les boucles selon un intervalle fixe continuent de s'exécuter jusqu'à ce que vous les arrêtiez ou que [sept jours s'écoulent](#seven-day-expiry).

126

125## Définir un rappel ponctuel127## Définir un rappel ponctuel

126 128

127Pour les rappels ponctuels, décrivez ce que vous voulez en langage naturel au lieu d'utiliser `/loop`. Claude planifie une tâche à usage unique qui se supprime après son exécution.129Pour les rappels ponctuels, décrivez ce que vous voulez en langage naturel au lieu d'utiliser `/loop`. Claude planifie une tâche à usage unique qui se supprime après son exécution.

168 170

169Pour éviter que chaque session ne frappe l'API au même moment mural, le planificateur ajoute un petit décalage déterministe aux heures d'exécution :171Pour éviter que chaque session ne frappe l'API au même moment mural, le planificateur ajoute un petit décalage déterministe aux heures d'exécution :

170 172

171* Les tâches récurrentes s'exécutent jusqu'à 10 % de leur période en retard, plafonnées à 15 minutes. Une tâche horaire peut s'exécuter n'importe où de `:00` à `:06`.173* Les tâches récurrentes s'exécutent jusqu'à 30 minutes après l'heure planifiée (ou jusqu'à la moitié de l'intervalle, pour les tâches qui s'exécutent plus souvent qu'une fois par heure). Une tâche horaire planifiée pour `:00` peut s'exécuter n'importe où jusqu'à `:30`.

172* Les tâches ponctuelles planifiées pour le haut ou le bas de l'heure s'exécutent jusqu'à 90 secondes plus tôt.174* Les tâches ponctuelles planifiées pour le haut ou le bas de l'heure s'exécutent jusqu'à 90 secondes plus tôt.

173 175

174Le décalage est dérivé de l'ID de la tâche, donc la même tâche obtient toujours le même décalage. Si le timing exact est important, choisissez une minute qui n'est pas `:00` ou `:30`, par exemple `3 9 * * *` au lieu de `0 9 * * *`, et la gigue ponctuelle ne s'appliquera pas.176Le décalage est dérivé de l'ID de la tâche, donc la même tâche obtient toujours le même décalage. Si le timing exact est important, choisissez une minute qui n'est pas `:00` ou `:30`, par exemple `3 9 * * *` au lieu de `0 9 * * *`, et la gigue ponctuelle ne s'appliquera pas.

settings.md +1 −0

Details

183| `companyAnnouncements` | Annonce à afficher aux utilisateurs au démarrage. Si plusieurs annonces sont fournies, elles seront affichées aléatoirement. | `["Welcome to Acme Corp! Review our code guidelines at docs.acme.com"]` |183| `companyAnnouncements` | Annonce à afficher aux utilisateurs au démarrage. Si plusieurs annonces sont fournies, elles seront affichées aléatoirement. | `["Welcome to Acme Corp! Review our code guidelines at docs.acme.com"]` |

184| `defaultShell` | Shell par défaut pour les commandes `!` de la boîte d'entrée. Accepte `"bash"` (par défaut) ou `"powershell"`. Définir à `"powershell"` achemine les commandes `!` interactives via PowerShell sur Windows. Nécessite `CLAUDE_CODE_USE_POWERSHELL_TOOL=1`. Voir [Outil PowerShell](/fr/tools-reference#powershell-tool) | `"powershell"` |184| `defaultShell` | Shell par défaut pour les commandes `!` de la boîte d'entrée. Accepte `"bash"` (par défaut) ou `"powershell"`. Définir à `"powershell"` achemine les commandes `!` interactives via PowerShell sur Windows. Nécessite `CLAUDE_CODE_USE_POWERSHELL_TOOL=1`. Voir [Outil PowerShell](/fr/tools-reference#powershell-tool) | `"powershell"` |

185| `deniedMcpServers` | Quand défini dans managed-settings.json, liste noire des MCP servers qui sont explicitement bloqués. S'applique à toutes les portées y compris les servers gérés. La liste noire a la priorité sur la liste blanche. Voir [Configuration MCP gérée](/fr/mcp#managed-mcp-configuration) | `[{ "serverName": "filesystem" }]` |185| `deniedMcpServers` | Quand défini dans managed-settings.json, liste noire des MCP servers qui sont explicitement bloqués. S'applique à toutes les portées y compris les servers gérés. La liste noire a la priorité sur la liste blanche. Voir [Configuration MCP gérée](/fr/mcp#managed-mcp-configuration) | `[{ "serverName": "filesystem" }]` |

186| `disableAgentView` | Définir à `true` pour désactiver les [agents de fond et la vue d'agent](/fr/agent-view) : `claude agents`, `--bg`, `/background`, et le superviseur à la demande. Généralement défini dans les [paramètres gérés](/fr/permissions#managed-settings). Équivalent à définir `CLAUDE_CODE_DISABLE_AGENT_VIEW` à `1` | `true` |

187| `disableAutoMode` | Définir à `"disable"` pour empêcher l'activation du [mode auto](/fr/permission-modes#eliminate-prompts-with-auto-mode). Supprime `auto` du cycle `Shift+Tab` et rejette `--permission-mode auto` au démarrage. Très utile dans les [paramètres gérés](/fr/permissions#managed-settings) où les utilisateurs ne peuvent pas le contourner | `"disable"` |188| `disableAutoMode` | Définir à `"disable"` pour empêcher l'activation du [mode auto](/fr/permission-modes#eliminate-prompts-with-auto-mode). Supprime `auto` du cycle `Shift+Tab` et rejette `--permission-mode auto` au démarrage. Très utile dans les [paramètres gérés](/fr/permissions#managed-settings) où les utilisateurs ne peuvent pas le contourner | `"disable"` |

188| `disableDeepLinkRegistration` | Définir à `"disable"` pour empêcher Claude Code d'enregistrer le gestionnaire de protocole `claude-cli://` auprès du système d'exploitation au démarrage. Les [liens profonds](/fr/deep-links) permettent aux outils externes d'ouvrir une session Claude Code avec une invite pré-remplie. Utile dans les environnements où l'enregistrement du gestionnaire de protocole est restreint ou géré séparément | `"disable"` |189| `disableDeepLinkRegistration` | Définir à `"disable"` pour empêcher Claude Code d'enregistrer le gestionnaire de protocole `claude-cli://` auprès du système d'exploitation au démarrage. Les [liens profonds](/fr/deep-links) permettent aux outils externes d'ouvrir une session Claude Code avec une invite pré-remplie. Utile dans les environnements où l'enregistrement du gestionnaire de protocole est restreint ou géré séparément | `"disable"` |

sub-agents.md +8 −8

Details

11Chaque sous-agent s'exécute dans sa propre fenêtre de contexte avec une invite système personnalisée, un accès à des outils spécifiques et des permissions indépendantes. Lorsque Claude rencontre une tâche qui correspond à la description d'un sous-agent, il délègue à ce sous-agent, qui fonctionne indépendamment et retourne les résultats. Pour voir les économies de contexte en pratique, la [visualisation de la fenêtre de contexte](/fr/context-window) vous guide à travers une session où un sous-agent gère la recherche dans sa propre fenêtre séparée.11Chaque sous-agent s'exécute dans sa propre fenêtre de contexte avec une invite système personnalisée, un accès à des outils spécifiques et des permissions indépendantes. Lorsque Claude rencontre une tâche qui correspond à la description d'un sous-agent, il délègue à ce sous-agent, qui fonctionne indépendamment et retourne les résultats. Pour voir les économies de contexte en pratique, la [visualisation de la fenêtre de contexte](/fr/context-window) vous guide à travers une session où un sous-agent gère la recherche dans sa propre fenêtre séparée.

12 12

13<Note>13<Note>

14 Si vous avez besoin de plusieurs agents travaillant en parallèle et communiquant entre eux, consultez plutôt [les équipes d'agents](/fr/agent-teams). Les sous-agents fonctionnent au sein d'une seule session ; les équipes d'agents coordonnent les sessions séparées.14 Les sous-agents fonctionnent au sein d'une seule session. Pour exécuter de nombreuses sessions indépendantes en parallèle et les surveiller depuis un seul endroit, consultez [les agents en arrière-plan](/fr/agent-view). Pour les sessions qui communiquent entre elles, consultez [les équipes d'agents](/fr/agent-teams).

15</Note>15</Note>

16 16

17Les sous-agents vous aident à :17Les sous-agents vous aident à :

158 158

159C'est la méthode recommandée pour créer et gérer les sous-agents. Pour la création manuelle ou l'automatisation, vous pouvez également ajouter des fichiers de sous-agent directement.159C'est la méthode recommandée pour créer et gérer les sous-agents. Pour la création manuelle ou l'automatisation, vous pouvez également ajouter des fichiers de sous-agent directement.

160 160

161Pour lister tous les sous-agents configurés à partir de la ligne de commande sans démarrer une session interactive, exécutez `claude agents`. Cela affiche les agents groupés par source et indique lesquels sont remplacés par des définitions de priorité plus élevée.161Pour lister tous les sous-agents configurés à partir de la ligne de commande sans ouvrir la [vue agent](/fr/agent-view), redirigez la sortie de `claude agents`. Par exemple, `claude agents | cat` affiche les agents groupés par source et indique lesquels sont remplacés par des définitions de priorité plus élevée.

162 162

163### Choisir la portée du sous-agent163### Choisir la portée du sous-agent

164 164

260 260

262| :---------------- | :---------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |262| :---------------- | :---------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

263| `name` | Oui | Identifiant unique utilisant des lettres minuscules et des tirets |263| `name` | Oui | Identifiant unique utilisant des lettres minuscules et des tirets. Les [Hooks](/fr/hooks#subagentstart) reçoivent cette valeur comme `agent_type`. Le nom du fichier n'a pas besoin de correspondre |

264| `description` | Oui | Quand Claude doit déléguer à ce sous-agent |264| `description` | Oui | Quand Claude doit déléguer à ce sous-agent |

265| `tools` | Non | [Outils](#available-tools) que le sous-agent peut utiliser. Hérite de tous les outils s'il est omis. Pour précharger les Skills dans le contexte, utilisez le champ `skills` plutôt que de lister `Skill` ici |265| `tools` | Non | [Outils](#available-tools) que le sous-agent peut utiliser. Hérite de tous les outils s'il est omis. Pour précharger les Skills dans le contexte, utilisez le champ `skills` plutôt que de lister `Skill` ici |

266| `disallowedTools` | Non | Outils à refuser, supprimés de la liste héritée ou spécifiée |266| `disallowedTools` | Non | Outils à refuser, supprimés de la liste héritée ou spécifiée |

666 666

667Les sous-agents peuvent s'exécuter au premier plan (bloquant) ou en arrière-plan (concurrent) :667Les sous-agents peuvent s'exécuter au premier plan (bloquant) ou en arrière-plan (concurrent) :

668 668

669* **Les sous-agents au premier plan** bloquent la conversation principale jusqu'à la fin. Les invites de permission et les questions de clarification (comme [`AskUserQuestion`](/fr/tools-reference)) vous sont transmises.669* **Les sous-agents au premier plan** bloquent la conversation principale jusqu'à la fin. Les invites de permission vous sont transmises au fur et à mesure qu'elles se produisent.

670* **Les sous-agents en arrière-plan** s'exécutent simultanément pendant que vous continuez à travailler. Avant le lancement, Claude Code vous demande les permissions d'outils dont le sous-agent aura besoin, en s'assurant qu'il a les approbations nécessaires à l'avance. Une fois en cours d'exécution, le sous-agent hérite de ces permissions et auto-refuse tout ce qui n'est pas pré-approuvé. Si un sous-agent en arrière-plan doit poser des questions de clarification, cet appel d'outil échoue mais le sous-agent continue.670* **Les sous-agents en arrière-plan** s'exécutent simultanément pendant que vous continuez à travailler. Ils s'exécutent avec les permissions déjà accordées dans la session et auto-refusent tout appel d'outil qui sinon demanderait une permission. Si un sous-agent en arrière-plan doit poser des questions de clarification, cet appel d'outil échoue mais le sous-agent continue.

671 671

672Si un sous-agent en arrière-plan échoue en raison de permissions manquantes, vous pouvez démarrer un nouveau sous-agent au premier plan avec la même tâche pour réessayer avec des invites interactives.672Si un sous-agent en arrière-plan échoue en raison de permissions manquantes, vous pouvez démarrer un nouveau sous-agent au premier plan avec la même tâche pour réessayer avec des invites interactives.

673 673

678 678

679Pour désactiver toute la fonctionnalité de tâche en arrière-plan, définissez la variable d'environnement `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` sur `1`. Consultez [Variables d'environnement](/fr/env-vars).679Pour désactiver toute la fonctionnalité de tâche en arrière-plan, définissez la variable d'environnement `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` sur `1`. Consultez [Variables d'environnement](/fr/env-vars).

680 680

681Lorsque le [mode fork](#fork-the-current-conversation) est activé, chaque génération de sous-agent s'exécute en arrière-plan indépendamment du champ `background`. Les forks affichent toujours les invites de permission dans votre terminal au fur et à mesure qu'elles se produisent au lieu de pré-approuver ; les sous-agents nommés suivent le flux de pré-approbation ci-dessus.681Lorsque le [mode fork](#fork-the-current-conversation) est activé, chaque génération de sous-agent s'exécute en arrière-plan indépendamment du champ `background`. Les forks affichent toujours les invites de permission dans votre terminal au fur et à mesure qu'elles se produisent ; les sous-agents nommés auto-refusent tout ce qui sinon demanderait une permission, comme décrit ci-dessus.

682 682

683### Modèles courants683### Modèles courants

684 684

824Un fork hérite de tout ce que la session principale a au moment où il se génère. Un sous-agent nommé démarre à partir de sa propre définition.824Un fork hérite de tout ce que la session principale a au moment où il se génère. Un sous-agent nommé démarre à partir de sa propre définition.

825 825

826| | Fork | Sous-agent nommé |826| | Fork | Sous-agent nommé |

827| :----------------------- | :------------------------------------------ | :-------------------------------------------------------------------------------------------------- |827| :----------------------- | :------------------------------------------ | :---------------------------------------------------------------------------------------------- |

833 833

834Parce que l'invite système d'un fork et les définitions d'outils sont identiques au parent, sa première demande réutilise le cache d'invite du parent. Cela rend le forking moins cher que la génération d'un sous-agent frais pour les tâches qui ont besoin du même contexte.834Parce que l'invite système d'un fork et les définitions d'outils sont identiques au parent, sa première demande réutilise le cache d'invite du parent. Cela rend le forking moins cher que la génération d'un sous-agent frais pour les tâches qui ont besoin du même contexte.

third-party-integrations.md +12 −2

Details

99 <th>Claude for Teams/Enterprise</th>99 <th>Claude for Teams/Enterprise</th>

100 <th>Anthropic Console</th>100 <th>Anthropic Console</th>

101 <th>Amazon Bedrock</th>101 <th>Amazon Bedrock</th>

102 <th>Claude Platform on AWS</th>

102 <th>Google Vertex AI</th>103 <th>Google Vertex AI</th>

103 <th>Microsoft Foundry</th>104 <th>Microsoft Foundry</th>

104 </tr>105 </tr>

110 <td>La plupart des organisations (recommandé)</td>111 <td>La plupart des organisations (recommandé)</td>

111 <td>Développeurs individuels</td>112 <td>Développeurs individuels</td>

112 <td>Déploiements natifs AWS</td>113 <td>Déploiements natifs AWS</td>

114 <td>Facturation AWS Marketplace avec les fonctionnalités de l'API Claude</td>

113 <td>Déploiements natifs GCP</td>115 <td>Déploiements natifs GCP</td>

114 <td>Déploiements natifs Azure</td>116 <td>Déploiements natifs Azure</td>

115 </tr>117 </tr>

119 <td><strong>Teams :</strong> 150 \$/siège (Premium) avec PAYG disponible<br /><strong>Enterprise :</strong> <a href="https://claude.com/contact-sales?utm_source=claude_code&utm_medium=docs&utm_content=third_party_enterprise">Contacter les ventes</a></td>121 <td><strong>Teams :</strong> 150 \$/siège (Premium) avec PAYG disponible<br /><strong>Enterprise :</strong> <a href="https://claude.com/contact-sales?utm_source=claude_code&utm_medium=docs&utm_content=third_party_enterprise">Contacter les ventes</a></td>

120 <td>PAYG</td>122 <td>PAYG</td>

121 <td>PAYG via AWS</td>123 <td>PAYG via AWS</td>

124 <td>PAYG via AWS Marketplace</td>

122 <td>PAYG via GCP</td>125 <td>PAYG via GCP</td>

123 <td>PAYG via Azure</td>126 <td>PAYG via Azure</td>

124 </tr>127 </tr>

128 <td>[Pays](https://www.anthropic.com/supported-countries) supportés</td>131 <td>[Pays](https://www.anthropic.com/supported-countries) supportés</td>

129 <td>[Pays](https://www.anthropic.com/supported-countries) supportés</td>132 <td>[Pays](https://www.anthropic.com/supported-countries) supportés</td>

130 <td>Plusieurs [régions](https://docs.aws.amazon.com/bedrock/latest/userguide/models-regions.html) AWS</td>133 <td>Plusieurs [régions](https://docs.aws.amazon.com/bedrock/latest/userguide/models-regions.html) AWS</td>

134 <td>Plusieurs régions AWS</td>

131 <td>Plusieurs [régions](https://cloud.google.com/vertex-ai/generative-ai/docs/learn/locations) GCP</td>135 <td>Plusieurs [régions](https://cloud.google.com/vertex-ai/generative-ai/docs/learn/locations) GCP</td>

132 <td>Plusieurs [régions](https://azure.microsoft.com/en-us/explore/global-infrastructure/products-by-region/) Azure</td>136 <td>Plusieurs [régions](https://azure.microsoft.com/en-us/explore/global-infrastructure/products-by-region/) Azure</td>

133 </tr>137 </tr>

139 <td>Activé par défaut</td>143 <td>Activé par défaut</td>

140 <td>Activé par défaut</td>144 <td>Activé par défaut</td>

141 <td>Activé par défaut</td>145 <td>Activé par défaut</td>

146 <td>Activé par défaut</td>

142 </tr>147 </tr>

143 148

144 <tr>149 <tr>

146 <td>Claude.ai SSO ou email</td>151 <td>Claude.ai SSO ou email</td>

147 <td>Clé API</td>152 <td>Clé API</td>

148 <td>Clé API ou identifiants AWS</td>153 <td>Clé API ou identifiants AWS</td>

154 <td>Clé API ou identifiants AWS</td>

149 <td>Identifiants GCP</td>155 <td>Identifiants GCP</td>

150 <td>Clé API ou Microsoft Entra ID</td>156 <td>Clé API ou Microsoft Entra ID</td>

151 </tr>157 </tr>

155 <td>Tableau de bord d'utilisation</td>161 <td>Tableau de bord d'utilisation</td>

156 <td>Tableau de bord d'utilisation</td>162 <td>Tableau de bord d'utilisation</td>

157 <td>AWS Cost Explorer</td>163 <td>AWS Cost Explorer</td>

164 <td>AWS Cost Explorer</td>

158 <td>Facturation GCP</td>165 <td>Facturation GCP</td>

159 <td>Gestion des coûts Azure</td>166 <td>Gestion des coûts Azure</td>

160 </tr>167 </tr>

166 <td>Non</td>173 <td>Non</td>

167 <td>Non</td>174 <td>Non</td>

168 <td>Non</td>175 <td>Non</td>

176 <td>Non</td>

169 </tr>177 </tr>

170 178

171 <tr>179 <tr>

173 <td>Gestion d'équipe, SSO, surveillance de l'utilisation</td>181 <td>Gestion d'équipe, SSO, surveillance de l'utilisation</td>

174 <td>Aucune</td>182 <td>Aucune</td>

175 <td>Politiques IAM, CloudTrail</td>183 <td>Politiques IAM, CloudTrail</td>

184 <td>Politiques IAM, CloudTrail</td>

176 <td>Rôles IAM, journaux d'audit cloud</td>185 <td>Rôles IAM, journaux d'audit cloud</td>

177 <td>Politiques RBAC, Azure Monitor</td>186 <td>Politiques RBAC, Azure Monitor</td>

178 </tr>187 </tr>

184* [Claude for Teams ou Enterprise](/fr/authentication#claude-for-teams-or-enterprise)193* [Claude for Teams ou Enterprise](/fr/authentication#claude-for-teams-or-enterprise)

185* [Anthropic Console](/fr/authentication#claude-console-authentication)194* [Anthropic Console](/fr/authentication#claude-console-authentication)

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

196* [Claude Platform on AWS](/fr/claude-platform-on-aws)

187* [Google Vertex AI](/fr/google-vertex-ai)197* [Google Vertex AI](/fr/google-vertex-ai)

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

189 199

192La plupart des organisations peuvent utiliser un fournisseur de cloud directement sans configuration supplémentaire. Cependant, vous devrez peut-être configurer un proxy d'entreprise ou une passerelle LLM si votre organisation a des exigences réseau ou de gestion spécifiques. Il s'agit de configurations différentes qui peuvent être utilisées ensemble :202La plupart des organisations peuvent utiliser un fournisseur de cloud directement sans configuration supplémentaire. Cependant, vous devrez peut-être configurer un proxy d'entreprise ou une passerelle LLM si votre organisation a des exigences réseau ou de gestion spécifiques. Il s'agit de configurations différentes qui peuvent être utilisées ensemble :

193 203

194* **Proxy d'entreprise** : Achemine le trafic via un proxy HTTP/HTTPS. Utilisez ceci si votre organisation exige que tout le trafic sortant passe par un serveur proxy pour la surveillance de la sécurité, la conformité ou l'application des politiques réseau. Configurez avec les variables d'environnement `HTTPS_PROXY` ou `HTTP_PROXY`. En savoir plus dans [Configuration du réseau d'entreprise](/fr/network-config).204* **Proxy d'entreprise** : Achemine le trafic via un proxy HTTP/HTTPS. Utilisez ceci si votre organisation exige que tout le trafic sortant passe par un serveur proxy pour la surveillance de la sécurité, la conformité ou l'application des politiques réseau. Configurez avec les variables d'environnement `HTTPS_PROXY` ou `HTTP_PROXY`. En savoir plus dans [Configuration du réseau d'entreprise](/fr/network-config).

195* **Passerelle LLM** : Un service qui se situe entre Claude Code et le fournisseur de cloud pour gérer l'authentification et le routage. Utilisez ceci si vous avez besoin d'un suivi centralisé de l'utilisation entre les équipes, d'une limitation de débit personnalisée ou de budgets, ou d'une gestion centralisée de l'authentification. Configurez avec les variables d'environnement `ANTHROPIC_BASE_URL`, `ANTHROPIC_BEDROCK_BASE_URL` ou `ANTHROPIC_VERTEX_BASE_URL`. En savoir plus dans [Configuration de la passerelle LLM](/fr/llm-gateway).205* **Passerelle LLM** : Un service qui se situe entre Claude Code et le fournisseur de cloud pour gérer l'authentification et le routage. Utilisez ceci si vous avez besoin d'un suivi centralisé de l'utilisation entre les équipes, d'une limitation de débit personnalisée ou de budgets, ou d'une gestion centralisée de l'authentification. Configurez avec les variables d'environnement `ANTHROPIC_BASE_URL`, `ANTHROPIC_BEDROCK_BASE_URL`, `ANTHROPIC_AWS_BASE_URL`, ou `ANTHROPIC_VERTEX_BASE_URL`. En savoir plus dans [Configuration de la passerelle LLM](/fr/llm-gateway).

196 206

197Les exemples suivants montrent les variables d'environnement à définir dans votre shell ou profil shell (`.bashrc`, `.zshrc`). Voir [Paramètres](/fr/settings) pour d'autres méthodes de configuration.207Les exemples suivants montrent les variables d'environnement à définir dans votre shell ou profil shell (`.bashrc`, `.zshrc`). Voir [Paramètres](/fr/settings) pour d'autres méthodes de configuration.

198 208

313 323

314### Épingler les versions de modèle pour les fournisseurs de cloud324### Épingler les versions de modèle pour les fournisseurs de cloud

315 325

316Si vous déployez via [Bedrock](/fr/amazon-bedrock), [Vertex AI](/fr/google-vertex-ai) ou [Foundry](/fr/microsoft-foundry), épinglez les versions de modèle spécifiques en utilisant `ANTHROPIC_DEFAULT_OPUS_MODEL`, `ANTHROPIC_DEFAULT_SONNET_MODEL` et `ANTHROPIC_DEFAULT_HAIKU_MODEL`. Sans épinglage, les alias de modèle se résolvent à la dernière version, ce qui peut ne pas encore être activé dans votre compte lorsqu'Anthropic publie une mise à jour. L'épinglage vous permet de contrôler quand vos utilisateurs passent à un nouveau modèle. Voir [Configuration du modèle](/fr/model-config#pin-models-for-third-party-deployments) pour ce que chaque fournisseur fait lorsque la dernière version n'est pas disponible.326Si vous déployez via [Bedrock](/fr/amazon-bedrock), [Vertex AI](/fr/google-vertex-ai), [Foundry](/fr/microsoft-foundry) ou [Claude Platform on AWS](/fr/claude-platform-on-aws), épinglez les versions de modèle spécifiques en utilisant `ANTHROPIC_DEFAULT_OPUS_MODEL`, `ANTHROPIC_DEFAULT_SONNET_MODEL` et `ANTHROPIC_DEFAULT_HAIKU_MODEL`. Sans épinglage, les alias de modèle se résolvent à la dernière version, ce qui peut ne pas encore être activé dans votre compte lorsqu'Anthropic publie une mise à jour. L'épinglage vous permet de contrôler quand vos utilisateurs passent à un nouveau modèle. Voir [Configuration du modèle](/fr/model-config#pin-models-for-third-party-deployments) pour ce que chaque fournisseur fait lorsque la dernière version n'est pas disponible.

317 327

318### Configurer les politiques de sécurité328### Configurer les politiques de sécurité

319 329

tools-reference.md +180 −13

Details

4 4

5# Référence des outils5# Référence des outils

6 6

~~7> Référence complète des outils que Claude Code peut utiliser, y compris les exigences de permission.~~7> Référence complète des outils que Claude Code peut utiliser, y compris les exigences de permission et le comportement par outil.

8 8

9Claude Code a accès à un ensemble d'outils intégrés qui l'aident à comprendre et modifier votre base de code. Les noms d'outils sont les chaînes exactes que vous utilisez dans les [règles de permission spécifiques aux outils](/fr/permissions#tool-specific-permission-rules), les [listes d'outils subagent](/fr/sub-agents), et les [correspondances de hook](/fr/hooks). Pour désactiver complètement un outil, ajoutez son nom au tableau `deny` dans vos [paramètres de permission](/fr/permissions#tool-specific-permission-rules).9Claude Code a accès à un ensemble d'outils intégrés qui l'aident à comprendre et modifier votre base de code. Les noms d'outils sont les chaînes exactes que vous utilisez dans les [règles de permission spécifiques aux outils](/fr/permissions#tool-specific-permission-rules), les [listes d'outils subagent](/fr/sub-agents), et les [correspondances de hook](/fr/hooks). Pour désactiver complètement un outil, ajoutez son nom au tableau `deny` dans vos [paramètres de permission](/fr/permissions#tool-specific-permission-rules).

10 10

11Pour ajouter des outils personnalisés, connectez un [serveur MCP](/fr/mcp). Pour étendre Claude avec des flux de travail réutilisables basés sur des invites, écrivez une [skill](/fr/skills), qui s'exécute via l'outil `Skill` existant plutôt que d'ajouter une nouvelle entrée d'outil.11Pour ajouter des outils personnalisés, connectez un [serveur MCP](/fr/mcp). Pour étendre Claude avec des flux de travail réutilisables basés sur des invites, écrivez une [skill](/fr/skills), qui s'exécute via l'outil `Skill` existant plutôt que d'ajouter une nouvelle entrée d'outil.

12 12

14| :--------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :----------------- |14| :--------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :----------------- |

15| `Agent` | Crée un [subagent](/fr/sub-agents) avec sa propre fenêtre de contexte pour gérer une tâche | Non |15| `Agent` | Crée un [subagent](/fr/sub-agents) avec sa propre fenêtre de contexte pour gérer une tâche. Voir [comportement de l'outil Agent](#agent-tool-behavior) | Non |

16| `AskUserQuestion` | Pose des questions à choix multiples pour recueillir les exigences ou clarifier l'ambiguïté | Non |16| `AskUserQuestion` | Pose des questions à choix multiples pour recueillir les exigences ou clarifier l'ambiguïté | Non |

17| `Bash` | Exécute des commandes shell dans votre environnement. Voir [comportement de l'outil Bash](#bash-tool-behavior) | Oui |17| `Bash` | Exécute des commandes shell dans votre environnement. Voir [comportement de l'outil Bash](#bash-tool-behavior) | Oui |

18| `CronCreate` | Planifie une invite récurrente ou ponctuelle dans la session actuelle. Les tâches sont limitées à la session et restaurées sur `--resume` ou `--continue` si non expirées. Voir [tâches planifiées](/fr/scheduled-tasks) | Non |18| `CronCreate` | Planifie une invite récurrente ou ponctuelle dans la session actuelle. Les tâches sont limitées à la session et restaurées sur `--resume` ou `--continue` si non expirées. Voir [tâches planifiées](/fr/scheduled-tasks) | Non |

19| `CronDelete` | Annule une tâche planifiée par ID | Non |19| `CronDelete` | Annule une tâche planifiée par ID | Non |

20| `CronList` | Liste toutes les tâches planifiées dans la session | Non |20| `CronList` | Liste toutes les tâches planifiées dans la session | Non |

21| `Edit` | Effectue des modifications ciblées sur des fichiers spécifiques | Oui |21| `Edit` | Effectue des modifications ciblées sur des fichiers spécifiques. Voir [comportement de l'outil Edit](#edit-tool-behavior) | Oui |

22| `EnterPlanMode` | Bascule en mode plan pour concevoir une approche avant de coder | Non |22| `EnterPlanMode` | Bascule en mode plan pour concevoir une approche avant de coder | Non |

23| `EnterWorktree` | Crée un [git worktree](/fr/common-workflows#run-parallel-claude-code-sessions-with-git-worktrees) isolé et y bascule. Passez un `path` pour basculer dans un worktree existant du référentiel actuel au lieu d'en créer un nouveau. Non disponible pour les subagents | Non |23| `EnterWorktree` | Crée un [git worktree](/fr/worktrees) isolé et y bascule. Passez un `path` pour basculer dans un worktree existant du référentiel actuel au lieu d'en créer un nouveau. Non disponible pour les subagents | Non |

24| `ExitPlanMode` | Présente un plan pour approbation et quitte le mode plan | Oui |24| `ExitPlanMode` | Présente un plan pour approbation et quitte le mode plan | Oui |

25| `ExitWorktree` | Quitte une session worktree et revient au répertoire d'origine. Non disponible pour les subagents | Non |25| `ExitWorktree` | Quitte une session worktree et revient au répertoire d'origine. Non disponible pour les subagents | Non |

26| `Glob` | Trouve des fichiers en fonction de la correspondance de motifs | Non |26| `Glob` | Trouve des fichiers en fonction de la correspondance de motifs. Voir [comportement de l'outil Glob](#glob-tool-behavior) | Non |

27| `Grep` | Recherche des motifs dans le contenu des fichiers | Non |27| `Grep` | Recherche des motifs dans le contenu des fichiers. Voir [comportement de l'outil Grep](#grep-tool-behavior) | Non |

28| `ListMcpResourcesTool` | Liste les ressources exposées par les [serveurs MCP](/fr/mcp) connectés | Non |28| `ListMcpResourcesTool` | Liste les ressources exposées par les [serveurs MCP](/fr/mcp) connectés | Non |

29| `LSP` | Intelligence du code via les serveurs de langage : accéder aux définitions, trouver les références, signaler les erreurs de type et les avertissements. Voir [comportement de l'outil LSP](#lsp-tool-behavior) | Non |29| `LSP` | Intelligence du code via les serveurs de langage : accéder aux définitions, trouver les références, signaler les erreurs de type et les avertissements. Voir [comportement de l'outil LSP](#lsp-tool-behavior) | Non |

30| `Monitor` | Exécute une commande en arrière-plan et renvoie chaque ligne de sortie à Claude, afin qu'il puisse réagir aux entrées de journal, aux modifications de fichiers, ou au statut interrogé en milieu de conversation. Voir [outil Monitor](#monitor-tool) | Oui |30| `Monitor` | Exécute une commande en arrière-plan et renvoie chaque ligne de sortie à Claude, afin qu'il puisse réagir aux entrées de journal, aux modifications de fichiers, ou au statut interrogé en milieu de conversation. Voir [outil Monitor](#monitor-tool) | Oui |

31| `NotebookEdit` | Modifie les cellules de notebook Jupyter | Oui |31| `NotebookEdit` | Modifie les cellules de notebook Jupyter. Voir [comportement de l'outil NotebookEdit](#notebookedit-tool-behavior) | Oui |

32| `PowerShell` | Exécute des commandes PowerShell nativement. Voir [outil PowerShell](#powershell-tool) pour la disponibilité | Oui |32| `PowerShell` | Exécute des commandes PowerShell nativement. Voir [outil PowerShell](#powershell-tool) pour la disponibilité | Oui |

33| `Read` | Lit le contenu des fichiers | Non |33| `PushNotification` | Envoie une notification de bureau, et une notification push sur téléphone quand [Remote Control](/fr/remote-control) est connecté, afin qu'une tâche de longue durée ou une [tâche planifiée](/fr/scheduled-tasks) puisse vous atteindre quand vous vous éloignez. {/* plan-availability: feature=push-notifications providers=anthropic */}La livraison push s'effectue via l'infrastructure hébergée par Anthropic, qui n'est pas accessible depuis Amazon Bedrock, Google Vertex AI, ou Microsoft Foundry | Non |

34| `Read` | Lit le contenu des fichiers. Voir [comportement de l'outil Read](#read-tool-behavior) | Non |

34| `ReadMcpResourceTool` | Lit une ressource MCP spécifique par URI | Non |35| `ReadMcpResourceTool` | Lit une ressource MCP spécifique par URI | Non |

36| `RemoteTrigger` | Crée, met à jour, exécute et liste les [Routines](/fr/routines) sur claude.ai. Soutient la commande `/schedule`. {/* plan-availability: feature=routines plans=pro,max,team,enterprise providers=anthropic */}Les Routines vivent sur claude.ai et nécessitent un plan Pro, Max, Team ou Enterprise, donc cet outil n'est pas accessible depuis Amazon Bedrock, Google Vertex AI, ou Microsoft Foundry | Non |

35| `SendMessage` | Envoie un message à un coéquipier de l'[équipe d'agents](/fr/agent-teams), ou [reprend un subagent](/fr/sub-agents#resume-subagents) par son ID d'agent. Les subagents arrêtés se reprennent automatiquement en arrière-plan. Disponible uniquement quand `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` est défini | Non |37| `SendMessage` | Envoie un message à un coéquipier de l'[équipe d'agents](/fr/agent-teams), ou [reprend un subagent](/fr/sub-agents#resume-subagents) par son ID d'agent. Les subagents arrêtés se reprennent automatiquement en arrière-plan. Disponible uniquement quand `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` est défini | Non |

38| `ShareOnboardingGuide` | {/* plan-availability: feature=onboarding-guide-share plans=pro,max,team,enterprise providers=anthropic */}Télécharge `ONBOARDING.md` et retourne un lien de partage que les coéquipiers peuvent ouvrir dans Claude Code. Appelé depuis `/team-onboarding` après que le guide soit écrit. Disponible pour les abonnés claude.ai sur les plans Pro, Max, Team et Enterprise | Oui |

36| `Skill` | Exécute une [skill](/fr/skills#control-who-invokes-a-skill) dans la conversation principale | Oui |39| `Skill` | Exécute une [skill](/fr/skills#control-who-invokes-a-skill) dans la conversation principale | Oui |

37| `TaskCreate` | Crée une nouvelle tâche dans la liste des tâches | Non |40| `TaskCreate` | Crée une nouvelle tâche dans la liste des tâches | Non |

38| `TaskGet` | Récupère les détails complets d'une tâche spécifique | Non |41| `TaskGet` | Récupère les détails complets d'une tâche spécifique | Non |

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

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

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

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

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

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

50 53

51Les règles de permission peuvent être configurées en utilisant `/permissions` ou dans les [paramètres de permission](/fr/settings#available-settings). Voir aussi [Règles de permission spécifiques aux outils](/fr/permissions#tool-specific-permission-rules).54## Configurer les outils avec les règles de permission et les hooks

56Pour la plupart, Claude décide quand utiliser ces outils et vous n'avez pas besoin de les nommer vous-même lors de l'interaction avec Claude. Vous référencez les noms d'outils directement lors de la définition des permissions et d'autres configurations :

58* dans [`permissions.allow` et `permissions.deny`](/fr/settings#available-settings) dans les paramètres, et l'interface `/permissions`

59* dans les drapeaux CLI [`--allowedTools` et `--disallowedTools`](/fr/cli-reference)

60* dans les options [`allowedTools` et `disallowedTools`](/fr/agent-sdk/permissions#allow-and-deny-rules) du SDK Agent

61* dans le frontmatter [`tools` ou `disallowedTools`](/fr/sub-agents#supported-frontmatter-fields) d'un subagent

62* dans le frontmatter [`allowed-tools`](/fr/skills#frontmatter-reference) d'une skill

63* dans la condition [`if`](/fr/hooks-guide#filter-by-tool-name-and-arguments-with-the-if-field) d'un hook

65Tous ces éléments acceptent le même format de règle, `ToolName(specifier)`. Le spécificateur dépend de l'outil, et plusieurs outils partagent un format :

67| Format de règle | S'applique à | Détails |

68| :----------------------------- | :------------------------ | :-------------------------------------------------------------------------- |

69| `Bash(npm run *)` | Bash, Monitor | [Correspondance de motif de commande](/fr/permissions#bash) |

70| `PowerShell(Get-ChildItem *)` | PowerShell | [Correspondance de motif de commande](/fr/permissions#powershell) |

71| `Read(~/secrets/**)` | Read, Grep, Glob, LSP | [Correspondance de motif de chemin](/fr/permissions#read-and-edit) |

72| `Edit(/src/**)` | Edit, Write, NotebookEdit | [Correspondance de motif de chemin](/fr/permissions#read-and-edit) |

73| `Skill(deploy *)` | Skill | [Correspondance de nom de skill](/fr/skills#restrict-claude's-skill-access) |

74| `Agent(Explore)` | Agent | [Correspondance de type de subagent](/fr/permissions#agent-subagents) |

75| `WebFetch(domain:example.com)` | WebFetch | [Correspondance de domaine](/fr/permissions#webfetch) |

76| `WebSearch` | WebSearch | Pas de spécificateur ; autoriser ou refuser l'outil dans son ensemble |

78Les outils non listés ici, tels que `ExitPlanMode` ou `ShareOnboardingGuide`, acceptent uniquement le nom d'outil nu sans spécificateur.

80Une règle d'autorisation `Edit(...)` accorde également l'accès en lecture au même chemin, donc vous n'avez pas besoin d'une règle `Read(...)` correspondante.

82Les champs `matcher` des hooks utilisent les noms d'outils nus, pas le format entre parenthèses. Voir [motifs de correspondance](/fr/hooks#matcher-patterns) pour les règles de correspondance. Pour les noms de champs que chaque outil transmet à `tool_input` dans les hooks, voir la [référence d'entrée PreToolUse](/fr/hooks#pretooluse-input).

84## Comportement de l'outil Agent

86L'outil Agent crée un subagent dans une fenêtre de contexte séparée. Le subagent travaille sur sa tâche de manière autonome, puis retourne un seul résultat textuel à la conversation parent. Le parent ne voit pas les appels d'outils intermédiaires ou les sorties du subagent, seulement ce résultat final. Pour limiter le nombre de tours qu'un subagent exécute, définissez `maxTurns` dans la [définition du subagent](/fr/sub-agents#supported-frontmatter-fields).

88Le même outil Agent lance également les [subagents forked](/fr/sub-agents#fork-the-current-conversation) quand le mode fork est activé. Un fork hérite de la conversation parent complète au lieu de commencer à zéro, s'exécute toujours en arrière-plan, et affiche toujours les invites de permission dans votre terminal. Le reste de cette section décrit les subagents nommés.

90Les outils qu'un subagent nommé peut utiliser dépendent des champs `tools` et `disallowedTools` dans la [définition du subagent](/fr/sub-agents):

92* **Aucun champ défini** : le subagent hérite de chaque outil disponible pour le parent.

93* **`tools` uniquement** : le subagent obtient uniquement les outils listés.

94* **`disallowedTools` uniquement** : le subagent obtient chaque outil parent sauf ceux listés.

95* **Les deux définis** : `disallowedTools` a la priorité. Un outil listé dans les deux est supprimé.

97Lancer le subagent ne demande pas lui-même la permission. Les appels d'outils du subagent sont vérifiés par rapport à vos règles de permission au fur et à mesure qu'il s'exécute :

99* **Les subagents au premier plan** affichent les mêmes invites de permission que vous verriez dans la conversation principale, au moment où chaque appel d'outil se produit.

100* **Les subagents en arrière-plan** n'affichent pas d'invites. Ils s'exécutent avec les permissions déjà accordées dans la session et refusent automatiquement tout appel d'outil qui demanderait autrement une permission. Après un refus, le subagent continue sans cet outil.

101

102Pour limiter ce qu'un subagent peut atteindre en premier lieu, réduisez son champ `tools`, laissez Bash en dehors de la liste, ou définissez des règles de refus dans vos paramètres, comme décrit dans [Contrôler les capacités du subagent](/fr/sub-agents#control-subagent-capabilities). Pour plus d'informations sur le choix entre le premier plan et l'arrière-plan, voir [Exécuter les subagents au premier plan ou en arrière-plan](/fr/sub-agents#run-subagents-in-foreground-or-background).

52 103

53## Comportement de l'outil Bash104## Comportement de l'outil Bash

54 105

61 112

62Activez votre environnement virtualenv ou conda avant de lancer Claude Code. Pour que les variables d'environnement persistent entre les commandes Bash, définissez [`CLAUDE_ENV_FILE`](/fr/env-vars) sur un script shell avant de lancer Claude Code, ou utilisez un [hook SessionStart](/fr/hooks#persist-environment-variables) pour le remplir dynamiquement.113Activez votre environnement virtualenv ou conda avant de lancer Claude Code. Pour que les variables d'environnement persistent entre les commandes Bash, définissez [`CLAUDE_ENV_FILE`](/fr/env-vars) sur un script shell avant de lancer Claude Code, ou utilisez un [hook SessionStart](/fr/hooks#persist-environment-variables) pour le remplir dynamiquement.

63 114

115Deux limites limitent chaque commande :

116

117* **Délai d'expiration** : deux minutes par défaut. Claude peut demander jusqu'à 10 minutes par commande avec le paramètre `timeout`. Remplacez la valeur par défaut et le plafond avec [`BASH_DEFAULT_TIMEOUT_MS` et `BASH_MAX_TIMEOUT_MS`](/fr/env-vars).

118* **Longueur de sortie** : 30 000 caractères par défaut. Quand une commande produit plus que cela, Claude Code enregistre la sortie complète dans un fichier du répertoire de session et donne à Claude le chemin du fichier plus un court aperçu du début. Claude lit ou recherche ce fichier quand il a besoin du reste. Augmentez la limite avec [`BASH_MAX_OUTPUT_LENGTH`](/fr/env-vars), jusqu'à un plafond dur de 150 000 caractères.

119

120Pour les processus de longue durée tels que les serveurs de développement ou les builds de surveillance, Claude peut définir `run_in_background: true` pour démarrer la commande en tant que tâche en arrière-plan et continuer à travailler pendant qu'elle s'exécute. Listez et arrêtez les tâches en arrière-plan avec `/tasks`.

121

122## Comportement de l'outil Edit

123

124L'outil Edit effectue un remplacement de chaîne exact. Il prend un `old_string` et un `new_string` et remplace le premier par le second. Il n'utilise pas regex ou la correspondance floue.

125

126Trois vérifications doivent réussir pour qu'une modification s'applique :

127

128* **Lecture avant modification** : Claude doit avoir lu le fichier dans la conversation actuelle, et le fichier ne doit pas avoir changé sur le disque depuis cette lecture. Cette vérification s'exécute en premier, avant toute correspondance de chaîne.

129* **Correspondance** : `old_string` doit apparaître dans le fichier exactement comme écrit. Une seule différence de caractère d'espace ou d'indentation est suffisante pour manquer.

130* **Unicité** : `old_string` doit apparaître exactement une fois. Quand il apparaît plus d'une fois, Claude fournit soit une chaîne plus longue avec suffisamment de contexte environnant pour épingler une occurrence, soit définit `replace_all: true` pour les remplacer tous.

131

132Afficher un fichier avec Bash satisfait également l'exigence de lecture avant modification quand la commande est `cat path/to/file` ou `sed -n 'X,Yp' path/to/file` sur un seul fichier sans pipes ou redirections. D'autres commandes Bash telles que `head`, `tail`, ou la sortie piped ne comptent pas, et Claude doit utiliser Read avant de modifier dans ces cas.

133

134Cela affecte uniquement l'éligibilité à la modification, pas les permissions. Les [règles de refus Read et Edit](/fr/permissions#tool-specific-permission-rules) s'appliquent également aux commandes de fichiers que Claude Code reconnaît dans Bash, telles que `cat`, `head`, `tail`, et `sed`, mais pas aux sous-processus arbitraires qui lisent ou écrivent des fichiers indirectement, comme un script Python ou Node qui ouvre des fichiers lui-même. Pour l'application au niveau du système d'exploitation qui couvre chaque processus, [activez le sandbox](/fr/sandboxing).

135

136## Comportement de l'outil Glob

137

138L'outil Glob trouve des fichiers par motif de nom. Il supporte la syntaxe glob standard incluant `**` pour la correspondance de répertoire récursive :

139

140* `**/*.js` correspond à tous les fichiers `.js` à n'importe quelle profondeur

141* `src/**/*.ts` correspond à tous les fichiers `.ts` sous `src/`

142* `*.{json,yaml}` correspond aux fichiers `.json` et `.yaml` dans le répertoire actuel

143

144Les résultats sont triés par heure de modification et limités à 100 fichiers. Si la limite est atteinte, Claude voit un drapeau de troncature dans le résultat et peut affiner le motif.

145

146Glob ne respecte pas `.gitignore` par défaut, donc il trouve les fichiers gitignorés aux côtés des fichiers suivis. Cela diffère de [Grep](#grep-tool-behavior), qui ignore les fichiers gitignorés. Pour faire respecter `.gitignore` à Glob, définissez `CLAUDE_CODE_GLOB_NO_IGNORE=false` avant de lancer Claude Code.

147

148## Comportement de l'outil Grep

149

150L'outil Grep recherche des motifs dans le contenu des fichiers. Où [Glob](#glob-tool-behavior) trouve des fichiers par nom, Grep trouve des lignes à l'intérieur d'eux.

151

152Grep est construit sur [ripgrep](https://github.com/BurntSushi/ripgrep) et utilise la syntaxe regex de ripgrep, pas grep POSIX. Les motifs qui incluent des métacaractères regex ont besoin d'échappement. Par exemple, trouver `interface{}` dans le code Go prend le motif `interface\{\}`.

153

154Trois modes de sortie contrôlent ce qui revient :

155

156* `files_with_matches` : chemins de fichiers uniquement, pas de contenu de ligne. C'est la valeur par défaut.

157* `content` : lignes correspondantes avec numéro de fichier et de ligne.

158* `count` : nombre de correspondances par fichier.

159

160Claude peut limiter les résultats par fichier avec le paramètre `glob`, tel que `**/*.tsx`, ou par langage avec le paramètre `type`, tel que `py` ou `rust`. Par défaut, les motifs correspondent dans une seule ligne. Claude peut définir `multiline: true` pour correspondre à travers les limites de ligne.

161

162Grep respecte `.gitignore`, donc les fichiers gitignorés sont ignorés. Pour rechercher un fichier gitignore, Claude transmet son chemin directement.

163

64## Comportement de l'outil LSP164## Comportement de l'outil LSP

65 165

66L'outil LSP donne à Claude l'intelligence du code à partir d'un serveur de langage en cours d'exécution. Après chaque modification de fichier, il signale automatiquement les erreurs de type et les avertissements afin que Claude puisse corriger les problèmes sans une étape de compilation séparée. Claude peut également l'appeler directement pour naviguer dans le code :166L'outil LSP donne à Claude l'intelligence du code à partir d'un serveur de langage en cours d'exécution. Après chaque modification de fichier, il signale automatiquement les erreurs de type et les avertissements afin que Claude puisse corriger les problèmes sans une étape de compilation séparée. Claude peut également l'appeler directement pour naviguer dans le code :

93 193

94Les plugins peuvent déclarer des moniteurs qui démarrent automatiquement quand le plugin est actif, au lieu de demander à Claude de les démarrer. Voir [moniteurs de plugin](/fr/plugins-reference#monitors).194Les plugins peuvent déclarer des moniteurs qui démarrent automatiquement quand le plugin est actif, au lieu de demander à Claude de les démarrer. Voir [moniteurs de plugin](/fr/plugins-reference#monitors).

95 195

196## Comportement de l'outil NotebookEdit

197

198NotebookEdit modifie un notebook Jupyter une cellule à la fois, ciblant les cellules par leur `cell_id`. Il n'effectue pas de remplacement de chaîne à travers le notebook comme le fait [Edit](#edit-tool-behavior) sur les fichiers simples.

199

200Trois modes de modification contrôlent ce qui arrive à la cellule cible :

201

202* `replace` : remplace la source de la cellule. C'est la valeur par défaut.

203* `insert` : ajoute une nouvelle cellule après la cible. Sans `cell_id`, la nouvelle cellule va au début du notebook. Nécessite que `cell_type` soit défini à `code` ou `markdown`.

204* `delete` : supprime la cellule cible.

205

206Les règles de permission utilisent le format de chemin `Edit(...)`. Une règle comme `Edit(notebooks/**)` couvre les appels NotebookEdit sur les fichiers dans ce répertoire.

207

96## Outil PowerShell208## Outil PowerShell

97 209

98L'outil PowerShell permet à Claude d'exécuter des commandes PowerShell nativement. Sur Windows, cela signifie que les commandes s'exécutent dans PowerShell au lieu d'être acheminées via Git Bash. Sur Windows sans Git Bash, l'outil est activé automatiquement. Sur Windows avec Git Bash installé, l'outil est en déploiement progressif. Sur Linux, macOS et WSL, l'outil est opt-in.210L'outil PowerShell permet à Claude d'exécuter des commandes PowerShell nativement. Sur Windows, cela signifie que les commandes s'exécutent dans PowerShell au lieu d'être acheminées via Git Bash. Sur Windows sans Git Bash, l'outil est activé automatiquement. Sur Windows avec Git Bash installé, l'outil est en déploiement progressif. Sur Linux, macOS et WSL, l'outil est opt-in.

130* Les profils PowerShell ne sont pas chargés242* Les profils PowerShell ne sont pas chargés

131* Sur Windows, le sandboxing n'est pas pris en charge243* Sur Windows, le sandboxing n'est pas pris en charge

132 244

245## Comportement de l'outil Read

246

247L'outil Read prend un chemin de fichier et retourne le contenu avec les numéros de ligne. Claude est instruit de toujours transmettre les chemins absolus.

248

249Par défaut, Read retourne le fichier depuis le début. Les fichiers au-delà d'un seuil de taille retournent une erreur plutôt que du contenu partiel, invitant Claude à réessayer avec `offset` et `limit` pour lire une plage spécifique.

250

251Read gère plusieurs types de fichiers au-delà du texte simple :

252

253* **Images** : PNG, JPG et autres formats d'image sont retournés en tant que contenu visuel que Claude peut voir, pas en tant que bytes bruts. Claude Code redimensionne et récompresse les grandes images pour s'adapter aux limites de taille d'image du modèle avant de les envoyer, donc Claude peut voir une version réduite d'une grande capture d'écran. Si Claude manque les détails au niveau des pixels fins dans une grande image, demandez-lui de recadrer d'abord la région d'intérêt, par exemple avec ImageMagick via Bash.

254* **PDFs** : Claude lit les fichiers `.pdf` courts en entier. Pour les PDFs plus longs que 10 pages, il lit par plages avec un paramètre `pages`, tel que `"1-5"`, jusqu'à 20 pages à la fois.

255* **Notebooks Jupyter** : les fichiers `.ipynb` retournent toutes les cellules avec leurs sorties, y compris le code, le markdown et les visualisations.

256

257Read ne lit que les fichiers, pas les répertoires. Claude utilise `ls` via l'outil Bash pour lister le contenu des répertoires.

258

259## Comportement de l'outil WebFetch

260

261WebFetch prend une URL et une invite décrivant ce qu'il faut extraire. Il récupère la page, convertit la réponse en Markdown quand le serveur retourne du HTML, et exécute l'invite contre le contenu en utilisant un petit modèle rapide. Pour la plupart des récupérations, Claude reçoit la réponse de ce modèle, pas la page brute. L'étape de conversion n'est pas configurable.

262

263Cela rend WebFetch lossy par conception. L'invite d'extraction détermine ce qui atteint Claude, donc un résultat qui dit qu'une page ne mentionne pas quelque chose peut seulement signifier que l'invite ne l'a pas demandé. Demandez à Claude de récupérer à nouveau avec une invite plus spécifique, ou utilisez `curl` via Bash pour la page non traitée.

264

265Quelques comportements façonnent la réponse que Claude reçoit :

266

267* Les URLs HTTP sont automatiquement mises à niveau vers HTTPS.

268* Les grandes pages sont tronquées à une limite de caractères fixe avant le traitement.

269* Les réponses sont mises en cache pendant 15 minutes, donc les récupérations répétées de la même URL retournent rapidement.

270* Quand une URL redirige vers un hôte différent, WebFetch retourne un résultat textuel qui nomme l'URL d'origine et la cible de redirection au lieu de la suivre. Claude récupère ensuite la nouvelle URL avec un deuxième appel WebFetch.

271

272Dans les modes de permission par défaut et `acceptEdits`, WebFetch demande la première fois qu'il atteint un nouveau domaine. Pour autoriser un domaine à l'avance sans demande, ajoutez une règle de permission comme `WebFetch(domain:example.com)`. Les modes de permission `auto` et `bypassPermissions` [permission modes](/fr/permissions#permission-modes) ignorent complètement la demande.

273

274WebFetch définit un en-tête `User-Agent` commençant par `Claude-User`, et un en-tête `Accept` qui préfère Markdown à HTML afin que les serveurs qui supportent la négociation de contenu puissent retourner Markdown directement. Les [règles de réseau Sandbox](/fr/sandboxing) sont configurées séparément, donc un domaine que vous voulez qu'un processus sandboxé atteigne a toujours besoin d'une règle de permission sandbox explicite.

275

276## Comportement de l'outil WebSearch

277

278WebSearch exécute une requête contre le backend de [recherche web](https://platform.claude.com/docs/en/agents-and-tools/tool-use/web-search-tool) d'Anthropic et retourne les titres et URLs des résultats. Il ne récupère pas les pages de résultats. Pour lire une page que Claude trouve dans les résultats de recherche, il suit avec [WebFetch](#webfetch-tool-behavior).

279

280L'outil peut émettre jusqu'à huit recherches backend par appel, affinage de la recherche en interne avant de retourner les résultats. Claude peut limiter les résultats avec `allowed_domains` pour inclure uniquement certains hôtes, ou `blocked_domains` pour les exclure. Les deux listes ne peuvent pas être combinées dans un seul appel.

281

282Le backend de recherche n'est pas configurable. Pour rechercher avec un fournisseur différent, ajoutez un [serveur MCP](/fr/mcp) qui expose un outil de recherche.

283

284Les règles de permission WebSearch ne prennent pas de spécificateur. Une entrée `WebSearch` nu dans `allow` ou `deny` est la seule forme.

285

286<Note>

287 WebSearch est disponible sur l'API Claude et Microsoft Foundry. Sur Google Cloud Vertex AI, il fonctionne avec les modèles Claude 4, y compris Opus, Sonnet et Haiku. Amazon Bedrock n'expose pas l'outil de recherche web côté serveur.

288</Note>

289

290## Comportement de l'outil Write

291

292L'outil Write crée un nouveau fichier ou remplace un fichier existant avec le contenu complet fourni. Il n'ajoute pas ou ne fusionne pas.

293

294Si le chemin cible existe déjà, Claude doit avoir lu ce fichier au moins une fois dans la conversation actuelle avant de le remplacer. Une Write vers un fichier existant non lu échoue avec une erreur. Cette contrainte ne s'applique pas aux nouveaux fichiers.

295

296Afficher le fichier avec Bash `cat` ou `sed -n` satisfait également cette exigence, comme décrit dans [comportement de l'outil Edit](#edit-tool-behavior).

297

298Pour les modifications partielles d'un fichier existant, Claude utilise Edit au lieu de Write.

299

133## Vérifier quels outils sont disponibles300## Vérifier quels outils sont disponibles

134 301

135Votre ensemble d'outils exact dépend de votre fournisseur, de votre plateforme et de vos paramètres. Pour vérifier ce qui est chargé dans une session en cours d'exécution, demandez directement à Claude :302Votre ensemble d'outils exact dépend de votre fournisseur, de votre plateforme et de vos paramètres. Pour vérifier ce qui est chargé dans une session en cours d'exécution, demandez directement à Claude :

worktrees.md +161 −0 created

Details

1> ## Documentation Index

2> 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.

5# Exécuter des sessions parallèles avec worktrees

7> Isolez les sessions Claude Code parallèles dans des git worktrees séparés pour que les modifications ne se heurtent pas. Couvre le flag `--worktree`, l'isolation des subagents, `.worktreeinclude`, le nettoyage et les hooks VCS non-git.

9Un [git worktree](https://git-scm.com/docs/git-worktree) est un répertoire de travail séparé avec ses propres fichiers et branche, partageant le même historique de dépôt et la même télécommande que votre extraction principale. Exécuter chaque session Claude Code dans son propre worktree signifie que les modifications dans une session ne touchent jamais les fichiers d'une autre, vous pouvez donc avoir Claude construisant une fonctionnalité dans un terminal tout en corrigeant un bug dans un second.

11Cette page couvre l'isolation des worktrees dans la CLI. Tout ce qui suit suppose un dépôt git. Pour les autres systèmes de contrôle de version, voir [Contrôle de version non-git](#non-git-version-control). L'[application de bureau](/fr/desktop#work-in-parallel-with-sessions) crée automatiquement un worktree pour chaque nouvelle session.

13Les worktrees sont l'une des plusieurs façons d'exécuter Claude en parallèle. Ils isolent les modifications de fichiers, tandis que les [subagents](/fr/sub-agents) et les [équipes d'agents](/fr/agent-teams) coordonnent le travail lui-même. Voir [Exécuter les agents en parallèle](/fr/agents) pour comparer les approches, ou passez directement à [Isoler les subagents avec worktrees](#isolate-subagents-with-worktrees) pour utiliser les worktrees et les subagents ensemble.

15## Démarrer Claude dans un worktree

17Passez `--worktree` ou `-w` pour créer un worktree isolé et démarrer Claude dedans. Par défaut, le worktree est créé sous `.claude/worktrees/<value>/` à la racine de votre dépôt, sur une nouvelle branche nommée `worktree-<value>` :

19```bash theme={null}

20claude --worktree feature-auth

21```

23Pour placer les worktrees ailleurs, configurez un hook [`WorktreeCreate`](#non-git-version-control). Exécutez la commande à nouveau avec un nom différent dans un autre terminal pour démarrer une deuxième session isolée :

25```bash theme={null}

26claude --worktree bugfix-123

27```

29Si vous omettez le nom, Claude en génère un tel que `bright-running-fox` :

31```bash theme={null}

32claude --worktree

33```

35Vous pouvez également demander à Claude de « travailler dans un worktree » pendant une session, et il en créera un avec l'outil [`EnterWorktree`](/fr/tools-reference).

37Avant d'utiliser `--worktree` dans un répertoire pour la première fois, acceptez la boîte de dialogue de confiance de l'espace de travail en exécutant `claude` une fois dans ce répertoire. Si la confiance n'a pas encore été acceptée, `--worktree` se termine avec une erreur et vous invite à exécuter `claude` dans le répertoire en premier, y compris lorsqu'il est combiné avec `-p`.

39<Tip>

40 Ajoutez `.claude/worktrees/` à votre `.gitignore` pour que le contenu des worktrees n'apparaisse pas comme des fichiers non suivis dans votre extraction principale.

41</Tip>

43### Choisir la branche de base

45Les worktrees se ramifient à partir de la branche par défaut de votre dépôt, `origin/HEAD`, ils commencent donc à partir d'un arbre propre correspondant à la télécommande. Si aucune télécommande n'est configurée ou si la récupération échoue, le worktree revient à votre `HEAD` local actuel. Pour toujours vous ramifier à partir du `HEAD` local à la place, définissez `worktree.baseRef` sur `"head"` dans [paramètres](/fr/settings#worktree-settings). Définir `baseRef` sur `"head"` fait que les nouveaux worktrees portent vos commits non poussés et l'état de la branche de fonctionnalité, ce qui est utile lors de l'isolation des subagents qui doivent opérer sur un travail en cours. Le paramètre n'accepte que `"fresh"` ou `"head"`, pas des refs git arbitraires :

47```json theme={null}

48{

49 "worktree": {

50 "baseRef": "head"

51 }

52}

53```

55Pour vous ramifier à partir d'une demande de tirage spécifique, passez le numéro de PR préfixé par `#`, ou une URL complète de demande de tirage GitHub. Claude Code récupère `pull/<number>/head` à partir de `origin` et crée le worktree à `.claude/worktrees/pr-<number>` :

57```bash theme={null}

58claude --worktree "#1234"

59```

61Pour un contrôle total sur la façon dont les worktrees sont créés, configurez un hook [`WorktreeCreate`](/fr/hooks#worktreecreate), qui remplace entièrement la logique `git worktree` par défaut.

63## Copier les fichiers gitignorés dans les worktrees

65Un worktree est une extraction fraîche, donc les fichiers non suivis comme `.env` ou `.env.local` de votre dépôt principal ne sont pas présents. Pour les copier automatiquement quand Claude crée un worktree, ajoutez un fichier `.worktreeinclude` à la racine de votre projet.

67Le fichier utilise la syntaxe `.gitignore`. Seuls les fichiers qui correspondent à un motif et sont également gitignorés sont copiés, donc les fichiers suivis ne sont jamais dupliqués.

69Ce `.worktreeinclude` copie deux fichiers env et une configuration de secrets dans chaque nouveau worktree :

71```text .worktreeinclude theme={null}

72.env

73.env.local

74config/secrets.json

75```

77Cela s'applique aux worktrees créés avec `--worktree`, [worktrees de subagents](#isolate-subagents-with-worktrees), et aux sessions parallèles dans l'[application de bureau](/fr/desktop#work-in-parallel-with-sessions).

79## Isoler les subagents avec worktrees

81Les subagents peuvent s'exécuter dans leurs propres worktrees pour que les modifications parallèles ne se heurtent pas. Demandez à Claude d'« utiliser les worktrees pour vos agents », ou définissez-le de manière permanente sur un [subagent personnalisé](/fr/sub-agents#supported-frontmatter-fields) en ajoutant `isolation: worktree` au frontmatter. Chaque subagent obtient un worktree temporaire qui est supprimé automatiquement quand le subagent se termine sans modifications.

83## Nettoyer les worktrees

85Quand vous quittez une session worktree, le nettoyage dépend de si vous avez apporté des modifications :

87* **Pas de modifications** : le worktree et sa branche sont supprimés automatiquement

88* **Des modifications ou des commits existent** : Claude vous demande de conserver ou de supprimer le worktree. Conserver préserve le répertoire et la branche pour que vous puissiez revenir plus tard. Supprimer supprime le répertoire worktree et sa branche, en supprimant toutes les modifications non validées et les commits

89* **Exécutions non interactives** : les worktrees créés avec `--worktree` aux côtés de `-p` ne sont pas nettoyés automatiquement puisqu'il n'y a pas d'invite de sortie. Supprimez-les avec `git worktree remove`

91Les worktrees de subagents orphelins par un crash ou une exécution interrompue sont supprimés au démarrage une fois qu'ils sont plus anciens que votre paramètre [`cleanupPeriodDays`](/fr/settings#available-settings), à condition qu'ils n'aient pas de modifications non validées, pas de fichiers non suivis et pas de commits non poussés. Les worktrees que vous créez avec `--worktree` ne sont jamais supprimés par ce balayage.

93## Gérer les worktrees manuellement

95Pour un contrôle total sur l'emplacement du worktree et la configuration de la branche, créez des worktrees directement avec Git. Ceci est utile quand vous devez extraire une branche existante spécifique ou placer le worktree en dehors du dépôt.

97Créer un worktree sur une nouvelle branche :

99```bash theme={null}

100git worktree add ../project-feature-a -b feature-a

101```

102

103Créer un worktree à partir d'une branche existante :

104

105```bash theme={null}

106git worktree add ../project-bugfix bugfix-123

107```

108

109Démarrer Claude dans le worktree :

110

111```bash theme={null}

112cd ../project-feature-a && claude

113```

114

115Lister vos worktrees :

116

117```bash theme={null}

118git worktree list

119```

120

121Supprimer un quand vous en avez terminé :

122

123```bash theme={null}

124git worktree remove ../project-feature-a

125```

126

127Voir la [documentation Git worktree](https://git-scm.com/docs/git-worktree) pour la référence complète des commandes. N'oubliez pas d'initialiser votre environnement de développement dans chaque nouveau worktree : installez les dépendances, configurez les environnements virtuels, ou exécutez tout ce que votre configuration de projet nécessite.

128

129## Contrôle de version non-git

130

131L'isolation des worktrees utilise git par défaut. Pour SVN, Perforce, Mercurial ou d'autres systèmes, configurez les hooks [`WorktreeCreate` et `WorktreeRemove`](/fr/hooks#worktreecreate) pour fournir une logique de création et de nettoyage personnalisée. Parce que le hook remplace le comportement git par défaut, [`.worktreeinclude`](#copy-gitignored-files-into-worktrees) n'est pas traité quand vous utilisez `--worktree`. Copiez plutôt tous les fichiers de configuration locale à l'intérieur de votre script de hook.

132

133Ce hook `WorktreeCreate` lit le nom du worktree à partir de stdin, extrait une copie de travail SVN fraîche, et imprime le chemin du répertoire pour que Claude Code puisse l'utiliser comme répertoire de travail de la session :

134

135```json theme={null}

136{

137 "hooks": {

138 "WorktreeCreate": [

139 {

140 "hooks": [

141 {

142 "type": "command",

143 "command": "bash -c 'NAME=$(jq -r .name); DIR=\"$HOME/.claude/worktrees/$NAME\"; svn checkout https://svn.example.com/repo/trunk \"$DIR\" >&2 && echo \"$DIR\"'"

144 }

145 ]

146 }

147 ]

148 }

149}

150```

151

152Associez-le à un hook `WorktreeRemove` pour nettoyer quand la session se termine. Voir la [référence des hooks](/fr/hooks#worktreecreate) pour le schéma d'entrée et un exemple de suppression.

153

154## Voir aussi

155

156Les worktrees gèrent l'isolation des fichiers. Les pages connexes ci-dessous couvrent la délégation du travail dans ces extractions isolées et le basculement entre les sessions que vous créez :

157

158* [Subagents](/fr/sub-agents) : déléguer le travail à des agents isolés dans une session

159* [Équipes d'agents](/fr/agent-teams) : coordonner plusieurs sessions Claude automatiquement

160* [Gérer les sessions](/fr/sessions) : nommer, reprendre et basculer entre les conversations

161* [Sessions parallèles de bureau](/fr/desktop#work-in-parallel-with-sessions) : sessions soutenues par worktree dans l'application de bureau

Documentation 2026-05-10 23:03 UTC to 2026-05-11 23:00 UTC