CLAUDE.md: как один раз объяснить Claude правила проекта

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

Что такое CLAUDE.md

Это обычный текстовый файл в формате Markdown, который лежит в корне проекта. Claude Code читает его автоматически в начале каждой сессии — тебе не нужно ничего копировать в чат.

Таких файлов может быть несколько:

• Глобальный — ~/.claude/CLAUDE.md. Твои личные правила для всех проектов: как ты работаешь, на каком языке общаться, чего никогда не делать.
• Проектный — CLAUDE.md в папке проекта. Правила конкретного сайта и конкретного клиента.
• Вложенный — в подпапке. Подхватывается, когда Claude работает с файлами этой части проекта.

Что туда писать

Только то, что повторяется и важно в каждой задаче:

• стек и структура проекта — где лежат страницы, компоненты, стили, изображения;
• нейминг — например, BEM для классов;
• дизайн-система — цвета, шрифты, отступы только через токены;
• что можно менять самостоятельно, а что — только после согласования;
• как проверять результат перед тем, как сказать «готово».

Что туда не писать

• Бриф, структуру и тексты. Это контекст проекта — держи их в отдельных файлах: brief.md, structure.md, content.md. CLAUDE.md отвечает на вопрос «как работать», контекст — «с чем работать».
• Разовые задачи. «Сделай кнопку синей» — это сообщение в чат, а не правило.
• Общие пожелания вроде «делай красиво». Правило должно быть проверяемым.
• Пароли и ключи. Никогда.

Пример

Короткий CLAUDE.md для лендинга частного шефа:

# Проект
Лендинг частного шефа. HTML + CSS, без CMS.
Контекст: brief.md, structure.md, content.md.

## Правила
- Тексты из content.md не переписывать — только переносить.
- Не придумывать цены, отзывы и контакты.
  Нет данных — ставь [PLACEHOLDER: что здесь].
- Цвета, шрифты и отступы — только CSS-переменные из tokens.css.
- Классы — BEM: hero, hero__title, hero--dark.

## Проверка
- Перед «готово» — проверить 375, 768 и 1440 px.
- Сказать, какие файлы изменены.

CLAUDE.md — не место, где AI принимает решения за нас. Это место, куда мы записываем уже принятые нами решения и правила работы.

Как не раздуть файл

Чем длиннее CLAUDE.md, тем хуже он работает: важные правила теряются среди второстепенных. Несколько привычек помогают держать его в форме:

• одно правило — одна строка;
• заметил, что повторяешь Claude одно и то же, — добавь правило;
• правило устарело или противоречит новому — удали;
• длинные инструкции для повторяемых процессов — дизайн, SEO, проверка сайта — выноси в Skills, а в CLAUDE.md оставляй только базу.

Начни с пяти-семи строк. Остальное допишешь в процессе — именно тогда, когда поймёшь, что без этого правила Claude ошибается.