Claude Platform Docs
СообщенияУправление контекстом

Обзор сжатия

Узнайте, что делает сжатие, чем сжатие по запросу отличается от сжатия при достижении порога токенов и какая страница описывает вашу задачу.

Сжатие заменяет более старые ходы разговора сводкой, которую Claude пишет на сервере, поэтому вам не нужен собственный код суммаризации. Оно удерживает длинный разговор или задачу агента в пределах «context window» (контекстного окна) и сохраняет активный контекст небольшим, потому что качество ответов ухудшается по мере роста разговора.

Если вы хотите пропустить этот обзор, начните со страницы Сжатие по запросу, чтобы добавить сжатие в ваше приложение. Хотя и оно, и Сжатие контекста при достижении порога токенов находятся в бета-версии, сжатие по запросу охватывает больше распространённых сценариев использования. Чтобы удалять старые результаты инструментов или старые блоки размышлений по правилу, а не суммаризировать их, см. Редактирование контекста.

Выбор способа сжатия

Используйте сжатие по запросу везде, где оно доступно.

Сжатие по запросуСжатие контекста при достижении порога токеновВаш собственный суммаризатор
Кто решает, когдаВы, отправляя запросAPI, когда входные токены достигают заданного вами порогаВы
Код, который вы пишетеЦикл сжатия, который запрашивает сводку и подставляет еёОдин параметр в ваших обычных запросахВызов суммаризации, его подсказку и перезапись истории
Что вы отправляете обратно после этогоВозвращённый блок первым в messages вместо сообщений, которые он обобщаетОтвет, добавленный как обычно. API отбрасывает всё, что было до блокаВашу сводку в виде вашего собственного сообщения
Последние ходы сохраняются дословноДа: Сжатие с сохранением последних ходовДа, с помощью паузы после сжатия и их повторной вставкиДа
Выполняется в фоновом режимеДа: Сжатие в фоновом режимеНет: оно выполняется внутри запроса, который достигает порогаДа, в вашем собственном коде
Сохранённые ходы сохраняют свои размышления, на моделях с «preserved thinking» (сохранёнными размышлениями)Да, при условиях, описанных на странице Сжатие и сохранённые размышленияНет: удалите размышления из ходов, которые вы вставляете повторно, или позвольте API отбросить их с помощью prefix_mismatch_behavior: "drop_block" (см. примеры сжатия по порогу)Нет: такие размышления не проходят проверку префикса
Бета-заголовок, параметр и платформыcompact-2026-09-04 и параметр верхнего уровня compaction. Платформы: см. раздел о поддержке API для сжатия по запросуСм. раздел о поддержке API для сжатия по порогу и Базовое использованиеНет. Выполняется в вашем коде
Выбирайте, когдаВашему приложению нужно управлять моментом сжатия, оно не может приостанавливаться на время написания сводки или должно сохранять последние ходы и их размышленияВы хотите, чтобы API управлял контекстом внутри обычных запросовВы уже используете собственный суммаризатор, и он заменяет всю историю сводкой

Варианты сжатия по запросу

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

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

Найдите эти темы на других страницах:

У сжатия по порогу есть своя страница: Сжатие контекста при достижении порога токенов.

Эта страница была полезной?