Claude Code Mods: как видеть контекст и повторы правок, не принимая индикаторы за проверку

В длинной сессии Claude Code обычно возникают два разных вопроса: насколько вырос контекст после очередного хода и какие операции редактирования файлов Claude вызывал. В playground Anthropic есть готовый пример для каждого случая. Token Weather показывает заполнение контекста основной сессии, а Replay Theater позволяет последовательно просмотреть вызовы редактирования из последнего хода с правками.

Главная граница: оба инструмента дают наблюдаемость, но не выполняют приёмку. Процент контекста не показывает остаток лимита, стоимость или готовность задачи. Наличие правки в replay не доказывает, что вы её разрешили, инструмент успешно выполнился, а итоговый файл сохранил изменение.

Выберите Mod по вопросу, который нужно решить сейчас

Вопрос	Что загрузить	Что вы увидите	Чего это не доказывает
Насколько заполнен основной контекст и резко ли он рос в последних ходах?	Token Weather	Context tokens, размер окна, процент и историю за 12 ходов	Остаток подписки, списание, число будущих запросов или завершение задачи
Какие Edit, Write или MultiEdit были вызваны в последнем ходе с правками?	Replay Theater	Файл, инструмент, локальные до/после и короткий diff каждого вызова	Разрешение вызова, успешное выполнение, итоговое состояние диска или прохождение тестов

Для диагностики запускайте один Mod за раз. Оба примера могут рисовать в AbovePrompt. В официальных README указано, что эта область общая: если другой Mod использует её же, видимым может остаться только один.

До запуска проверьте версию и доверие к коду

Текущие README примеров требуют Claude Code 2.1.287 или новее и рассчитаны на терминал. Сначала проверьте клиент:

claude --version

Эти Mods находятся в playground команды Anthropic DevRel. Сам репозиторий называет записи примерами «как есть», без поддержки и гарантии работы после изменений Claude Code, API или моделей. Перед запуском просмотрите как минимум README.md, .claude-plugin/plugin.json, hooks/hooks.json и модуль hooks выбранного каталога.

Mod работает с правами вашего пользователя; фраза «он только рисует интерфейс» не является границей безопасности. Для первой проверки лучше использовать --plugin-dir на одну сессию. После закрытия процесса эксперимент заканчивается и не превращается в постоянную установку.

Клонируйте официальный репозиторий и проверьте выбранный Mod

git clone https://github.com/anthropics/claude-code-playground.git
cd claude-code-playground/claude-code/mods

Сам факт скачивания не означает, что структура корректна. Сначала проверьте конкретный каталог.

Для Token Weather:

claude plugin validate ./token-weather
claude --plugin-dir ./token-weather

Для Replay Theater:

claude plugin validate ./replay-theater
claude --plugin-dir ./replay-theater

Если validate сообщает ошибку, остановитесь и восстановите указанный manifest, конфигурацию hooks или модуль. Не рассчитывайте, что Claude Code безопасно проигнорирует повреждённый пакет. В новой сессии /plugin помогает увидеть, что загружено. Рабочий сигнал проверяется отдельно: Token Weather должен обновиться после завершения основного хода, а Replay Theater — показать вход в replay после хода, где действительно были вызваны правки файлов.

Token Weather показывает контекст, а не счёт

После каждого основного хода Token Weather вызывает $.session.usage() и читает из context значения tokens, window и percent. Над строкой ввода появляется одна строка, история последних 12 измерений и прирост последнего хода.

Значения означают:

• tokens — входной контекст, на котором был сформирован последний ответ, включая uncached, cache-written и cache-read input tokens;
• window — окно контекста модели текущей сессии;
• percent — отношение tokens / window.

До первого ответа 0% — нормальный результат: usage ещё не был возвращён. Индикатор обновляется один раз после хода, а не непрерывно во время работы. Ходы субагентов не создают отдельные измерения основного цикла.

Почему процент отличается от предупреждения о compaction

Token Weather считает процент от полного окна контекста. Уведомление auto-compact в Claude Code использует более низкую точку автоматического сжатия, поэтому значения могут различаться. В официальном примере Token Weather показывал 81%, а уведомление клиента — 90%. Это иллюстрация двух шкал в условиях примера, а не числа, которые обязаны совпасть у вас.

Столбцы истории относительны самому высокому значению среди показанных ходов. Даже при небольшом абсолютном заполнении колебания могут выглядеть заметными. Для абсолютной оценки смотрите процент и число tokens. После перезапуска сессии или reload плагина история обнуляется.

Какой вывод допустим

