Вайбкодинг · Headroom × Claude Code · установка по шагам
Перестань платить за токены, которые модель уже видела
Каждый раз, когда Claude Code лезет в файл, в лог или в длинную историю переписки, он отправляет в нейросеть гору текста, за который ты платишь. Половина этого текста ей на самом деле не нужна. Headroom встаёт посередине и сжимает всё лишнее до отправки: 60-95% меньше токенов при том же ответе. Открытый код, лицензия Apache-2.0, около 58 тысяч звёзд на GitHub. Разложу по шагам, что нужно до старта, какую команду вставить и что ты увидишь. Без терминальной магии, понятно человеку, который открывает это впервые
Что это за штука
Прокладка между Claude Code и нейросетью, которая режет лишний текст
Токен это кусочек текста, которым нейросеть считает и твой вопрос, и всё, что она вокруг него читает: файлы, логи, ответы инструментов, куски базы знаний, историю чата. Чем больше текста едет в модель, тем больше токенов ты жжёшь, и тем дороже выходит каждый шаг
Headroom это прокси (посредник), который поднимается прямо на твоём компьютере и встаёт между Claude Code и нейросетью. Всё, что Claude собирается отправить, сначала проходит через Headroom, он выкидывает повторы и воду, сжимает длинные куски и только потом передаёт дальше. В README у них это сказано в одну строку: сжать ответы инструментов, логи, файлы и куски базы знаний до того, как они дойдут до модели, 60-95% меньше токенов при том же ответе
Важное: сжатие обратимое. Оригиналы Headroom держит у себя в кэше, и если модели вдруг понадобятся полные данные, она их дозапросит. Ты ничего не теряешь, платишь меньше. Проект открытый, около 58 тысяч звёзд и свободная лицензия Apache-2.0. Ставим по шагам
Шаг 0 · что нужно до старта
Нужны две вещи: сам Claude Code и Python на компьютере
Headroom не работает сам по себе, он оборачивает уже установленный Claude Code (это Claude, встроенный в редактор кода VS Code, как программа на компьютере). Если его ещё нет, поставь сначала его, это один вечер и без программирования
Вторая вещь это Python версии 3.10 или новее. Python это язык, на котором написан Headroom, и заодно среда, через которую он ставится. У большинства он уже стоит вместе с системой, отдельно качать чаще всего не придётся, а как проверить и что делать, если версия старая, я показываю ниже в граблях
Если Claude Code ещё не стоит
У меня есть отдельный гайд: скачать, оплатить российской картой и запустить за один вечер, всё по скриншотам
Установить Claude Code с нуляClaude Code стоит и открыт? Тогда поехали ставить Headroom
Шаг 1 · вот он, репозиторий
Открой страницу проекта на GitHub
Репозиторий это папка проекта на GitHub, складе открытого кода, куда выкладывают такие штуки. Зайди на страницу по адресу github.com/headroomlabs-ai/headroom. Там видно число звёзд (столько людей отметили проект полезным), лицензию и инструкцию по установке. Так выглядит её шапка:
Compress tool outputs, logs, files, and RAG chunks before they reach the LLM. 60-95% fewer tokens, same answers
Шаг 2 · ставим инструмент
Одна команда в терминал, и Headroom в системе
Открой в VS Code встроенный терминал (верхнее меню Terminal → New Terminal). Терминал это чёрное окошко, куда пишут команды текстом. Вставь команду ниже и нажми Enter. Это официальный установщик через Python: pip это его встроенный магазин пакетов, а хвост [all] в квадратных скобках значит «поставь сразу со всем набором», чтобы потом ничего не докачивать
# ставим Headroom со всем набором
pip install "headroom-ai[all]"
Что увидишь
В терминале побегут строки установки, потом появится финальная строка вроде Successfully installed headroom-ai. Это значит, что в системе появилась новая команда headroom, ей мы дальше и пользуемся
Шаг 3 · оборачиваем Claude Code
Одна команда, и весь Claude Code едет через Headroom
Теперь самое главное. В том же терминале вставь команду ниже и нажми Enter. Слово wrap значит «оберни», то есть заверни Claude Code в Headroom, а claude это и есть тот самый Claude Code, который мы оборачиваем
# поднимаем прокси и запускаем Claude Code через него
headroom wrap claude
Что произойдёт
Headroom поднимет локальный прокси (посредника на твоём компьютере, наружу ничего не уходит), подцепит к нему Claude Code и запустит твою сессию Claude Code уже через себя. Внешне это тот же Claude Code, что и раньше, только теперь весь текст к модели идёт через сжатие
Хочешь убедиться, что всё встало правильно, запусти проверку здоровья (health-check). Открой второй терминал и вставь:
# проверяем, что всё на месте
headroom doctor
Если всё в порядке, doctor отчитается, что прокси на месте и подключение к Claude Code живо
Как пользоваться
Работаешь как обычно, а экономию смотришь на дашборде
Дальше ничего нового учить не надо. Ты пишешь Claude Code задачи ровно так же, как раньше: попроси собрать страницу, разобрать файл, написать текст. Всё это едет через Headroom, сжимается по пути, а ты просто получаешь ответ. Разница только в счёте за токены
Чтобы увидеть эту разницу цифрами, открой дашборд (панель экономии в браузере). Запусти команду ниже, и Headroom покажет живой процент сокращения токенов и прикидку экономии в долларах:
# открыть живой дашборд экономии
headroom dashboard
Быстро глянуть цифры прямо в терминале, без браузера, можно короткой командой headroom savings
Дашборд выглядит примерно так: сверху общий процент, ниже видно, на чём именно срезаны токены
Токенов срезано
92%
Пример по одному запросу
65k → 5k токенов
Оценка экономии
≈ $ за сессию
Чтобы не споткнуться
Headroom не находит claude и просит Python 3.10: что проверить
- 01
Сначала Claude Code, потом Headroom
Headroom нечего оборачивать, если самого Claude Code на компьютере ещё нет. Если headroom wrap claude ругается, что не находит claude, почти всегда дело в этом, вернись к Шагу 0
- 02
Проверь версию Python
Нужен Python 3.10 или новее. Набери в терминале python3 --version. Если цифра меньше 3.10 или команду вообще не нашли, скачай свежий Python с официального сайта python.org и поставь, дальше установка Headroom пойдёт как надо
- 03
Сжатие обратимо, потери данных не бойся
Кажется, что если выкинуть половину текста, модель что-то недопоймёт. Не недопоймёт: оригиналы Headroom держит в кэше, и если модели нужны полные данные, она их дозапросит. Ты режешь счёт за токены, а не качество ответа
Проекты живые, команды иногда меняются. Актуальные шаги всегда сверяй с первоисточником: github.com/headroomlabs-ai/headroom
ИИ-Лагерь
Токены срезал. Дальше лестница пустая
Установил Headroom, обернул Claude Code, проверил doctor, увидел на дашборде процент сэкономленных токенов
Ступеней в статье было четыре, а до результата - ни одной. Дальше пусто: что делать с освободившимся бюджетом, чтобы на выходе был не процент экономии, а готовый продукт
На ИИ-Лагере беру этот освободившийся бюджет токенов и веду от него до первого продукта: ставим инструменты, настраиваем под тебя, собираем результат, который можно продать
Это заявка в мой закрытый канал, не оплата. Впускаю сразу, дальше бот в личке отдаёт путёвку на три дня
Сохрани себе
Памятка по шагам
- 01 Сначала Claude Code, потом Headroom Headroom нечего оборачивать, если самого Claude Code на компьютере ещё нет. Если headroom wrap claude ругается, что не находит claude, почти всегда дело в этом, вернись к Шагу 0
- 02 Проверь версию Python Нужен Python 3.10 или новее. Набери в терминале python3 --version . Если цифра меньше 3.10 или команду вообще не нашли, скачай свежий Python с официального сайта python.org и поставь, дальше установка Headroom пойдёт как надо
- 03 Сжатие обратимо, потери данных не бойся Кажется, что если выкинуть половину текста, модель что-то недопоймёт. Не недопоймёт: оригиналы Headroom держит в кэше, и если модели нужны полные данные, она их дозапросит. Ты режешь счёт за токены, а не качество ответа
Куда идти дальше
Следующий шаг
Это заявка в мой закрытый канал, не оплата. Впускаю сразу, дальше бот в личке отдаёт путёвку на три дня