Architecture des sous-agents et délégation dans Claude Code
Claude Code permet de structurer la résolution de tâches complexes en déléguant des sous-ensembles de travail à des agents spécialisés. Cette approche évite de saturer le contexte principal et isole l'exécution des commandes.
La configuration des agents s'appuie sur la définition de rôles précis dans le projet. Chaque sous-agent reçoit un ensemble restreint d'outils et un périmètre d'action limité, défini par des instructions contextuelles transmises au moment de l'appel.
Mise en place d'un sous-agent de test
Pour lancer une vérification ciblée, l'agent principal invoque un processus subordonné en lui transmettant le chemin des fichiers à analyser et la commande exacte à exécuter. Le fragment suivant illustre la déclaration d'un agent dédié aux tests unitaires :
agent:
name: "test-runner"
tools: ["bash", "view"]
prompt: "Exécute uniquement les tests du module modifié et rapporte les erreurs."
Flux de délégation et récupération des résultats
Durant l'exécution, le processus parent suspend sa propre boucle de décision et attend le retour structuré du sous-agent. Une fois le code de retour analysé, l'agent principal intègre les données pertinentes dans son propre contexte pour décider de la suite des opérations.
- Isolation stricte des variables d'environnement entre agents.
- Réduction de la consommation de jetons sur le contexte global.
- Traçabilité des actions via les journaux d'exécution de chaque sous-tâche.
Cette segmentation garantit un comportement prédictible lors de refactorisations d'envergure, chaque sous-agent traitant une seule préoccupation à la fois.