CLAUDE.md за 30 минут: готовый шаблон, 6 правил живого файла и чек-лист аудита

CLAUDE.md - текстовый файл в корне проекта, который Claude Code читает в начале каждой сессии. Без него агент каждый раз начинает с нуля: ты тратишь по 5-10 минут на разогрев в каждом чате. С ним - получаешь сотрудника на втором году работы, который помнит твой стек, твою аудиторию и твои правила.

Ниже - готовый шаблон под копирование, 6 правил, которые отличают живой файл от мёртвого, разбор боевого CLAUDE.md действующего бизнеса и чек-лист аудита из 12 пунктов. Применить - 30 минут. Сэкономит - часов 6 в неделю на повторных объяснениях агенту.

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

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

С живым CLAUDE.md разогрев пропадает. Все правила в одном файле и автоматически попадают в начало каждой сессии. Промпт становится коротким: «сделай X», а не «я веду проект Y, инструменты Z, не делай A и B». Boris Cherny, создатель Claude Code, формулирует главный принцип работы с файлом коротко: каждый раз, когда Claude делает что-то не так, дописываешь одну строку в CLAUDE.md - и больше эту ошибку он не делает.

CLAUDE.md - файл в формате Markdown. Claude Code ищет его в четырёх местах и грузит все одновременно в начале сессии. Корпоративный уровень (/Library/Application Support/ClaudeCode/CLAUDE.md на Mac) - правила, которые админ компании раскатывает на всю команду, тебе как одиночке не нужен. Пользовательский (~/.claude/CLAUDE.md) - личные правила для всех твоих проектов. Проектный (./CLAUDE.md в корне) - правила конкретного проекта, коммитится в git. Локальный (./CLAUDE.local.md) - твои личные заметки по проекту, которые не должны попасть в git.

Имя файла регистр-чувствительное. CLAUDE.md заглавными - Claude прочитает. claude.md или Claude.md - не прочитает. Это типовая ошибка у новичков: создал файл, написал инструкции, удивился, что не работает - а имя в нижнем регистре.

Важная техническая деталь: CLAUDE.md приходит в модель как первое сообщение от пользователя, а не как системный промпт. Правила в нём - сильное пожелание, а не закон. Если правило критичное и должно выполняться всегда - его лучше реализовывать через hooks (детерминированные команды) или settings.json, а не через текст в CLAUDE.md.

Скопируй шаблон ниже, замени поля в квадратных скобках, сохрани в корне проекта как CLAUDE.md. Этого хватит, чтобы Claude перестал начинать с нуля в каждой сессии. Доращивать будешь по ходу, через правило «после каждой ошибки агента - добавь строку».

Шаблон обкатан на десятках проектов и держит файл в районе 80-120 строк - это диапазон, на котором агент даёт максимальную адекватность. Anthropic в документации ставит верхний потолок в 200 строк.

Чтобы Claude заполнил этот шаблон под твой проект автоматически, дай ему такой промпт: «Создай в корне проекта файл CLAUDE.md по моему шаблону. Прочитай ai-clone/INDEX.md и business/INDEX.md, заполни все поля в квадратных скобках на основе того, что найдёшь. Если данных не хватает - задай мне вопросы по одному. Проверь, что итоговый файл не больше 200 строк. Всегда отвечай на русском». Если папок ai-clone/ и business/ ещё нет - не страшно: Claude задаст уточняющие вопросы.

Эти 6 правил - сводный опыт из десятков проектов. После них CLAUDE.md перестаёт быть «файлом, который мы создали и забыли» и становится рабочим документом, к которому Claude обращается каждую сессию.

1. Держи под 200 строк. Anthropic в документации пишет прямо: файлы длиннее 200 строк сжигают контекст и снижают выполнение правил. После этой границы модель начинает игнорировать часть инструкций - это техническое ограничение, не маркетинг. Практический оптимум - 80-120 строк. Если разгоняешься до 300+ - разноси детальные правила по вложенным файлам, в CLAUDE.md оставляй ссылки.

2. Заканчивай каждую сессию рефлексией. В CLAUDE.md прописываешь: «в конце каждой сессии запиши, что сделал и что узнал, в файл retrospectives/YYYY-MM-DD_*.md». После этой строки Claude сам начинает каждую сессию завершать рефлексией. Через месяц у тебя готовая карта всех последних решений, по которой можно вернуться к проекту без «о чём я тут вообще думал».

3. Коммит после каждой завершённой задачи. В CLAUDE.md прописываешь: «после каждой завершённой задачи делай git commit с осмысленным сообщением». Claude сам начинает разбивать работу на атомарные коммиты. Если что-то сломалось - откатываешься на одну операцию назад, не на «всё, что я делал сегодня». История коммитов превращается в журнал работы.

4. Всегда сверяйся с папкой business/. При любой задаче, которая касается клиентов, продукта или текстов - агент должен сначала открыть business/INDEX.md и нужный файл. Без этого правила Claude пишет в «общем стиле качественного сайта». С ним - в твоём стиле, под твоего клиента, с твоими стоп-словами.

