Sous-agents

Les sous-agents personnalisés dans Claude Code sont des assistants IA spécialisés qui peuvent être invoqués pour gérer des types spécifiques de tâches. Ils permettent une résolution de problèmes plus efficace en fournissant des configurations spécifiques aux tâches avec des invites système personnalisées, des outils et une fenêtre de contexte séparée.

​

Que sont les sous-agents ?

Les sous-agents sont des personnalités IA pré-configurées auxquelles Claude Code peut déléguer des tâches. Chaque sous-agent :

• A un objectif spécifique et un domaine d’expertise
• Utilise sa propre fenêtre de contexte séparée de la conversation principale
• Peut être configuré avec des outils spécifiques qu’il est autorisé à utiliser
• Inclut une invite système personnalisée qui guide son comportement

Lorsque Claude Code rencontre une tâche qui correspond à l’expertise d’un sous-agent, il peut déléguer cette tâche au sous-agent spécialisé, qui travaille de manière indépendante et retourne des résultats.

​

Avantages clés

​

Démarrage rapide

Pour créer votre premier sous-agent :

/agents

> Utilisez le sous-agent code-reviewer pour vérifier mes changements récents

​

Configuration des sous-agents

​

Emplacements des fichiers

Les sous-agents sont stockés comme des fichiers Markdown avec un frontmatter YAML dans deux emplacements possibles :

Lorsque les noms de sous-agents entrent en conflit, les sous-agents au niveau du projet ont la priorité sur les sous-agents au niveau de l’utilisateur.

​

Format de fichier

Chaque sous-agent est défini dans un fichier Markdown avec cette structure :

---
name: votre-nom-de-sous-agent
description: Description de quand ce sous-agent devrait être invoqué
tools: outil1, outil2, outil3  # Optionnel - hérite de tous les outils si omis
---

L'invite système de votre sous-agent va ici. Cela peut être plusieurs paragraphes
et devrait clairement définir le rôle du sous-agent, ses capacités, et son approche
pour résoudre les problèmes.

Incluez des instructions spécifiques, les meilleures pratiques, et toutes les contraintes
que le sous-agent devrait suivre.

​

Champs de configuration

​

Outils disponibles

Les sous-agents peuvent se voir accorder l’accès à n’importe lequel des outils internes de Claude Code. Voir la documentation des outils pour une liste complète des outils disponibles.

Vous avez deux options pour configurer les outils :

• Omettre le champ tools pour hériter de tous les outils du thread principal (par défaut), y compris les outils MCP
• Spécifier des outils individuels comme une liste séparée par des virgules pour un contrôle plus granulaire (peut être édité manuellement ou via /agents)

Outils MCP : Les sous-agents peuvent accéder aux outils MCP des serveurs MCP configurés. Lorsque le champ tools est omis, les sous-agents héritent de tous les outils MCP disponibles au thread principal.

​

Gestion des sous-agents

​

Utilisation de la commande /agents (Recommandé)

La commande /agents fournit une interface complète pour la gestion des sous-agents :

/agents

Cela ouvre un menu interactif où vous pouvez :

• Voir tous les sous-agents disponibles (intégrés, utilisateur, et projet)
• Créer de nouveaux sous-agents avec une configuration guidée
• Éditer les sous-agents personnalisés existants, y compris leur accès aux outils
• Supprimer les sous-agents personnalisés
• Voir quels sous-agents sont actifs quand des doublons existent
• Gérer facilement les permissions d’outils avec une liste complète des outils disponibles

​

Gestion directe des fichiers

Vous pouvez aussi gérer les sous-agents en travaillant directement avec leurs fichiers :

# Créer un sous-agent de projet
mkdir -p .claude/agents
echo '---
name: test-runner
description: Utilisez de manière proactive pour exécuter les tests et corriger les échecs
---

Vous êtes un expert en automatisation de tests. Quand vous voyez des changements de code, exécutez de manière proactive les tests appropriés. Si les tests échouent, analysez les échecs et corrigez-les tout en préservant l'intention originale du test.' > .claude/agents/test-runner.md

# Créer un sous-agent utilisateur
mkdir -p ~/.claude/agents
# ... créer le fichier de sous-agent

​

Utilisation efficace des sous-agents

​

Délégation automatique

Claude Code délègue de manière proactive les tâches basées sur :

• La description de la tâche dans votre demande
• Le champ description dans les configurations de sous-agents
• Le contexte actuel et les outils disponibles

​

Invocation explicite

Demandez un sous-agent spécifique en le mentionnant dans votre commande :

> Utilisez le sous-agent test-runner pour corriger les tests qui échouent
> Demandez au sous-agent code-reviewer de regarder mes changements récents
> Demandez au sous-agent debugger d'enquêter sur cette erreur

​

Exemples de sous-agents

​

Réviseur de code

---
name: code-reviewer
description: Spécialiste expert en révision de code. Révise de manière proactive le code pour la qualité, la sécurité, et la maintenabilité. Utilisez immédiatement après avoir écrit ou modifié du code.
tools: Read, Grep, Glob, Bash
---

Vous êtes un réviseur de code senior assurant des standards élevés de qualité et de sécurité du code.

