Pourquoi un seul Claude ne suffit plus sur un gros chantier

Le contexte, la mémoire de travail de Claude

Claude Code ne se souvient pas de ta session « en gros ». À chaque requête, il relit tout ce qui se trouve dans sa fenêtre de contexte : la zone de texte qu'il voit en entier à chaque tour.

Dans cette fenêtre, il y a tes messages et ses réponses. Mais il y a aussi tout le reste : ton CLAUDE.md (le fichier de règles que Claude lit au début de chaque session, sujet de la formation CLAUDE.md), chaque fichier qu'il a ouvert, chaque sortie de commande, chaque page web qu'il a consultée.

Ce qui remplit la fenêtre sans que tu le voies

Sur une petite tâche, ce n'est pas un problème. Sur un gros chantier, les lectures s'empilent vite.

Deux mesures faites sur mes projets :

• Le CLAUDE.md de ma chaîne de vidéos fait 190 lignes et près de 10 000 mots. Il est chargé au début de chaque session.
• La page officielle de Claude Code sur les sous-agents fait 107 Ko de texte. Pour écrire la formation que tu lis, il a fallu la lire en entier, puis celles sur les worktrees, les coûts et les tâches en arrière-plan.

Ajoute les sorties de tests, les logs, les résultats d'une recherche dans tout le code. Une bonne partie ne sert qu'une fois. Mais elle reste là.

Quand la fenêtre est pleine

La fenêtre a une taille fixe. Quand elle approche de la limite, Claude Code compacte la conversation tout seul : il la remplace par un résumé structuré, puis relit quelques fichiers modifiés récemment.

Le bon côté : la session continue. Le mauvais côté : un résumé perd des détails. Une consigne donnée au début, une exception notée en passant, le nom exact d'un fichier peuvent disparaître.

Le coût caché d'une longue session

Il y a aussi une question d'argent, ou de quota si tu as un abonnement. D'après la documentation officielle, Claude Code renvoie toute la conversation à chaque requête.

Une partie de cet historique est relue à un tarif réduit grâce au cache : une mise en mémoire, côté serveur, du début de conversation déjà traité. Mais une question d'une ligne, posée dans une session ouverte depuis le matin, consomme quand même pour tout ce qui précède.

Les signes à surveiller

Voici les symptômes d'une session trop chargée :

• Claude te redemande une information que tu lui as déjà donnée.
• Il oublie une règle du projet qu'il appliquait bien au début.
• Il mélange deux sujets traités dans la même session.
• Chaque échange consomme plus que le précédent, pour une demande de même taille.

Tu peux compacter à la main, ou repartir d'une session neuve. Ça aide. Mais sur un gros chantier, le problème revient, parce que le travail lui-même est trop gros pour une seule fenêtre.

Un exemple réel : dix formations à écrire

Le site sur lequel tu lis cette leçon avait besoin de dix formations. Chacune demandait de lire la documentation officielle de son sujet, de vérifier chaque commande, d'écrire plusieurs leçons, puis de tout relire.

Dans une seule session, la fenêtre aurait contenu la documentation de dix sujets différents et dix séries de brouillons. Au moment d'écrire la dixième formation, Claude aurait travaillé avec un résumé de ce qu'il avait lu pour la première.

Et un résumé, pour un public de développeurs, c'est dangereux. Une option mal nommée, un chemin de fichier approximatif, et la leçon est fausse.

L'idée qui règle le problème

La solution n'est pas une fenêtre plus grande. C'est de ne pas tout faire dans la même.

Un sous-agent est un autre Claude, lancé par ta session, avec sa propre fenêtre de contexte, vide au départ. Il fait le travail lourd de son côté : il lit, cherche, teste. Puis il te rend seulement son résultat.

Pour les dix formations, c'est exactement ce qui s'est passé : dix sous-agents, un par formation, chacun avec sa fenêtre neuve. Ma session n'a reçu que dix rapports.

Avant de commencer

Pour refaire chez toi tout ce que montre cette formation, il te faut trois choses :

• Claude Code, l'assistant de code d'Anthropic qui tourne dans ton terminal. Il fonctionne sur Windows 10 (version 1809 ou plus récente), macOS 13 ou plus récent, Ubuntu 20.04 ou Debian 10 et plus, avec 4 Go de mémoire vive au moins.
• un compte Claude : un abonnement Pro, Max, Team ou Enterprise, ou un compte Claude Console, payé à l'usage.
• git, l'outil qui garde l'historique de ton code. Il sert au chapitre 3.

L'installation pas à pas, avec les commandes pour Windows, macOS et Linux, ouvre le chapitre 2. Si tu n'as encore jamais ouvert une session, commence par la formation Claude Code : bien démarrer.

Ce que la suite t'apporte

Dans la prochaine leçon, gratuite elle aussi, tu vois ce qu'un sous-agent reçoit exactement, ce qu'il ne voit pas, et comment les dix rédacteurs de ce site ont été cadrés pour travailler en même temps.

Ensuite, la formation passe à la pratique :

• écrire tes propres agents, avec les bons outils et le bon modèle ;
• rédiger une consigne qui dit à l'agent quoi rendre et quand il a fini ;
• en lancer plusieurs sans qu'ils se marchent dessus, avec des dossiers séparés ou des worktrees git (des copies de travail séparées d'un même projet) ;
• les suivre en arrière-plan pendant que tu continues à travailler ;
• éviter les pièges : agents qui tournent pour rien, quota qui fond, résultats perdus.