Blog › Construire avec l'IA

Construire avec l'IA

Claude Code context : ne plus perdre le fil du client

Claude Code context : dès que la fenêtre est pleine, l’outil produit un résumé de la conversation et supprime le reste, résumé qui laisse échapper des éléments. Sur le projet de votre client, ce sont souvent les plus coûteux : la décision arrêtée le matin avec lui, la piste déjà écartée qui resurgit l’après-midi. Deux plugins résolvent ce problème : You should know vous indique ce qui a dérapé, auto-handoff transmet la suite à une session neuve avec un point d’étape écrit.

Pourquoi Claude Code perd le fil en pleine session

Claude Code travaille dans une fenêtre de contexte : tout ce qui a été dit, lu et produit dans la session doit y tenir. Une longue tâche sur un vrai projet la remplit vite, parce que chaque fichier lu et chaque sortie de test y entre.

Près de la limite, la compression automatique (auto-compact) se déclenche : Claude Code résume la conversation et repart de ce résumé. La session continue sans planter, mais le résumé est avec pertes, et vous ne choisissez pas ce qu’il garde.

Ce qui saute en premier, c’est ce qui ne se voit pas dans le code : pourquoi une option a été écartée, ce que le client a refusé, l’hypothèse qu’il fallait vérifier. Claude Code repart alors sur une piste déjà abandonnée, avec beaucoup d’assurance.

Pour voir où en est votre session, tapez /context : la commande affiche ce qui occupe la fenêtre et la place qui reste avant la compression. Les seuils publiés varient d’un guide à l’autre et d’une version à l’autre : fiez-vous à ce que la commande affiche.

You should know : une relecture pendant que Claude travaille

Le premier plugin est déjà dans Claude Code depuis la version 2.1.287, désactivé par défaut. Une fois activé, un agent à côté relit la conversation pendant les longues tâches et cherche la chose que vous risquez de manquer.

Quand il trouve quelque chose, une note courte s’affiche au-dessus de l’invite, juste sous la dernière réponse : un test sauté sans le dire, un résultat qui cloche, une décision prise par Claude sans vous la soumettre. Vous répondez par un chiffre : 1 pour en savoir plus, 2 si vous le saviez déjà, 0 pour fermer. Un sujet marqué connu ne revient plus.

L’agent qui relit n’a aucun outil : il ne lit pas vos fichiers, ne lance rien et ne change pas ce que fait Claude Code. Il attire votre attention, il ne relit pas le code à votre place : le diff reste à relire avant de livrer.

Avant de compter dessus :

  • une connexion directe à l’API Claude (compte claude.ai ou clé de la Console) : derrière une passerelle LLM ou un apiKeyHelper, le plugin n’apparaît pas ;
  • la télémétrie active : une session où elle est coupée ne le propose pas ;
  • un coût : chaque vérification est une requête en arrière-plan qui compte dans vos limites d’usage ou votre facture API. Sur un forfait serré, surveillez votre limite Claude les premiers jours.

auto-handoff : un point d’étape à la place du résumé

Le second plugin, auto-handoff, est open source (licence MIT) et remplace la compression automatique. Au lieu de résumer en place, il prépare la suite avant que la fenêtre déborde.

Au seuil, 160 000 tokens par défaut pour une fenêtre de 200 000, il refuse les nouveaux appels d’outils, pour qu’une rafale de lectures ne fasse pas tout déborder. Haiku écrit alors un point d’étape sur le disque, avec une structure fixe :

  • le travail en cours ;
  • les décisions prises ;
  • les hypothèses à vérifier ;
  • les impasses, ce qui a été essayé et écarté ;
  • la dernière demande, et si elle a reçu sa réponse ;
  • la prochaine étape.

Les fichiers modifiés, les commits et les tickets sont ajoutés par le code à partir de la conversation, pas par la mémoire du modèle. Puis le plugin vide la session et en ouvre une neuve, qui lit le point d’étape et reprend là où l’autre s’est arrêtée. Dans la démo du dépôt, la session neuve se remet au travail en 7 secondes environ.

Le format du point d’étape se modifie : deux fichiers markdown, un pour les sections, un pour les instructions données à la session neuve. Un garde-fou limite à 2 le nombre de relais d’affilée sans message de votre part.

Sur le premier relais d’un projet client, j’ouvrirais le point d’étape avant de laisser la session neuve repartir : c’est là qu’on voit si Haiku a gardé la bonne décision, et il se corrige en deux lignes.

Ce qui change sur un projet client

Un point d’étape, c’est le journal du projet de votre client : ses décisions, ses fichiers, les pistes refusées. Il mérite les mêmes précautions que son code.

Par défaut, auto-handoff sert chaque point d’étape comme une page web sur votre réseau privé, pour l’ouvrir depuis votre téléphone. Pratique sur vos projets à vous ; sur celui d’un client, c’est le premier réglage à changer, et il fait partie du kit à recevoir plus bas. Une autre option du plugin laisse hors du point d’étape les fichiers à ne jamais recopier, comme un .env ou un export de données.

Les règles qui doivent survivre à tout, relais compris, ont leur place dans le fichier CLAUDE.md du projet : Claude Code le relit au début de chaque session. Le point d’étape dit où en est la journée ; les règles du client restent dans CLAUDE.md.

Pour installer et gérer d’autres plugins, le guide des plugins Claude Code détaille la marche à suivre.

Livrer

Ce que vous pouvez vendre avec ça

Mission de développement de 3 à 6 semaines pour une PME de 10 à 50 personnes : application interne, outil de devis, portail client. Sur ce format, les sessions longues sont la norme, et un client qui voit revenir une option qu’il a refusée deux semaines plus tôt perd confiance.

Outre le code, votre livrable inclut les points d’étape, relus et classés par date, façon journal de bord. Le client découvre chaque décision, chaque piste écartée et pourquoi, sans assister aux sessions.

La phrase pour le présenter : « Chaque décision que nous prenons ensemble est écrite, et l’outil repart de là le lendemain : vous ne payez jamais deux fois la même discussion. » Pour démarrer avec l’outil lui-même, le guide Claude Code pose les bases.

L'Accélérateur IA

Signez vos 3 premiers clients IA en 180 jours

On rejoint L'Accélérateur IA sur appel d'admission : 45 minutes pour voir si le programme correspond à votre projet. Gratuit et sans engagement.

Réservez votre appel d'admission