Claude Code: когда начинать новую сессию и что делает команда /compact

Команда /compact в Claude Code сжимает раннюю часть переписки в структурированное резюме и освобождает место в активном контекстном окне, стараясь сохранить цель задачи, важные решения и текущее состояние проекта. Она подходит, когда задача не изменилась, направление в целом верное, но сессию переполнили логи, результаты инструментов, большие diff и промежуточные обсуждения.

Но /compact не исправляет запутавшуюся сессию автоматически. После сжатия активный контекст уже не содержит каждую старую деталь дословно. Точная строка ошибки, отклонённый вариант, временное ограничение или инструкция, сказанная только в чате, могут стать менее заметными. Если Claude смешивает задачи, повторяет нерабочее решение или исходит из неверной архитектурной гипотезы, безопаснее подготовить короткий handoff и открыть чистую сессию.

Что делает команда /compact в Claude Code и Claude Web?

В Claude Code команда /compact суммирует ранние сообщения многошагового диалога и освобождает контекст, не изменяя файлы проекта. Claude Code также умеет запускать compaction автоматически при приближении к пределу контекста; вручную команду удобно вызвать раньше, пока сессия ещё не стала медленной и шумной.

В обычном чате Claude Web нет пользовательской команды /compact. Если включено выполнение кода, длинный диалог при приближении к пределу контекста может автоматически суммировать ранние сообщения и продолжиться. Иногда интерфейс показывает, что Claude «упорядочивает мысли». Полная история чата сохраняется, но в активную рабочую память модели попадает резюме, а не вся стенограмма дословно.

Вопрос	Claude Code	Claude Web
Как запускается сжатие	Вручную через /compact или автоматически	Автоматически рядом с пределом контекста
Можно ли вызвать ту же команду самому	Да	Нет аналогичной команды в чате
Продолжается ли тот же диалог	Да, та же сессия	Да, тот же чат
Главная цель	Освободить контекст для продолжения той же задачи разработки	Продлить длинный разговор и реже упираться в лимит длины
Главный риск	Точные ошибки и ограничения, заданные только в чате, могут ослабнуть в summary	Старые детали могут стать менее заметными в активном контексте

/compact или /clear, /rewind или новая сессия?

Вариант	Что изменится	Когда использовать	Когда не использовать
Продолжить	Ничего не очищается и не сжимается	Claude помнит симптом, ограничения и последний результат проверки	Сессия зациклилась, смешивает задачи или возвращает отклонённые идеи
/compact	Ранние сообщения превращаются в summary, контекст освобождается, сессия сохраняется	Та же задача, правильное направление, но слишком много логов и tool output	Неверно понята сама задача или важны дословные старые детали
/clear	В текущем процессе Claude Code начинается пустой диалог; старую сессию можно вернуть через /resume	Нужен чистый чат при сохранении текущего каталога и состояния файлов	Нужно отменить изменения кода: /clear файлы не откатывает
/rewind	Открывается меню checkpoint: можно восстановить код, разговор или суммировать выбранный участок	Последние шаги увели работу в сторону, а хороший checkpoint известен	Изменения сделаны Bash-командами, внешними программами, вручную или большинством subagent
Отдельная новая сессия	Чистый контекст в другом терминале, окне или изолированном workspace	Смена задачи, пересмотр архитектуры, параллельная работа, сильная деградация контекста	Единственная проблема — длинные логи при корректном понимании задачи

/clear уже создаёт новый пустой разговор. Под «отдельной новой сессией» здесь понимается более жёсткая граница: новый терминал или окно, при необходимости отдельная ветка или worktree, и явная передача только проверенных фактов.

Сначала определите: проблема в контексте или в диагностике

Допустим, нужно исправить импорт CSV. Если amount пустой, система должна вернуть validation error и не записывать данные. Claude уже дважды менял обработчик, снова открыл те же файлы и предлагает вернуться к первой реализации.

Не спешите делать /compact или перезапуск. Сначала выполните самый узкий тест:

npm test -- tests/import/empty-amount.test.ts

Дальше возможны три ситуации:

