Тогда наверняка знаете о важности файла CLAUDE.md. и его особенностях.
Сегодня разбираемся, что стоит туда добавить👇
🔘Описание проекта
Начните с самого простого — в одном-двух предложениях объясните Claude, что именно вы разрабатываете.
Чем лучше агент понимает цель проекта, тем меньше вероятность, что он начнёт предлагать решения, которые вообще не относятся к вашей задаче.
🔘 Принятые решения
Если вы уже выбрали технологии, платформу или ограничения проекта — обязательно укажите это в CLAUDE.md.
Такие правила помогают агенту работать в нужных рамках и не предлагать решения, от которых вы давно отказались. Чем больше важных решений зафиксировано, тем меньше времени придётся тратить на одни и те же объяснения в каждой новой сессии.
🔘 Пропишите ограничения
Многие подробно описывают, что нужно делать, но забывают объяснить, чего делать не стоит.
Такие ограничения помогают избежать лишних изменений и ситуаций, когда агент начинает «улучшать» проект там, где его об этом никто не просил.
🔘 Чётко укажите, как запускать проект
Добавьте конкретные команды для запуска, тестов и превью проекта.
Не объясняйте словами вроде «запускается стандартно» — пишите прямо:
npm run dev, npm test и так далее.Claude работает только с тем, что вы ему явно указали, поэтому точные команды сильно снижают количество ошибок и попыток «угадать», как у вас всё устроено.
🔘 Известные проблемы
Если в проекте есть баги, недоделанные функции или части системы, которые пока лучше не трогать, стоит написать об этом заранее.
Это помогает избежать ситуации, когда агент начинает «чинить» то, что вы уже знаете как проблемное, вместо того чтобы двигаться дальше по задаче.
📌Лайфхаки
Есть несколько простых приёмов, которые реально улучшают работу с файлом и Claude Code в целом.
🔘Начните с команды
/init Она сама проанализирует проект и создаст первый вариант CLAUDE.md.
Это помогает не начинать с пустого файла и сразу получить базовую структуру.
🔘Держите файл коротким.
Всё, что можно — выносите в отдельные документы и просто ссылайтесь на них. Чем меньше лишнего текста, тем лучше агент удерживает контекст.
🔘Пишите как для нового участника команды.
Не как техническую документацию, а как понятное объяснение человеку, который впервые видит проект.
🔘Фиксируйте свои правки.
Если вы постоянно говорите «не так», «переделай» — значит это нужно сразу добавить в CLAUDE.md.
И обязательно используйте режим планирования перед кодом. Сначала обсуждение и план, потом реализация — это сильно снижает количество ошибок и переделок.