Avez-vous ces problèmes lorsque vous utilisez Claude Code ?
・Quand la session Claude Code s'allonge, la qualité des réponses baisse pour une raison ou une autre.
・Quelles sont les commandes ? Je ne comprends pas vraiment les différences.
・Je n'arrive pas à décider quand utiliser les sous-agents.
・Le contexte est un vrai bazar.
En ce moment, un post de Thariq (@trq212), un employé d'Anthropic, à propos de « la gestion de session Claude Code et le contexte d'un million de tokens » devient viral avec 540 000 vues 😳
Alors, pour tous ceux qui rencontrent ces problèmes, je vais décortiquer et expliquer le contenu de manière simple 👇
Post original ici : https://x.com/trq212/status/2044548257058328723?s=20
■ Les bases de la 𝗳𝗲𝗻ê𝘁𝗿𝗲 𝗱𝗲 𝗰𝗼𝗻𝘁𝗲𝘅𝘁𝗲
D'abord, comme prérequis, la fenêtre de contexte de Claude Code est d'un million de tokens.
Le contexte inclut tout ce qui suit :
・Le prompt système
・L'historique des conversations passées
・Tous les appels d'outils et leurs sorties
・Le contenu des fichiers chargés
En d'autres termes, plus la session est longue, plus les informations s'accumulent dans ce contexte.
■ Qu'est-ce que la 𝗱é𝘁é𝗿𝗶𝗼𝗿𝗮𝘁𝗶𝗼𝗻 𝗱𝘂 𝗰𝗼𝗻𝘁𝗲𝘅𝘁𝗲 ?
Un concept important ici est la « détérioration du contexte » (context rot).
À mesure que le contexte grandit, l'attention du modèle est dispersée sur de nombreux tokens, et les informations anciennes ou non pertinentes deviennent du bruit qui commence à interférer avec la tâche en cours.
Selon Thariq, la détérioration du contexte est observée à partir d'environ 300 000 à 400 000 tokens dans le modèle à un million de tokens. Cependant, ce n'est pas une règle stricte car cela dépend fortement de la tâche.
Comme la fenêtre de contexte a une limite stricte, lorsque vous approchez de la limite, vous devez résumer le travail précédent et continuer dans un nouveau contexte. Ce processus s'appelle la « compaction ».
■ Chaque tour est un « point de basculement »
Que doit faire Claude Code après avoir terminé une tâche ? C'est en fait le point de décision le plus important.
Thariq énumère cinq options :
𝟭. 𝗖𝗼𝗻𝘁𝗶𝗻𝘂𝗲𝗿
Envoyer le message suivant dans la même session. Le choix le plus naturel.
𝟮. /𝗿𝗲𝘄𝗶𝗻𝗱 (Double appui sur Échap Échap)
Revenir à un message passé et redémarrer à partir de là. Les messages suivants sont supprimés du contexte.
𝟯. /𝗰𝗹𝗲𝗮𝗿 (Nouvelle session)
Résumez vous-même les informations importantes et démarrez une nouvelle session.
𝟰. /𝗰𝗼𝗺𝗽𝗮𝗰𝘁
Demander au modèle de résumer la conversation jusqu'à présent et de continuer sur la base de ce résumé.
𝟱. 𝗦𝗼𝘂𝘀-𝗮𝗴𝗲𝗻𝘁𝘀
Déléguer le prochain bloc de travail à un agent avec son propre contexte vierge, en ne renvoyant que le résultat à la session parente.
■ Quand démarrer une nouvelle session
Grâce à la fenêtre de contexte d'un million de tokens, les longues tâches comme la construction d'une application full-stack à partir de zéro peuvent désormais être exécutées de manière plus stable.
Cependant, ce n'est pas parce qu'il reste de l'espace de contexte que vous devez continuer la même session.
La règle empirique de Thariq est simple :
🔥 « Si vous commencez une nouvelle tâche, vous devriez démarrer une nouvelle session. »
Il y a des exceptions. Par exemple, écrire la documentation immédiatement après avoir implémenté une fonctionnalité. Si vous démarrez une nouvelle session, Claude Code doit relire les fichiers qu'il vient d'implémenter, ce qui est lent et coûteux. Pour des tâches comme la documentation qui ne nécessitent pas une « haute intelligence », il est plus efficace d'accepter une certaine pollution du contexte et de simplement continuer.
■ 𝗿𝗲𝘄𝗶𝗻𝗱 est la fonctionnalité la plus sous-estimée
Thariq cite « rewind » comme la meilleure habitude pour une bonne gestion du contexte.
Dans Claude Code, vous pouvez revenir à n'importe quel message passé et redémarrer en appuyant deux fois sur la touche Échap (ou en utilisant la commande /rewind). Les messages après ce point sont complètement supprimés du contexte.
Considérez un scénario spécifique :
Claude a lu cinq fichiers et a essayé une approche qui a échoué.
❌ Réaction normale : « Ça n'a pas marché. Essaie X à la place. »
→ Tout le journal de l'approche échouée reste dans le contexte.
✅ Meilleure façon : Revenir (rewind) juste après la lecture des fichiers et redonner des instructions avec ce que vous avez appris.
→ « N'utilise pas l'approche A. Le module foo n'expose pas ça. Va directement avec B. »
En faisant cela, les tokens de l'essai-erreur infructueux disparaissent, permettant une nouvelle tentative dans un état propre.
De plus, en utilisant une fonctionnalité « résumer à partir d'ici », Claude peut résumer son propre apprentissage et créer un « mémo de soi passé à soi futur ».
■ La différence cruciale entre /𝗰𝗼𝗺𝗽𝗮𝗰𝘁 et /𝗰𝗹𝗲𝗮𝗿
Quand une session s'allonge, il y a deux façons de réduire le poids. Elles semblent similaires mais sont complètement différentes.
【/compact】
・Le modèle résume la conversation et remplace l'historique par ce résumé.
・Avec perte — ce qui est important est laissé à l'appréciation de Claude.
・Vous n'avez rien à écrire, mais Claude pourrait manquer quelque chose.
・Vous pouvez fournir des instructions pour le guider (ex : /compact focus on auth refactor, remove test debugging).
【/clear】
・Vous écrivez vous-même les informations importantes et démarrez une nouvelle session.
・Par exemple : « La cible est le middleware d'authentification, les contraintes sont X, les fichiers associés sont A et B, l'approche Y est exclue. »
・Cela demande un effort, mais le contexte résultant ne contient que les informations que vous avez choisies.
Choisir entre eux est un compromis entre contrôle et commodité.
■ Pourquoi 𝗰𝗼𝗺𝗽𝗮𝗰𝘁 échoue
Lors de l'utilisation de longues sessions, la qualité du compact peut devenir extrêmement médiocre.
Selon Thariq, la plus grande cause d'un mauvais compact est « lorsque le modèle ne peut pas prédire la direction du travail ».
Exemple :
Après une longue session de débogage, l'auto-compact est déclenché et résume l'investigation.
→ Si vous dites ensuite « Corrige aussi cet avertissement dans bar.ts », l'information sur cet avertissement pourrait avoir été supprimée du résumé axé sur le débogage.
Encore plus gênant est le dilemme qu'en raison de la détérioration du contexte, le modèle est dans son « état d'intelligence le plus bas » lors de l'exécution du compact. En d'autres termes, le résumé de la plus basse qualité est généré au moment où le résumé le plus précis est nécessaire.
Maintenant que nous avons un contexte d'un million de tokens, la meilleure stratégie est d'exécuter /compact vous-même pendant qu'il vous reste de la place, en ajoutant une explication de ce qu'il faut faire ensuite.
■ Quand utiliser les 𝗦𝗼𝘂𝘀-𝗮𝗴𝗲𝗻𝘁𝘀
Les sous-agents sont aussi une forme de gestion du contexte.
Quand Claude Code crée un sous-agent avec l'outil Agent, ce sous-agent a sa propre fenêtre de contexte vierge. Il fait autant de travail que nécessaire, résume le résultat et le renvoie à la session parente.
Le critère est simple :
👀 « Vais-je avoir besoin de cette sortie d'outil plus tard ? Ou la conclusion suffit-elle ? »
Si la conclusion suffit, vous devriez la confier à un sous-agent.
Claude Code appelle les sous-agents automatiquement, mais donner des instructions explicites est également efficace :
・« Lance un sous-agent et vérifie les résultats du travail en te basant sur ce fichier de spécifications. »
・« Utilise un sous-agent pour lire et résumer comment le flux d'authentification est implémenté dans une autre base de code. Utilise cela comme référence pour l'implémenter ici. »
・« Utilise un sous-agent pour écrire la documentation de cette fonctionnalité à partir du git diff. »
En ne ramenant pas les sorties intermédiaires dans le contexte parent, vous gardez le contexte propre.
■ Résumé : 5 techniques de gestion du contexte
Les choses que vous devriez toujours décider avant d'envoyer le message suivant après que Claude a terminé un tour :
- La tâche a-t-elle changé ? → /clear pour une nouvelle session
- L'approche a-t-elle échoué ? → /rewind pour revenir juste après le chargement des fichiers
- La session s'allonge-t-elle ? → /compact pendant qu'il reste de la place (avec une direction)
- Est-ce une tâche avec beaucoup de sorties intermédiaires ? → Déléguer à un sous-agent
- Le contexte peut-il être utilisé pour des tâches connexes ? → Continuer tel quel
À l'avenir, Claude lui-même aidera à ces décisions, mais pour l'instant, les utilisateurs qui prennent ces jugements peuvent considérablement améliorer la qualité des sorties de Claude Code.
La gestion de session est subtile, mais c'est une compétence qui change fondamentalement l'expérience Claude Code 🔥
Pour ceux qui ont trouvé cet article utile :
𝗖𝗹𝗮𝘂𝗱𝗲 𝗖𝗼𝗱𝗲 𝗦𝘁𝘂𝗱𝗶𝗼 @ 𝗝𝗮𝗽𝗼𝗻 (@ClaudeCode_love) est un compte géré par trois passionnés de Claude Code.
Nous publions quotidiennement des articles sur l'utilisation pratique en ligne de commande et l'automatisation.
Nous développons actuellement un agent IA en collaboration avec une entreprise cotée en bourse.
Notre contenu habituel 👇
・Cas réels de développement de produits utilisant Claude Code et Claude
・Utilisation de Claude Code / Vibe Coding / organisation des tendances de développement
・Dernières informations sur Claude Code en provenance de l'étranger
De la philosophie de développement à la conception, l'implémentation et l'amélioration, nous synthétisons les informations étrangères et primaires pour vous aider à livrer des produits fonctionnels, pas seulement à « finir de les fabriquer ».
Si cela vous intéresse, suivez-nous et jetez un œil ! Ça en vaudra la peine !
