Агент вдруг стал вести себя странно
Час назад Claude Code отлично понимал задачу, а теперь путает названия файлов, снова предлагает решение, которое вы уже отклонили, или уверенно называет неправильное число. Дело почти всегда не в том, что модель «поглупела», а в переполненном контексте.
Контекст, или контекстное окно, это вся переписка, которую агент держит «в голове» прямо сейчас: ваши сообщения, его ответы, содержимое файлов, которые он читал, результаты команд, которые он выполнял. Это окно не бесконечное. Пока диалог короткий, всё помещается свободно. Но чем дольше вы работаете в одной сессии, тем больше туда набивается, и в какой-то момент места перестаёт хватать.
Когда контекст заполняется, происходит одно из двух: либо агент начинает хуже удерживать детали из начала разговора, либо срабатывает автоматическое сжатие, и часть истории заменяется коротким пересказом. В обоих случаях подробности, которые были важны, могут потеряться.
Признаки, что дело именно в контексте
Прежде чем что-то предпринимать, полезно убедиться, что причина именно в переполненной памяти сессии, а не в том, что задача была сформулирована нечётко.
- Агент снова предлагает подход, который вы уже отклонили десять или двадцать сообщений назад.
- Он путает имена файлов или переменных, которые сам же создавал в начале сессии.
- Уверенно называет число, которое звучит правдоподобно, но не совпадает с реальностью, например неверное количество файлов или строк.
- Начинает предлагать сторонние библиотеки или решения, хотя раньше вы договаривались обходиться без них.
- Отвечает так, будто забыл, зачем вы вообще всё это делаете, хотя объясняли это в начале разговора.
Если сессия идёт уже долго, счёт часто идёт на часы непрерывной работы, и вы узнаёте себя хотя бы в паре пунктов списка, дело почти наверняка в контексте, а не в том, что вы плохо объяснили задачу.
Две команды, которые решают проблему
В Claude Code есть две встроенные команды для управления памятью сессии. Разница между ними принципиальная, и путать их не стоит.
/clear
Полностью стирает историю разговора. Начинается чистый лист. Используйте это, когда переходите к совсем другой задаче, никак не связанной с предыдущей.
/compact
Сжимает историю в краткий пересказ, но сохраняет суть того, что происходило. Используйте это, когда работаете над той же задачей, но разговор стал слишком длинным.
/compact можно уточнить, на чём именно сосредоточиться при сжатии, например написать после команды одной фразой, что важно сохранить. Это снижает риск, что нужная деталь потеряется при пересказе.
/compact. Если задача другая, смело жмите /clear.
Как не потерять важное при сбросе
Очистка контекста не должна означать, что агент забывает вообще всё про проект. Есть два простых способа сохранить главное.
CLAUDE.md
Обычный текстовый файл в корне проекта. Claude Code читает его в начале каждой сессии заново, поэтому он не теряется при очистке. Туда стоит записать, что делает проект, какие есть договорённости и что агенту делать нельзя.
Попросите резюме
Прямо перед /clear напишите: «сделай короткое резюме, что мы сделали и на чём остановились». Сохраните ответ себе и вставьте его первым сообщением в новую сессию.
Файл CLAUDE.md не нужно писать сразу идеальным. Можно начать с нескольких строк: как называется проект, из чего он состоит, какие команды нужны для запуска и проверки. Постепенно, по мере того как вы будете замечать, что агент повторяет одну и ту же ошибку, дописывайте в файл короткое правило, чтобы больше не объяснять это заново каждый раз.
Привычка, которая экономит нервы
Управление контекстом, это не разовая настройка, а рабочая привычка, которая со временем становится автоматической.
- Не ждите, пока агент явно начнёт путаться. Проще сбрасывать контекст заранее, между задачами, чем разгребать путаницу постфактум.
- Перед
/clearсохраните текущий прогресс через git commit, чтобы точно ничего не потерять, даже если резюме окажется неполным. - Начинайте новую сессию с одного короткого абзаца: что делали, что уже готово, что осталось сделать дальше.
- Не вставляйте в чат целиком огромные куски вывода команд или логов ошибок. Оставляйте только нужную часть, остальное просто занимает место без пользы.
- Если чувствуете, что разговор стал слишком длинным и переключились на новую тему внутри той же сессии, это тоже повод для очистки.