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

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

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