CLAUDE.md: память проекта - что писать, а что нет

Argo Intelligent5 июля 20263 мин чтения✓ проверено 5 июля 2026

Каждая новая сессия Claude Code начинается с чистого листа: вчера вы полчаса объясняли, что за проект и как вы любите работать, - сегодня он этого не помнит. Решение - файл CLAUDE.md в папке проекта: Claude Code автоматически читает его в начале каждой сессии. Это Custom Instructions из шага 1.3, только для работы с кодом.

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

Быстрый старт: /init

В папке проекта напишите Claude Code команду /init - он сам изучит проект и создаст черновик CLAUDE.md. Для старта достаточно. Дальше - главный навык: пополнять и подрезать этот файл.

Формула: четыре блока

1. Что это за проект (2-3 предложения). «Сайт-визитка студии ремонта. Одна страница, форма заявки шлёт в Telegram. Аудитория - семьи, тон - спокойный и уверенный».

2. Как проверить, что всё работает. Самый недооценённый блок: команда запуска, что должно открыться, что проверить руками. «Запуск: открыть index.html. Проверка: форма отправляется, на телефоне ничего не разъезжается».

3. Правила проекта. То, что вы уже дважды объясняли в сессиях - переносите сюда: «Тексты на русском, без канцелярита. Цвета - только из палитры в начале style.css. После каждого законченного изменения - коммит. Ключи - только в .env».

4. Чего НЕ делать. Запреты работают отлично: «Не менять блок с ценами без прямой просьбы. Не добавлять библиотеки без согласования. Не трогать папку legacy/».

Что НЕ писать (антипаттерны)

Роман вместо инструкции. CLAUDE.md читается в каждой сессии и занимает место в «оперативной памяти» модели (подробнее - следующий шаг). Страница-полторы - потолок. Всё, что «вообще полезно знать», - в отдельные файлы, о которых можно сказать «прочитай docs/style.md, когда работаешь с текстами».
Очевидное и общее. «Пиши качественный код без багов» - мусорная строка: она ничего не меняет, но разбавляет важное.
Устаревшее. Переехали с одного способа оплаты на другой, а в CLAUDE.md старая инструкция - Claude будет уверенно делать по-старому. Правило: изменилось в проекте - обнови файл (это тоже одна фраза: «обнови CLAUDE.md по итогам этой сессии»).
Секреты. Файл лежит в проекте и попадает в Git - паролей и ключей в нём быть не должно.

Живой файл: правило одного повтора

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

У Claude Code есть и автоматическая память проекта - он сам делает пометки между сессиями. Она полезна, но работает как записная книжка модели; CLAUDE.md - как приказ. Важные правила держите в CLAUDE.md, где вы их видите и контролируете.

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

Практика шага

В проекте визитки: (1) запустите /init и прочитайте, что получилось, (2) перепишите по формуле четырёх блоков - коротко, своими словами, (3) закройте сессию, откройте новую и попросите любую правку. Заметите разницу сразу: он «в курсе» без объяснений. С этого момента ведите файл правилом одного повтора.

Следующий шаг - контекст: почему Claude «тупеет» в длинных сессиях и как с этим жить.