Правило 50% контекста для Claude Code и Cursor: когда чистить сессию и как передать задачу
Que se passe-t-il lors d'une longue session
Vous travaillez avec un agent sur une fonctionnalité pendant une heure. Au début nous étions d'accord : ne touchez pas à l'API publique, écrivez des tests dans Vitest, utilisez le apiClient existant. À la fin de la session, l'agent crée un nouveau wrapper fetch, rompt la signature de la fonction exportée et écrit un test dans Jest. Il n'a pas été « oublié » au sens humain du terme : les premières instructions sont toujours dans leur contexte, mais elles sont désormais entourées de dizaines de milliers de jetons de journal, de différences et de fichiers de lecture.
Cela a une base de recherche. Lost in the Middle (Liu et al., 2023) montre que les modèles utilisent moins bien les informations provenant du milieu d’un contexte long que celles du début et de la fin. De plus, les déchets s'accumulent dans le contexte : versions obsolètes de fichiers, approches annulées, messages d'erreur déjà corrigés. Le modèle les considère à égalité avec l’état actuel.
La « règle des 50 % » est une heuristique et non un seuil mesuré. L’essentiel est de gérer le contexte à l’avance, plutôt que d’attendre que l’agent fasse des erreurs ou que la compression automatique se déclenche.
Comment afficher l'occupation
Dans Claude Code, la commande /context montre combien est occupé et quoi : instructions système, fichiers mémoire comme CLAUDE.md, descriptions des outils MCP, historique des messages. Le dernier point s'avère souvent inattendu : les serveurs MCP connectés avec des dizaines d'outils occupent une partie notable de la fenêtre avant même le premier message.
Dans Curseur, concentrez-vous sur l'indicateur de contexte du chat et sur vos propres signes : l'agent relit les fichiers qu'il a déjà ouverts, répète une option rejetée, confond les noms.
Procédure pour une demi-fenêtre
- 1.Demandez à l'agent de noter le statut. Pas un récit de la conversation, mais un document de travail :
Запиши в docs/handoff/feature-export.md: - цель задачи в одном абзаце; - принятые решения и почему (с путями к файлам); - что сделано и проверено (какие тесты проходят); - что осталось, в порядке выполнения; - ограничения: что нельзя трогать; - открытые вопросы. Не включай историю попыток, которые мы отбросили.
- 2.Vérifiez le document vous-même. C'est le seul endroit où vous contrôlez ce qui se passe dans la nouvelle session. Supprimez ce qui est incorrect, ajoutez des restrictions oubliées.
- 3.Effacer la session. Dans Claude Code -
/clear, dans Cursor - nouveau chat.
- 4.Commencez par le fichier. « Lisez docs/handoff/feature-export.md et continuez à partir du point suivant. »
Une alternative aux trois premières étapes de Claude Code est /compact avec une indication de ce qu'il faut sauvegarder : /compact сохрани решения по API экспорта и список оставшихся шагов, логи тестов не нужны. C'est plus rapide, mais vous ne voyez pas le résultat final aussi clairement que le fichier.
Ce qu'il faut garder en dehors du dialogue
Les règles permanentes du projet ne doivent pas résider dans l’historique des messages. Ils appartiennent à CLAUDE.md (Claude Code) ou à .cursor/rules (Curseur) : ils sont chargés à chaque nouvelle session. Joli court CLAUDE.md :
# Проект Next.js 15, App Router, PostgreSQL через Drizzle. # Команды - pnpm test — Vitest - pnpm lint — ESLint + tsc --noEmit # Правила - HTTP-запросы только через lib/api-client.ts. - Публичные функции в lib/public/* не меняют сигнатуру без явной просьбы. - Перед завершением задачи запускай pnpm lint и pnpm test.
Il est préférable de conserver les longs ouvrages de référence (schéma de base de données, description de l'API) dans des fichiers séparés et de les lier si nécessaire, plutôt que de toujours les télécharger.
Comment ne pas gonfler le contexte
- Ne demandez pas de lire l'intégralité du répertoire. Spécifiez des fichiers spécifiques ou demandez d'abord de trouver ce dont vous avez besoin en effectuant une recherche.
- Réduire la sortie de la commande.
pnpm test 2>&1 | tail -50au lieu du journal complet en milliers de lignes. - Placez la recherche dans un sous-agent. Dans Claude Code, les sous-agents fonctionnent dans un contexte séparé et renvoient uniquement une sortie. La tâche de « retrouver tous les endroits où l'ancien client est appelé » est bien déléguée : la session principale recevra une liste, et non le contenu d'une vingtaine de fichiers.
- Une session - une tâche. Le passage à « corriger en même temps les styles dans l'en-tête » fait glisser les fichiers sans rapport dans leur contexte.
Signes qu'il est temps de nettoyer plus tôt
- L'agent propose une solution que vous avez refusée il y a plusieurs étapes.
- Il relit le fichier qu'il vient d'éditer et est surpris par son contenu.
- Corriger une erreur en crée une autre à un endroit qu'il a déjà corrigé.
- Les réponses deviennent plus longues et la différence devient plus petite.
Si cela se produit, continuer dans la même session coûte généralement plus cher que de consacrer quelques minutes au fichier de transfert.
Lorsqu'une règle n'est pas nécessaire
Les tâches courtes qui s'inscrivent dans une douzaine de messages ne nécessitent aucune procédure. Sur les modèles dotés d'une très grande vitre, le seuil peut être déplacé, mais les débris des tentatives annulées ne disparaîtront pas. Concentrez-vous sur le comportement de l'agent, pas sur le pourcentage : le nombre 50 est le point auquel vous devriez au moins y penser.
Нужна реализация под ваш проект или аудит архитектуры?
Разрабатываем сайты на Next.js, Telegram-ботов, интеграции с CRM и ИИ-агентов под ключ.