Quand la conversation devient trop longue

Ce que c'est et pourquoi ça compte

Ça vous est sûrement déjà arrivé : vous travaillez depuis des heures dans la même conversation avec Claude Code et, à un moment, quelque chose glisse. Il refait un choix que vous aviez déjà écarté, oublie une règle donnée au début, vous repropose un essai qui ne marchait pas.

La raison, c'est la fenêtre de contexte, la mémoire de travail de Claude. Tout y entre : vos messages, les réponses, les fichiers lus, la sortie des commandes, le CLAUDE.md. Quand elle approche de la limite, Claude Code fait de la place tout seul : d'abord il retire les anciens résultats des commandes, puis il résume la conversation. Vos demandes et le code important restent. Les instructions détaillées données au début peuvent disparaître.

Et il y a aussi la consommation : à chaque message, Claude Code renvoie toute la conversation au modèle. Plus la conversation est longue, plus chaque question vous coûte, même celle d'une ligne.

Ce que je fais : quand je termine un morceau, je demande à Claude de résumer où on en est, je lui fais écrire les décisions dans un fichier du projet et je repars d'une conversation propre. Les choses importantes sont dans le fichier, pas dans la conversation.

1. Le prompt de résumé

Quand vous terminez un morceau de travail (un écran, une connexion, une correction) et avant de passer au suivant, écrivez ceci :

Résume où on en est en cinq points : ce qu'on a décidé, ce qui est fait, ce qui manque, les problèmes encore ouverts, les fichiers qu'on a touchés. Ensuite, mets à jour DECISIONS.md avec les nouvelles décisions. Pas de code dans le résumé.

Les cinq points vous donnent une photo complète du travail, pas seulement de la dernière chose faite. « Les fichiers qu'on a touchés » vous sert si quelque chose casse plus tard : vous savez où regarder. « Pas de code dans le résumé », parce que le code est déjà dans les fichiers : ici, il s'agit de comprendre où vous en êtes, pas de relire cent lignes.

Ce résumé, lisez-le vous-même. S'il y a une décision que vous ne vous souvenez pas d'avoir prise, ou un problème ouvert qui vous avait échappé, demandez maintenant, tant que la conversation est encore là.

2. Le fichier des décisions

Créez dans le dossier du projet un fichier DECISIONS.md. Court, une ligne par décision, avec la raison. Le mien ressemble à ça :

# Décisions
## Login
- Uniquement par e-mail, pas de réseaux sociaux (moins de choses à maintenir)
## Profil
- Une seule photo, nom visible par tous
## Ne pas toucher
- La vraie base de données : on teste uniquement sur celle de test
## Questions ouvertes
- Notifications, oui ou non ?

Les sections sont les parties de l'app, plus deux que j'utilise toujours. « Ne pas toucher » est la liste de ce que Claude ne doit pas modifier sans demander : la vraie base de données, les paiements, ce qui est délicat pour vous. « Questions ouvertes » garde ce qui n'est pas encore décidé : comme ça, Claude ne choisit pas à votre place et vous retrouvez ces questions devant vous le moment venu.

La raison, c'est ce qui compte. Dans une semaine, un choix sans explication ressemble à une erreur, et Claude risque de le « corriger ». Avec la raison écrite à côté, il sait pourquoi c'est comme ça.

Et gardez-le court. Dans un instant, on va le faire charger à chaque session, et tout ce qu'il contient prend de la mémoire à chaque fois. Pas de comptes rendus : une ligne par décision. Quand une question ouverte est tranchée, déplacez-la dans la bonne section. Quand une décision change, réécrivez la ligne au lieu d'en ajouter une autre.

3. Repartir proprement

Une fois le résumé fait et le fichier à jour, Claude Code vous offre deux voies.

/clear : une nouvelle conversation

/clear ouvre une nouvelle conversation, vide. Il ne touche pas aux fichiers du projet, et la conversation d'avant ne disparaît pas : si vous en avez besoin, vous la rouvrez avec /resume. Dans la nouvelle conversation, écrivez :

Lis DECISIONS.md et repars de là : le prochain morceau, c'est [ce qui manque].

À la place des crochets, mettez le prochain morceau en une phrase, du genre « la page profil, seulement la partie photo ». Si vous avez le résumé d'avant, le point « ce qui manque » vous le dit déjà. Comme ça, la nouvelle conversation démarre avec seulement ce qu'il lui faut.

