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 помиляється.