CLAUDE.md: памятка проекта, которую читает помощник

Что такое файл CLAUDE.md и как его заполнить: правила проекта, что где лежит, чего делать нельзя. Простыми словами, на реальном примере лаборатории QuboLab.

Обновлено 30 июня 2026 г.

Коротко

CLAUDE.md — это файл-памятка о вашем проекте, который помощник читает каждый раз перед работой. В нём вы простыми словами пишете: что за проект, что где лежит и чего делать нельзя. То, что должно быть верным всегда, — чтобы не повторять это в каждом сообщении. Чем понятнее памятка, тем реже помощник ошибается и делает «не то».

Определение

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

Когда использовать

Записывайте в памятку всё, что должно соблюдаться всегда:

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

Когда НЕ стоит

Не пишите в памятку разовые поручения для одной задачи — их просто скажите помощнику в сообщении. Не делайте файл огромным: чем он длиннее, тем тяжелее помощнику держать его в голове. Если деталей много — выносите их в отдельные файлы и ссылайтесь.

Пошаговая инструкция

Как собрать памятку, которая реально помогает.

  1. 1
    Создать черновик командой /init

    Запустите /init — помощник сам напишет первый вариант памятки по тому, что увидел в проекте.

  2. 2
    Описать, что где лежит

    Простыми словами: где код сайта, где картинки, где настройки. Чтобы помощник не искал наугад.

  3. 3
    Записать правила и запреты

    Чёткие «делай / не делай»: как вы хотите, чтобы он работал, и чего нельзя трогать. Короткие понятные фразы работают лучше длинных абзацев.

  4. 4
    Большое — выносить отдельно

    Если какой-то раздел разрастается, заведите для него отдельный файл и дайте на него ссылку. Так памятка остаётся короткой.

  5. 5
    Поддерживать в актуальном виде

    Поменялось что-то важное — поправьте памятку. Устаревшее правило хуже отсутствующего: помощник поверит ему буквально.

Пример

Кусочек в духе нашей настоящей памятки (QuboLab) — обычный текст с табличками и списками:

## Что за проект
Сайт лаборатории на Next.js, база данных — Postgres, живёт на нашем сервере.

## Что где лежит
| Нужен... | Смотри |
|---|---|
| Код продуктов | папка something_projects |
| Тексты статей | папка content |

## Запрещено
- Придумывать цифры — брать из настроек
- Публиковать без моего разрешения

Главное — не «всё про проект», а точки входа: что где лежит + правила + запреты. Подробности живут в отдельных файлах, на которые памятка ссылается.

Частые ошибки

  • Слишком длинная памятка — помощнику тяжело удержать её целиком. Держите коротко, детали — по ссылкам.
  • Размытые формулировки — «пиши хорошо» бесполезно; «не придумывай цены, бери из настроек» работает.
  • Устаревшие правила — помощник верит памятке буквально; старое правило будет сбивать его раз за разом.
  • Описывать словами то, что и так в файлах — это лишнее, помощник и сам это видит.

Частые вопросы

Где должен лежать CLAUDE.md?+

В папке вашего проекта, рядом с остальными файлами. Тогда памятка всегда под рукой и действует для всех, кто открывает проект в Claude Code. В больших проектах можно держать отдельные памятки для отдельных частей.

Чем памятка отличается от «памяти»?+

Памятка CLAUDE.md — это правила: как работать в этом проекте. Память — это накопленные факты и заметки, которые сохраняются между сессиями. Коротко: памятка про «как надо», память про «что мы уже выяснили».

Насколько большой она может быть?+

Технически — любой, но за длину вы «платите» вниманием помощника в каждой сессии. Наш опыт: основную памятку держать короткой (десятки строк), а объёмные знания выносить в отдельные файлы.

Термины

Определения из глоссария QuboLab

Материалы QuboLab

Наши продукты, кейсы и исследования по теме