5. После каждой ошибки агента дописываешь правило. Главное правило, на котором держится живой CLAUDE.md. Примеры из моего файла, появившиеся после конкретных аварий: «никогда не коммитить чужие WIP-файлы через git add . - стейджить поимённо», «перед push в main проверять git log origin/main..main», «не выдумывать URL и токены - брать из .env или из кода». Каждая строка - след от конкретной аварии. Тот же выстрел в ногу не повторяется.

6. Критичную безопасность держи в .claude/settings.json. В CLAUDE.md ты пишешь «не трогай .env», но это пожелание - агент может нарушить. Для критичной безопасности есть .claude/settings.json - через него жёстко запрещаешь rm -rf, чтение .env целиком, паттерн export + curl в одной команде, git push --force. Правило в CLAUDE.md - совет, агент может нарушить. Правило в settings.json - блокировка, агент физически не сможет выполнить.

Разбираю каркас рабочего CLAUDE.md, который живёт в моём действующем онлайн-сервисе. Файл около 280 строк, 11 разделов. Конкретный текст не выложу - в нём боевая внутрянка. Но скелет переносится на любой бизнес. В большинстве примеров в интернете - технические шаблоны для разработчиков. Для предпринимателя такой файл бесполезен.

Коротко по разделам. Краткое описание проекта (15 строк) - выжимка для агента, куда мы. ИИ-клон (10 строк) - указатель на папку ai-clone/ с тоном, ценностями, стоп-словами. Структура репозитория (20 строк) - дерево с комментариями. Таблица «вопрос → файл» (25 строк) - сердце файла, роутинг к источнику. Ключевые принципы (40 строк, 10-15 пунктов) - раздел, который копится медленнее всего и стоит дороже всего. Каждый пункт - след от конкретной ошибки.

Операционное планирование (20 строк) - триггер-таблица «фраза пользователя → действие». Например, «план на неделю» → открой ops/monthly.md и создай файл недели. Инструменты (5 строк) - технологии. Публикация (15 строк) - пошаговый алгоритм выката в продакшен. Безопасность (35 строк) - четыре подраздела: работа с .env, доступ к продовой БД, безопасные команды для демонстрации, ротация секретов.

Каждый раздел должен отвечать на вопрос «без этого Claude сделал бы ошибку?». Если ответ «нет» - убираешь. Это главный фильтр при работе с файлом.

В Claude Code есть команда /init, которая создаёт базовый CLAUDE.md автоматически - сканирует проект и прописывает стек, команды сборки и тестов, распознаёт конвенции из .eslintrc и .prettierrc. Это нормальная стартовая точка. Но он не узнает, кто твой клиент, не пропишет твои стоп-слова, не сделает таблицу «вопрос → файл» под твою структуру.

Правильный сценарий: запускаешь /init, получаешь стартовый файл на 30-50 строк, накатываешь поверх шаблон из верхней части статьи, даёшь Claude промпт «заполни поля в квадратных скобках», прогоняешь стресс-тест «найди 10 двусмысленностей, из-за которых ты как агент можешь понять неправильно», дорабатываешь. Дальше живёшь с файлом: после каждой ошибки - одна новая строка.

Три похожих файла, которые часто путают. CLAUDE.md - правила проекта, ты пишешь сам, Claude Code читает в каждой сессии. AGENTS.md - универсальный стандарт для других агентов (Codex, Cursor, Copilot). MEMORY.md - автоматические заметки, которые Claude пишет сам себе про твои привычки. Все три могут существовать одновременно и не конфликтуют.

Главный вопрос, на котором путаются новички: читает ли Claude Code файл AGENTS.md? Нет. Нужно явно прописать в CLAUDE.md импорт через @AGENTS.md - тогда все правила из AGENTS.md попадут в контекст. Если ты работаешь только в Claude Code - AGENTS.md не нужен, оставайся с одним CLAUDE.md.

Про MEMORY.md: с недавнего обновления Claude Code сам ведёт заметки про тебя в файле ~/.claude/projects/<проект>/memory/MEMORY.md. Туда попадают «пользователь предпочитает короткие ответы», «работает на macOS, использует zsh» и так далее. Чтобы увидеть, что сейчас грузится в начало сессии, в Claude Code набери /memory.

Парадокс простой: написал 500 правил, чтобы Claude всё помнил, - Claude не помнит ничего. В каждой сессии Claude Code грузит в контекст системный промпт, твой CLAUDE.md, импортированные файлы, MEMORY.md, историю чата, тела файлов, которые Claude открывает. Всё это должно влезть в контекст модели. Чем больше CLAUDE.md - тем меньше места для работы.

Вторая проблема важнее денег. У моделей есть наблюдаемое свойство: первые 150-200 инструкций в контексте выполняются надёжно, дальше начинается «гниение контекста» - правила в тексте есть, но агент перестаёт их выполнять. Длинный CLAUDE.md эту проблему усиливает. Правила, которые ты считал важными, начинают молча игнорироваться.

Правило размера. 80-120 строк - оптимум, файл умещается на 2-3 экрана, агент выполняет 90%+ правил. 150-200 строк - предел, файл работает, но требует ревизии каждые пару недель. 200-300 строк - тревожная зона. 400+ строк - функционально мёртвый файл. Агент его «видит», но «не слышит».

