Governor для Claude Code: как не сжечь токены на логах и раздутой памяти — VogueTech

Что нового

Governor — плагин для Claude Code Max, который не просто «ужимает стиль», а системно экономит токены и контекст. Он работает в нескольких направлениях сразу:

Компактный профессиональный режим по умолчанию
Плагин автоматически включает сжатый, деловой стиль ответов во всех сессиях Claude Code. Команда /governor:on включает режим, /governor:off — отключает.
Сжатие файлов памяти (CLAUDE.md и не только)
Команда /governor:compress CLAUDE.md переписывает длинные файлы правил и заметок в более плотный текст. При этом Governor защищает код, команды, пути, URL, версии и заголовки.
Фильтрация шума из вывода инструментов
Плагин перехватывает громоздкий вывод Bash, тестов и сборки. Он оставляет только важные части (например, строки с ошибками) и убирает тысячи строк однообразных логов.
Планирование и защита от «расползания» задач
Для больших задач есть связка /governor:plan + /governor:guard: сначала Governor формирует план-«контракт», затем следит, чтобы работа не вышла за рамки этого плана.
Аудит и телеметрия
Команды /governor:status и /governor:audit показывают, где вы теряете токены: раздутые файлы памяти, лишний вывод инструментов, неудачные попытки, компакции.
Готовые правила для других агентов
В репозитории есть rule-файлы для Codex, Gemini CLI, Cursor, Windsurf и Cline. Они включают только компактный стиль, без хуков и телеметрии.

Конкретные цифры

1. Экономия токенов на ответах
Тест: три технических объяснения, Claude 3.5 Sonnet, без инструментов (локальные прогоны через Claude CLI).

Контроль (без плагинов): 2967 токенов, в среднем 989 токенов на запрос
Caveman (плагин-«стайлкомпрессор»): 1634 токена, 545 токенов на запрос, экономия 44,9%
Governor: 1320 токенов, 440 токенов на запрос, экономия 55,5% против контроля

2. Сжатие файлов памяти
Тест на project-notes.md из набора Caveman:

Оригинал: 1877 токенов
Caveman fixture: 924 токена, экономия 50,8%
Governor (уровень medium): 838 токенов, экономия 55,4%

3. Фильтрация вывода инструментов
Тест на синтетическом шумном выводе pytest -vv с сохранением строк с ошибками:

Сырой вывод: около 54 314 токенов
После фильтрации Governor: около 1726 токенов
Блокировка: 96,8% токенов вывода

Governor не только ужимает стиль, но и уменьшает размер постоянной памяти и шум от инструментов, что особенно важно при длинных сессиях и большом контексте.

Как это работает

Хуки Claude Code

Governor подключается к жизненному циклу Claude Code через хуки:

SessionStart — включает компактный режим в начале каждой сессии.
UserPromptSubmit — перед каждым ответом заставляет Claude отвечать кратко и по делу.

Благодаря этому вам не нужно каждый раз просить «пиши короче» — плагин делает это автоматически.

Сжатие памяти `/governor:compress`

Процесс сжатия файла (например, CLAUDE.md) выглядит так:

Создать резервную копию с таймстампом.
Пометить защищённые фрагменты:
- блоки кода
- inline-код
- пути и URL
- команды
- переменные окружения
- версии
- заголовки и таблицы
- предупреждения
Переписать файл в более плотный, профессиональный текст с учётом уровня сжатия.
Убрать служебные маркеры.
Проверить, что все защищённые фрагменты сохранились.
При необходимости попытаться восстановить защищённые фрагменты.
Оценить экономию токенов. Если экономия слишком мала, Governor откатывается к бэкапу.
Показать точные оценки «до/после» и путь к резервной копии.

Доступны три уровня сжатия:

light — убирает воду и повторы, но оставляет большую часть рассуждений.
medium — сжимает повествование до списков решений и ключевых пунктов.
aggressive — оставляет только правила, факты, команды, риски и принятые решения.

Переменная окружения GOVERNOR_ALLOW_LOW_SAVINGS=1 отключает защиту от «бессмысленного сжатия» и разрешает сохранять файл даже при маленькой экономии. По умолчанию Governor предпочитает откатиться к бэкапу, чем делать вид, что помог.

Фильтрация вывода инструментов

Когда вы запускаете через Claude Code Bash, тесты или сборку, Governor анализирует вывод:

Ищет сигнальные части: ошибки, фейлы тестов, важные сообщения.
Суммирует однообразный шум (например, тысячи строк успешных тестов).
Передаёт в контекст только сжатый, информативный вывод.