Корректно сказать: «Входной контекст основной сессии заметно вырос за последние ходы». Некорректно: «У аккаунта осталось 19%», «этот ход стоил столько-то» или «задача завершена». Кэш влияет на тарификацию, но кэшированный ввод всё равно занимает контекст. Баланс, списание и статус смотрите в журнале провайдера.

Replay Theater показывает попытки редактирования

После загрузки попросите Claude выполнить задачу, которая действительно меняет файлы, и дождитесь завершения хода. Когда появится подсказка, откройте replay:

/replay

Можно также сфокусировать полосу комбинацией ctrl+x, Tab, а затем нажать r. В панели доступны:

Клавиша	Действие
n	Следующий шаг
p	Предыдущий шаг
c или Escape	Закрыть

Каждый шаг показывает файл, инструмент, количество добавленных и удалённых строк и короткий diff. Пример ограничивает один шаг 12 строками. Для Edit сравниваются old_string и new_string, а не целый файл; номера строк не показываются. Для Write старый текст читается с диска непосредственно перед вызовом, но для файлов длиннее 400 строк полное сопоставление строк не выполняется.

Почему показанная правка может отсутствовать в файле

Replay Theater записывает вызов до того, как передаёт его дальше. Поэтому отклонённое вами изменение или неудачный вызов инструмента тоже может попасть в replay. Следующий вызов способен перезаписать или отменить предыдущий.

Replay хранится в памяти текущей сессии. Перезапуск Claude Code или reload плагина удаляет его. Новый ход без правок сохраняет предыдущий replay. Используйте его для ответа «что Claude пытался сделать», а не как снимок итогового репозитория.

Принимайте результат по реальным файлам

После работы вернитесь к репозиторию независимо от того, сколько шагов показал Replay Theater:

git status --short
git diff --stat
git diff -- path/to/file
git diff --check

git status --short покажет реальные добавления, изменения и удаления. git diff --stat быстро обнаружит неожиданно широкий объём. Для важных файлов прочитайте полный diff вместо 12 строк replay. git diff --check проверит ошибки пробелов; затем запустите минимальный тест, type check или сборку, непосредственно связанные с изменёнными файлами.

Критерий приёмки должен быть наблюдаемым: «целевая функция переименована, все ссылки обновлены, нужный unit test проходит, посторонние файлы не изменены». Формулировка «в replay было пять зелёных шагов» критерием не является.

Фактический расход сверяйте в записи запроса

Token Weather показывает заполнение контекста, но не рассчитывает API-списание. У любого API-провайдера найдите запрос по времени и модели, затем проверьте status, input/output tokens, применимые cache tokens и фактическое списание.

Если Claude Code подключён через BetterToken, текущая страница сервиса указывает, что model, time, token counts, cache usage, final cost и status находятся в одной записи запроса. Эта запись нужна для сверки реального API usage. Это не означает, что BetterToken предоставляет сами Mods, хранит полный prompt/ответ или автоматически принимает изменения кода. Подключение описано в документации BetterToken для Claude Code.

Устраняйте проблемы в коротком порядке

Не проходит claude plugin validate

Прочитайте точный файл и поле из сообщения валидатора. Убедитесь, что текущий каталог — claude-code-playground/claude-code/mods, скрытые файлы не были переименованы загрузчиком, а checkout не повреждён. До успешной повторной проверки не запускайте Mod.

Token Weather не виден или остаётся на 0%

Работайте в терминале, а не только в VS Code chat panel; проверьте версию 2.1.287 или новее и загрузку нужного Mod в текущей сессии. Отправьте обычный запрос и дождитесь завершения основного хода. Ноль до первого ответа нормален.

Replay Theater не показывает вход в replay

Проверьте, что ход вызвал Edit, Write или MultiEdit и уже завершился. Чтение файлов, обычный ответ или только Bash-команды не создают нужного события редактирования.

Replay не совпадает с git diff

Доверяйте реальным файлам. Правка могла быть отклонена или завершиться ошибкой, более поздний вызов мог её заменить, панель показывает только локальный фрагмент, а restart/reload меняет состояние памяти. Проверьте полный diff и целевые тесты.

Два Mod не показываются одновременно

Отключите один и начните новую сессию с другим. Они делят AbovePrompt, поэтому отсутствие второй строки само по себе не доказывает поломку.

Надёжный минимальный цикл

Выбирайте Token Weather для вопроса о росте контекста, а Replay Theater — для вопроса о вызванных операциях редактирования. Успешная загрузка — только первый шаг; появившийся индикатор или replay — второй. Третий шаг всегда один: проверить реальные файлы, выполнить минимальную релевантную проверку и при необходимости сверить запись запроса провайдера. Так наблюдение за процессом превращается в подтверждённый результат.