Commandes personnalisées et skills - FAQ

Les commandes personnalisées, skills et hooks de Claude Code vous permettent d'automatiser vos workflows de développement et d'enseigner vos patterns à l'IA. Créez des commandes slash custom en quelques minutes, déléguez des tâches à des subagents autonomes et déclenchez des actions déterministes via les hooks pour gagner jusqu'à 40 % de temps sur vos tâches répétitives.

Les commandes personnalisées et skills de Claude Code constituent un système d'extensibilité qui transforme l'agent IA en assistant sur mesure. Claude Code (version 1.0+) propose cinq mécanismes d'extension : les commandes slash custom, les skills, les subagents, les hooks et les intégrations tierces. plus de 60 % des utilisateurs avancés créent au moins une commande personnalisée dans leur première semaine d'utilisation.

Comment créer une commande slash personnalisée dans Claude Code ?

Créez un fichier Markdown dans le répertoire .claude/commands/ de votre projet pour définir une commande slash custom. Chaque fichier .md devient automatiquement une commande accessible via /.

Le nom du fichier détermine le nom de la commande. Par exemple, .claude/commands/review.md crée la commande /review. Vous pouvez organiser vos commandes dans des sous-dossiers pour les regrouper par catégorie.

Voici comment structurer votre première commande :

mkdir -p .claude/commands
touch .claude/commands/review.md

Le contenu du fichier définit le prompt envoyé à Claude Code. Utilisez la variable $ARGUMENTS pour capturer les paramètres passés par l'utilisateur :

Analyse le fichier $ARGUMENTS et vérifie :
1. Les erreurs de typage TypeScript
2. Les failles de sécurité OWASP Top 10
3. La conformité avec nos conventions ESLint
Propose des corrections concrètes avec du code.

Pour des commandes partagées à l'échelle de votre machine, placez-les dans ~/.claude/commands/. Ces commandes globales sont disponibles dans tous vos projets.

En pratique, une commande slash custom réduit un prompt de 200 mots à une invocation de 3 mots. Consultez la référence complète des commandes personnalisées pour découvrir la syntaxe avancée avec variables multiples.

À retenir : une commande slash custom est un fichier Markdown dans .claude/commands/ - un fichier = une commande.

Quels sont les cas d'usage les plus courants des commandes custom ?

Les commandes custom couvrent quatre catégories principales : la revue de code, la génération de tests, la documentation et le déploiement.

Voici concrètement les commandes les plus créées par les équipes de développement :

# .claude/commands/test-unit.md
Génère des tests unitaires pour $ARGUMENTS en utilisant :
- Framework : Vitest
- Pattern : AAA (Arrange, Act, Assert)
- Couverture : branches et edge cases
- Mocks : vi.mock pour les dépendances externes

# .claude/commands/doc-api.md
Documente l'endpoint API dans $ARGUMENTS :
- Méthode HTTP et URL
- Paramètres requis et optionnels
- Codes de réponse (200, 400, 401, 500)
- Exemple curl fonctionnel

les équipes qui adoptent au moins 5 commandes custom réduisent de 35 % le temps consacré aux tâches de revue de code. Les commandes slash essentielles fournissent une base solide avant de créer vos propres variantes.

À retenir : concentrez vos commandes custom sur les tâches que vous répétez plus de 3 fois par semaine.

Comment fonctionnent les skills dans Claude Code ?

Les skills sont des fichiers Markdown chargés automatiquement par Claude Code pour lui enseigner vos conventions, patterns et préférences de codage. Ajoutez vos skills dans le fichier CLAUDE.md à la racine de votre projet ou dans des fichiers CLAUDE.md imbriqués par répertoire.

Un skill diffère d'une commande slash : la commande est invoquée explicitement, tandis que le skill est lu et appliqué automatiquement à chaque session. Le système de mémoire CLAUDE.md détaille l'architecture complète de cette mémoire persistante.

Voici comment déclarer un skill dans votre CLAUDE.md :

# Conventions de code

## TypeScript
- Utiliser des interfaces plutôt que des types pour les objets
- Nommer les fichiers en kebab-case
- Préfixer les interfaces par I (IUser, IProduct)
- Toujours utiliser des enums string pour les statuts

