Claude Code Auto Compact: /autocompact, порог срабатывания и починка
Что auto compact делает, когда окно контекста заполняется, как работает окно /autocompact (теперь сохраняется для каждой модели), когда compact, а когда clear — и что делать, если «Compacting conversation…» тормозит.
Коротко
- Auto compact резюмирует старую историю, когда диалог подходит к лимиту контекста. Начиная с v2.1.288, режим auto компактирует длинные диалоги вместо падения на каждом вызове инструмента.
- /autocompact 500k задаёт окно срабатывания (100K–1M токенов), причём с v2.1.288 — отдельно для каждой модели. /autocompact auto возвращает настроенное для модели значение по умолчанию.
- /context показывает, что занимает место, и зарезервированный Autocompact buffer. Продолжаете ту же фичу — compact; начинаете новое — /clear.
- Компакция читает весь диалог, поэтому длинные сессии и медленные. Зависло — сначала обновите Claude Code: 2.1.288 починил случай, когда вместо компакции падало с «Prompt is too long».
Context Management in Claude Code
Канал: Anthropic · Claude3:31
Claude Code release notes — v2.1.288
Release notes: github.com/anthropics/claude-code
Set the auto-compact window — official documentation
Документация: code.claude.com/docs
Факты на этой странице сверены с официальной документацией Claude Code и changelog v2.1.288; скриншоты взяты из видео выше. Описанное поведение соответствует Claude Code v2.1.288 (сентябрь 2026).
Скриншоты — кадры из видео Anthropic «Context Management in Claude Code»: использованы с указанием источника, каждый шаг ведёт на точную секунду оригинала.
Auto compact: пошаговый разбор
Понять, чем заполняется контекст
- 1
Посмотреть, что загружено в контекст
Запустите /context и прокрутите разбивку. MCP-инструменты грузятся по требованию, но их определения, кастомные агенты и скиллы резервируют токены ещё до вашего первого промпта. Отключить MCP-серверы, которые проекту не нужны, — самое дешёвое освобождение места из всех возможных.
Разбивка /context показывает MCP-инструменты, кастомных агентов и скиллы с расходом в токенах ещё до начала работы.Смотреть с 0:10 - 2
Проверить свободное место и буфер autocompact
Вверху /context — окно модели и ваш расход: в демо claude-opus-4-6 при 21k/200k токенов (11%). Последняя строка, Autocompact buffer, — запас, который Claude Code резервирует, чтобы auto compact успел отработать до того, как окно заполнится по-настоящему.
Строка Autocompact buffer в /context — зарезервированное под компакцию место; здесь 33k токенов (16,5%).Смотреть с 2:38 - 3
Распознать сессию, которая заполняется
Длинные сессии растут на результатах инструментов: каждое чтение файла, каждая находка код-ревью и каждый фикс добавляют сообщения в окно. Демо-сессия прогнала код-ревью, перечислила находки вроде отсутствия валидации ввода и захардкоженного JWT-секрета и попросила их починить — ровно та работа, которая упирается в лимит.
Код-ревью с находками и фиксами — типичная работа длинной сессии, толкающая окно контекста к пределу.Смотреть с 0:24 - 4
По сводке увидеть, что сохранится
Когда диалог становится длинным, собственная сводка Claude Code — ранжирование приоритетов, все сообщения пользователя, отложенные задачи — показывает, что резюме обязано сохранить. Auto compact рассуждает так же: ваши запросы и ключевые фрагменты кода выживают; первыми выбрасываются старые результаты инструментов.
Приоритеты, сообщения пользователя, отложенные задачи — то состояние, которое сжатое резюме должно унести с собой.Смотреть с 0:50
Компактировать осознанно
- 5
Выбрать /compact в слэш-меню
Введите / и читайте описания: /clear — «Clear conversation history and free up context», /compact — «Clear conversation history but keep a summary in context». Одна строка — вся разница: compact меняет резюме на непрерывность работы, clear покупает максимум места. /compact к тому же принимает фокус-инструкцию вроде /compact Focus on the API changes.
Слэш-меню говорит прямо: /compact оставляет резюме в контексте, /clear освобождает всё.Смотреть с 0:09 - 6
Понять спиннер Compacting conversation
После запуска /compact появляется «Compacting conversation…», пока модель читает и резюмирует всё, что было. Auto compact запускает ту же процедуру сам у лимита — а v2.1.288 дополнительно сделал так, что режим auto компактирует длинные диалоги вместо падения на каждом вызове: застрять посреди задачи больше не грозит.
Compacting conversation… — тот самый спиннер, независимо от того, ручная компакция или автоматическая.Смотреть с 0:46 - 7
Прочитать резюме после компакции
Вывод начинается с «This session is being continued from a previous conversation that ran out of context», а дальше переносит Primary Request and Intent, Key Technical Concepts и Files and Code Sections в новое окно. Работаете дальше с резюме вместо полной истории.
Сжатое резюме открывается признанием, что сессии не хватило контекста, и перечисляет сохранённое.Смотреть с 0:48 - 8
Вернуть детали из полной переписки
Если в резюме не хватило нужного, заметки после компакции говорят, куда смотреть: «read the full transcript at» — путь к .jsonl, плюс секции Current Work и Optional Next Step. Предупреждение документации в силе: подробные инструкции из начала диалога могут потеряться, поэтому постоянные правила держите в CLAUDE.md.
Current Work, Optional Next Step и путь к переписке — три точки восстановления после компакции.Смотреть с 0:52
Очистить, делегировать, восстановить
- 9
Использовать /clear, когда задача закрыта
Начинаете новую фичу? /clear стирает диалог целиком — документация отдельно отмечает, что это ничего не стоит, тогда как компакция большого контекста сама по себе большой запрос. Сначала /rename, чтобы завершённая сессия находилась через /resume, а то, что должны знать будущие сессии, положите в CLAUDE.md.
/clear стартует с чистого листа без резюме — сначала переименуйте сессию, чтобы /resume её нашёл.Смотреть с 3:14 - 10
Делегировать тяжёлое чтение сабагенту
Сабагенты работают в собственном окне контекста и возвращают в основную сессию только резюме. Запуск сабагента code-reviewer, как в демо, держит вывод ревью целиком вне вашего окна — документация прямо советует это для вопросов вида «где находится X?», где нужен ответ, а не путь к нему.
Запуск сабагента code-reviewer: работа идёт вне вашего основного окна контекста.Смотреть с 2:50 - 11
Пусть сабагент работает, а ответ останется у вас
Пока сабагент резюмирует рефакторинги и обновляет задачи, главное окно получает только результат. Меньше вывода инструментов в основной ветке — auto compact срабатывает позже или не срабатывает вовсе. Это самый дешёвый способ не дать длинному проекту добраться до буфера.
Сабагент возвращает только сжатый итог — промежуточный вывод в основной сессии никогда не хранился.Смотреть с 2:53
Auto compact vs /compact vs /clear vs /rewind
Четыре команды живут в одном углу Claude Code — все сбрасывают или перестраивают диалог, — но отвечают на разные вопросы. Разбираемся, когда какая и есть правильный ответ.
- 1Auto compact (автоматический) срабатывает, когда диалог доходит до лимита контекста — или до заданного вами окна /autocompact. Он резюмирует старую историю, и сессия просто продолжается; с v2.1.288 даже режим auto компактирует вместо падения на вызовах в очень длинных диалогах.
- 2/compact (ручной, с сохранением резюме) запускает ту же суммаризацию по требованию — «Clear conversation history but keep a summary in context», как сказано в меню. Случай: вы вышли за окно, но продолжаете ту же фичу; можно добавить фокус вроде /compact Focus on the test output.
- 3/clear (с нуля) удаляет всё без резюме и ничего не стоит — компакция большого контекста сама по себе большой запрос. Случай: план завершён, дальше работа никак не связана с прошлым. Сначала /rename, чтобы /resume мог вернуть старую сессию.
- 4/rewind (отмена) — совсем другая история: двойное Esc открывает меню отката, чтобы восстановить код и диалог с более раннего чекпоинта. Инструмент для «вернуть как было», а не для продолжения работы за пределом контекста.
- 5Эмпирическое правило из официального разбора Anthropic: вышли за окно, но нужна непрерывность той же фичи — compact; начинаете новое — clear; а то, что должны помнить будущие сессии, кладите в CLAUDE.md — это переживёт и то и другое.
И ещё одно различие, которое стоит знать: компакция по дизайну теряет детали. Запросы и ключевые фрагменты кода сохраняются, но подробные инструкции из начала диалога могут пропасть — такова цена освобождённого места, и потому постоянные правила живут в CLAUDE.md, а не в истории чата.
Compacting conversation тормозит или завис? Первая помощь
Компакция читает весь диалог, поэтому большая сессия заметно долго сводится в резюме — само по себе это не баг. Ниже случаи, когда действительно что-то сломалось, и что с этим делать.
- 1«Prompt is too long» вместо компакции — сначала обновите Claude Code. В v2.1.288 починены длинные диалоги, которые при нулевом потреблении токенов в последнем ответе падали с этой ошибкой вместо автокомпакции. Старые сборки спотыкаются ровно здесь.
- 2Компакция закончилась, и контекст мгновенно заполнился снова (трэшинг). Одного огромного чтения файла или вывода инструмента хватает, чтобы после каждого резюме окно было полным; Claude Code после нескольких попыток прекращает автокомпакцию и показывает ошибку вместо цикла. /clear, делите задачу или отдайте тяжёлое чтение сабагенту.
- 3Шлюз или прокси отклоняет большие запросы. Если ваш эндпоинт не принимает ничего свыше 200K токенов, задайте CLAUDE_CODE_AUTO_COMPACT_WINDOW=200000 — компакция будет срабатывать раньше, чем сессия вырастет за пределы допустимого шлюзом.
- 4/autocompact сообщает, что значение сохранено, но не применяет его. Его перекрывает скоуп с более высоким приоритетом — например, управляемые настройки; команда сама предупреждает об этом. Переменная CLAUDE_CODE_AUTO_COMPACT_WINDOW важнее всего, включая /autocompact.
- 5А бывает, просто медленно. Резюмировать почти полное окно — большой запрос; дайте минуту перед повторным /compact, а если резюме вам всё равно не нужно, /clear мгновенен и бесплатен. Выключенные лишние MCP-серверы укорачивают и каждую будущую компакцию.
Если компакция в одной и той же сессии падает раз за разом, запасной выход ручной: /rename сессии, /clear и позже /resume — либо продолжайте с резюме, которое оставил прошлый прогон. На диске ничего не теряется; компакция перестраивает только память диалога.