Если вам нужно получить полный вывод для диагностики, используйте:

/governor:full

Следующая команда Bash вернёт весь лог без фильтрации.

Планирование и защита от «расползания» задач

Для больших задач Governor предлагает явный контракт:

/governor:plan "task" — формирует план реализации, который фиксирует объём работ.
/governor:guard — сравнивает текущие изменения с утверждённым планом и сигнализирует о выходе за рамки.

Это снижает количество повторных попыток и уменьшает риск того, что Claude уйдёт в сторону от исходной задачи, тратя контекст на лишние эксперименты.

Телеметрия и аудит

Governor ведёт локальный JSONL-лог по адресу:

~/.claude/plugins/governor/

Он записывает:

сколько токенов вывода инструментов удалось заблокировать;
случаи, когда вы запросили полный вывод;
подсказки по «опасным» промптам;
неудачные Bash-запуски;
компакции и их экономию;
снимки статуслайна;
экономию от сжатия памяти.

Команда /governor:status показывает «дашборд» по текущей сессии: заблокированные токены, компакции, ошибки, статус режимов. /governor:audit ищет раздутые файлы памяти и правил, а также другие источники контекстного мусора.

Поддержка других агентов

Скрипт установки может разложить rule-файлы Governor в проекты других агентов. Поддерживаются:

Codex — AGENTS.md
Gemini CLI — GEMINI.md
Cursor — .cursor/rules/governor.mdc
Windsurf — .windsurf/rules/governor.md
Cline — .clinerules/governor.md

В этих средах Governor даёт только компактный профессиональный стиль. Полный набор функций (хуки, телеметрия, статуслайн, фильтрация Bash) сейчас нацелен на Claude Code.

Что это значит для вас

Кому это действительно полезно

Разработчики, которые живут в Claude Code
Если вы постоянно держите открытый проект, большую CLAUDE.md, кучу заметок и часто запускаете тесты или сборку, Governor помогает:
- уменьшить размер всегда загруженной памяти (CLAUDE.md, project-notes);
- не забивать контекст логами pytest -vv и сборки;
- получить более короткие и структурированные ответы без ручного «режь текст».
Команды с жёстким лимитом токенов и квоты
Governor экономит не только на длине ответов, но и на «системном» мусоре: памяти и логах. Это снижает расходы и уменьшает риск упереться в лимит контекста в середине важной задачи.
Инженеры, которые ведут большие проекты через Claude Code
Планирование и /governor:guard полезны, если вы поручаете Claude большие рефакторинги, внедрение фич или миграции. Плагин помогает не вывалиться за рамки задачи и не тратить контекст на лишние ветки.

Когда Governor может мешать

Диагностика сложных багов по логам. Если вы хотите видеть полный вывод тестов или команд, фильтрация будет мешать, пока не выполните /governor:full.
Работа с секретами. Команда /governor:compress прогоняет содержимое файла через активный воркфлоу Claude Code. Не стоит сжимать файлы с токенами доступа, ключами или чувствительными данными.
Сценарии, где важна длинная развёрнутая «литературная» подача. Governor по умолчанию нацелен на деловой, компактный стиль. Если вы пишете, например, маркетинговый текст с большим количеством примеров и нарратива, возможно, захочется временно отключить /governor:off.

Доступность и ограничения

Governor рассчитан на пользователей Claude Code Max.
Плагин работает локально, через директорию плагинов Claude.
Для клонирования репозитория через gh repo clone и установки из GitHub может потребоваться доступ к GitHub; при ограничениях по регионам придётся использовать VPN или альтернативный способ скачивания.

Если вы уже используете Caveman или другие «стайл-компрессоры», Governor даёт дополнительный слой контроля: сжатие памяти, фильтрацию инструментов и телеметрию.

Место на рынке

Сейчас есть два основных типа инструментов экономии токенов:

Плагины, которые просто сжимают стиль ответа
Пример — Caveman. Он хорошо уменьшает длину ответов, что подтверждают бенчмарки: экономия 44,9% токенов на трёх технических промптах.
Инструменты, которые управляют всей сессией
Governor относится ко второй категории. Он:
- экономит 55,5% токенов на тех же промптах — чуть больше, чем Caveman;
- дополнительно сжимает файлы памяти (ещё 55,4% против исходника в тесте);
- блокирует до 96,8% токенов шума в выводе инструментов.

Прямых цифр по сравнению с GPT-4o, Claude 3.5 Haiku или другими моделями в бенчмарках нет, потому что Governor работает поверх Claude Code и управляет именно расходом контекста и токенов внутри этой среды.

