Accueil

Créer un Sous-Agent dans Claude Code

Vous souhaitez comparer des opportunités d’investissement, mais faire des recherches sur plusieurs entreprises et les évaluer prend des heures. Un sous-agent, c’est comme embaucher un analyste financier qui sait exactement comment utiliser vos outils de recherche : vous lui donnez des noms d’entreprises, et il rassemble des rapports, évalue chaque entreprise selon des critères clés et recommande le meilleur investissement. Une fois que vous aurez appris à créer des sous-agents, vous pourrez automatiser n’importe quel flux de travail répétitif en plusieurs étapes dans votre travail. Ce tutoriel vous montre comment construire cet analyste.

Concepts Clés

• Sous-Agent - Un travailleur IA spécialisé avec son propre objectif, son prompt système et ses outils qui accomplit des tâches de manière autonome
• Contexte Isolé - Un sous-agent travaille dans son propre espace de travail séparé, donc ses recherches n’encombrent pas votre conversation principale : seul le résultat final vous est renvoyé
• Skill (appelé « Compétence » dans le tutoriel précédent) - Une capacité réutilisable (comme générer des rapports boursiers) que les sous-agents peuvent invoquer pour accomplir leurs objectifs
• Prompt Système - Instructions qui définissent ce que fait le sous-agent, comment il évalue les entreprises et quel format il renvoie
• Séparation des Responsabilités - Les skills collectent les données ; les sous-agents utilisent ces données pour prendre des décisions

Ce Dont Vous Aurez Besoin

• Avoir terminé le tutoriel Créez Votre Première Compétence Claude
• Le skill stock-report déjà installé (dans .claude/skills/stock-report/) grâce à ce tutoriel
• VS Code ou un autre éditeur de texte
• 20-25 minutes

Étape 1 : Ouvrir Votre Dossier de Projet et Démarrer Claude Code

Votre skill stock-report se trouve dans le même dossier de projet que celui utilisé pour le tutoriel sur les Compétences (Skills) : rouvrez ce dossier plutôt que d’en créer un nouveau.

Windows (PowerShell) :

• Cliquez sur le bouton Démarrer de Windows, tapez PowerShell, et ouvrez-le
• Tapez cette commande :

  cd ~/Documents/test_claude
  

• Démarrez Claude Code :

  claude
  

Mac :

• Ouvrez Terminal (trouvez-le dans Applications > Utilitaires)
• Tapez cette commande :

  cd ~/Documents/test_claude
  

• Démarrez Claude Code :

  claude
  

Étape 2 : Vérifier que le Skill de Rapport Boursier Existe

Avant de construire votre sous-agent, confirmez que le skill est disponible. Tapez :

Liste tous les skills disponibles

Vous devriez voir stock-report dans la sortie. Ce skill fait des recherches sur les entreprises et génère des rapports couvrant les actualités produits, les mises à jour de la direction, les performances financières et les perspectives des analystes.

Si vous ne le voyez pas, les fichiers du skill devraient se trouver dans .claude/skills/stock-report/ (niveau projet). Si le dossier est complètement absent, revenez d’abord au tutoriel Créez Votre Première Compétence Claude et terminez-le dans ce même dossier de projet.

Étape 3 : Comprendre l’Architecture Sous-Agent vs Skill

Voici comment les sous-agents et les skills fonctionnent ensemble :

Différence clé :

• Skill = outil qui fait des recherches
• Sous-Agent = décideur qui utilise l’outil et applique la logique

Votre sous-agent de sélection d’actions va :

1. Invoquer le skill de rapport boursier pour chaque entreprise (2+ fois)
2. Évaluer les entreprises selon plusieurs catégories (finances, croissance, direction, sentiment)
3. Comparer les scores et recommander le meilleur investissement

Étape 4 : Créer le Sous-Agent de Sélection d’Actions

Demandez à Claude d’écrire le fichier du sous-agent pour vous. Copiez et collez ce prompt :

Crée un sous-agent de projet appelé stock-picker dans .claude/agents/ :
- Il prend deux actions ou plus
- Utilise le skill stock-report pour faire des recherches
- Des fiches de notation sont créées en fonction des catégories de données collectées
- Une recommandation finale est donnée.
Utilise le modèle Sonnet.

Claude crée le fichier .claude/agents/stock-picker.md. Si Claude demande la permission de créer le fichier, choisissez Yes.

Remarque : Dans les anciennes versions de Claude Code, taper /agents ouvrait un menu pour créer des sous-agents. Dans les versions actuelles, /agents vous rappelle seulement de le demander à Claude, ce que nous venons de faire.

Outils : Un sous-agent peut être limité aux seuls outils dont il a besoin, par exemple un agent dédié uniquement à la recherche, avec seulement la recherche web. Si le fichier n’a pas de ligne tools:, le sous-agent peut utiliser tous les outils, ce dont le stock-picker a besoin pour faire des recherches en ligne et écrire des fichiers.

Étape 5 : Examiner ce que Vous Avez Construit (Point de Réflexion)

Pour ouvrir le fichier dans VS Code, cliquez sur File > Open File… et naviguez vers .claude/agents/stock-picker.md.

Ou vous pouvez demander à Claude :

Montre-moi le fichier du sous-agent stock-picker.

