CLAUDE.md: что писать, а что агент узнает сам
Файл, который читается каждую сессию, это налог. Разбираю, что в нём оставлять, как урезать втрое и почему половина написанного там вредит.
Где мы находимся
Самый дорогой файл в проекте
CLAUDE.md заводится первым делом и первым же превращается в свалку. У меня было ровно так.
Логика понятная: агент про проект ничего не знает, надо рассказать. И начинается. Структура папок, список команд, стек, архитектура, соглашения об именах. Оглянуться не успеваешь, а там полторы сотни строк.
Только вот этот файл читается в начале каждой сессии. Каждая строка оплачивается всегда: и когда ты правишь опечатку в тексте, и когда чинишь платежи.
Причём дважды. Токенами и вниманием: чем длиннее файл, тем хуже он соблюдается.
Ниже конкретные файлы и правила одного инструмента. У соседей есть свои файлы того же назначения, но механика отличается, так что переносить один в один нельзя.
Куда попадает этот текст
Тут нужно короткое отступление про то, как вообще устроен разговор с моделью. Без него дальше половина смысла теряется.
Что такое системный промпт
Модель не помнит ничего. Каждый твой вопрос уезжает к ней вместе со всей перепиской целиком, с нуля: вся история, все файлы, которые агент открыл, все команды, которые он выполнил. Модель читает это и отвечает.
Но перед всей перепиской идёт ещё один кусок текста, который ты не писал. Системный промпт. Это инструкция от разработчиков инструмента: кто ты, какими инструментами располагаешь, как себя вести, чего не делать. Он отправляется в каждом запросе, стоит выше всего остального и не смешивается с разговором.
Разница между этими двумя местами не формальная, а очень практическая. Всё, что лежит в системном промпте, находится в привилегированном положении: оно не стареет и не тонет. Всё, что попало в переписку, живёт по законам переписки: чем дальше уехало вверх, тем меньше весит.
Где в этой картине CLAUDE.md
В разборе про персону мы разводили пять способов задать характер ровно по этой границе: одни дописывают в системный промпт, другие подкладывают текст в разговор.
Так вот, CLAUDE.md это не системный промпт. В документации сказано прямо: содержимое доставляется пользовательским сообщением после системного промпта. То есть технически это первая реплика в разговоре, просто написанная не тобой.
Отсюда два следствия, о которых стоит знать заранее.
Он не про то, кто агент. Он про то, где агент работает. Характер сюда писать бессмысленно: он окажется этажом ниже механизмов, которые для этого предназначены.
И он подчиняется тем же законам, что остальной разговор. Не пропадает, но к сотому сообщению конкурирует за внимание со всем, что вы наговорили за два часа работы. Правило поведения так не удержишь. Факт о проекте удержишь: его достаточно знать, а не помнить каждую секунду.
Дальше полный разбор
Полный разбор и остальные материалы уровня Pro доступны по подписке.