## Tests
- Un fichier de test par fichier source
- Nommer les tests : "should [action] when [condition]"
- Minimum 80% de couverture de branches

En pratique, un fichier CLAUDE.md de 50 lignes suffit à aligner Claude Code sur 90 % de vos conventions d'équipe. Le skill est appliqué dès le démarrage de la session, sans action de votre part.

À retenir : les skills dans CLAUDE.md enseignent vos patterns à Claude Code - il les applique automatiquement sans invocation.

Peut-on utiliser des subagents pour paralléliser les tâches ?

Lancez des subagents avec l'outil Task de Claude Code pour exécuter plusieurs tâches en parallèle et diviser le travail complexe. Un subagent est une instance autonome de Claude qui traite une sous-tâche spécifique.

Les subagents disposent de leur propre contexte et peuvent lire des fichiers, exécuter des commandes et produire des résultats. Vous pouvez en lancer plusieurs simultanément pour des tâches indépendantes. Concrètement, un subagent de type Explore recherche dans votre codebase pendant qu'un autre de type general-purpose implémente une fonctionnalité.

Voici les types de subagents disponibles en février 2026 :

En pratique, lancer 3 subagents en parallèle pour analyser un projet de 50 000 lignes prend environ 45 secondes contre 3 minutes en séquentiel. Découvrez comment le coding agentique exploite cette parallélisation pour résoudre des problèmes complexes.

À retenir : les subagents divisent le travail - lancez-en plusieurs en parallèle pour les tâches indépendantes.

Comment configurer les hooks pour automatiser des actions ?

Les hooks sont des commandes shell exécutées automatiquement par Claude Code en réponse à des événements précis. Configurez-les dans le fichier .claude/settings.json de votre projet.

Un hook se déclenche de manière déterministe, sans intervention de l'IA. C'est la différence fondamentale avec une commande ou un skill : le hook est une automatisation fiable et reproductible à 100 %.

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit",
        "command": "npx eslint --fix $CLAUDE_FILE_PATH"
      }
    ],
    "PreToolUse": [
      {
        "matcher": "Bash",
        "command": "echo 'Commande bash détectée'"
      }
    ]
  }
}

les hooks supportent quatre événements : PreToolUse, PostToolUse, Notification et Stop. Chaque hook reçoit des variables d'environnement contextuelles comme $CLAUDE_FILE_PATH.

Vous pouvez chaîner plusieurs hooks sur le même événement. Vérifiez que vos scripts de hook retournent un code de sortie 0 pour indiquer le succès. Un code non-zéro bloque l'action en cours. Pour approfondir la sécurité de ces automatisations, consultez la FAQ sur les permissions et la sécurité.

À retenir : les hooks automatisent des actions déterministes sur des événements précis - zéro IA, 100 % fiable.

Quels fichiers de configuration contrôlent les commandes et skills ?

Cinq fichiers et répertoires principaux gouvernent l'extensibilité de Claude Code. Vérifiez leur présence avec la commande suivante :

ls -la .claude/commands/ CLAUDE.md .claude/settings.json

Le fichier CLAUDE.md à la racine est le point d'entrée des skills. Le répertoire .claude/commands/ contient vos commandes slash. Le fichier .claude/settings.json configure les hooks et les permissions.

Voici concrètement l'arborescence type d'un projet bien configuré :

mon-projet/
├── CLAUDE.md                    # Skills globaux du projet
├── .claude/
│   ├── commands/
│   │   ├── review.md            # /review
│   │   ├── test-unit.md         # /test-unit
│   │   └── deploy/
│   │       └── staging.md       # /deploy:staging
│   └── settings.json            # Hooks et permissions
├── src/
│   └── CLAUDE.md                # Skills spécifiques à src/
└── tests/
    └── CLAUDE.md                # Skills spécifiques aux tests

Le guide d'installation et premier lancement explique comment initialiser cette structure dès la première utilisation de Claude Code. Consultez aussi les astuces pour les commandes personnalisées pour optimiser votre arborescence.

À retenir : cinq fichiers structurent vos extensions - CLAUDE.md, .claude/commands/, .claude/settings.json et leurs variantes par répertoire.

Comment partager des commandes custom avec son équipe ?