Claude affichera le fichier du sous-agent situé dans .claude/agents/stock-picker.md. Vous verrez :

Il y a un frontmatter YAML en haut :

---
name: stock-picker
description: Compares multiple companies for investment decisions...
skills:
  - stock-report
model: sonnet
---

Ce frontmatter (la section entre les marqueurs ---) indique à Claude Code quand utiliser ce sous-agent (description), quels skills charger dans celui-ci dès le départ (skills), et sur quel modèle Claude il s’exécute (model).

Il y a un prompt système sous le frontmatter avec votre méthodologie d’évaluation.

Confirmez ces éléments clés :

• Le sous-agent a accès au skill stock-report
• Le prompt système explique la répartition des scores
• L’objectif du sous-agent est clair : comparer les entreprises et en recommander une

Vous pouvez modifier le fichier directement ou demander à Claude de le mettre à jour.

Étape 6 : Tester le Sous-Agent

Commencez par quitter Claude Code en appuyant deux fois sur Ctrl+C, puis tapez claude pour le redémarrer. Claude Code ne remarque un tout nouveau dossier .claude/agents/ qu’après un redémarrage.

Maintenant testez votre sous-agent avec une vraie comparaison. Tapez :

Quel est le meilleur investissement : Apple ou Google ?

Le sous-agent s’activera automatiquement en fonction de votre description.

Étape 7 : Observer le Sous-Agent Travailler

Le sous-agent s’exécute en arrière-plan : vous verrez donc son nom dans un petit panneau sous l’invite, plutôt que chacune de ses étapes. Pour le suivre, tapez /tasks, sélectionnez stock-picker avec les touches fléchées, puis appuyez sur Entrée. En coulisses, il va :

1. Invoquer le skill deux fois - Appeler le skill stock-report une fois pour Apple, puis pour Google
2. Collecter des données - Chaque appel du skill recherche sur le web et génère un rapport d’entreprise
3. Évaluer les entreprises - Note chaque catégorie et les combine en une note globale
4. Générer la sortie - Crée un tableau de comparaison et une recommandation

Cela peut prendre 2-3 minutes car il faut effectuer des recherches sur le web.

Remarquez que votre conversation principale ne se remplit pas de tous les résultats de recherche et des étapes intermédiaires : c’est le contexte isolé en action. Le sous-agent fait ses recherches dans son propre espace de travail séparé et ne vous renvoie que ce que vous voyez ici.

Étape 8 : Examiner la Sortie

Le sous-agent renvoie une analyse détaillée incluant :

• Rapports individuels des entreprises - Mises à jour produits, métriques financières, changements de direction, sentiment des analystes pour chaque action
• Tableau de comparaison - Scores numériques selon les catégories (Santé Financière, Potentiel de Croissance, Qualité de la Direction, Sentiment du Marché)
• Recommandation finale - Dans quelle action investir et pourquoi

Le sous-agent peut afficher cela dans le terminal ou générer un fichier markdown avec le rapport complet. Vous pouvez modifier le fichier du sous-agent pour personnaliser les pondérations des scores ou le format de sortie.

Prochaines Étapes

Maintenant que vous avez un sous-agent de sélection d’actions fonctionnel, essayez ces extensions :

• Comparer 3+ actions : « Compare AAPL, MSFT et GOOGL » pour voir comment le sous-agent gère plus d’options
• Ajuster les pondérations : Modifiez le fichier du sous-agent pour changer le poids de chaque catégorie (par exemple, mettez la croissance à 40% si vous préférez les actions de croissance)
• Créer d’autres sous-agents : Construisez un sous-agent “code-reviewer”, “bug-hunter” ou “document-writer” pour différentes tâches

Dépannage

• Le sous-agent ne s’active pas : Assurez-vous que votre demande mentionne la comparaison d’entreprises ou les décisions d’investissement. Essayez : « Utilise le sous-agent stock-picker pour comparer… »
• Skill non trouvé : Vérifiez que .claude/skills/stock-report/SKILL.md existe. Redémarrez Claude Code si vous venez de l’ajouter.
• Scores incomplets : Demandez au sous-agent : « continue » ou « explique plus en détail les scores de chaque catégorie »
• Sous-agent introuvable après sa création : Vérifiez que .claude/agents/stock-picker.md existe. Si c’est le cas, quittez Claude Code (Ctrl+C deux fois) et redémarrez-le avec claude. Un tout nouveau dossier .claude/agents/ n’est pris en compte qu’après un redémarrage.

Vue d’Ensemble du Flux de Travail

• Les sous-agents automatisent les flux de travail en plusieurs étapes - Ils orchestrent les skills, appliquent la logique et fournissent des décisions
• Les skills sont des outils réutilisables - Un skill peut être utilisé par plusieurs sous-agents pour différents objectifs
• Les prompts système définissent le comportement - Des instructions claires et des critères d’évaluation rendent les sous-agents fiables
• Les sous-agents restent concentrés - Chaque sous-agent a un objectif unique et clair (sélection d’actions, revue de code, etc.)
• La composition permet l’évolutivité - Construisez une bibliothèque de skills et de sous-agents qui fonctionnent ensemble

Créé par Steven Ge le 14 décembre 2025.