Quand un codebase dépasse les cinq cent mille lignes, la fenêtre de contexte de Claude n'est plus suffisante pour tenir l'ensemble en mémoire. Anthropic publie en 2026 le pattern subagents comme solution officielle, et le détaille dans son guide grand codebase.
Le principe est simple. Au lieu de demander à Claude d'explorer ET d'éditer en une seule session, on sépare les deux rôles entre deux instances Claude distinctes. Une instance read-only qui explore et écrit ses findings. Une instance principale qui édite avec le contexte synthétisé.
Étape un. L'utilisateur demande à Claude de modifier le système d'authentification. Plutôt qu'ouvrir tous les fichiers liés à l'auth (modèles, controllers, middlewares, tests), Claude lance un subagent en read-only via le Task tool.
Étape deux. Le subagent reçoit comme mission de mapper le subsystème auth complet. Il parcourt les fichiers, identifie les flux, repère les dépendances, et écrit le tout dans un fichier de synthèse de mille lignes maximum.
Étape trois. L'agent principal reçoit ce fichier de synthèse en input. Il a maintenant une compréhension complète du subsystème en cinq cents lignes au lieu de cinquante mille. Il édite en toute connaissance de cause sans avoir dû lire chaque fichier.
Étape quatre. Une fois la modification faite, un autre subagent peut être lancé pour valider que rien n'a régressé dans les autres parties du codebase qui touchent à l'auth.
Le contexte n'est pas chargé deux fois. Le subagent explore avec sa propre fenêtre de contexte fraîche, sans pollution. Sa sortie est une synthèse compressée et exploitable, pas une copie brute des fichiers. L'agent principal travaille avec un contexte focalisé et minimal.
Deuxième bénéfice. Les subagents peuvent tourner en parallèle. Pour une modification cross-cutting qui touche auth, paiement et notifications, lancer trois subagents simultanément qui mappent chacun leur subsystème, puis l'agent principal édite avec les trois synthèses en main. Gain de temps massif sur les refactorings transverses.
Quand le codebase dépasse les deux cent mille lignes au total. Quand le subsystème à modifier touche plus de dix fichiers connectés. Quand la première lecture exploratoire est plus longue que la modification elle-même. Quand il faut paralléliser plusieurs explorations.
Ne pas utiliser pour les petits changements isolés (un fichier, une fonction). L'overhead du subagent n'en vaut pas la peine.
Dans son article, Anthropic mentionne aussi l'émergence du rôle d'agent manager dans les équipes mature qui utilisent intensivement Claude Code. C'est une fonction hybride PM/ingénieur qui s'occupe de gouverner la configuration centrale : quels CLAUDE.md, quels plugins approuvés, quels MCP servers exposés, quelles skills disponibles par équipe.
Sans agent manager, chaque développeur tire dans une direction différente et la productivité globale stagne. Avec agent manager, l'équipe converge sur des patterns partagés et le ROI du tooling Claude Code décolle.
Notre formation Claude Architect Prep couvre le pattern subagents en module quatre, avec exercices pratiques sur des codebases de plus de cent mille lignes. Quinze heures, gratuit, certificat partageable sur LinkedIn.
https://businessdigital.fr/academie/parcours/claude-architect-prep
Franck PARIENTI BusinessDigital.fr