Перейти к содержанию

Claude Code

CLAUDE.md растёт на 226% за свою жизнь

2 мин чтения

Текст написан ИИ-моделью по источникам, на которые ведут ссылки, и сверен с ними второй моделью. Как мы работаем

Всё о теме: Claude Code: версии и изменения →
Изображение: arxiv.org

Файлы инструкций для кодовых агентов вроде CLAUDE.md в реальных репозиториях почти никогда не худеют. Рост останавливается, только когда репозиторий закрывают или кто-то переписывает файл целиком. К такому выводу пришли авторы препринта на arXiv, опубликованного 11 августа: за срок жизни такой промпт вырастает больше чем втрое (+226%), а каждый коммит добавляет в него в среднем 4,9 инструкции чистого прироста.

Работу отправил на arXiv Кушал Чакрабарти, выборка в ней большая: 247 694 жизненных цикла отдельных инструкций в 1 867 репозиториях. Помимо общего роста авторы измерили, как возраст правила влияет на шанс его удаления. Чем дольше инструкция живёт в файле, тем реже её трогают: логарифм риска удаления падает на 0,032 с каждым коммитом.

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

Причину роста авторы называют несовершенным припоминанием (imperfect recall). Дописать инструкцию всегда дёшево. Удалить сложнее: как только обоснование правила утеряно, удаление без риска регрессии в промпте из |D| инструкций стоит O(2^|D|). Экспонента здесь из перебора: чтобы доказать, что строка не нужна, в худшем случае приходится проверять её против всех сочетаний остальных, и с каждой новой инструкцией вариантов становится вдвое больше.

Явление назвали catastrophic remembering, «катастрофическое запоминание». Название отсылает к катастрофическому забыванию, когда модель при дообучении на новых задачах теряет старые навыки: вокруг этой проблемы выстроено всё непрерывное обучение. В промптах беда обратная: система не может забыть ничего.

Советы по CLAUDE.md за этот год успели смениться. В январе 2026 года Борис Черни рекомендовал дописывать правило после каждой ошибки модели, а в конце июля уже предлагал раз в полгода удалять CLAUDE.md, навыки и хуки и возвращать строки только после повторяющихся сбоев.

Лечение авторы предлагают позаимствовать у обычного кода: писать в промпте комментарии, которые фиксируют скрытое обоснование инструкции. Проверяли идею на перевёрнутом IFEval. Сам IFEval - набор инструкций, выполнение которых проверяется автоматически; перевернув его, авторы получили проверяемые среды, где оптимальный промпт известен заранее. Там комментарии убрали 99,3% лишних инструкций: избыточный рост сократился с +211,3% до +1,4%.

Тот же приём применили к WildIFEval, набору ближе к реальным запросам. Там комментарии в промптах улучшили следование инструкциям в агентных задачах до 23,1%.

Аннотацию авторы заканчивают вопросом: «Если английский - новый код, почему у нас до сих пор нет комментариев?»

Пока никто не написал. Будьте первым.

Присоединяйтесь к разговору

Войдите, чтобы оставить комментарий. Он появится после модерации.