Как не дать переполниться контекстному окну вашего ИИ-агента для написания кода

Каждый ИИ-агент для написания кода работает внутри контекстного окна — ограниченного объёма текста, который он может «видеть» одновременно: ваши сообщения, его ответы, файлы, которые он читает, вывод команд, которые он запускает. Когда это окно переполняется, качество падает загадочными на первый взгляд способами. Агент забывает решение, которое вы приняли двадцать минут назад, перечитывает файл, который уже редактировал, или незаметно противоречит сам себе. В любой задаче длиннее нескольких минут управление контекстом — это самый значимый рычаг влияния на качество результата, который у вас есть. Вот как делать это осознанно.

Почему переполненное окно вредит

Модели не деградируют плавно, когда окно становится переполненным. Происходят две вещи. Во-первых, более старые сообщения оттесняются к краям, где модель обращается к ним менее надёжно — классическая проблема «потерянного в середине» (lost in the middle). Во-вторых, большинство агентов автоматически резюмируют историю, когда у них заканчивается место, а автоматическое резюме, сделанное под давлением, теряет информацию: оно может отбросить именно то ограничение, которое было для вас важно. Решение — сохранять контроль над тем, что держит агент, вместо того чтобы давать окну переполниться и импровизировать.

Следите за тем, насколько заполнено окно

Нельзя управлять тем, что нельзя увидеть. В Claude Code выполните /context, чтобы вывести текущее использование в процентах. Хорошее эмпирическое правило от практиков — действовать примерно при 60% заполнения в сложной задаче — задолго до отметки ~80%, где включается автоматическое сжатие. Cursor и Codex показывают похожий индикатор в своих интерфейсах. Периодический взгляд на это число превращает управление контекстом из смутного беспокойства в конкретный сигнал.

Сжимайте на контрольных точках — не просто продолжайте дальше

Когда вы достигаете естественной контрольной точки (функция работает, тесты проходят, баг исправлен), сжимайте историю вместо того, чтобы позволять ей расти. В Claude Code /compact заменяет полную стенограмму на сгенерированное моделью резюме — разговор объёмом 70 000 токенов может сократиться примерно до 4 000 токенов. Что особенно важно, вы можете управлять тем, что уцелеет:

/compact "Keep the API contract and the DB schema we agreed on. Summarize the debugging session — I only need the root cause, not every step."

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

Очищайте контекст при переключении задач

/compact предназначен для продолжения той же линии работы. /clear — для её оставления. Когда вы переключаетесь на что-то не связанное — заканчиваете исправление на бэкенде и переходите к функции на фронтенде — начинайте с чистого листа. Перенос старого контекста вперёд не помогает; он лишь тратит токены и создаёт риск, что агент по паттернам подгонит новую задачу под предыдущую. Очистка также лечит ситуацию, когда контекст «отравлен»: модель ухватилась за неверное предположение и постоянно к нему возвращается, как бы вы её ни поправляли.

Держите стабильные знания в файле, а не в чате

Если вы замечаете, что снова и снова объясняете одно и то же — вашу команду для тестов, ваши соглашения об именовании, в какой директории находится API — этой информации вообще не место в разговоре. Поместите её в файл проекта, который агент читает автоматически: CLAUDE.md для Claude Code, AGENTS.md для Codex и других, .cursorrules для Cursor. Он загружается в начале каждой сессии, поэтому агент располагает им с первого же сообщения, и он переживает каждый /clear и /compact. Но держите его лаконичным — он расходует токены при каждом запросе, так что раздутый CLAUDE.md — это своего рода трата контекста.

Давайте агенту меньше, а не больше

Инстинкт вывалить десять файлов, «чтобы у него было всё», даёт обратный эффект. Каждый файл, который вы вставляете или упоминаете через @, потребляет бюджет и размывает внимание модели. Один удачно выбранный файл обычно лучше, чем десять. Начинайте с минимума и добавляйте контекст только тогда, когда он агенту действительно нужен. Если вы не уверены, какой файл важен, попросите агента сначала найти его, а не загружайте заранее всю директорию.

Делегируйте беспорядочное исследование субагенту

Некоторые задачи по своей природе многословны — «найди в кодовой базе все места, где мы вызываем платёжный API». Если вы запустите это в основной сессии, сырой вывод поиска затопит ваше окно. Вместо этого делегируйте задачу субагенту (инструмент Task в Claude Code или отдельный агент Cursor). Субагент выполняет шумное исследование в своём собственном изолированном окне и возвращает лишь вывод — три файла, которые имеют значение, — сохраняя ваш основной контекст чистым.

Рабочий ритм

Если собрать всё вместе, здоровая долгая сессия выглядит так:

1. Начните с лаконичного CLAUDE.md, чтобы агент знал ваш проект.
2. Определяйте узкие рамки каждой задачи; ссылайтесь только на файлы, которых она касается.
3. Поглядывайте на /context каждые 30–45 минут или после каждой вехи.
4. Выполняйте /compact с собственной инструкцией на каждой контрольной точке.
5. Выполняйте /clear в тот же момент, когда переключаетесь на не связанную работу.

Ничего экзотического в этом нет. Это разница между агентом, который остаётся собранным на протяжении двухчасовой сессии, и тем, что начинает сильно, но постепенно теряет нить, — и стоит вам это нескольких секунд внимания, а не загадочного дня отладки его путаницы.