Committez le répertoire .claude/commands/ dans votre dépôt Git pour partager vos commandes avec toute l'équipe. Chaque développeur qui clone le projet obtient automatiquement les mêmes commandes slash.

Concrètement, votre fichier .gitignore ne doit PAS exclure .claude/commands/. En revanche, ajoutez .claude/settings.local.json au .gitignore pour les configurations personnelles.

# .gitignore recommandé pour Claude Code
.claude/settings.local.json
# NE PAS ignorer :
# .claude/commands/
# CLAUDE.md

Les équipes de plus de 5 développeurs adoptent souvent un processus de revue pour les nouvelles commandes. Vous créez une pull request qui ajoute un fichier dans .claude/commands/, l'équipe la review comme du code standard. cette pratique réduit de 25 % la divergence des pratiques au sein d'une équipe.

Pour aller plus loin dans la gestion d'équipe des commandes, consultez l'aide-mémoire des commandes personnalisées qui résume toutes les bonnes pratiques de partage.

À retenir : committez .claude/commands/ dans Git - vos commandes deviennent un standard d'équipe versionné.

Y a-t-il un marketplace de plugins pour Claude Code ?

Claude Code ne dispose pas d'un marketplace centralisé de plugins comme VS Code. L'extensibilité repose sur les commandes custom, les skills et les hooks.

La communauté partage néanmoins des commandes et configurations via des dépôts GitHub publics. Vous trouverez des collections de commandes prêtes à l'emploi pour le testing, le refactoring et la documentation.

L'intégration avec le protocole MCP (Model Context Protocol) permet de connecter Claude Code à des serveurs d'outils externes. MCP est un standard ouvert publié par Anthropic en 2024 qui unifie la communication entre les agents IA et les sources de données.

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"]
    },
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"]
    }
  }
}

En pratique, plus de 150 serveurs MCP sont disponibles sur npm en février 2026. Chaque serveur ajoute des outils spécialisés : accès à une base de données, navigation web, gestion de fichiers cloud. Pour comprendre comment ces intégrations s'inscrivent dans le paradigme agentique, consultez la FAQ sur le coding agentique.

À retenir : pas de marketplace centralisé, mais MCP et les dépôts communautaires offrent un écosystème d'extensions en croissance rapide.

Comment déboguer une commande custom qui ne fonctionne pas ?

Exécutez la commande / dans Claude Code pour lister toutes les commandes détectées et identifier immédiatement si votre fichier est reconnu.

Trois causes couvrent 90 % des erreurs sur les commandes custom : un chemin de fichier incorrect, une extension .md manquante ou un problème d'encodage UTF-8. Vérifiez ces points dans l'ordre.

# Vérifier que le fichier existe et est lisible
file .claude/commands/ma-commande.md

# Vérifier l'encodage
file -I .claude/commands/ma-commande.md
# Attendu : text/plain; charset=utf-8

Si votre commande utilise $ARGUMENTS mais ne reçoit rien, assurez-vous de passer les arguments après le nom de la commande : /ma-commande fichier.ts. La variable $ARGUMENTS capture tout le texte après le nom de la commande.

Pour les hooks qui échouent silencieusement, ajoutez du logging dans votre script :

#!/bin/bash
echo "[HOOK $(date)] Exécution sur $CLAUDE_FILE_PATH" >> /tmp/claude-hooks.log
npx eslint --fix "$CLAUDE_FILE_PATH" 2>> /tmp/claude-hooks.log

Consultez les premières conversations avec Claude Code si vous débutez et rencontrez des problèmes de configuration initiale.

À retenir : listez vos commandes avec /, vérifiez le chemin, l'extension .md et l'encodage UTF-8 pour résoudre 90 % des problèmes.

Peut-on créer des commandes qui modifient plusieurs fichiers à la fois ?

Décrivez dans votre commande custom le scope des fichiers à modifier et Claude Code les traitera séquentiellement ou en parallèle selon le contexte. Une commande custom n'a aucune limite sur le nombre de fichiers qu'elle peut cibler.

Voici un exemple de commande multi-fichiers pour ajouter des headers de licence :

# .claude/commands/add-license.md
Ajoute le header de licence Apache 2.0 suivant en haut de
chaque fichier TypeScript dans $ARGUMENTS :

