Guide · quatre minutes

Claude Code lit moins : installer Headroom pas à pas

Quand Claude Code ouvre un gros fichier ou lance une commande qui affiche des pages de résultats, il lit tout. Et tout est compté dans ta limite d'utilisation (la quantité de travail que ton abonnement te laisse faire avant une pause). Headroom est un outil gratuit qui raccourcit ce que Claude lit avant que ça lui arrive. Il tourne sur ton ordinateur.

L'installation pas à pas de Headroom, la commande qui lance Claude Code avec lui, ce que tu peux en attendre, puis la commande qui l'enlève. Sur téléphone, garde ce guide ouvert et fais les gestes sur ton ordinateur.

Tu arrives d'un reel ?

Quatre minutes à lire, compte vingt minutes la première fois.

En plus de Claude Code, il te faut :

Claude Code installé sur ton ordinateur (Claude qui travaille directement dans tes dossiers)
Un ordinateur sous Mac ou Linux de préférence : sous Windows, je ne l'ai pas testé

Ce guide se fait dans Claude Code, compris dans la formule Claude Pro (la version gratuite ne l'inclut pas). Jamais installé ? Ces quatre leçons gratuites le mettent en place :

Ouvre le terminal

Le terminal est la fenêtre où l'on tape des commandes. Sur Windows : touche Windows, tape PowerShell, Entrée. Sur Mac : Commande + Espace, tape Terminal, Entrée. Toutes les lignes marquées terminal de ce guide se tapent là, une à la fois, suivies d'Entrée.

Réglage de sécurité

La commande qui lance Claude Code avec Headroom ajoute aussi, par défaut, un deuxième outil (Serena, qui aide Claude à se repérer dans ton code) dans la configuration de Claude Code, pour le projet où tu la lances. La notice dit qu'on peut s'en passer en ajoutant --code-memory none : tu le verras à l'étape 4. Choisis dès maintenant.

Installe uv, l'outil qui installe Headroom

Headroom s'installe avec un petit outil gratuit qui s'appelle uv. Copie la ligne de ton système, puis ferme et rouvre le terminal. Ces lignes sont recopiées de la notice officielle (docs.astral.sh/uv), je ne les ai pas lancées.

Sur Mac (ou Linux) :

Dans le terminal

curl -LsSf https://astral.sh/uv/install.sh | sh

Sur Windows :

Dans le terminal

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Installe Headroom

Une seule ligne, recopiée de la notice officielle (github.com/chopratejas/headroom). Elle installe Headroom dans son propre espace, sans toucher au reste de ton ordinateur.

Dans le terminal

uv tool install --python 3.13 "headroom-ai[all]"

Le piège

Sous Windows, je ne l'ai pas testé : la notice est contradictoire sur les fichiers prévus pour Windows. Si l'installation échoue, ne force pas : lis le message et regarde les signalements de problèmes (« issues ») sur la page du projet.

Lance Claude Code avec Headroom

Place-toi dans le dossier de ton projet, puis tape la ligne ci-dessous à la place de claude. Elle démarre un petit relais sur ton ordinateur, puis ouvre Claude Code réglé pour passer par lui. Tu la relanceras à chaque fois que tu veux travailler avec Headroom.

Dans le terminal

headroom wrap claude

Si tu ne veux pas du deuxième outil expliqué à l'étape 1, ajoute l'option de la notice :

Dans le terminal

headroom wrap claude --code-memory none

Tu retrouves Claude Code comme d'habitude : tu continues à lui parler normalement.

Vérifie que ça passe bien par Headroom

La notice propose une commande de contrôle. Ouvre un deuxième terminal et lance-la pendant que Claude Code tourne dans le premier.

Dans le terminal

headroom doctor

Elle dit si le routage marche. Pour voir les économies en direct, la notice cite aussi headroom dashboard.

Ce que tu peux en attendre

Ce que Claude lit	Le gain annoncé par le projet
Des données bien rangées (listes, JSON)	Soixante à quatre-vingt-quinze pour cent de moins
Le travail d'un agent de code en général	Environ vingt pour cent de moins
Du texte normal (articles, mails)	Très peu : le gain est faible

Ces chiffres sont ceux que les créateurs annoncent. Je ne les ai pas mesurés : sur tes fichiers, le gain peut être plus petit.

À savoir

Ce que Headroom raccourcit reste en entier sur ton ordinateur. D'après la notice, Claude peut redemander l'original quand il en a besoin : tu ne perds rien.

Pour l'enlever

Si ça ne te va pas, une commande défait ce que la précédente a posé, y compris le deuxième outil de l'étape 1. Recopiée de la notice officielle, non testée par moi.

Dans le terminal

headroom unwrap claude

Le raccourci se fait sur ton ordinateur, avant Claude.

Si ça a marché, tu as fait le premier pas. La formation fait pareil pour tes devis, tes relances et ton site, leçon par leçon : 29 € une seule fois, accès à vie. Prix de lancement.

Je prends l'accès

Si tu ne retiens qu'une chose

Installe uv puis Headroom. Lance Claude avec lui et regarde si ta limite tient plus longtemps. Si ça ne te va pas, une commande l'enlève.

Offre de lancement

La suite, c'est la formation complète.

82 leçons comme celle-ci, dans l'ordre, de ta première demande à Claude à ton propre site en ligne.
Chaque leçon te donne la phrase exacte à écrire, puis ce que tu dois voir à l'écran.
Des outils pour ton travail : devis, relances, agenda, réseaux, sans coder.
Tu bloques ? Tu réponds au mail de bienvenue et je te débloque.

29 €une seule fois, accès à vie

Prix de lancement : ensuite ce sera 49 €.

Je prends l'accès à vie

Paiement sécurisé par Stripe. Nécessite Claude Pro chez Anthropic (environ 20 € par mois).