# Headroom + RTK: экономия токенов

Headroom + RTK: настройка, которая экономит токены Claude Code.

Цель — растянуть лимит Claude Code без апгрейда тарифа: убрать лишний контекст до модели и сжать шумный вывод команд.

врезка `// Схема`: текст «Headroom режет лишний контекст на уровне прокси. RTK режет шум в выводе CLI-команд. Вместе они уменьшают токены, не меняя смысл задачи.»

## 1. Поставь Headroom CLI

- [ ] Открой репозиторий: github.com/headroomlabs-ai/headroom
- [ ] Убедись, что стоит Python 3.10+.
- [ ] Поставь CLI: pip install "headroom-ai[all]"
- [ ] Оберни Claude Code: headroom wrap claude
- [ ] Проверь роутинг и экономию: headroom doctor, затем headroom perf

## 2. Добавь RTK поверх вывода команд

- [ ] Открой репозиторий: github.com/rtk-ai/rtk
- [ ] На Mac проще всего: brew install rtk
- [ ] Проверь установку: rtk --version и rtk gain
- [ ] Подключи к Claude Code: rtk init -g
- [ ] Перезапусти Claude Code и проверь: обычный git status должен проходить через RTK.

## 3. Проверь связку на реальной задаче

- [ ] Запусти короткую сессию в репозитории, где много логов, grep, test output или больших file reads.
- [ ] Сравни до и после: сколько токенов отправляет Headroom и что показывает rtk gain.
- [ ] Если ответ модели стал хуже, ослабь агрессивность RTK и проверь, не сжимаешь ли source code там, где нужна точность.
- [ ] Если экономии почти нет, проверь, действительно ли Claude Code запущен через Headroom wrapper, а команды идут через Bash hook RTK.

## 4. Что не делать

- [ ] Не путай Headroom desktop app и бесплатный CLI: для бесплатной настройки нужен CLI из GitHub/PyPI.
- [ ] Не обещай фиксированные 92% экономии: это максимум на шумных задачах, обычные сессии зависят от контента.
- [ ] Не ставь сразу в критичный рабочий проект без тестовой сессии.
- [ ] Не запускай сжатие поверх секретов, приватных логов и токенов, которые не должны попадать в контекст вообще.

## Полезные ссылки

- Headroom продукт и обзор механики: extraheadroom.com
- Headroom CLI: github.com/headroomlabs-ai/headroom
- RTK: github.com/rtk-ai/rtk
- Разбор связки RTK + Headroom: andrewpatterson.dev/posts/token-savings-rtk-headroom

---

Источник: https://localhost:3000/m/headroom-rtk-token-savings