traduction
This commit is contained in:
@@ -0,0 +1,231 @@
|
||||
# Bonnes pratiques — Drapeaux de démarrage du CLI
|
||||
|
||||
|
||||
|
||||
Référence des drapeaux de démarrage de Claude Code, des sous-commandes de premier niveau et des variables d'environnement de démarrage lors du lancement de Claude Code depuis le terminal.
|
||||
|
||||
<table width="100%">
|
||||
<tr>
|
||||
<td><a href="../">← Retour à Claude Code Best Practice</a></td>
|
||||
<td align="right"><img src="../../!/claude-jumping.svg" alt="Claude" width="60" /></td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
---
|
||||
|
||||
## Table des matières
|
||||
|
||||
1. [Gestion des sessions](#gestion-des-sessions)
|
||||
2. [Modèle & configuration](#modèle--configuration)
|
||||
3. [Permissions & sécurité](#permissions--sécurité)
|
||||
4. [Sortie & format](#sortie--format)
|
||||
5. [System prompt](#system-prompt)
|
||||
6. [Agent & sous-agent](#agent--sous-agent)
|
||||
7. [MCP & plugins](#mcp--plugins)
|
||||
8. [Répertoire & espace de travail](#répertoire--espace-de-travail)
|
||||
9. [Budget & limites](#budget--limites)
|
||||
10. [Intégration](#intégration)
|
||||
11. [Initialisation & maintenance](#initialisation--maintenance)
|
||||
12. [Débogage & diagnostics](#débogage--diagnostics)
|
||||
13. [Surcharge des paramètres](#surcharge-des-paramètres)
|
||||
14. [Version & aide](#version--aide)
|
||||
15. [Sous-commandes](#sous-commandes)
|
||||
16. [Variables d'environnement](#variables-denvironnement)
|
||||
|
||||
---
|
||||
|
||||
## Gestion des sessions
|
||||
|
||||
| Drapeau | Court | Description |
|
||||
|------|-------|-------------|
|
||||
| `--continue` | `-c` | Continuer la conversation la plus récente dans le répertoire courant |
|
||||
| `--resume` | `-r` | Reprendre une session spécifique par ID ou nom, ou afficher le sélecteur interactif |
|
||||
| `--from-pr <NUMBER\|URL>` | | Reprendre les sessions liées à une PR GitHub spécifique |
|
||||
| `--fork-session` | | Créer un nouvel ID de session lors de la reprise (à utiliser avec `--resume` ou `--continue`) |
|
||||
| `--session-id <UUID>` | | Utiliser un ID de session spécifique (doit être un UUID valide) |
|
||||
| `--no-session-persistence` | | Désactiver la persistance de session (mode print uniquement) |
|
||||
| `--remote` | | Créer une nouvelle session web sur claude.ai |
|
||||
| `--teleport` | | Reprendre une session web dans ton terminal local |
|
||||
|
||||
---
|
||||
|
||||
## Modèle & configuration
|
||||
|
||||
| Drapeau | Court | Description |
|
||||
|------|-------|-------------|
|
||||
| `--model <NAME>` | | Définir le modèle avec un alias (`sonnet`, `opus`, `haiku`) ou un ID de modèle complet |
|
||||
| `--fallback-model <NAME>` | | Modèle de repli automatique quand le défaut est surchargé (mode print uniquement) |
|
||||
| `--betas <LIST>` | | En-têtes beta à inclure dans les requêtes API (utilisateurs avec clé API uniquement) |
|
||||
|
||||
---
|
||||
|
||||
## Permissions & sécurité
|
||||
|
||||
| Drapeau | Court | Description |
|
||||
|------|-------|-------------|
|
||||
| `--dangerously-skip-permissions` | | Ignorer TOUTES les demandes de permission. À utiliser avec une extrême prudence |
|
||||
| `--allow-dangerously-skip-permissions` | | Activer le contournement de permissions comme option sans l'activer |
|
||||
| `--permission-mode <MODE>` | | Démarrer dans le mode de permissions spécifié : `default`, `plan`, `acceptEdits`, `bypassPermissions` |
|
||||
| `--allowedTools <TOOLS>` | | Outils qui s'exécutent sans demande (syntaxe de règle de permission) |
|
||||
| `--disallowedTools <TOOLS>` | | Outils entièrement retirés du contexte du modèle |
|
||||
| `--tools <TOOLS>` | | Restreindre les outils intégrés que Claude peut utiliser (utilise `""` pour tout désactiver) |
|
||||
| `--permission-prompt-tool <TOOL>` | | Spécifier l'outil MCP qui gère les demandes de permission en mode non interactif |
|
||||
|
||||
---
|
||||
|
||||
## Sortie & format
|
||||
|
||||
| Drapeau | Court | Description |
|
||||
|------|-------|-------------|
|
||||
| `--print` | `-p` | Afficher la réponse sans mode interactif (mode headless/SDK) |
|
||||
| `--output-format <FORMAT>` | | Format de sortie : `text`, `json`, `stream-json` |
|
||||
| `--input-format <FORMAT>` | | Format d'entrée : `text`, `stream-json` |
|
||||
| `--json-schema <SCHEMA>` | | Obtenir un JSON validé correspondant au schéma (mode print uniquement) |
|
||||
| `--include-partial-messages` | | Inclure les événements de streaming partiels (requiert `--print` et `--output-format=stream-json`) |
|
||||
| `--verbose` | | Activer la journalisation verbeuse avec sortie complète tour par tour |
|
||||
|
||||
---
|
||||
|
||||
## System prompt
|
||||
|
||||
| Drapeau | Court | Description |
|
||||
|------|-------|-------------|
|
||||
| `--system-prompt <TEXT>` | | Remplacer entièrement le system prompt par un texte personnalisé |
|
||||
| `--system-prompt-file <PATH>` | | Charger le system prompt depuis un fichier, remplaçant le défaut (mode print uniquement) |
|
||||
| `--append-system-prompt <TEXT>` | | Ajouter du texte personnalisé au system prompt par défaut |
|
||||
| `--append-system-prompt-file <PATH>` | | Ajouter le contenu d'un fichier au prompt par défaut (mode print uniquement) |
|
||||
|
||||
---
|
||||
|
||||
## Agent & sous-agent
|
||||
|
||||
| Drapeau | Court | Description |
|
||||
|------|-------|-------------|
|
||||
| `--agent <NAME>` | | Spécifier un agent pour la session courante |
|
||||
| `--agents <JSON>` | | Définir des sous-agents personnalisés dynamiquement via JSON |
|
||||
| `--teammate-mode <MODE>` | | Définir l'affichage de l'équipe d'agents : `auto`, `in-process`, `tmux` |
|
||||
|
||||
---
|
||||
|
||||
## MCP & plugins
|
||||
|
||||
| Drapeau | Court | Description |
|
||||
|------|-------|-------------|
|
||||
| `--mcp-config <PATH\|JSON>` | | Charger les serveurs MCP depuis un fichier JSON ou une chaîne |
|
||||
| `--strict-mcp-config` | | Utiliser uniquement les serveurs MCP de `--mcp-config`, ignorer tous les autres |
|
||||
| `--plugin-dir <PATH>` | | Charger les plugins depuis un répertoire pour cette session uniquement (répétable) |
|
||||
|
||||
---
|
||||
|
||||
## Répertoire & espace de travail
|
||||
|
||||
| Drapeau | Court | Description |
|
||||
|------|-------|-------------|
|
||||
| `--add-dir <PATH>` | | Ajouter des répertoires de travail supplémentaires accessibles à Claude |
|
||||
| `--worktree` | `-w` | Démarrer Claude dans un worktree git isolé (branché depuis HEAD) |
|
||||
|
||||
---
|
||||
|
||||
## Budget & limites
|
||||
|
||||
| Drapeau | Court | Description |
|
||||
|------|-------|-------------|
|
||||
| `--max-budget-usd <AMOUNT>` | | Montant maximum en dollars pour les appels API avant arrêt (mode print uniquement) |
|
||||
| `--max-turns <NUMBER>` | | Limiter le nombre de tours agentiques (mode print uniquement) |
|
||||
|
||||
---
|
||||
|
||||
## Intégration
|
||||
|
||||
| Drapeau | Court | Description |
|
||||
|------|-------|-------------|
|
||||
| `--chrome` | | Activer l'intégration du navigateur Chrome pour l'automatisation web |
|
||||
| `--no-chrome` | | Désactiver l'intégration du navigateur Chrome pour cette session |
|
||||
| `--ide` | | Se connecter automatiquement à l'IDE au démarrage si exactement un IDE valide est disponible |
|
||||
|
||||
---
|
||||
|
||||
## Initialisation & maintenance
|
||||
|
||||
| Drapeau | Court | Description |
|
||||
|------|-------|-------------|
|
||||
| `--init` | | Exécuter les hooks d'initialisation et démarrer le mode interactif |
|
||||
| `--init-only` | | Exécuter les hooks d'initialisation et quitter (pas de session interactive) |
|
||||
| `--maintenance` | | Exécuter les hooks de maintenance et quitter |
|
||||
|
||||
---
|
||||
|
||||
## Débogage & diagnostics
|
||||
|
||||
| Drapeau | Court | Description |
|
||||
|------|-------|-------------|
|
||||
| `--debug <CATEGORIES>` | | Activer le mode debug avec filtrage de catégorie optionnel (par ex. `"api,hooks"`) |
|
||||
|
||||
---
|
||||
|
||||
## Surcharge des paramètres
|
||||
|
||||
| Drapeau | Court | Description |
|
||||
|------|-------|-------------|
|
||||
| `--settings <PATH\|JSON>` | | Chemin vers un fichier JSON de paramètres ou chaîne JSON à charger |
|
||||
| `--setting-sources <LIST>` | | Liste de sources à charger séparées par des virgules : `user`, `project`, `local` |
|
||||
| `--disable-slash-commands` | | Désactiver tous les skills et commandes slash pour cette session |
|
||||
|
||||
---
|
||||
|
||||
## Version & aide
|
||||
|
||||
| Drapeau | Court | Description |
|
||||
|------|-------|-------------|
|
||||
| `--version` | `-v` | Afficher le numéro de version |
|
||||
| `--help` | `-h` | Afficher les informations d'aide |
|
||||
|
||||
---
|
||||
|
||||
## Sous-commandes
|
||||
|
||||
Ce sont des commandes de premier niveau exécutées comme `claude <subcommand>` :
|
||||
|
||||
| Sous-commande | Description |
|
||||
|------------|-------------|
|
||||
| `claude` | Démarrer le REPL interactif |
|
||||
| `claude "query"` | Démarrer le REPL avec un prompt initial |
|
||||
| `claude agents` | Lister les agents configurés |
|
||||
| `claude auth` | Gérer l'authentification Claude Code |
|
||||
| `claude doctor` | Lancer les diagnostics en ligne de commande |
|
||||
| `claude install` | Installer ou changer de build natif Claude Code |
|
||||
| `claude mcp` | Configurer les serveurs MCP (`add`, `remove`, `list`, `get`, `enable`) |
|
||||
| `claude plugin` | Gérer les plugins Claude Code |
|
||||
| `claude remote-control` | Gérer les sessions de contrôle à distance |
|
||||
| `claude setup-token` | Créer un token longue durée pour l'usage par abonnement |
|
||||
| `claude update` / `claude upgrade` | Mettre à jour vers la dernière version |
|
||||
|
||||
---
|
||||
|
||||
## Variables d'environnement
|
||||
|
||||
Ces variables d'environnement de démarrage uniquement sont définies dans ton shell avant de lancer Claude Code (elles ne peuvent pas être configurées via `settings.json`) :
|
||||
|
||||
| Variable | Description |
|
||||
|----------|-------------|
|
||||
| `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` | Activer les équipes d'agents expérimentales |
|
||||
| `CLAUDE_CODE_TMPDIR` | Surcharger le répertoire temp pour les fichiers internes. Configurable aussi via la clé `env` — voir [Référence des paramètres](./claude-settings.md#variables-denvironnement-via-env) |
|
||||
| `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1` | Activer le chargement des CLAUDE.md de répertoires additionnels |
|
||||
| `DISABLE_AUTOUPDATER=1` | Désactiver les mises à jour automatiques. Configurable aussi via la clé `env` — voir [Référence des paramètres](./claude-settings.md#variables-denvironnement-via-env) |
|
||||
| `CLAUDE_CODE_EFFORT_LEVEL` | Contrôler la profondeur de réflexion — voir [Référence des paramètres](./claude-settings.md#variables-denvironnement-via-env) |
|
||||
| `USE_BUILTIN_RIPGREP=0` | Utiliser le ripgrep système au lieu de celui intégré (Alpine Linux) |
|
||||
| `CLAUDE_CODE_SIMPLE` | Activer le mode simple (outils Bash + Edit uniquement). Configurable aussi via la clé `env` — voir [Référence des paramètres](./claude-settings.md#variables-denvironnement-via-env) |
|
||||
| `CLAUDE_BASH_NO_LOGIN=1` | Sauter le login shell pour BashTool |
|
||||
| `CCR_FORCE_BUNDLE=1` | Forcer le bundling/upload du dépôt local en utilisant `claude --remote`. Configurable aussi via la clé `env` — voir [Référence des paramètres](./claude-settings.md#variables-denvironnement-via-env) |
|
||||
|
||||
Pour les variables d'environnement configurables via la clé `"env"` dans `settings.json` (dont `MAX_THINKING_TOKENS`, `CLAUDE_CODE_SHELL`, `CLAUDE_CODE_ENABLE_TASKS`, `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS`, `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`, et plus), voir la [Référence des paramètres Claude](./claude-settings.md#variables-denvironnement-via-env).
|
||||
|
||||
---
|
||||
|
||||
## Sources
|
||||
|
||||
- [Référence CLI Claude Code](https://code.claude.com/docs/en/cli-reference)
|
||||
- [Mode Headless Claude Code](https://code.claude.com/docs/en/headless)
|
||||
- [Configuration Claude Code](https://code.claude.com/docs/en/setup)
|
||||
- [CHANGELOG Claude Code](https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md)
|
||||
- [Workflows courants Claude Code](https://code.claude.com/docs/en/common-workflows)
|
||||
@@ -0,0 +1,135 @@
|
||||
# Bonnes pratiques — Commandes
|
||||
|
||||
 <br>
|
||||
[](../implementation/claude-commands-implementation.md)
|
||||
|
||||
Commandes Claude Code — champs de frontmatter et commandes slash intégrées officielles.
|
||||
|
||||
<table width="100%">
|
||||
<tr>
|
||||
<td><a href="../">← Retour à Claude Code Best Practice</a></td>
|
||||
<td align="right"><img src="../../!/claude-jumping.svg" alt="Claude" width="60" /></td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
---
|
||||
|
||||
## Champs de frontmatter (16)
|
||||
|
||||
| Champ | Type | Requis | Description |
|
||||
|-------|------|----------|-------------|
|
||||
| `name` | string | Non | Nom d'affichage et identifiant `/slash-command`. Par défaut le nom du répertoire si omis |
|
||||
| `description` | string | Recommandé | Ce que fait la commande. Affiché en autocomplétion et utilisé par Claude pour l'auto-découverte |
|
||||
| `when_to_use` | string | Non | Contexte additionnel indiquant quand Claude doit invoquer le skill — phrases déclencheuses ou exemples de requêtes. Ajouté à `description` dans la liste et compte dans la limite de 1 536 caractères |
|
||||
| `argument-hint` | string | Non | Indice affiché pendant l'autocomplétion (par ex. `[issue-number]`, `[filename]`) |
|
||||
| `arguments` | string/list | Non | Arguments positionnels nommés pour la substitution `$name` dans le contenu de la commande. Accepte une chaîne séparée par des espaces ou une liste YAML — les noms correspondent aux positions des arguments dans l'ordre |
|
||||
| `disable-model-invocation` | boolean | Non | Mets `true` pour empêcher Claude d'invoquer automatiquement cette commande |
|
||||
| `user-invocable` | boolean | Non | Mets `false` pour masquer du menu `/` — la commande devient connaissance d'arrière-plan uniquement |
|
||||
| `paths` | string/list | Non | Motifs glob qui limitent quand ce skill est activé. Accepte une chaîne séparée par des virgules ou une liste YAML. Si défini, Claude charge le skill automatiquement uniquement quand il travaille sur des fichiers correspondant aux motifs |
|
||||
| `allowed-tools` | string | Non | Outils autorisés sans demande de permission quand cette commande est active |
|
||||
| `disallowed-tools` | string/list | Non | Outils retirés du pool disponible de Claude tant que cette commande est active. Se lève quand tu envoies ton message suivant. L'inverse de `allowed-tools` |
|
||||
| `model` | string | Non | Modèle à utiliser quand cette commande s'exécute (par ex. `haiku`, `sonnet`, `opus`) |
|
||||
| `effort` | string | Non | Surcharge le niveau d'effort du modèle à l'invocation (`low`, `medium`, `high`, `xhigh`, `max`) |
|
||||
| `context` | string | Non | Mets `fork` pour exécuter la commande dans un contexte de sous-agent isolé |
|
||||
| `agent` | string | Non | Type de sous-agent quand `context: fork` est défini (défaut : `general-purpose`) |
|
||||
| `shell` | string | Non | Shell pour les blocs `` !`command` `` — accepte `bash` (défaut) ou `powershell`. Requiert `CLAUDE_CODE_USE_POWERSHELL_TOOL=1` |
|
||||
| `hooks` | object | Non | Hooks de cycle de vie limités à cette commande |
|
||||
|
||||
---
|
||||
|
||||
##  **(82)**
|
||||
|
||||
| # | Commande | Tag | Description |
|
||||
|---|---------|-----|-------------|
|
||||
| 1 | `/login` |  | Se connecter à ton compte Anthropic |
|
||||
| 2 | `/logout` |  | Se déconnecter de ton compte Anthropic |
|
||||
| 3 | `/setup-bedrock` |  | Configurer l'authentification, la région et les épingles de modèle Amazon Bedrock via un assistant interactif. Visible uniquement quand `CLAUDE_CODE_USE_BEDROCK=1` est défini. Les nouveaux utilisateurs Bedrock peuvent aussi accéder à cet assistant depuis l'écran de connexion |
|
||||
| 4 | `/setup-vertex` |  | Configurer l'authentification, le projet, la région et les épingles de modèle Google Vertex AI via un assistant interactif. Visible uniquement quand `CLAUDE_CODE_USE_VERTEX=1` est défini. Les nouveaux utilisateurs Vertex AI peuvent aussi accéder à cet assistant depuis l'écran de connexion |
|
||||
| 5 | `/upgrade` |  | Ouvrir la page de mise à niveau pour passer à un palier de forfait supérieur |
|
||||
| 6 | `/color [color\|default]` |  | Définir la couleur de la barre de prompt pour la session courante. Couleurs disponibles : `red`, `blue`, `green`, `yellow`, `purple`, `orange`, `pink`, `cyan`. Utilise `default` pour réinitialiser |
|
||||
| 7 | `/config` |  | Ouvrir l'interface des Paramètres pour ajuster le thème, le modèle, le style de sortie et d'autres préférences. Alias : `/settings` |
|
||||
| 8 | `/focus` |  | Basculer la vue focus, qui n'affiche que le dernier prompt, un résumé des appels d'outils et la réponse finale. Utile pour réduire le bruit visuel pendant de longues sessions. Disponible uniquement en rendu plein écran |
|
||||
| 9 | `/keybindings` |  | Ouvrir ou créer ton fichier de configuration de raccourcis clavier |
|
||||
| 10 | `/permissions` |  | Gérer les règles d'autorisation, de demande et de refus pour les permissions d'outils. Ouvre un dialogue interactif où tu peux voir les règles par portée, ajouter ou retirer des règles, gérer les répertoires de travail et examiner les refus récents en mode auto. Alias : `/allowed-tools` |
|
||||
| 11 | `/privacy-settings` |  | Voir et mettre à jour tes paramètres de confidentialité. Disponible uniquement pour les abonnés Pro et Max |
|
||||
| 12 | `/radio` |  | Ouvrir la radio lo-fi Claude FM dans ton navigateur |
|
||||
| 13 | `/sandbox` |  | Basculer le mode sandbox. Disponible uniquement sur les plateformes supportées |
|
||||
| 14 | `/scroll-speed` |  | Ajuster la vitesse de défilement de la molette de façon interactive |
|
||||
| 15 | `/statusline` |  | Configurer la barre d'état de Claude Code. Décris ce que tu veux, ou lance sans argument pour l'auto-configurer depuis ton prompt shell |
|
||||
| 16 | `/stickers` |  | Commander des autocollants Claude Code |
|
||||
| 17 | `/terminal-setup` |  | Configurer les raccourcis clavier du terminal pour Shift+Entrée et d'autres raccourcis. Visible uniquement dans les terminaux qui en ont besoin, comme VS Code, Cursor, Windsurf, Alacritty ou Zed |
|
||||
| 18 | `/theme` |  | Changer le thème de couleurs. Inclut des variantes claire et sombre, des thèmes accessibles aux daltoniens (daltonisés), des thèmes ANSI qui utilisent la palette de ton terminal, une option « Auto (suivre le terminal) » qui suit le mode clair/sombre de ton terminal, et des thèmes personnalisés chargés depuis `~/.claude/themes/` ou des plugins. Sélectionne « New custom theme… » pour créer le tien |
|
||||
| 19 | `/tui [default\|fullscreen]` |  | Définir le moteur de rendu de l'UI du terminal et relancer Claude Code avec la conversation courante intacte. `default` utilise le rendu inline ; `fullscreen` utilise une TUI en écran alternatif |
|
||||
| 20 | `/voice [hold\|tap\|off]` |  | Basculer la dictée vocale, ou l'activer dans un mode spécifique. Requiert un compte Claude.ai |
|
||||
| 21 | `/context` |  | Visualiser l'usage actuel du contexte sous forme de grille colorée. Affiche des suggestions d'optimisation pour les outils gourmands en contexte, le gonflement de mémoire et les avertissements de capacité |
|
||||
| 22 | `/cost` |  | Alias de `/usage` |
|
||||
| 23 | `/insights` |  | Générer un rapport analysant tes sessions Claude Code, dont les zones de projet, les schémas d'interaction et les points de friction |
|
||||
| 24 | `/stats` |  | Alias de `/usage`. S'ouvre sur l'onglet Stats |
|
||||
| 25 | `/status` |  | Ouvrir l'interface des Paramètres (onglet Status) 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 en cours |
|
||||
| 26 | `/usage` |  | Afficher le coût de la session, les limites d'usage du forfait et les stats d'activité. `/cost` et `/stats` sont des alias |
|
||||
| 27 | `/usage-credits` |  | Configurer des crédits d'usage pour continuer à travailler quand tu atteins une limite. Anciennement `/extra-usage` |
|
||||
| 28 | `/doctor` |  | Diagnostiquer et vérifier ton installation et tes paramètres Claude Code. Les résultats s'affichent avec des icônes de statut. Appuie sur `f` pour que Claude corrige les problèmes signalés |
|
||||
| 29 | `/feedback [report]` |  | Envoyer un retour, signaler un bug ou partager ta conversation. Alias : `/bug`, `/share` |
|
||||
| 30 | `/heapdump` |  | Écrire un instantané du tas JavaScript et une répartition mémoire dans `~/Desktop` pour diagnostiquer un usage mémoire élevé. Utile lors du signalement de bugs sur la croissance mémoire |
|
||||
| 31 | `/help` |  | Afficher l'aide et les commandes disponibles |
|
||||
| 32 | `/powerup` |  | Découvrir les fonctionnalités de Claude Code via de courtes leçons interactives avec des démos animées |
|
||||
| 33 | `/release-notes` |  | Voir le changelog dans un sélecteur de version interactif. Sélectionne une version spécifique pour voir ses notes de version, ou choisis d'afficher toutes les versions |
|
||||
| 34 | `/tasks` |  | Lister et gérer les tâches en arrière-plan. Alias : `/bashes` |
|
||||
| 35 | `/copy [N]` |  | Copier la dernière réponse de l'assistant dans le presse-papiers. Passe un nombre `N` pour copier la N-ième réponse la plus récente : `/copy 2` copie l'avant-dernière. Quand des blocs de code sont présents, affiche un sélecteur interactif pour choisir des blocs individuels ou la réponse complète. Appuie sur `w` dans le sélecteur pour écrire la sélection dans un fichier au lieu du presse-papiers, utile en SSH |
|
||||
| 36 | `/export [filename]` |  | Exporter la conversation courante en texte brut. Avec un nom de fichier, écrit directement dans ce fichier. Sans, ouvre un dialogue pour copier dans le presse-papiers ou enregistrer dans un fichier |
|
||||
| 37 | `/agents` |  | Gérer les configurations d'agents |
|
||||
| 38 | `/chrome` |  | Configurer les paramètres de Claude in Chrome |
|
||||
| 39 | `/hooks` |  | Voir les configurations de hooks pour les événements d'outils |
|
||||
| 40 | `/ide` |  | Gérer les intégrations IDE et afficher le statut |
|
||||
| 41 | `/mcp` |  | Gérer les connexions aux serveurs MCP et l'authentification OAuth |
|
||||
| 42 | `/plugin` |  | Gérer les plugins Claude Code |
|
||||
| 43 | `/reload-plugins` |  | Recharger tous les plugins actifs pour appliquer les changements en attente sans redémarrer. Rapporte les comptes pour chaque composant rechargé et signale les erreurs de chargement |
|
||||
| 44 | `/reload-skills` |  | Re-scanner les répertoires de skills et de commandes pour que les skills ajoutés ou modifiés sur le disque pendant la session deviennent disponibles sans redémarrer. Rapporte combien de skills sont disponibles et combien ont été ajoutés ou retirés |
|
||||
| 45 | `/skills` |  | Lister les skills disponibles. Appuie sur `t` pour trier par nombre de tokens |
|
||||
| 46 | `/memory` |  | Éditer les fichiers de mémoire `CLAUDE.md`, activer ou désactiver l'auto-mémoire, et voir les entrées d'auto-mémoire |
|
||||
| 47 | `/effort [low\|medium\|high\|xhigh\|max\|ultracode]` |  | Définir le niveau d'effort du modèle. Les niveaux disponibles dépendent du modèle et incluent `low`, `medium`, `high`, `xhigh`, `max` (session uniquement) et `ultracode` (combine le raisonnement `xhigh` avec l'orchestration automatique de workflow ; session uniquement). Sans argument, ouvre un curseur interactif pour choisir le niveau. `auto` réinitialise au défaut du modèle. Prend effet immédiatement sans attendre la fin de la réponse en cours |
|
||||
| 48 | `/fast [on\|off]` |  | Activer ou désactiver le mode fast |
|
||||
| 49 | `/model [model]` |  | Sélectionner ou changer le modèle IA. Pour les modèles qui le supportent, utilise les flèches gauche/droite pour ajuster le niveau d'effort. Le changement prend effet immédiatement sans attendre la fin de la réponse en cours. Lors d'un changement en cours de conversation après une sortie antérieure, Claude avertit avant d'appliquer le changement |
|
||||
| 50 | `/passes` |  | Partager une semaine gratuite de Claude Code avec des amis. Visible uniquement si ton compte est éligible |
|
||||
| 51 | `/plan [description]` |  | Entrer en mode plan directement depuis le prompt. Passe une description optionnelle pour entrer en mode plan et démarrer immédiatement sur cette tâche, par exemple `/plan fix the auth bug` |
|
||||
| 52 | `/ultraplan <prompt>` |  | Rédiger un plan dans une session ultraplan, le relire dans ton navigateur, puis l'exécuter à distance ou le renvoyer vers ton terminal |
|
||||
| 53 | `/add-dir <path>` |  | Ajouter un répertoire de travail pour l'accès aux fichiers pendant la session courante. La plupart de la configuration `.claude/` n'est pas découverte depuis le répertoire ajouté |
|
||||
| 54 | `/diff` |  | Ouvrir une visionneuse de diff interactive montrant les changements non committés et les diffs par tour. Utilise les flèches gauche/droite pour basculer entre le diff git actuel et les tours individuels de Claude, et haut/bas pour parcourir les fichiers |
|
||||
| 55 | `/init` |  | Initialiser le projet avec un guide `CLAUDE.md`. Définis `CLAUDE_CODE_NEW_INIT=1` pour un flux interactif qui couvre aussi les skills, hooks et fichiers de mémoire personnelle |
|
||||
| 56 | `/review` |  | Relire une pull request localement dans ta session courante. Pour une revue cloud plus approfondie, voir `/ultrareview` |
|
||||
| 57 | `/security-review` |  | Analyser les changements en attente sur la branche courante à la recherche de vulnérabilités de sécurité. Relit le diff git et identifie les risques comme l'injection, les problèmes d'auth et l'exposition de données |
|
||||
| 58 | `/team-onboarding` |  | Générer un guide d'onboarding d'équipe à partir de ton historique d'usage Claude Code. Analyse les sessions, commandes et usage de serveurs MCP des 30 derniers jours |
|
||||
| 59 | `/ultrareview [PR]` |  | Lancer une revue de code multi-agents approfondie de la pull request donnée dans un sandbox cloud. Produit une revue structurée avec des constats priorisés ; complète la commande locale `/review` |
|
||||
| 60 | `/autofix-pr [prompt]` |  | Lancer une session Claude Code on the web qui surveille la PR de la branche courante et pousse des correctifs quand la CI échoue ou que des relecteurs laissent des commentaires. Détecte la PR ouverte depuis ta branche checkoutée avec `gh pr view` ; pour surveiller une autre PR, checkout sa branche d'abord. Requiert le CLI `gh` et l'accès à Claude Code on the web |
|
||||
| 61 | `/desktop` |  | Continuer la session courante dans l'app Claude Code Desktop. macOS et Windows uniquement. Alias : `/app` |
|
||||
| 62 | `/install-github-app` |  | Configurer l'app Claude GitHub Actions pour un dépôt. Te guide pour sélectionner un dépôt et configurer l'intégration |
|
||||
| 63 | `/install-slack-app` |  | Installer l'app Claude Slack. Ouvre un navigateur pour compléter le flux OAuth |
|
||||
| 64 | `/mobile` |  | Afficher un QR code pour télécharger l'app mobile Claude. Alias : `/ios`, `/android` |
|
||||
| 65 | `/remote-control` |  | Rendre cette session disponible pour le contrôle à distance depuis claude.ai. Alias : `/rc` |
|
||||
| 66 | `/remote-env` |  | Configurer l'environnement distant par défaut pour les sessions web démarrées avec `--remote` |
|
||||
| 67 | `/schedule [description]` |  | Créer, mettre à jour, lister ou exécuter des routines. Claude te guide dans la configuration de façon conversationnelle. Alias : `/routines` |
|
||||
| 68 | `/teleport` |  | Rapatrier une session Claude Code on the web dans ce terminal : ouvre un sélecteur, puis récupère la branche et la conversation. Aussi disponible comme `/tp`. Requiert un abonnement claude.ai |
|
||||
| 69 | `/web-setup` |  | Connecter ton compte GitHub à Claude Code on the web avec tes identifiants `gh` CLI locaux. `/schedule` le demande automatiquement si GitHub n'est pas connecté |
|
||||
| 70 | `/background [prompt]` |  | Détacher la session courante pour l'exécuter comme agent en arrière-plan et libérer ce terminal. Alias : `/bg` |
|
||||
| 71 | `/branch [name]` |  | Créer une branche de la conversation courante à ce point. Alias : `/fork`. Quand `CLAUDE_CODE_FORK_SUBAGENT` est défini, `/fork` crée plutôt un sous-agent forké et n'est plus un alias de cette commande |
|
||||
| 72 | `/btw <question>` |  | Poser une question annexe rapide sans l'ajouter à la conversation |
|
||||
| 73 | `/clear` |  | Démarrer une nouvelle conversation avec un contexte vide. La conversation précédente reste disponible dans `/resume`. Pour libérer du contexte tout en continuant la même conversation, utilise plutôt `/compact`. Alias : `/reset`, `/new` |
|
||||
| 74 | `/compact [instructions]` |  | Compacter la conversation avec des instructions de focus optionnelles |
|
||||
| 75 | `/exit` |  | Quitter le CLI. Alias : `/quit` |
|
||||
| 76 | `/goal [condition\|clear]` |  | Définir un objectif — Claude continue de travailler tour après tour jusqu'à ce que la condition soit remplie. Passe `clear` pour retirer un objectif existant |
|
||||
| 77 | `/recap` |  | Générer à la demande un résumé d'une ligne de la session courante, sans affecter la conversation en cours |
|
||||
| 78 | `/rename [name]` |  | Renommer la session courante et afficher le nom sur la barre de prompt. Sans nom, en génère un automatiquement à partir de l'historique de conversation |
|
||||
| 79 | `/resume [session]` |  | Reprendre une conversation par ID ou nom, ou ouvrir le sélecteur de session. Alias : `/continue` |
|
||||
| 80 | `/rewind` |  | Revenir en arrière dans la conversation et/ou le code jusqu'à un point précédent, ou résumer à partir d'un message sélectionné. Voir le checkpointing. Alias : `/checkpoint`, `/undo` |
|
||||
| 81 | `/stop` |  | Arrêter la session d'arrière-plan courante. Le transcript et le worktree sont conservés |
|
||||
| 82 | `/workflows` |  | Ouvrir la vue de progression des workflows pour observer, mettre en pause, reprendre ou sauvegarder les workflows en cours et terminés |
|
||||
|
||||
Des skills fournis comme `/debug` peuvent aussi apparaître dans le menu des commandes slash, mais ce ne sont pas des commandes intégrées.
|
||||
|
||||
---
|
||||
|
||||
## Sources
|
||||
|
||||
- [Commandes slash Claude Code](https://code.claude.com/docs/en/slash-commands)
|
||||
- [Mode interactif Claude Code](https://code.claude.com/docs/en/interactive-mode)
|
||||
- [CHANGELOG Claude Code](https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md)
|
||||
@@ -0,0 +1,132 @@
|
||||
# Bonnes pratiques — Serveurs MCP
|
||||
|
||||
<br>
|
||||
[](../../.mcp.json)
|
||||
|
||||
Les serveurs MCP (Model Context Protocol) étendent Claude Code avec des connexions vers des outils, bases de données et API externes. Ce guide couvre les serveurs recommandés pour l'usage quotidien et les bonnes pratiques de configuration.
|
||||
|
||||
<table width="100%">
|
||||
<tr>
|
||||
<td><a href="../">← Retour à Claude Code Best Practice</a></td>
|
||||
<td align="right"><img src="../../!/claude-jumping.svg" alt="Claude" width="60" /></td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
---
|
||||
|
||||
## Serveurs MCP pour l'usage quotidien
|
||||
|
||||
> *« J'ai exagéré avec 15 serveurs MCP en pensant que plus = mieux. Au final je n'en utilisais que 4 au quotidien. »* — [r/mcp](https://reddit.com/r/mcp/comments/1mj0fxs/) (682 upvotes)
|
||||
|
||||
| Serveur MCP | Ce qu'il fait | Ressources |
|
||||
|------------|-------------|-----------|
|
||||
| [**Context7**](https://github.com/upstash/context7) | Récupère la documentation à jour des bibliothèques en contexte. Évite les API hallucinées issues de données d'entraînement périmées | [Reddit : « de loin le meilleur MCP pour le code »](https://reddit.com/r/mcp/comments/1qarjqm/) · [npm](https://www.npmjs.com/package/@upstash/context7-mcp) |
|
||||
| [**Playwright**](https://github.com/microsoft/playwright-mcp) | Automatisation du navigateur — implémente, teste et vérifie des fonctionnalités UI de façon autonome. Captures d'écran, navigation, test de formulaires | [Reddit : essentiel pour le frontend](https://reddit.com/r/mcp/comments/1m59pk0/) · [Docs](https://playwright.dev/) |
|
||||
| [**Claude in Chrome**](https://github.com/nicobailon/claude-code-in-chrome-mcp) | Connecte Claude à ton vrai navigateur Chrome — inspecte la console, le réseau, le DOM. Débogue ce que les utilisateurs voient réellement | [Reddit : « changement radical » pour le débogage](https://reddit.com/r/mcp/comments/1qarjqm/5_mcps_that_have_genuinely_made_me_10x_faster/nza0i7t/) · [Rapport comparatif](../reports/claude-in-chrome-v-chrome-devtools-mcp.md) |
|
||||
| [**DeepWiki**](https://github.com/devanshusemwal/deepwiki-mcp) | Récupère une documentation structurée de type wiki pour n'importe quel dépôt GitHub — architecture, surface d'API, relations | [Reddit : « place-le derrière une gateway avec Context7 »](https://reddit.com/r/mcp/comments/1qarjqm/) |
|
||||
| [**Excalidraw**](https://github.com/antonpk1/excalidraw-mcp-app) | Génère des diagrammes d'architecture, organigrammes et designs de systèmes sous forme de croquis Excalidraw dessinés à la main, à partir de prompts | [GitHub](https://github.com/antonpk1/excalidraw-mcp-app) |
|
||||
|
||||
Recherche (Context7/DeepWiki) -> Débogage (Playwright/Chrome) -> Documentation (Excalidraw)
|
||||
|
||||
---
|
||||
|
||||
## Configuration
|
||||
|
||||
Les serveurs MCP se configurent dans `.mcp.json` à la racine du projet (portée projet) ou dans `~/.claude.json` (portée utilisateur).
|
||||
|
||||
### Types de serveurs
|
||||
|
||||
| Type | Transport | Exemple |
|
||||
|------|-----------|---------|
|
||||
| **stdio** | Lance un processus local | `npx`, `python`, binaire |
|
||||
| **http** | Se connecte à une URL distante | endpoint HTTP/SSE |
|
||||
|
||||
### Exemple de `.mcp.json`
|
||||
|
||||
```json
|
||||
{
|
||||
"mcpServers": {
|
||||
"context7": {
|
||||
"command": "npx",
|
||||
"args": ["-y", "@upstash/context7-mcp"]
|
||||
},
|
||||
"playwright": {
|
||||
"command": "npx",
|
||||
"args": ["-y", "@playwright/mcp"]
|
||||
},
|
||||
"deepwiki": {
|
||||
"command": "npx",
|
||||
"args": ["-y", "deepwiki-mcp"]
|
||||
},
|
||||
"remote-api": {
|
||||
"type": "http",
|
||||
"url": "https://mcp.example.com/mcp"
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
Utilise l'expansion de variables d'environnement pour les secrets au lieu de committer des clés API dans `.mcp.json` :
|
||||
|
||||
```json
|
||||
{
|
||||
"mcpServers": {
|
||||
"remote-api": {
|
||||
"type": "http",
|
||||
"url": "https://mcp.example.com/mcp?token=${MCP_API_TOKEN}"
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Paramètres pour les serveurs MCP
|
||||
|
||||
Ces paramètres dans `.claude/settings.json` contrôlent l'approbation des serveurs MCP :
|
||||
|
||||
| Clé | Type | Description |
|
||||
|-----|------|-------------|
|
||||
| `enableAllProjectMcpServers` | boolean | Auto-approuve tous les serveurs de `.mcp.json` sans demande |
|
||||
| `enabledMcpjsonServers` | array | Allowlist de noms de serveurs spécifiques à auto-approuver |
|
||||
| `disabledMcpjsonServers` | array | Blocklist de noms de serveurs spécifiques à rejeter |
|
||||
|
||||
### Règles de permission pour les outils MCP
|
||||
|
||||
Les outils MCP suivent la convention de nommage `mcp__<server>__<tool>` dans les règles de permission :
|
||||
|
||||
```json
|
||||
{
|
||||
"permissions": {
|
||||
"allow": [
|
||||
"mcp__*",
|
||||
"mcp__context7__*",
|
||||
"mcp__playwright__browser_snapshot"
|
||||
],
|
||||
"deny": [
|
||||
"mcp__dangerous-server__*"
|
||||
]
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Portées MCP
|
||||
|
||||
Les serveurs MCP peuvent être définis à trois niveaux :
|
||||
|
||||
| Portée | Emplacement | Objectif |
|
||||
|-------|----------|---------|
|
||||
| **Projet** | `.mcp.json` (racine du dépôt) | Serveurs partagés en équipe, committés dans git |
|
||||
| **Utilisateur** | `~/.claude.json` (clé `mcpServers`) | Serveurs personnels sur tous les projets |
|
||||
| **Sous-agent** | Frontmatter de l'agent (champ `mcpServers`) | Serveurs limités à un sous-agent spécifique |
|
||||
|
||||
Priorité : Sous-agent > Projet > Utilisateur
|
||||
|
||||
---
|
||||
|
||||
## Sources
|
||||
|
||||
- [Serveurs MCP — Documentation Claude Code](https://code.claude.com/docs/en/mcp)
|
||||
- [Spécification du Model Context Protocol](https://modelcontextprotocol.io/)
|
||||
- [5 MCP qui m'ont vraiment rendu 10× plus rapide — r/mcp](https://reddit.com/r/mcp/comments/1qarjqm/)
|
||||
- [Discussion sur la surcharge de serveurs MCP — r/mcp](https://reddit.com/r/mcp/comments/1mj0fxs/)
|
||||
@@ -0,0 +1,121 @@
|
||||
# Mémoire de Claude
|
||||
|
||||
Contexte persistant via les fichiers CLAUDE.md — comment les écrire et comment ils se chargent dans les monorepos.
|
||||
|
||||
<table width="100%">
|
||||
<tr>
|
||||
<td><a href="../">← Retour à Claude Code Best Practice</a></td>
|
||||
<td align="right"><img src="../../!/claude-jumping.svg" alt="Claude" width="60" /></td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
---
|
||||
|
||||
## 1. Écrire un bon CLAUDE.md
|
||||
|
||||
Un CLAUDE.md bien structuré est le moyen le plus impactant d'améliorer la sortie de Claude Code pour ton projet. Humanlayer propose un excellent guide couvrant ce qu'il faut inclure, comment le structurer et les pièges courants.
|
||||
|
||||
- [Humanlayer - Writing a good Claude.md](https://www.humanlayer.dev/blog/writing-a-good-claude-md)
|
||||
|
||||
---
|
||||
|
||||
## 2. CLAUDE.md dans les grands monorepos
|
||||
|
||||
Quand tu travailles avec Claude Code dans un monorepo, comprendre comment les fichiers CLAUDE.md se chargent en contexte est crucial pour organiser efficacement les instructions de ton projet.
|
||||
|
||||
<p align="center">
|
||||
<a href="https://x.com/bcherny/status/2016339448863355206"><img src="../../best-practice/assets/claude-memory/claude-memory-monorepo.jpg" alt="Chargement des CLAUDE.md dans les monorepos" width="600"></a>
|
||||
</p>
|
||||
|
||||
### Les deux mécanismes de chargement
|
||||
|
||||
Claude Code utilise deux mécanismes distincts pour charger les fichiers CLAUDE.md :
|
||||
|
||||
#### Chargement des ancêtres (vers le HAUT de l'arborescence)
|
||||
|
||||
Quand tu démarres Claude Code, il remonte **vers le haut** depuis ton répertoire de travail courant jusqu'à la racine du système de fichiers et charge chaque CLAUDE.md qu'il trouve en chemin. Ces fichiers sont chargés **immédiatement au démarrage**.
|
||||
|
||||
#### Chargement des descendants (vers le BAS de l'arborescence)
|
||||
|
||||
Les fichiers CLAUDE.md dans les sous-répertoires situés sous ton répertoire de travail courant **NE sont PAS chargés au lancement**. Ils ne sont inclus que lorsque Claude lit des fichiers dans ces sous-répertoires durant ta session. C'est ce qu'on appelle le **chargement paresseux** (lazy loading).
|
||||
|
||||
### Exemple de structure de monorepo
|
||||
|
||||
Considère un monorepo typique avec des répertoires séparés pour différents composants :
|
||||
|
||||
```
|
||||
/mymonorepo/
|
||||
├── CLAUDE.md # Instructions racine (partagées entre tous les composants)
|
||||
├── frontend/
|
||||
│ └── CLAUDE.md # Instructions spécifiques au frontend
|
||||
├── backend/
|
||||
│ └── CLAUDE.md # Instructions spécifiques au backend
|
||||
└── api/
|
||||
└── CLAUDE.md # Instructions spécifiques à l'API
|
||||
```
|
||||
|
||||
### Scénario 1 : Lancer Claude Code depuis le répertoire racine
|
||||
|
||||
Quand tu lances Claude Code depuis `/mymonorepo/` :
|
||||
|
||||
```bash
|
||||
cd /mymonorepo
|
||||
claude
|
||||
```
|
||||
|
||||
| Fichier | Chargé au lancement ? | Raison |
|
||||
|------|-------------------|--------|
|
||||
| `/mymonorepo/CLAUDE.md` | Oui | C'est ton répertoire de travail courant |
|
||||
| `/mymonorepo/frontend/CLAUDE.md` | Non | Chargé seulement quand tu lis/édites des fichiers dans `frontend/` |
|
||||
| `/mymonorepo/backend/CLAUDE.md` | Non | Chargé seulement quand tu lis/édites des fichiers dans `backend/` |
|
||||
| `/mymonorepo/api/CLAUDE.md` | Non | Chargé seulement quand tu lis/édites des fichiers dans `api/` |
|
||||
|
||||
### Scénario 2 : Lancer Claude Code depuis un répertoire de composant
|
||||
|
||||
Quand tu lances Claude Code depuis `/mymonorepo/frontend/` :
|
||||
|
||||
```bash
|
||||
cd /mymonorepo/frontend
|
||||
claude
|
||||
```
|
||||
|
||||
| Fichier | Chargé au lancement ? | Raison |
|
||||
|------|-------------------|--------|
|
||||
| `/mymonorepo/CLAUDE.md` | Oui | C'est un répertoire ancêtre |
|
||||
| `/mymonorepo/frontend/CLAUDE.md` | Oui | C'est ton répertoire de travail courant |
|
||||
| `/mymonorepo/backend/CLAUDE.md` | Non | Branche différente de l'arborescence |
|
||||
| `/mymonorepo/api/CLAUDE.md` | Non | Branche différente de l'arborescence |
|
||||
|
||||
### Points clés à retenir
|
||||
|
||||
1. **Les ancêtres se chargent toujours au démarrage** — Claude remonte l'arborescence et charge tous les CLAUDE.md qu'il trouve. Cela garantit que tu as toujours accès aux instructions racine, valables pour tout le dépôt.
|
||||
|
||||
2. **Les descendants se chargent paresseusement** — Les CLAUDE.md de sous-répertoire ne se chargent que lorsque tu interagis avec des fichiers dans ces sous-répertoires. Cela évite que du contexte non pertinent ne gonfle ta session.
|
||||
|
||||
3. **Les frères ne se chargent jamais** — Si tu travailles dans `frontend/`, tu n'auras pas `backend/CLAUDE.md` ni `api/CLAUDE.md` chargés en contexte.
|
||||
|
||||
4. **CLAUDE.md global** — Tu peux aussi placer un CLAUDE.md dans `~/.claude/CLAUDE.md` dans ton dossier personnel, qui s'applique à TOUTES les sessions Claude Code, quel que soit le projet.
|
||||
|
||||
### Pourquoi ce design fonctionne pour les monorepos
|
||||
|
||||
- **Les instructions partagées se propagent vers le bas** — Le CLAUDE.md racine contient les conventions valables pour tout le dépôt, les standards de code et les patterns communs qui s'appliquent partout.
|
||||
|
||||
- **Les instructions spécifiques aux composants restent isolées** — Les développeurs frontend n'ont pas besoin que des instructions spécifiques au backend encombrent leur contexte, et inversement.
|
||||
|
||||
- **Le contexte est optimisé** — En chargeant paresseusement les CLAUDE.md descendants, Claude Code évite de charger potentiellement des centaines de kilo-octets d'instructions non pertinentes au démarrage.
|
||||
|
||||
### Bonnes pratiques
|
||||
|
||||
1. **Mets les conventions partagées dans le CLAUDE.md racine** — Standards de code, formats de messages de commit, templates de PR, et autres directives valables pour tout le dépôt.
|
||||
|
||||
2. **Mets les instructions spécifiques aux composants dans le CLAUDE.md du composant** — Patterns propres au framework, architecture du composant, conventions de test propres à ce composant.
|
||||
|
||||
3. **Utilise CLAUDE.local.md pour les préférences personnelles** — Ajoute-le à `.gitignore` pour les instructions qui ne devraient pas être partagées avec l'équipe.
|
||||
|
||||
---
|
||||
|
||||
## Sources
|
||||
|
||||
- [Documentation Claude Code - Comment Claude recherche les mémoires](https://code.claude.com/docs/en/memory#how-claude-looks-up-memories)
|
||||
- [Boris Cherny sur X - Clarification sur le chargement des CLAUDE.md](https://x.com/bcherny/status/2016339448863355206)
|
||||
- [Humanlayer - Writing a good Claude.md](https://www.humanlayer.dev/blog/writing-a-good-claude-md)
|
||||
@@ -0,0 +1,66 @@
|
||||
# Bonnes pratiques — Power-ups
|
||||
|
||||
|
||||
|
||||
Leçons interactives qui enseignent les fonctionnalités de Claude Code avec des démos animées. Chaque power-up enseigne une chose que Claude Code sait faire et que la plupart des gens ignorent. Introduit en v2.1.90.
|
||||
|
||||
<table width="100%">
|
||||
<tr>
|
||||
<td><a href="../">← Retour à Claude Code Best Practice</a></td>
|
||||
<td align="right"><img src="../../!/claude-jumping.svg" alt="Claude" width="60" /></td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
---
|
||||
|
||||
## Utilisation
|
||||
|
||||
```bash
|
||||
claude
|
||||
/powerup
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Power-ups (10)
|
||||
|
||||
<p align="center">
|
||||
<img src="../../best-practice/assets/claude-power-ups/powerup-menu.png" alt="Menu des power-ups montrant 10 leçons" width="700">
|
||||
</p>
|
||||
|
||||
| # | Power-up | Sujets |
|
||||
|---|----------|--------|
|
||||
| 1 | Dialogue avec ton codebase | fichiers `@`, références de lignes |
|
||||
| 2 | Pilote avec les modes | `shift+tab`, plan, auto |
|
||||
| 3 | Annule n'importe quoi | `/rewind`, `Esc-Esc` |
|
||||
| 4 | Exécute en arrière-plan | tâches, `/tasks` |
|
||||
| 5 | Enseigne tes règles à Claude | `CLAUDE.md`, `/memory` |
|
||||
| 6 | Étends avec des outils | MCP, `/mcp` |
|
||||
| 7 | Automatise ton workflow | skills, hooks |
|
||||
| 8 | Démultiplie-toi | sous-agents, `/agents` |
|
||||
| 9 | Code depuis n'importe où | `/remote-control`, `/teleport` |
|
||||
| 10 | Règle le modèle | `/model`, `/effort` |
|
||||
|
||||
---
|
||||
|
||||
## Exemple : Régler le modèle
|
||||
|
||||
Le dernier power-up enseigne le changement de modèle et le contrôle de l'effort avec une démo animée.
|
||||
|
||||
<p align="center">
|
||||
<img src="../../best-practice/assets/claude-power-ups/dial-the-model-1.png" alt="Régler le modèle — démo réflexion approfondie" width="700">
|
||||
</p>
|
||||
|
||||
<p align="center">
|
||||
<img src="../../best-practice/assets/claude-power-ups/dial-the-model-2.png" alt="Régler le modèle — démo affichant des hypothèses" width="700">
|
||||
</p>
|
||||
|
||||
<p align="center">
|
||||
<img src="../../best-practice/assets/claude-power-ups/dial-the-model-3.png" alt="Régler le modèle — démo réglant l'effort sur high" width="700">
|
||||
</p>
|
||||
|
||||
---
|
||||
|
||||
## Sources
|
||||
|
||||
- [Changelog — v2.1.90](https://code.claude.com/docs/en/changelog)
|
||||
File diff suppressed because it is too large
Load Diff
@@ -0,0 +1,63 @@
|
||||
# Bonnes pratiques — Skills
|
||||
|
||||
 <br>
|
||||
[](../implementation/claude-skills-implementation.md)
|
||||
|
||||
Skills Claude Code — champs de frontmatter et skills officiels fournis.
|
||||
|
||||
<table width="100%">
|
||||
<tr>
|
||||
<td><a href="../">← Retour à Claude Code Best Practice</a></td>
|
||||
<td align="right"><img src="../../!/claude-jumping.svg" alt="Claude" width="60" /></td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
---
|
||||
|
||||
## Champs de frontmatter (16)
|
||||
|
||||
| Champ | Type | Requis | Description |
|
||||
|-------|------|----------|-------------|
|
||||
| `name` | string | Non | Nom d'affichage et identifiant `/slash-command`. Par défaut le nom du répertoire si omis |
|
||||
| `description` | string | Recommandé | Ce que fait le skill. Affiché en autocomplétion et utilisé par Claude pour l'auto-découverte |
|
||||
| `when_to_use` | string | Non | Contexte additionnel indiquant quand Claude doit invoquer le skill — phrases déclencheuses et exemples de requêtes. Ajouté à `description` dans la liste des skills, compte dans la limite de 1 536 caractères |
|
||||
| `argument-hint` | string | Non | Indice affiché pendant l'autocomplétion (par ex. `[issue-number]`, `[filename]`) |
|
||||
| `arguments` | string/list | Non | Arguments positionnels nommés pour la substitution `$name` dans le contenu du skill. Accepte une chaîne séparée par des espaces ou une liste YAML — les noms correspondent aux positions des arguments dans l'ordre |
|
||||
| `disable-model-invocation` | boolean | Non | Mets `true` pour empêcher Claude d'invoquer automatiquement ce skill |
|
||||
| `user-invocable` | boolean | Non | Mets `false` pour masquer du menu `/` — le skill devient connaissance d'arrière-plan uniquement, destiné au préchargement par un agent |
|
||||
| `allowed-tools` | string | Non | Outils autorisés sans demande de permission quand ce skill est actif |
|
||||
| `disallowed-tools` | string/list | Non | Outils retirés du pool disponible de Claude tant que le skill est actif (par ex. bloquer `AskUserQuestion` pour une boucle en arrière-plan). Accepte une chaîne séparée par espaces/virgules ou une liste YAML — la restriction se lève au message suivant |
|
||||
| `model` | string | Non | Modèle à utiliser quand ce skill s'exécute (par ex. `haiku`, `sonnet`, `opus`) |
|
||||
| `effort` | string | Non | Surcharge le niveau d'effort du modèle à l'invocation (`low`, `medium`, `high`, `xhigh`, `max`) |
|
||||
| `context` | string | Non | Mets `fork` pour exécuter le skill dans un contexte de sous-agent isolé |
|
||||
| `agent` | string | Non | Type de sous-agent quand `context: fork` est défini (défaut : `general-purpose`) |
|
||||
| `hooks` | object | Non | Hooks de cycle de vie limités à ce skill |
|
||||
| `paths` | string/list | Non | Motifs glob qui limitent quand le skill s'auto-active. Accepte une chaîne séparée par des virgules ou une liste YAML — Claude charge le skill uniquement quand il travaille sur des fichiers correspondants |
|
||||
| `shell` | string | Non | Shell pour les blocs `` !`command` `` — `bash` (défaut) ou `powershell`. Requiert `CLAUDE_CODE_USE_POWERSHELL_TOOL=1` |
|
||||
|
||||
---
|
||||
|
||||
##  **(10)**
|
||||
|
||||
| # | Skill | Description |
|
||||
|---|-------|-------------|
|
||||
| 1 | `code-review` | Relit le diff courant à la recherche de bugs de correction au niveau d'effort choisi (low/medium : moins de constats, à forte confiance ; high→max : couverture plus large) — `--comment` poste les constats en commentaires inline sur la PR |
|
||||
| 2 | `batch` | Exécute des commandes sur plusieurs fichiers en masse |
|
||||
| 3 | `debug` | Débogue des commandes en échec ou des problèmes de code |
|
||||
| 4 | `loop` | Exécute un prompt ou une commande slash à intervalle récurrent (jusqu'à 3 jours) |
|
||||
| 5 | `claude-api` | Construit des apps avec l'API Claude ou le SDK Anthropic — se déclenche sur les imports `anthropic` / `@anthropic-ai/sdk` |
|
||||
| 6 | `fewer-permission-prompts` | Parcourt les transcripts à la recherche d'appels Bash/MCP en lecture seule courants et ajoute une allowlist priorisée à `.claude/settings.json` pour réduire les demandes de permission |
|
||||
| 7 | `run` | Lance et pilote l'app du projet pour voir un changement fonctionner dans l'app réelle (pas seulement les tests). Requiert v2.1.145 |
|
||||
| 8 | `verify` | Build et lance l'app pour confirmer qu'un changement de code fait ce qu'il doit, sans se rabattre sur les tests ou la vérification de types. Requiert v2.1.145 |
|
||||
| 9 | `run-skill-generator` | Apprend à `/run` et `/verify` comment construire et lancer le projet — enregistre une recette de lancement par projet dans `.claude/skills/run-<name>/`. Requiert v2.1.145 |
|
||||
| 10 | `simplify` | Relit le code modifié pour repérer les opportunités de nettoyage (réutilisation, simplification, efficacité, niveau d'abstraction), quatre agents de revue en parallèle. Depuis v2.1.154, il ne traque **pas** les bugs de correction — utilise `/code-review` pour cela |
|
||||
|
||||
Voir aussi : [Dépôt officiel des skills](https://github.com/anthropics/skills/tree/main/skills) pour des skills installables maintenus par la communauté.
|
||||
|
||||
---
|
||||
|
||||
## Sources
|
||||
|
||||
- [Skills Claude Code — Documentation](https://code.claude.com/docs/en/skills)
|
||||
- [Découverte des skills dans les monorepos](../reports/claude-skills-for-larger-mono-repos.md)
|
||||
- [CHANGELOG Claude Code](https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md)
|
||||
@@ -0,0 +1,56 @@
|
||||
# Bonnes pratiques — Sous-agents
|
||||
|
||||
 <br>
|
||||
[](../implementation/claude-subagents-implementation.md)
|
||||
|
||||
Sous-agents Claude Code — champs de frontmatter et types d'agents intégrés officiels.
|
||||
|
||||
<table width="100%">
|
||||
<tr>
|
||||
<td><a href="../">← Retour à Claude Code Best Practice</a></td>
|
||||
<td align="right"><img src="../../!/claude-jumping.svg" alt="Claude" width="60" /></td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
---
|
||||
|
||||
## Champs de frontmatter (16)
|
||||
|
||||
| Champ | Type | Requis | Description |
|
||||
|-------|------|----------|-------------|
|
||||
| `name` | string | Oui | Identifiant unique en lettres minuscules et tirets |
|
||||
| `description` | string | Oui | Quand l'invoquer. Utilise `"PROACTIVELY"` pour une auto-invocation par Claude |
|
||||
| `tools` | string/list | Non | Liste d'autorisation d'outils séparés par des virgules (par ex. `Read, Write, Edit, Bash`). Hérite de tous les outils si omis. Supporte la syntaxe `Agent(agent_type)` pour restreindre les sous-agents instanciables ; l'ancien alias `Task(agent_type)` fonctionne toujours |
|
||||
| `disallowedTools` | string/list | Non | Outils à refuser, retirés de la liste héritée ou spécifiée |
|
||||
| `model` | string | Non | Modèle à utiliser : `sonnet`, `opus`, `haiku`, un ID de modèle complet (par ex. `claude-opus-4-6`), ou `inherit` (défaut : `inherit`) |
|
||||
| `permissionMode` | string | Non | Mode de permissions : `default`, `acceptEdits`, `auto`, `dontAsk`, `bypassPermissions`, ou `plan` |
|
||||
| `maxTurns` | integer | Non | Nombre maximum de tours agentiques avant que le sous-agent ne s'arrête |
|
||||
| `skills` | list | Non | Noms de skills à précharger dans le contexte de l'agent au démarrage (contenu complet injecté, pas seulement rendu disponible) |
|
||||
| `mcpServers` | list | Non | Serveurs MCP pour ce sous-agent — chaînes de noms de serveurs ou objets `{name: config}` inline |
|
||||
| `hooks` | object | Non | Hooks de cycle de vie limités à ce sous-agent. Tous les événements de hook sont supportés ; `PreToolUse`, `PostToolUse` et `Stop` sont les plus courants |
|
||||
| `memory` | string | Non | Portée de la mémoire persistante : `user`, `project`, ou `local` |
|
||||
| `background` | boolean | Non | Mets `true` pour toujours s'exécuter comme tâche en arrière-plan (défaut : `false`) |
|
||||
| `effort` | string | Non | Surcharge du niveau d'effort quand ce sous-agent est actif : `low`, `medium`, `high`, `xhigh`, `max` (Opus 4.6 uniquement). Défaut : hérité de la session |
|
||||
| `isolation` | string | Non | Mets `"worktree"` pour s'exécuter dans un worktree git temporaire (auto-nettoyé si aucun changement) |
|
||||
| `initialPrompt` | string | Non | Auto-soumis comme premier tour utilisateur quand cet agent s'exécute comme agent de la session principale (via `--agent` ou le réglage `agent`). Les commandes et skills sont traités. Préfixé à tout prompt fourni par l'utilisateur |
|
||||
| `color` | string | Non | Couleur d'affichage du sous-agent dans la liste des tâches et le transcript : `red`, `blue`, `green`, `yellow`, `purple`, `orange`, `pink`, ou `cyan` |
|
||||
|
||||
---
|
||||
|
||||
##  **(5)**
|
||||
|
||||
| # | Agent | Modèle | Outils | Description |
|
||||
|---|-------|-------|-------|-------------|
|
||||
| 1 | `general-purpose` | inherit | Tous | Tâches complexes en plusieurs étapes — le type d'agent par défaut pour la recherche, la recherche de code et le travail autonome |
|
||||
| 2 | `Explore` | haiku | Lecture seule (pas de Write, Edit) | Recherche et exploration rapides du codebase — optimisé pour trouver des fichiers, chercher du code et répondre à des questions sur le codebase |
|
||||
| 3 | `Plan` | inherit | Lecture seule (pas de Write, Edit) | Recherche de pré-planification en mode plan — explore le codebase et conçoit des approches d'implémentation avant d'écrire du code |
|
||||
| 4 | `statusline-setup` | sonnet | Read, Edit | Configure le réglage de la barre d'état Claude Code de l'utilisateur |
|
||||
| 5 | `claude-code-guide` | haiku | Glob, Grep, Read, WebFetch, WebSearch | Répond aux questions sur les fonctionnalités de Claude Code, l'Agent SDK et l'API Claude |
|
||||
|
||||
---
|
||||
|
||||
## Sources
|
||||
|
||||
- [Créer des sous-agents personnalisés — Documentation Claude Code](https://code.claude.com/docs/en/sub-agents)
|
||||
- [Référence CLI — Documentation Claude Code](https://code.claude.com/docs/en/cli-reference)
|
||||
- [CHANGELOG Claude Code](https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md)
|
||||
Reference in New Issue
Block a user