Toutes les ressources

Outils · 5 min

L'outil open source qui compresse ton contexte IA (jusqu'à 95% de tokens en moins)

Un senior engineer de Netflix a créé un outil open source qui compresse le contexte de tes agents IA et divise ta facture par 12 sur les workflows les plus lourds. Il s'appelle Headroom.

Ce qu’il y a dedans

  • Le problème
  • Le prompt d'installation (à copier tel quel)
  • Où coller ce prompt
  • Ce que Claude va faire concrètement

Un senior engineer de Netflix a créé un outil open source qui compresse le contexte de tes agents IA et divise ta facture par 12 sur les workflows les plus lourds. Il s'appelle Headroom. Le problème habituel : l'installer demande de toucher au terminal. La solution : voici le prompt que tu colles dans Claude Code (ou Claude Desktop en mode agent), et Claude installe tout seul, vérifie, configure ton CLAUDE.md, et te dit quand c'est prêt. Zéro ligne de commande à taper.


Le problème

Quand tu utilises Claude Code, Claude Desktop ou n'importe quel agent IA, il rebalance à chaque tour un paquet de contexte inutile : fichiers entiers, logs bruts, résultats d'outils, résumés de ce qu'il vient de faire (que tu vois déjà dans ton IDE).

Sur une session de 3h, ça peut représenter 80% de tes tokens consommés. Ta facture Anthropic gonfle sans que la qualité augmente. Sur Claude Pro / Max, tu atteins ton plafond deux fois plus vite qu'il faudrait.

Headroom règle ça en insérant une couche de compression entre ton agent et le modèle. Le problème c'est que l'installer demande normalement de manipuler Python ou npm dans un terminal. Beaucoup de gens décrochent à ce moment-là.

La solution : laisse Claude s'installer lui-même. Voici le prompt.


Le prompt d'installation (à copier tel quel)

code
Installe le skill Headroom sur ma machine pour compresser mon contexte IA
et économiser mes tokens.

Voici ce que je veux que tu fasses, dans cet ordre :

1. Détecte mon système d'exploitation (Mac, Linux, Windows).
2. Vérifie que Node.js 18 ou plus est installé (commande : node --version).
   Si Node est absent, indique-moi précisément comment l'installer
   depuis nodejs.org (version LTS) et arrête-toi ici.
3. Une fois Node disponible, lance :
   npx headroom-ai@latest wrap claude
   Cette commande installe Headroom et l'active en transparent
   sur Claude Code.
4. Vérifie que ça tourne avec : npx headroom-ai@latest doctor
   Toutes les checks doivent être vertes.
5. Ouvre (ou crée) le fichier CLAUDE.md à la racine de mon projet
   et ajoute en bas ces trois lignes en commentaire :

   # Headroom activé sur ce projet
   # Pour voir les tokens économisés : npx headroom-ai output-savings
   # Pour l'auto-correction du CLAUDE.md : npx headroom-ai learn --apply

6. Fais-moi un résumé de 5 lignes maximum :
   - Ce qui a été installé
   - La commande exacte à taper la prochaine fois pour lancer
     Claude Code avec Headroom activé
   - Comment vérifier mes économies dans une semaine

Si tu bloques à une étape, dis-le-moi précisément, ne bricole pas
ta manière de contourner. J'ai besoin de savoir ce qui a marché
et ce qui n'a pas marché.

Où coller ce prompt

Claude Code (recommandé)

Ouvre Claude Code dans ton dossier de travail habituel. Colle le prompt dans la conversation. Claude va exécuter chaque étape en te montrant les commandes qu'il lance. Tu regardes, tu approuves quand il te demande. Fin.

Claude Desktop avec Mode Agent

Sur Claude Desktop récent (avec le connecteur Bash / Filesystem activé), le prompt marche pareil. Claude a accès à ton terminal, il lance les commandes, il te montre les résultats.

Cursor

Ouvre le Composer (Cmd/Ctrl + I), colle le prompt. Cursor exécute les commandes shell si tu l'autorises.

Autre IA (ChatGPT, Gemini, etc.)

Le prompt marche aussi, mais tu devras copier-coller chaque commande dans ton terminal manuellement. Moins fluide. Reste sur Claude Code ou Claude Desktop si tu peux.


Ce que Claude va faire concrètement