• Теста нет или он проверяет не то поведение: сначала не хватает спецификации или воспроизводимого примера. Новая сессия доказательств не создаст.
• Тест стабильно показывает нужный симптом, а Claude правильно использует результат: продолжайте текущую сессию.
• Тест стабильно падает, но Claude забывает исключённые причины, расширяет область изменений или повторяет старые варианты: это уже признак деградации контекста.

Официального порога в Token или количестве сообщений нет. Значение 60%–80% занятого контекста можно использовать как ранний сигнал для проверки, но не как жёсткое правило. Надёжнее смотреть на поведение: может ли Claude точно назвать цель, ограничения, проверенные факты и следующую команду проверки?

Когда стоит выполнять /compact?

Выбирайте /compact, если одновременно выполняются все условия:

1. Вы продолжаете ту же задачу в том же репозитории.
2. Claude правильно понимает цель и разрешённые для изменения файлы.
3. Текущее направление подтверждено тестом или логом, а не только догадкой.
4. Контекст в основном занят длинными логами, сборками, повторяющимися diff и промежуточными обсуждениями.
5. Критические факты можно сформулировать несколькими предложениями.

Перед сжатием проверьте рабочее дерево:

git status --short
git diff

Затем выполните /context и посмотрите, что занимает окно: сообщения, инструменты, определения MCP или CLAUDE.md. Если пространство съедает одно огромное первое сообщение, крупные вложения, наборы инструментов или слишком длинный memory-файл, ранних сообщений для /compact может просто не хватить.

Корневой CLAUDE.md проекта после /compact загружается заново. Инструкции, существовавшие только в разговоре, менее надёжны. Долгосрочные правила лучше держать в коротком CLAUDE.md, а факты конкретной задачи — явно повторить до и после сжатия.

После compaction обязательно проверьте контекст

Не разрешайте Claude сразу продолжать редактирование. Сначала отправьте проверочный промпт:

Мы только что сжали контекст. До изменения любых файлов ответь на четыре вопроса:
1. Какой точный симптом мы исправляем и какой результат ожидается?
2. Какой вариант уже проверен и отклонён, и почему?
3. Какие файлы разрешено менять, а что менять нельзя?
4. Какую одну команду мы запустим следующей для проверки гипотезы?

Если какой-либо ответ нельзя определить из текущего контекста, назови недостающую информацию и не додумывай её.

Для нашего примера Claude должен назвать как минимум следующее:

• пустой amount должен дать validation error без записи данных;
• Number(value || 0) отклонён, потому что превращает пустое значение в допустимый ноль;
• область правки ограничена parser и целевым тестом;
• следующий шаг — один узкий тест или tracing-команда, а не рефакторинг всего импорта.

Если ответы точны, продолжайте в той же сессии. Если они расплывчаты, возвращают отклонённое решение или добавляют README и публичный CSV-формат в область работ, summary ненадёжен. Подготовьте handoff и используйте /clear либо отдельную новую сессию.

Когда /compact не поможет

1. Задача уже сменилась

Вы начали с ошибки валидации, затем добавили обновление README, изменение деплоя и вторую проблему API. Compaction суммирует всё вместе, но не построит чистые границы. Вынесите вторую задачу в отдельную сессию.

2. Базовая гипотеза Claude уже неверна

Если Claude снова и снова считает пустое значение нулём или неправильно понимает путь записи данных, дело не просто в длинном диалоге. Чистая сессия с проверенными фактами обычно быстрее.

3. Точные детали должны сохраниться дословно

Некоторые строки ошибок, SQL, позиции стека, поля протокола и ограничения безопасности нельзя отдавать на волю summary. Запишите минимально необходимый фрагмент в handoff или локальный файл.

4. Один ввод сам по себе слишком большой

Если первая реплика содержит огромный лог, вложения или множество определений инструментов, раннего многошагового диалога для сжатия нет. Уменьшите вход, передавайте пути к файлам или отключите ненужные MCP-серверы.

5. Контекст уже заполнен настолько, что summary не помещается

/compact может завершиться ошибкой, если для создания резюме уже нет свободного места. Дважды нажмите Esc, вернитесь на несколько сообщений назад и повторите. Если не помогло, выполните /clear; старую сессию можно открыть через /resume.

