claude-auto-handoff — плагин
Плагин для Claude Code вместо автосжатия пишет передаточную записку, очищает сессию и продолжает работу с нее
- 125 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Читает транскрипт сессии, отклоняет вызовы инструментов на пороге и сам выполняет очистку сессии.
- Запускает локальный сервер страниц на адресе Tailscale, доступный устройствам сети.
Установка
- Работает в
Ручная установка
git clone https://github.com/alexknowshtml/claude-auto-handoff.git ~/claude-auto-handoffЗатем claude --plugin-dir ~/claude-auto-handoff; для всех сессий задайте CLAUDE_CODE_PLUGIN_DIRS.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Читает транскрипт сессии, отклоняет вызовы инструментов на пороге и сам выполняет очистку сессии.
- Запускает локальный сервер страниц на адресе Tailscale, доступный устройствам сети.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
claude-auto-handoff следит за размером контекста Claude Code. Когда порог достигнут, модуль отказывает в новых вызовах инструментов, поручает Haiku написать структурную записку на диск, выполняет `/clear` и отправляет новой сессии одну строку со ссылкой на записку. Свежая сессия читает записку и продолжает работу. В записке фиксированная структура: работа в процессе, решения, допущения для проверки, тупики, последняя просьба и статус ответа, следующий шаг. Списки файлов, коммитов и задач собираются из транскрипта кодом и от памяти модели не зависят. Над строкой ввода рисуется панель шагов, а каждая записка получает читаемую страницу, которую отдает локальный сервер.
Для кого. Тем, кто ведет длинные сессии Claude Code и хочет управляемо переносить состояние в новую сессию вместо автоматического сжатия.
Подходит, если
- Сессия на сотни тысяч токенов близка к пределу окна, а прерывать работу нельзя.
- Записку о передаче хочется править руками, и ее структура должна быть фиксированной.
- Нужно видеть, чем завершились прошлые попытки: тупики и допущения для проверки хранятся отдельно.
- Работа идет через телефон, и страницу записки удобно открыть по короткой ссылке в сети Tailscale.
Не подходит, если
- Сборка Claude Code не поддерживает моды (хуки-функции плагинов): плагин на ней не запустится.
- Автосжатие вас устраивает, а структура записки не важна.
- Нельзя открывать на машине дополнительный локальный сервер.
Пример запроса к агенту
Установи порог передачи в 80 тысяч токенов на один запуск и покажи, как плагин пишет записку и очищает сессию.Ограничения
Нужна сборка Claude Code с поддержкой модов. Порог по умолчанию равен 160000 токенов и рассчитан на окно 200 тысяч, его меняют в настройках или переменной `AUTO_HANDOFF_TOKENS` на один запуск. Размер непросчитанного вывода инструментов оценивается с запасом, поэтому реальный размер иногда оказывается ниже порога. Если Haiku недоступен, записка собирается только из фактов. Сервер страниц по умолчанию слушает адрес Tailscale на порту 3846, без Tailscale он работает на 127.0.0.1. Последний коммит датирован октябрем 2026 года.
Как отключить. Уберите `--plugin-dir` из команды запуска и значение `CLAUDE_CODE_PLUGIN_DIRS` из окружения или из `~/.claude/settings.json`. Для одной сессии достаточно `AUTO_HANDOFF_DISABLE=1`. Записки в `~/.claude/state/auto-handoff/` удаляются вручную.
Частые вопросы
Чем передача лучше автосжатия?
Автосжатие пересказывает сессию на месте, и состав пересказа не контролируется. Записка передачи имеет фиксированную структуру, ее можно править, а списки файлов и коммитов берутся из транскрипта кодом.
Где лежат записки?
В `~/.claude/state/auto-handoff/<session-id>.md`, а читаемые страницы в подпапке `pages`.
Как проверить работу без ожидания 160 тысяч токенов?
Задайте `AUTO_HANDOFF_TOKENS=60000` на один запуск. Свежая сессия стартует около 45 тысяч токенов, поэтому значения ниже примерно 85 тысяч оставляют ей мало места.
Что видно в терминале во время передачи?
Панель над строкой ввода с шагами: запись записки, очистка, запуск новой сессии. После успеха выводится строка с размером контекста до и после, например 162 тысячи и 45 тысяч, со ссылкой на записку.
Как загружать плагин в каждой сессии?
Укажите папку в переменной `CLAUDE_CODE_PLUGIN_DIRS` в окружении или в блоке `env` файла `~/.claude/settings.json`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ПлагиныПлагин Claude Code пишет документ передачи работы, пока кеш промпта сессии еще теплый и не вырос счет за токены.
Плагин передачи работы для Claude Code и Codex: чистая сессия с решениями и задачами или перенос истории в другой клиент.
Плагин для Claude Code сам выбирает уровень усилий модели на каждый запрос и показывает остаток времени кэша промпта
claude-history ищет и открывает прошлые диалоги Claude Code, Codex и Pi в терминале и дает Claude скилл для чтения истории
Плагин Claude Code, который ловит ваши поправки в диалоге и после проверки записывает их в CLAUDE.md и AGENTS.md
Claude Code Toolkit (robertguss)
Claude Code Toolkit
Набор скиллов и хуков для Claude Code: брейншторм, ведение проекта воркерами, вики, конвейер книги.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| claude-auto-handoff (эта карточка) | нет | 125 | ||
| Context Mode | нет | не нужна | 34 013 | экономит контекст на уровне вывода инструментов; claude-auto-handoff переносит работу в новую сессию на пороге |
| Table Skills: project-handoff | нет | 463 | скиллы передачи проекта по таблицам; плагин автоматически передает саму сессию Claude Code |
Коротко о README
Описан порядок работы: порог, записка, очистка с затравкой, панель, страница-просмотрщик и необязательная строка состояния. Журнал версий дошел до 0.8.3.