Quand tu envoies le prompt, tu vas voir Claude enchaîner :

  1. Un node --version pour vérifier ton Node.js.
  2. Si tout est bon, un npx headroom-ai@latest wrap claude. La première fois, ça télécharge Headroom (30 secondes) et le lance. Les fois suivantes, c'est instantané.
  3. Un npx headroom-ai@latest doctor qui affiche 5-6 lignes de checks avec des ✓ verts. Si un check est rouge, Claude va te dire quoi faire.
  4. Une modification de ton CLAUDE.md (ou création si tu n'en as pas) avec les 3 lignes de rappel.
  5. Un résumé clair de ce qui est en place.

Tu n'as jamais tapé de commande. Tu as juste collé un prompt et regardé Claude bosser.


Le second prompt (auto-optimisation continue)

Une fois Headroom installé, lance ce second prompt une fois par semaine dans ton projet :

code
Lance : npx headroom-ai learn --apply

Cette commande va scanner mon historique de sessions Claude,
repérer les erreurs récurrentes que je corrige à la main,
identifier le pattern derrière, et écrire les corrections
directement dans mon CLAUDE.md.

Une fois fini :
1. Montre-moi le diff exact de ce qui a été ajouté au CLAUDE.md
2. Explique-moi en 3 lignes quelles classes d'erreurs Headroom
   a détectées et corrigées
3. Dis-moi combien de tokens j'ai économisé sur la semaine
   avec : npx headroom-ai output-savings

Ce second prompt fait la magie sur le long terme. Ton CLAUDE.md devient de plus en plus précis pour ton projet sans que tu écrives une ligne. Après 3-4 semaines, tu as un vrai document sur-mesure, écrit par Headroom en observant tes vraies erreurs.


Le résultat concret

Avant / après sur une session type dans Claude Code (recherche + lecture + modif d'un fichier) :

Sur Claude Pro (200K tokens/5h), sans Headroom tu tapes la limite en une session. Avec Headroom, tu tiens la semaine entière sur le même quota. Sur l'API, ta facture chute d'un facteur 3 à 12 selon ta charge.


Mes 3 conseils pour bien démarrer

  1. Colle le prompt d'installation dans Claude Code une fois, pas dans plusieurs projets. Une fois Headroom installé sur ta machine, npx headroom-ai wrap claude marche depuis n'importe quel dossier. Pas besoin de refaire l'install par projet.
  2. Lance le second prompt (learn --apply) tous les vendredis. C'est le rythme qui marche le mieux. Assez fréquent pour que ton CLAUDE.md s'améliore, pas assez pour saouler. Mets-toi un rappel dans ton agenda.
  3. Regarde ton output-savings chaque semaine. Pas juste pour le chiffre. Ça te montre où Headroom a le plus d'impact (souvent les résultats d'outils et les logs). Tu comprends d'où venaient tes surcoûts avant. Ça change ta manière de designer tes agents.

Si tu veux qu'on installe Headroom et qu'on configure learn --apply en pipeline automatique sur ton stack, c'est le genre de setup que je fais en une session pour mes clients. Ton CLAUDE.md s'améliore tout seul chaque semaine, tu ne fais rien.


Les limites à garder en tête

  1. Le prompt d'installation demande que Claude ait accès à ton terminal. Claude Code et Claude Desktop (avec le Mode Agent activé) l'ont par défaut. Si tu es sur claude.ai dans le navigateur sans connecteur, le prompt te donnera juste les commandes à taper à la main.
  2. Le facteur 12 est le pic, pas la moyenne. Sur des workflows outil-lourds (Claude Code sur un gros projet, agents avec beaucoup d'appels API), tu tapes le pic. Sur un chatbot classique, tu seras plus proche de x3 à x5. Réel quand même, mais pas x12.
  3. learn --apply demande de l'historique. Sur ton premier jour d'utilisation, Headroom n'a rien à apprendre. Compte 1-2 semaines d'usage avant que le second prompt devienne vraiment utile.
  4. Headroom compresse le contexte, pas la latence. Il économise du coût et du contexte, pas du temps réseau. Si ton problème c'est que Claude met du temps à répondre, ce n'est pas le bon outil.

Le mot de la fin

L'audience qui rate Headroom aujourd'hui, c'est celle qui décroche dès qu'on parle de terminal. Le prompt d'installation règle ça pour de bon : tu colles, Claude exécute, tu regardes.

Colle le prompt d'installation ce soir dans Claude Code. Compte 2 minutes. La prochaine fois que tu lances une session, tu es sur Headroom sans avoir tapé une commande. Le vendredi, tu colles le second prompt, Headroom optimise ton CLAUDE.md tout seul. Répète, ton agent devient plus intelligent chaque semaine.

Un ingénieur senior de Netflix a écrit cet outil et l'a donné gratuitement. Il te reste juste à lui laisser une chance.

S’inscrire à la newsletter

Pas le temps de tout monter toi-même ?

Je structure ta boîte : systèmes, process et un OS qui fait tourner l’opérationnel sans que tout repasse par toi. On commence par un diagnostic de 45 minutes : on regarde comment ta boîte tourne, ce qui te coûte le plus, et tu repars avec un récap écrit.

ou écris-moi :@capitain.aimaxence@corelabs.studio