Если CLAUDE.md разросся - не делай рефакторинг руками. Дай Claude промпт: «прочитай CLAUDE.md, оцени каждую строку по принципу "если убрать эту строку, агент сделает ошибку?", верни список строк, которые можно убрать без потери, с обоснованием». Удалит то, что объективно не работает.

1. «Будь хорошим инженером». Самая частая ошибка. Общие пожелания «пиши чистый код», «думай как senior» - слова, которые ничего не значат. Claude и так пишет код в общем смысле «чистым». Замена: «используй 2 пробела для отступов», «не используй any в TypeScript». Конкретно, проверяемо.

2. Дубли того, что Claude и так знает. Описания конвенций языка, объяснения, как работают npm/git/docker. Claude всё это знает с тренировки. Дубль режет твой контекст без пользы.

3. Длинные пошаговые инструкции внутри файла. «Как развернуть проект», «как написать миграцию БД» на десятки строк. CLAUDE.md - это место для правил-однострочников. Длинные инструкции - в skills/ или docs/. В CLAUDE.md - ссылка одной строкой.

4. Правила, которые уже проверяет линтер. «Используй точки с запятой», «не оставляй неиспользуемые импорты». Всё это ловит ESLint, Prettier, Biome. Линтер - детерминированный. Правило в CLAUDE.md - вероятностное. Дубль не нужен.

5. Секреты в CLAUDE.md. Пароли тестовых аккаунтов, токены sandbox API, ссылки на admin-панели. Всё это в файле, который коммитится в git. Никогда. Секреты - в .env. В CLAUDE.md максимум - правило «не читай .env целиком, для конкретной переменной - grep».

6. Файл-помойка на 500+ строк, который никто не чистил. Дубли правил, устаревшие ссылки, «исторические» примечания. Агент игнорирует большую часть. Лечение - раз в две недели ревизия по тесту «если убрать эту строку - агент сделает ошибку?».

7. Создал и забыл. Противоположная предыдущей. Файл собрали два месяца назад, не трогали. Стек сменился, папки добавились, CLAUDE.md ничего не знает. Признак: ты повторяешь одно и то же правило в каждой сессии. Если повторяешь больше двух раз - правило должно жить в CLAUDE.md, а не у тебя в голове.

Главный приём, который превратил мой CLAUDE.md из документа в живой инструмент - одна строка в самом файле: «в конце каждой сессии проверь, узнал ли ты что-то новое о пользователе или о работе с ним, чего нет в CLAUDE.md, и допиши строку». Через две недели файл начинает накапливать индивидуальные правила без отдельного процесса.

После этого блока Claude в конце каждой сессии сам спрашивает: «было ли что-то новое, что стоит зафиксировать?». Если было - предлагает черновик правила. Через полгода у меня в папке ai-clone/feedback/ лежит больше двух десятков файлов - правила, выученные через конкретные ошибки. Каждый файл - одна страница, формат Rule → Why → How.

Прогони свой текущий CLAUDE.md по чек-листу. Каждый пункт - 30 секунд. Если «нет» пять и больше - файл нуждается в чистке.

1. Размер. Файл меньше 200 строк?

2. Имя. Точно CLAUDE.md заглавными?

3. Расположение. В корне проекта?

4. Описание проекта в первых 5 строках?

5. Инструменты перечислены явно, без воды?

6. Есть схема репозитория?

7. Есть таблица «вопрос → файл»?

8. Есть раздел правил с «никогда» и «всегда»?

9. Каждое правило проверяемо?

10. Прописано правило «обнови в конце сессии»?

11. Прописано правило «рефлексия в конце сессии»?

12. Критичные запреты дублированы в .claude/settings.json?

CLAUDE.md - база. Когда он работает, открываются следующие уровни. Plan Mode - режим, в котором Claude сначала составляет план, ждёт одобрения, и только потом делает. Снимает боль вайб-кодинга: попросил поправить одно, он переписал полпроекта. Skills - отдельные .md-файлы с объёмным знанием для конкретных типов задач, грузятся по запросу. Sub-agents - изолированные задачи в собственном чистом контексте.

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

Создай в корне проекта файл CLAUDE.md, скопируй шаблон из начала статьи, заполни поля в квадратных скобках через промпт-помощник. Дальше - живи с файлом: каждая ошибка агента превращается в одну новую строку. Через две-три недели CLAUDE.md перестаёт быть «документом, который мы написали и забыли» и становится тем, к чему Claude реально обращается каждую сессию.

Если хочешь собрать вокруг CLAUDE.md полный каркас - папку business/ со вторым мозгом, папку ai-clone/ с цифровой проекцией тебя, базовые Skills, настроенный Plan Mode - это мы за 3 эфира делаем на практикуме по вайб-кодингу. С разбором твоего проекта, записями эфиров, поддержкой в чате. Старт 26-28 мая, стоимость 2 000 ₽.

Дочитал до конца - попробуй применить за следующие 30 минут. Лучшая инструкция та, что прошла через твои руки.