Subagents dans Claude Code : comment déléguer la relecture et les tests à des agents distincts

Les subagents de Claude Code permettent de déléguer des tâches gourmandes en ressources (relecture, tests, audit, exploration de code) à des agents distincts, dotés d'un contexte, d'outils et de règles indépendants. Ils contournent ainsi la principale limite de l'outil : l'épuisement de la fenêtre de contexte.

Pourquoi le contexte est le principal ennemi de Claude Code

La plupart des développeurs qui se mettent à Claude Code remarquent la même chose : l'outil est brillant en début de session et nettement moins bon vers le milieu et la fin. Le problème ne vient pas des capacités du modèle, puisqu'Anthropic améliore régulièrement Claude. Il vient de la façon dont le contexte est géré.

Chaque interaction au sein d'une session s'accumule dans la fenêtre de contexte : fichiers lus, plans rédigés, historique des modifications, sorties des outils, résultats des commandes. Plus la session est longue, plus le contexte se remplit de « déchets ». Le modèle se met à perdre le fil de son raisonnement, à contredire des instructions antérieures et, parfois, à revenir à des solutions déjà écartées.

La parade habituelle consiste à découper le travail en sessions courtes. Mais c'est peu pratique : il faut à chaque fois reconstituer le contexte à la main, copier les résultats intermédiaires et réexpliquer à l'agent ce qui a déjà été fait.

Les subagents apportent une réponse systémique à ce problème.

Que sont les subagents et comment fonctionnent-ils ?

Les subagents sont des instances d'agent distinctes que la session principale de Claude Code lance pour des sous-tâches précises. La différence essentielle avec le « on ouvre un nouveau chat » manuel : la délégation se fait par programme, et le résultat revient dans la session principale sous forme structurée.

Chaque subagent travaille dans un environnement isolé :

• Sa propre fenêtre de contexte : indépendante de la session parente, et vierge au départ
• Un jeu d'outils adapté à la tâche : lecture seule des fichiers pour un audit, ou exécution de tests pour le QA
• Des règles et instructions propres : le rôle se configure via un prompt système ou un fichier CLAUDE.md
• Un répertoire de travail isolé : au besoin, le subagent travaille dans un git worktree séparé

Le schéma est simple : l'agent principal pose la tâche, transmet les fichiers et le contexte nécessaires, puis lance le subagent. Celui-ci travaille dans une session isolée et ne renvoie que le résultat (un rapport de relecture, une liste de problèmes, des tests prêts à l'emploi), sans ses raisonnements intermédiaires.

Le parallélisme est un bonus. Plusieurs subagents peuvent tourner en même temps : pendant que l'un relit un module, un autre écrit les tests de ce même module. La session principale coordonne le travail sans l'exécuter elle-même.

Quelles tâches déléguer en priorité ?

Il ne vaut pas la peine de confier n'importe quelle tâche à un subagent, car la délégation entraîne un surcoût d'initialisation et de transfert de contexte. Mais dans plusieurs cas, le gain est évident.

Revue de code : analyser une PR ou un fichier précis exige une immersion profonde, mais le résultat tient en peu de place, une liste de remarques hiérarchisées. Le subagent lit le code et rend un rapport sans polluer le contexte principal avec des milliers de lignes.

Écriture de tests : le subagent reçoit la description d'une fonction ou le fichier source, écrit les tests, les exécute et rapporte le résultat. Pendant ce temps, la session principale continue de travailler sur d'autres parties du projet.

Audit de sécurité : la recherche de vulnérabilités avec une checklist OWASP et des règles de sécurité isolées renvoie une courte liste de constats hiérarchisés, sans encombrer le contexte principal.

Exploration de la base de code : retrouver toutes les occurrences d'un motif ou étudier une partie inconnue du projet. Le subagent renvoie une cartographie structurée des dépendances sans occuper de place dans la fenêtre principale.

Ce que cela change

Les subagents modifient la façon de travailler avec un assistant IA en développement : au lieu d'une unique grande session qui se dégrade à mesure que le contexte grossit, le développeur orchestre des agents spécialisés, chacun disposant d'une fenêtre de contexte vierge dans son périmètre. L'un relit, l'autre teste, un troisième traque les vulnérabilités.

C'est plus proche de la direction d'une petite équipe que de la conversation avec un assistant unique, et c'est précisément cette approche qui permet à Claude Code de venir à bout de façon stable de tâches vastes, étalées sur plusieurs jours, sans perte de qualité.