Как собрать контекст для Claude, чтобы он не терялся в противоречивых инструкциях

У многих, кто давно работает с Claude Code, есть один и тот же файл – CLAUDE.md, который постепенно разросся до нескольких сотен строк. Туда за месяцы работы попало все подряд: как называть переменные, что делать с комментариями, как оформлять коммиты, что писать в тестах, а что нет. Кажется логичным – вдруг какое-то правило понадобится, лучше пусть будет записано. На деле часть этих правил начинает противоречить друг другу и самому запросу пользователя, и модели приходится тратить силы на то, чтобы понять, какую инструкцию слушать в первую очередь.

Anthropic недавно пересмотрела собственные подходы к тому, как собирать контекст для новых моделей Claude 5, и убрала из системного промпта Claude Code больше 80% инструкций – при этом тесты по программированию не показали измеримого ухудшения результата. Вот что изменилось и как это применить к своему проекту.

Первое – меньше жестких правил, больше доверия. Раньше модели прямо запрещали писать многострочные комментарии, чтобы подстраховаться от худших случаев. Но правило подходило не всем: где-то нужна была подробная документация, а где-то нет. Вместо запрета теперь используют простую инструкцию – писать код в стиле того, что уже есть в проекте. Это стоит повторить и в своем CLAUDE.md: если правило написано на все случаи жизни, скорее всего, оно мешает в половине из них.

Второе – меньше примеров, понятнее интерфейс. Раньше, чтобы объяснить модели, как пользоваться инструментом, добавляли побольше примеров. Оказалось, что примеры сужают пространство для решения, а не помогают. Показательный случай – инструмент для списка задач: описание на 9100 символов заменили коротким – три статуса задачи и одно правило, что активной может быть только одна. Если ваша документация состоит в основном из примеров «как сделать вот так», возможно, ее стоит заменить на понятную структуру, а не на список случаев.

Третье, и, пожалуй, самое полезное – прогрессивное раскрытие вместо всего сразу. Не обязательно держать в одном файле вообще все, что когда-либо может пригодиться. Инструкции по code review вынесли в отдельный навык, который вызывается только когда нужен, а не лежит в основном контексте постоянно. Тот же принцип стоит применить к своим файлам: короткий CLAUDE.md с описанием неочевидных особенностей проекта, а специфичные инструкции – в отдельные навыки, на которые можно сослаться.

Четвертое – про память. Раньше приходилось вручную командовать Claude что-то запомнить, и это записывалось в CLAUDE.md. Сейчас модель сама сохраняет то, что относится к текущей работе и к пользователю, без ручной команды.

Проверить, насколько раздулся собственный контекст, можно одной командой – /doctor. Она подсказывает, что стоит сократить в навыках и файлах CLAUDE.md, а что оставить.

Начать стоит с малого: открыть свой CLAUDE.md и честно спросить – какая часть этих правил на самом деле неочевидна, а какая просто когда-то показалась хорошей идеей. Вторую часть можно смело убирать.