Когда /rewind лучше, чем /compact?

Используйте /rewind или дважды нажмите Esc при пустой строке ввода, когда проблема сосредоточена в последних шагах. Меню checkpoint позволяет:

• восстановить одновременно код и разговор;
• восстановить только разговор, сохранив текущие файлы;
• восстановить только код, сохранив разговор;
• суммировать историю от выбранной точки вперёд;
• суммировать всё до выбранной точки.

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

Checkpoint в основном отслеживает правки, сделанные файловыми инструментами Claude. Изменения через Bash, внешние программы, ручное редактирование или большинство subagent могут не восстановиться. И это не замена Git: важные точки по-прежнему стоит фиксировать веткой, commit или хотя бы проверкой git diff.

Как безопасно передать задачу новой сессии

Новой сессии не нужна полная стенограмма. Ей нужны проверенные факты, текущее состояние файлов и один следующий шаг.

Сначала выполните:

git status --short
git diff

Затем передайте короткую карточку:

Цель: пустой amount возвращает validation error и не записывает данные.
Рабочее дерево: сначала проверь git status и git diff; не считай его чистым по умолчанию.
Целевые файлы: parser/amount.ts, tests/import/empty-amount.test.ts
Воспроизведение: npm test -- tests/import/empty-amount.test.ts
Текущий результат: тест падает.
Отклонённый вариант: Number(value || 0), потому что пустое значение превращается в ноль.
Ограничения: не менять публичный CSV-формат и не рефакторить посторонние модули.
Открытый вопрос: на каком слое отличить пустое значение от корректного 0?
Следующий шаг: проследить value от CSV parser до validation branch и предложить одну проверяемую гипотезу.

До редактирования повтори цель, ограничения, отклонённый вариант и следующую команду проверки.

Не добавляйте API Key, Cookie, содержимое .env, персональные данные или полный необработанный лог. Если строка ошибки важна, оставьте только минимальный фрагмент и путь к локальному логу.

Решение за одну минуту

1. Сначала воспроизведите. Запустите самый маленький тест или команду, подтверждающую симптом.
2. Сессия ещё точна? Если Claude помнит цель, ограничения и последнее доказательство, продолжайте.
3. Проблема только в шуме? Та же задача, верное направление и слишком много логов — используйте /compact.
4. Ошибочны только последние шаги? Используйте /rewind для точечного восстановления или summary.
5. Задача сменилась или понимание деградировало? Выполните /clear или откройте отдельную сессию с handoff.
6. Проверьте перед правкой. Сначала попросите Claude восстановить факты, и только потом разрешайте менять файлы.

Частые вопросы

Что именно делает /compact в Claude Code?

Команда превращает раннюю часть многошагового разговора в более короткое представление и освобождает место в контекстном окне, чтобы та же сессия могла продолжиться. Сама команда не изменяет файлы проекта.

Удаляет ли /compact исходный чат или код?

Её задача — сжать активный контекст, а не удалить код. История сессии сохраняется, но следующие ответы в основном опираются на summary и текущий активный контент, поэтому критические детали нужно проверять отдельно.

Когда делать /compact, а когда открывать новую сессию?

Используйте /compact, если задача и направление остаются правильными, а мешают накопившиеся логи и промежуточные выводы. Начинайте заново, если смешались задачи, возвращаются отклонённые решения, теряются ограничения или неверно понята архитектура.

Что означает Compact в Claude Web?

Claude Web может автоматически суммировать ранние сообщения, когда длинный чат приближается к пределу контекста. Это не команда /compact из Claude Code и обычно не требует ручного запуска. Автоматическое управление контекстом зависит от включённого выполнения кода.

Чем /clear отличается от нового терминала?

/clear начинает пустой разговор внутри текущего процесса Claude Code, а прошлую сессию можно вернуть через /resume. Новый терминал или окно лучше подходит для строгой изоляции задачи, параллельной работы и отдельной ветки или worktree.

Официальные источники

• Интерактивный режим Claude Code и /clear
• Checkpoint и /rewind в Claude Code
• Ошибки лимита контекста и /compact
• Поведение CLAUDE.md после compaction
• Claude Web: лимиты длины и автоматическое управление контекстом