C’est quoi Headroom (et pourquoi l’utiliser) ?

Installer & brancher Headroom · 2 min

En une phrase

FORGE AI headroom est un proxy local qui s’intercale entre tes CLI IA (Claude Code, Codex) et l’API : il compresse le contexte et stabilise le cache pour réduire la saturation et le coût des sessions longues — sans aucune clé API.

Le problème qu’il résout

Les sessions IA longues se gavent de contexte inutile : gros logs de build, erreurs TypeScript à rallonge, sorties pnpm / vite / nest / prisma, stack traces répétitives, fichiers volumineux. Résultat : contexte saturé, réponses dégradées, coûts qui grimpent.

Ce que fait Headroom

• Compression proxy : retire du contexte ce qui est volumineux et non-cacheable.

• Cache de préfixe : stabilise le cache Anthropic (CacheAligner + prefix-freeze) pour maximiser les hits.

• Dashboard : visualise tokens, hit rate et économie.

Décisions clés à connaître

• Port standard : **8788**.

• Pas de clé API : Claude / Codex restent en mode compte / plan déjà authentifié.

• Tourne sur Windows et macOS (scripts natifs .ps1 / .sh).

Important : Headroom n’est pas obligatoire pour travailler. C’est un confort pour les sessions IA longues — les projets restent utilisables sans lui.

À retenir

• Headroom = proxy local de compression + cache pour Claude Code / Codex.

• Objectif : moins de saturation, moins de coût sur les longues sessions.

• Sans clé API, multi-OS, branché par projet.