Blog › Construire avec l'IA

Construire avec l'IA

Claude Code statusline : la jauge qui dit quand vider le contexte

La Claude Code statusline se présente comme la ligne visible sous la zone de saisie : un script que vous rédigez, exécuté à chaque réponse, capable d’indiquer l’état actuel du contexte de la session. Dans le cadre d’un projet client, c’est elle qui vous indique le moment où Claude va commencer à perdre vos consignes de vue, avant même qu’une erreur ne se glisse dans le code livré. Avec trois couleurs, elle devient une jauge : vert signifie que vous poursuivez, orange que vous terminez la tâche, rouge que vous videz le contexte.

Pourquoi Claude Code baisse quand la session se remplit

Chaque fichier lu, chaque commande lancée, chaque réponse s’ajoute à la fenêtre de contexte. Claude relit tout cet historique à chaque message.

Ça a deux effets. Plus la fenêtre est chargée, plus les consignes du début pèsent peu face au reste : Claude les perd de vue et se met à inventer. Et chaque message coûte plus cher, en quota comme en temps, puisqu’il renvoie tout ce qui précède.

Et rien ne prévient. La session marche bien pendant une heure, puis Claude réécrit une fonction que vous lui aviez dit de ne pas toucher. Le mécanisme complet, et ce qu’on peut faire en cours de route, est dans l’article sur le contexte de Claude Code.

La statusline : un script sous la zone de saisie

Claude Code envoie à votre script, sur son entrée standard, un JSON qui décrit la session : le modèle, l’effort, le dossier, et un objet context_window. Le script imprime une ligne, Claude Code l’affiche. Les mises à jour sont regroupées toutes les 300 ms.

Les champs qui servent à la jauge :

  • context_window.context_window_size : la taille de la fenêtre, en tokens ;
  • context_window.current_usage : les tokens du dernier appel, détaillés (entrée, écriture et lecture du cache) ;
  • context_window.used_percentage : le pourcentage déjà calculé, sur les tokens d’entrée seulement.

Le réglage tient en une clé de ~/.claude/settings.json :

json
"statusLine": { "type": "command", "command": "node ~/.claude/statusline.js", "padding": 0 }

Le plus court reste la commande /statusline, suivie de ce que vous voulez voir en français : Claude écrit le script et met le réglage à jour. Tout est décrit dans la documentation de la barre de statut (nouvel onglet).

Une jauge en tokens, pas en pourcentage

Ma ligne affiche trois choses : le modèle, l’effort, puis le contexte sous la forme 137k/1m (14%). Seul ce dernier bloc change de couleur.

La couleur suit les tokens utilisés, pas le pourcentage :

  • vert sous 80 000 tokens ;
  • orange de 80 000 à 100 000 ;
  • rouge au-delà.

Sur une fenêtre d’un million de tokens, 14 % paraît confortable. En pratique, Claude commence à décrocher bien avant d’être plein : 137 000 tokens d’historique, c’est déjà beaucoup de consignes noyées. Un seuil en pourcentage resterait au vert pendant toute la partie où la qualité baisse.

Ces seuils sont les miens, réglés à l’usage. Ils se changent en une ligne dans le script, et c’est à faire : une session qui lit de gros fichiers se dégrade plus vite qu’une session de petites retouches.

Le prompt complet qui recrée exactement cette ligne est dans le lead magnet de cet article.

Vert, orange, rouge : trois gestes

Une couleur qui ne déclenche rien ne sert à rien. Voici ce que je fais à chacune.

Vert : vous continuez. Vous ouvrez de nouvelles tâches, Claude a la place de tout garder en tête.

Orange : vous finissez la tâche en cours. Pas de nouveau chantier dans cette session. Vous terminez, vous testez, vous validez.

Rouge : vous videz le contexte et vous repartez propre. Avant /clear, demandez à Claude d’écrire où il en est dans un fichier du projet : ce qui est fait, les fichiers touchés, la prochaine étape. La nouvelle session lit ce fichier et reprend sans que vous réexpliquiez le projet. Le même principe sert à passer la main d’un agent à un autre, quand c’est le quota qui tombe : voir la limite de Claude.

Aller plus loin : ccstatusline

Mon script fait une ligne, sans dépendance. Pour plus, ccstatusline est un outil open source qui compose la statusline à partir de widgets : branche git, coût de la session, durée, thèmes, plusieurs lignes. Il s’installe avec npm et se règle dans un menu, sans écrire de code.

Je l’ai utilisé avant d’écrire mon propre script. Si vous voulez tout voir d’un coup, il fait très bien le travail. Pour la jauge seule, c’était trop : quelques lignes de Node suffisent.

Les limites de la jauge

  • Elle mesure, elle ne protège pas. Au rouge, rien ne s’arrête : c’est à vous de lancer /clear.
  • Le chiffre arrive après coup. Il vient de la dernière réponse. Une grosse lecture de fichiers peut faire passer du vert au rouge en un seul tour.
  • Au début de session, rien ne s’affiche. Les champs sont vides avant le premier appel, et de nouveau juste après /compact.
  • Les seuils ne sont pas universels. 80 000 et 100 000 tokens marchent pour mes projets ; sur une base de code très grosse, baissez-les.
Livrer

Ce que vous pouvez vendre avec ça

À qui. Une agence web ou une PME de 5 à 30 personnes dont l’équipe se met à coder avec Claude Code, et qui constate des erreurs qu’elle ne comprend pas : des consignes ignorées, du code réécrit sans raison en fin de journée.

Ce que vous livrez. Une demi-journée de configuration : la statusline déployée sur chaque poste, les seuils adaptés à leur base de code, la règle des trois couleurs consignée dans leur CLAUDE.md, et le modèle de note de passation avant /clear. Dès le lendemain, le client constate le résultat : une ligne dont la couleur se modifie, et des sessions qui redémarrent propres plutôt que de dériver.

Comment le présenter. « Vos développeurs ne remarquent pas quand Claude commence à oublier leurs consignes. Je leur mets une jauge sous la zone de saisie : dès le rouge, ils repartent sur une session propre, avant que l’erreur ne touche le code. »

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