Если вы уже пользуетесь Caveman, сценарий может быть таким:

оставить Caveman, если вам нужен только компактный стиль;
перейти на Governor, если вы хотите ещё и сжатие памяти, фильтрацию Bash и телеметрию;
в бенчмарках автора Governor показывает чуть большую экономию токенов на ответах и более высокую экономию на памяти.

Установка

Локальная разработка

Если вы хотите запустить Governor из текущей директории как плагин Claude:

claude --plugin-dir .

Однострочная локальная установка

Для быстрой установки из уже клонированного репозитория:

bash install.sh --force

После этого перезапустите Claude Code и выполните:

/governor:status
/governor:audit
/governor:compress CLAUDE.md

Governor автоматически запустится в компактном профессиональном режиме.
Команда /governor:off отключает сжатие ответов, /governor:on — включает обратно.

Установка из репозитория GitHub

gh repo clone 0xhimanshu/governor
cd governor
bash install.sh --force

Установка rule-файлов для других агентов

Если вы хотите добавить правила компактного стиля в другие агенты, используйте:

bash install.sh --project /path/to/project --agents all

Поддерживаемые файлы правил:

| Agent | Rule File | |--------|-------------------------------------| | Codex | AGENTS.md | | Gemini CLI | GEMINI.md | | Cursor | .cursor/rules/governor.mdc | | Windsurf | .windsurf/rules/governor.md | | Cline | .clinerules/governor.md |

В этих средах вы получите только компактный профессиональный стиль без хуков и телеметрии.

Как запустить и команды Governor

Основные команды:

/governor:on

Включить компактный профессиональный режим ответов.

/governor:off

Отключить сжатие ответов.

/governor:status

Показать дашборд использования и «карту тепла» по растрате токенов.

/governor:audit

Найти раздутые файлы памяти/правил и другие источники контекстного мусора.

/governor:compress CLAUDE.md

Сжать файл памяти с защитой важных фрагментов и проверкой экономии.

/governor:full

Разрешить следующей Bash-команде вернуть полный вывод без фильтрации.

/governor:plan "task"

Сформировать «контракт» реализации перед большой задачей.

/governor:guard

Проверить текущие изменения относительно утверждённого плана.

/governor:benchmark

Объяснить или суммировать результаты бенчмарков.

/governor:install-rules

Скопировать правила компактного режима в проекты других агентов.

Режимы запуска и переменные окружения

GOVERNOR_DEFAULT_MODE=off — запустить Claude Code с установленным, но по умолчанию выключенным Governor.
GOVERNOR_ALLOW_LOW_SAVINGS=1 — разрешить сохранять результаты сжатия файлов даже при небольшой экономии токенов.

Как оценить эффект: бенчмарки

В репозитории есть папка benchmarks/ и скрипт сравнения результатов.

Рекомендуемые условия прогонов:

control — без плагинов стиля/экономии токенов;
caveman — с включённым Caveman;
governor-hooks — включённые хуки Governor, память без изменений;
governor-compressed — Governor после /governor:compress CLAUDE.md;
governor-strict — опциональный строгий режим для больших задач.

Процесс:

Заполнить benchmarks/run-sheet.csv.
Запустить сравнение:

python3 scripts/compare_benchmarks.py benchmarks/run-sheet.csv

Основные метрики:

расход за пять часов;
пик использования контекста;
токены ответов ассистента;
заблокированные токены вывода инструментов;
количество неудачных вызовов инструментов;
число компакций;
wall time;
успешность выполнения задач.

На что обратить внимание

Если хуки Governor не срабатывают, /governor:status почти ничего не покажет.
Скрипт установки не перезаписывает уже существующие кастомные статуслайны в Claude Code.
Сжатие файлов прогоняет содержимое через активный воркфлоу Claude Code. Не используйте /governor:compress для файлов с секретами или конфиденциальными данными.
Перед диагностическими командами, где важен полный лог, запускайте /governor:full.
Если вы хотите, чтобы Governor был установлен, но не вмешивался по умолчанию, запускайте Claude Code с GOVERNOR_DEFAULT_MODE=off.

Лицензия и вклад

Governor распространяется по лицензии MIT (подробности в файле LICENSE).

Автор принимает pull request’ы, если они делают Governor:

полезнее в реальной работе;
безопаснее;
проще для доверия и аудита.

Перед изменениями, которые касаются сжатия, хуков, телеметрии или бенчмарков, нужно ознакомиться с CONTRIBUTING.md в репозитории.