← Все гайды

Вдвоём · Гайды

Claude Code вдруг всё забыл. Что такое контекст и как с ним работать

⏱ 6-7 минут чтения 🧠 Навык
1
Что случилось

Агент вдруг стал вести себя странно

Час назад Claude Code отлично понимал задачу, а теперь путает названия файлов, снова предлагает решение, которое вы уже отклонили, или уверенно называет неправильное число. Дело почти всегда не в том, что модель «поглупела», а в переполненном контексте.

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

Когда контекст заполняется, происходит одно из двух: либо агент начинает хуже удерживать детали из начала разговора, либо срабатывает автоматическое сжатие, и часть истории заменяется коротким пересказом. В обоих случаях подробности, которые были важны, могут потеряться.

Это не поломка Так устроены все похожие ИИ-агенты, не только Claude Code. Это не повод паниковать и не признак того, что вы делаете что-то не так. Это просто особенность, с которой нужно уметь работать.
2
Как узнать проблему

Признаки, что дело именно в контексте

Прежде чем что-то предпринимать, полезно убедиться, что причина именно в переполненной памяти сессии, а не в том, что задача была сформулирована нечётко.

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

Если сессия идёт уже долго, счёт часто идёт на часы непрерывной работы, и вы узнаёте себя хотя бы в паре пунктов списка, дело почти наверняка в контексте, а не в том, что вы плохо объяснили задачу.

3
Инструменты

Две команды, которые решают проблему

В Claude Code есть две встроенные команды для управления памятью сессии. Разница между ними принципиальная, и путать их не стоит.

терминал

/clear

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

/compact

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

/compact можно уточнить, на чём именно сосредоточиться при сжатии, например написать после команды одной фразой, что важно сохранить. Это снижает риск, что нужная деталь потеряется при пересказе.

Если не уверены, что выбрать: если задача та же, пробуйте /compact. Если задача другая, смело жмите /clear.
4
Подготовка

Как не потерять важное при сбросе

Очистка контекста не должна означать, что агент забывает вообще всё про проект. Есть два простых способа сохранить главное.

Файл проекта

CLAUDE.md

Обычный текстовый файл в корне проекта. Claude Code читает его в начале каждой сессии заново, поэтому он не теряется при очистке. Туда стоит записать, что делает проект, какие есть договорённости и что агенту делать нельзя.

Перед сбросом

Попросите резюме

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

Файл CLAUDE.md не нужно писать сразу идеальным. Можно начать с нескольких строк: как называется проект, из чего он состоит, какие команды нужны для запуска и проверки. Постепенно, по мере того как вы будете замечать, что агент повторяет одну и ту же ошибку, дописывайте в файл короткое правило, чтобы больше не объяснять это заново каждый раз.

Не превращайте файл в свалку Чем длиннее CLAUDE.md, тем больше его придётся читать при каждом сообщении, и тем меньше шансов, что агент выполнит все инструкции разом. Лучше несколько коротких, чётких пунктов, чем длинный список всего, что когда-либо приходило в голову.
5
Каждый день

Привычка, которая экономит нервы

Управление контекстом, это не разовая настройка, а рабочая привычка, которая со временем становится автоматической.

  • Не ждите, пока агент явно начнёт путаться. Проще сбрасывать контекст заранее, между задачами, чем разгребать путаницу постфактум.
  • Перед /clear сохраните текущий прогресс через git commit, чтобы точно ничего не потерять, даже если резюме окажется неполным.
  • Начинайте новую сессию с одного короткого абзаца: что делали, что уже готово, что осталось сделать дальше.
  • Не вставляйте в чат целиком огромные куски вывода команд или логов ошибок. Оставляйте только нужную часть, остальное просто занимает место без пользы.
  • Если чувствуете, что разговор стал слишком длинным и переключились на новую тему внутри той же сессии, это тоже повод для очистки.
Главное, что стоит унести из этого гайда: если Claude Code вдруг ведёт себя странно, дело не всегда в задаче или в вас. Иногда агенту просто нужно немного свежего места в памяти.