/compact : même conversation, plus légère

/compact résume la conversation et libère de la place sans la fermer. Vous pouvez lui donner des instructions pour le résumé, écrites après la commande. Moi, je lui dis quoi garder et quoi jeter :

/compact garde les décisions, ce qui est fait et ce qui manque ; laisse tomber les essais ratés

Le résumé automatique, celui que Claude Code fait tout seul quand la mémoire est presque pleine, fonctionne de la même façon. La différence, c'est qui choisit : là, c'est Claude Code qui décide ce qui est important ; avec des instructions, c'est vous.

Lequel des deux

J'utilise /clear quand j'ai fini un morceau ou que je passe à un travail sans rapport : ça repart du fichier, je sais ce qu'il contient, et ça ne coûte rien. J'utilise /compact quand je suis au milieu d'un morceau et que j'ai encore besoin du fil de la conversation. N'oubliez pas que /compact n'est pas gratuit : pour résumer, il doit relire toute la conversation, donc sur une conversation énorme, c'est une grosse requête.

/context : à quel point elle est pleine

Si vous voulez voir à quel point la mémoire est pleine, /context vous la montre : une grille colorée de ce qui prend de la place, du CLAUDE.md aux fichiers lus. Moi, je le regarde quand Claude commence à perdre des morceaux, avant de décider si je repars.

4. Le lui faire lire à chaque fois

Le CLAUDE.md est le fichier d'instructions du projet, celui que Claude Code charge au début de chaque session. Si vous n'en avez pas, créez-le dans le dossier principal du projet, ou faites-le préparer avec /init. Ensuite, ajoutez cette ligne :

@DECISIONS.md

Avec le @ devant, le fichier est chargé avec le CLAUDE.md, même après un /clear. Et après une compaction, Claude Code relit depuis le disque le CLAUDE.md principal du projet, donc les décisions reviennent là aussi. Le chemin part du dossier du CLAUDE.md : si les deux fichiers sont côte à côte, le nom suffit.

En dessous, ajoutez :

Quand on prend une décision importante, écris-la dans DECISIONS.md.

Comme ça, le fichier grandit pendant que vous travaillez, pas seulement quand vous y pensez. Le prompt de résumé en fin de morceau reste le contrôle : c'est là que vous voyez s'il manque quelque chose. Et le « Lis DECISIONS.md » après un /clear devient presque superflu, mais je l'écris quand même : il dit à Claude d'où repartir.

Une chose à savoir : avec le @, DECISIONS.md entre dans chaque session, même quand il ne sert pas. C'est pour ça qu'il doit rester court. C'est pareil pour le CLAUDE.md : la documentation conseille de le garder sous les 200 lignes.

En plus : des instructions pour le résumé automatique

Si vous voulez que le résumé automatique garde lui aussi les bonnes choses, vous pouvez écrire dans le CLAUDE.md une section avec des instructions pour la compaction. Claude Code en tient compte quand il résume :

# Compact instructions
Quand tu résumes la conversation, garde les décisions, ce qui est fait et ce qui manque ; laisse tomber les essais ratés.

La règle : conversations courtes, fichiers longs. La conversation, vous la jetez ; le fichier, lui, reste.

Les erreurs les plus courantes

• Attendre que la conversation se remplisse toute seule : le résumé automatique choisit lui-même quoi garder. En fin de morceau, faites vous-même le résumé et repartez.
• Faire /clear sans avoir mis à jour DECISIONS.md : ce que vous avez décidé reste uniquement dans l'ancienne conversation. D'abord le prompt de résumé, ensuite /clear.
• Écrire les décisions sans la raison : une semaine plus tard, elles ressemblent à des erreurs et Claude risque de les « corriger ». Ajoutez la raison entre parenthèses.
• Laisser DECISIONS.md grossir comme un journal intime : avec le @, il entre dans chaque session et prend de la mémoire. Une ligne par décision, et quand une décision change, réécrivez cette ligne.
• Utiliser /compact pour changer de travail : vous traînez un résumé inutile et vous payez la relecture. Quand vous changez de sujet, /clear.

Check-list

• DECISIONS.md est dans le dossier du projet
• Chaque décision a sa raison
• Le CLAUDE.md contient la ligne @DECISIONS.md
• En fin de morceau, j'utilise le prompt de résumé
• Avant /clear, le fichier est à jour
• /clear quand je change de travail, /compact seulement au milieu d'un morceau

Questions fréquentes