Claude Token Optimizer — меньше токенов на старте

Установка

Работает в

• Claude Code

npx skillfoxx add cli/claude-token-optimizer

Что делает

Claude Code перечитывает заметки проекта в начале каждой сессии, и чем они длиннее, тем больше токенов тратится до первого вопроса. Утилита cto из пакета claude-token-optimizer сокращает этот расход. Она оставляет в `CLAUDE.md` короткую шпаргалку, а остальное выносит в файлы, которые Claude открывает только при необходимости. В проекте автора на RedwoodJS стартовая загрузка упала примерно с 11 тысяч токенов до 800. Для начала хватает двух команд. `npx -y claude-token-optimizer measure` показывает по файлам, сколько токенов грузится на старте. `npx -y claude-token-optimizer prune --yes` переносит завершенные задачи и старые заметки по сессиям в отдельные файлы внутри `.claude`. Для проекта с нуля есть `cto init`: он определяет фреймворк по `package.json`, `go.mod`, `composer.json` и другим файлам и создает набор справочных файлов и `.claudeignore`. Для постоянного контроля есть `cto audit` с 19 проверками структуры, `cto compress` для сжатия markdown правилами без модели, `cto diff`, живая панель `cto watch` и `cto hooks` с 12 шаблонами хуков. Хуки предупреждают о раздувшемся контексте, блокируют чтение лок-файлов и бинарников и подмешивают в запрос только нужные файлы из `docs/learnings`.

Для кого. Для тех, кто работает в Claude Code каждый день, упирается в лимиты и замечает, что CLAUDE.md и документация проекта разрослись.

Пример запроса к агенту

Сделай копию CLAUDE.md, измерь стартовые токены через cto и покажи, сколько удастся сэкономить, прежде чем что-то менять.

Ограничения

Нужен Node.js 20 или новее. Счетчик токенов использует токенизатор Claude 2, поэтому цифры годятся для сравнения до и после, а сверять их со счетом от Anthropic нельзя. Подсчет и правила для `.claudeignore` рассчитаны на Claude Code, остальные агенты просто прочитают получившийся markdown.

`cto compress` сжимает с потерями: обрезает длинные списки и убирает HTML-комментарии. `cto prune` и `cto compress` сохраняют прежнюю версию файла как `.bak`, но повторный запуск перезаписывает эту копию, поэтому перед цепочкой команд стоит скопировать файл самому. Если `CLAUDE.md` уже есть, `cto init` только добавляет недостающие разделы, а если его нет, заменяет существующие `.claudeignore` и `.claude/*.md`. Флаг `--force` заменяет все без резервной копии.

Доступность npm из России при подготовке карточки не проверялась.

Как отключить. Верните сохраненную копию: `cp CLAUDE.md.mine CLAUDE.md`, а в проекте под git выполните `git restore CLAUDE.md`. Новые файлы перечислит `git clean -n`, а `git clean -fd` удалит их после проверки списка. Если ставили хуки, уберите блок cto из `settings.json` и папку `.claude/hooks`. Глобальную установку удаляет `npm uninstall -g claude-token-optimizer`.

Коротко о README

Документ строится вокруг двух строк для быстрого старта и объяснения, что произошло с токенами. Затем идут блоки помощи с типичными ошибками, ответами на вопросы о перезаписи и откате и справочный раздел для разработчиков: установка, режим для агентов, таблица цифр до и после, структура файлов после init, список команд и шаблонов хуков. В конце перечислены сторонние инструменты экономии токенов, которые показывает `cto companions`, правила поддержания малого размера и ответы на частые вопросы.