// Copyright 2026 SFEIR. All rights reserved.
// Licensed under the Apache License, Version 2.0

Ne modifie PAS les fichiers qui ont déjà un header de licence.
Compte et liste les fichiers modifiés.

En pratique, cette commande traite un répertoire de 80 fichiers TypeScript en moins de 30 secondes. Claude Code utilise l'outil Edit pour chaque fichier, ce qui garantit des modifications atomiques et réversibles.

Les commandes personnalisées et skills détaillent les patterns avancés pour les opérations sur des arborescences entières. Le mécanisme de permissions vous protège : Claude Code demande votre confirmation avant toute écriture en mode par défaut.

À retenir : aucune limite de fichiers par commande - décrivez le scope dans le prompt et Claude Code gère le parcours et les modifications.

Quand faut-il utiliser un hook plutôt qu'une commande custom ?

Utilisez un hook quand l'action doit se déclencher automatiquement et de manière déterministe, sans intervention humaine. Utilisez une commande custom quand vous voulez invoquer l'IA à la demande.

Concrètement, configurez un hook PostToolUse pour lancer Prettier après chaque écriture de fichier. Créez une commande custom /review pour une analyse de code approfondie par l'IA. Le hook s'exécute en 50 ms, la commande custom prend 15 à 45 secondes.

La formation Claude Code de SFEIR Institute consacre une demi-journée à la création de commandes personnalisées et hooks avec des labs pratiques. Vous y apprendrez à construire un pipeline complet d'automatisation en 1 jour.

À retenir : hook = automatisation déterministe instantanée, commande custom = invocation IA à la demande.

Comment structurer ses skills pour un projet monorepo ?

Placez un fichier CLAUDE.md à chaque niveau significatif de votre monorepo pour contextualiser les instructions selon le package ou le service. Claude Code charge les skills du répertoire courant et de ses parents.

monorepo/
├── CLAUDE.md                      # Conventions globales
├── packages/
│   ├── api/
│   │   └── CLAUDE.md              # Stack NestJS, conventions API
│   ├── web/
│   │   └── CLAUDE.md              # Stack Next.js 15, conventions frontend
│   └── shared/
│       └── CLAUDE.md              # Règles de la lib partagée

Quand vous travaillez dans packages/web/, Claude Code charge à la fois le CLAUDE.md racine et celui de packages/web/. Le skill le plus spécifique prévaut en cas de conflit. cette hiérarchie supporte jusqu'à 10 niveaux d'imbrication sans perte de performance.

En pratique, un monorepo de 200 000 lignes avec 5 fichiers CLAUDE.md ciblés réduit les erreurs de convention de 70 % par rapport à un unique fichier racine. Pour approfondir, la formation Développeur Augmenté par l'IA sur 2 jours couvre les architectures monorepo et la personnalisation avancée des agents IA avec des exercices sur des projets réels.

À retenir : un CLAUDE.md par package dans un monorepo - Claude Code fusionne automatiquement les skills du chemin courant.

Quels sont les pièges à éviter avec les commandes personnalisées ?

Évitez cinq erreurs fréquentes qui neutralisent l'efficacité de vos commandes custom et skills.

1. Prompts trop vagues : "Améliore ce code" ne donne rien d'exploitable. Spécifiez les critères : performance, lisibilité, sécurité.
2. Skills contradictoires : deux fichiers CLAUDE.md qui donnent des instructions opposées créent des résultats incohérents. Auditez régulièrement vos skills.
3. Hooks bloquants : un script de hook qui prend plus de 10 secondes ralentit toute la session. Limitez vos hooks à des opérations sous les 500 ms.
4. Pas de $ARGUMENTS : oublier cette variable rend la commande rigide et non réutilisable.
5. Trop de commandes : au-delà de 20 commandes custom, la maintenabilité chute. Regroupez les commandes similaires.

Consultez les astuces pour les commandes personnalisées pour des solutions détaillées à chacun de ces pièges.

La formation Développeur Augmenté par l'IA – Avancé de SFEIR Institute, en 1 jour, approfondit ces bonnes pratiques avec des cas réels de debugging de workflows agentiques complexes.

À retenir : spécificité des prompts, cohérence des skills, rapidité des hooks - ces trois principes évitent 80 % des problèmes.

---