Quand invoqué :
1. Exécutez git diff pour voir les changements récents
2. Concentrez-vous sur les fichiers modifiés
3. Commencez la révision immédiatement

Liste de vérification de révision :
- Le code est simple et lisible
- Les fonctions et variables sont bien nommées
- Pas de code dupliqué
- Gestion d'erreur appropriée
- Pas de secrets exposés ou de clés API
- Validation d'entrée implémentée
- Bonne couverture de tests
- Considérations de performance adressées

Fournissez des commentaires organisés par priorité :
- Problèmes critiques (doit corriger)
- Avertissements (devrait corriger)
- Suggestions (considérez l'amélioration)

Incluez des exemples spécifiques de comment corriger les problèmes.

​

Débogueur

---
name: debugger
description: Spécialiste en débogage pour les erreurs, échecs de tests, et comportements inattendus. Utilisez de manière proactive lors de la rencontre de tout problème.
tools: Read, Edit, Bash, Grep, Glob
---

Vous êtes un expert débogueur spécialisé dans l'analyse de cause racine.

Quand invoqué :
1. Capturez le message d'erreur et la trace de pile
2. Identifiez les étapes de reproduction
3. Isolez l'emplacement de l'échec
4. Implémentez une correction minimale
5. Vérifiez que la solution fonctionne

Processus de débogage :
- Analysez les messages d'erreur et les logs
- Vérifiez les changements de code récents
- Formez et testez des hypothèses
- Ajoutez des logs de débogage stratégiques
- Inspectez les états des variables

Pour chaque problème, fournissez :
- Explication de la cause racine
- Preuves soutenant le diagnostic
- Correction de code spécifique
- Approche de test
- Recommandations de prévention

Concentrez-vous sur la correction du problème sous-jacent, pas seulement les symptômes.

​

Scientifique des données

---
name: data-scientist
description: Expert en analyse de données pour les requêtes SQL, opérations BigQuery, et insights de données. Utilisez de manière proactive pour les tâches d'analyse de données et les requêtes.
tools: Bash, Read, Write
---

Vous êtes un scientifique des données spécialisé dans l'analyse SQL et BigQuery.

Quand invoqué :
1. Comprenez l'exigence d'analyse de données
2. Écrivez des requêtes SQL efficaces
3. Utilisez les outils de ligne de commande BigQuery (bq) quand approprié
4. Analysez et résumez les résultats
5. Présentez les découvertes clairement

Pratiques clés :
- Écrivez des requêtes SQL optimisées avec des filtres appropriés
- Utilisez des agrégations et jointures appropriées
- Incluez des commentaires expliquant la logique complexe
- Formatez les résultats pour la lisibilité
- Fournissez des recommandations basées sur les données

Pour chaque analyse :
- Expliquez l'approche de requête
- Documentez toutes les hypothèses
- Mettez en évidence les découvertes clés
- Suggérez les prochaines étapes basées sur les données

Assurez-vous toujours que les requêtes sont efficaces et rentables.

​

Meilleures pratiques

• Commencez avec des agents générés par Claude : Nous recommandons fortement de générer votre agent initial avec Claude puis d’itérer dessus pour le rendre personnellement vôtre. Cette approche vous donne les meilleurs résultats - une fondation solide que vous pouvez personnaliser selon vos besoins spécifiques.

• Concevez des sous-agents focalisés : Créez des sous-agents avec des responsabilités uniques et claires plutôt que d’essayer de faire qu’un sous-agent fasse tout. Cela améliore les performances et rend les sous-agents plus prévisibles.

• Écrivez des invites détaillées : Incluez des instructions spécifiques, des exemples, et des contraintes dans vos invites système. Plus vous fournissez de guidance, mieux le sous-agent performera.

• Limitez l’accès aux outils : N’accordez que les outils qui sont nécessaires pour l’objectif du sous-agent. Cela améliore la sécurité et aide le sous-agent à se concentrer sur les actions pertinentes.

• Contrôle de version : Vérifiez les sous-agents de projet dans le contrôle de version pour que votre équipe puisse en bénéficier et les améliorer de manière collaborative.

​

Usage avancé

​

Chaînage de sous-agents

Pour des flux de travail complexes, vous pouvez chaîner plusieurs sous-agents :

> D'abord utilisez le sous-agent code-analyzer pour trouver les problèmes de performance, puis utilisez le sous-agent optimizer pour les corriger

​

Sélection dynamique de sous-agents

Claude Code sélectionne intelligemment les sous-agents basés sur le contexte. Rendez vos champs description spécifiques et orientés action pour de meilleurs résultats.

​

Considérations de performance

• Efficacité du contexte : Les agents aident à préserver le contexte principal, permettant des sessions globales plus longues
• Latence : Les sous-agents commencent avec une ardoise propre chaque fois qu’ils sont invoqués et peuvent ajouter de la latence car ils rassemblent le contexte dont ils ont besoin pour faire leur travail efficacement.

​

Documentation connexe

• Commandes slash - Apprenez sur les autres commandes intégrées
• Paramètres - Configurez le comportement de Claude Code
• Hooks - Automatisez les flux de travail avec des gestionnaires d’événements