CLAUDE.md: как настроить файл памяти Claude Code

Матвей Абрамов

9 июля 2026 · 15 мин чтения · Уровень: Базовый → Средний

Ты запускаешь Claude Code, а он будто первый день на работе: не знает, какой командой у тебя собирается проект, каким стилем ты пишешь код, что где лежит. Ты объясняешь это заново каждую сессию — и жжёшь на это токены и время. CLAUDE.md закрывает ровно это: ты один раз описываешь проект в файле, и Claude читает его при каждом старте сам. Ниже разберём, что такое CLAUDE.md простыми словами, какие бывают файлы памяти и как они наследуются, как создать CLAUDE.md через /init и править через /memory, что именно в него писать, дам готовый шаблон под копирование и покажу главную ошибку, из-за которой Claude твой CLAUDE.md игнорирует. А в конце — зачем эта настройка нужна на самом деле и как она превращает Claude в станок для продукта без лица.

Что такое CLAUDE.md простыми словами

Короткий ответ сразу, как любит поисковик: CLAUDE.md — это файл памяти Claude Code, обычный текстовый файл в корне проекта, который агент автоматически читает в начале каждой сессии. Пишется он в разметке Markdown (отсюда расширение .md), и по сути это памятка о проекте, которую Claude открывает первой.

Разберём на пальцах. Без CLAUDE.md Claude Code каждый раз начинает с чистого листа: он видит файлы, но не знает договорённостей. Какой командой собирать? Какие тесты гонять? Писать на русском или английском? Что в проекте трогать нельзя? Всё это ты объясняешь в диалоге — и на следующий день объясняешь снова.

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

Аналогия простая: CLAUDE.md — это вводная для нового сотрудника, приклеенная к монитору. Без неё стажёр каждое утро переспрашивает, как тут всё устроено. С ней — сразу берётся за дело.

Важно не путать CLAUDE.md с обычным промптом. Промпт — разовое указание в конкретном сообщении, его надо повторять. CLAUDE.md — постоянные правила, которые Claude Code читает всегда и сам. Поэтому в файл кладут стабильные вещи (команды, стиль, структуру), а точечные задачи по-прежнему пишут промптом в диалоге.

Зачем он нужен: какую боль закрывает

Без файла памяти работа с Claude Code превращается в день сурка. Ты тратишь начало каждой сессии на одно и то же введение в контекст, а модель всё равно нет-нет да и сделает по-своему: соберёт не той командой, напишет не в твоём стиле, полезет в файл, который трогать не нужно.

Посмотри, как выглядит работа без CLAUDE.md и с ним:

Разница не в «удобнее», а в деньгах и нервах. Каждое повторное введение в контекст — это сожжённые токены и твоё время. Настроенный CLAUDE.md убирает эту рутину целиком: один раз описал — экономишь на каждой сессии дальше. Час такой настройки окупается за первую же неделю работы.

Файлы памяти: проектный, личный, глобальный

Файл памяти не один — их несколько, и они наследуются от общего к частному. Понимать иерархию важно: от неё зависит, где что писать, чтобы правило действовало там, где надо.

Работает это так: Claude Code складывает все подходящие файлы памяти вместе и получает общий свод правил на сессию. Плюс он ищет CLAUDE.md вверх по дереву папок (удобно в монорепозиториях) и подхватывает вложенные CLAUDE.md в подпапках, когда работает с файлами именно оттуда. То есть общий стиль можно задать в корне, а нюансы конкретного модуля — в его папке.

Логика выбора простая. Правило нужно всей команде на проекте — пиши в проектный ./CLAUDE.md (он в git, у всех). Правило только твоё и на конкретный проект — ./CLAUDE.local.md. Привычка, которая нужна тебе везде (например, «отвечай на русском») — в пользовательский ~/.claude/CLAUDE.md, и она подхватится во всех проектах.

Запомни развилку: общее и командное — в проектный файл, личное и глобальное — в пользовательский. Тогда правила не дублируются и не конфликтуют.

Как создать и править: /init, /memory, #

Теперь самое нужное — как настроить CLAUDE.md на практике. Есть три способа, и все быстрые.

1. Сгенерировать через /init. Набери /init прямо в Claude Code — он просканирует проект и создаст стартовый CLAUDE.md: подтянет команды, стек, структуру. Это лучший старт: не с чистого листа, а с готовым черновиком, который останется поправить.
2. Редактировать через /memory. Команда /memory открывает файлы памяти на редактирование — правишь текст, сохраняешь. Так вносишь осмысленные правки, когда хочешь пересобрать раздел.
3. Дописать на ходу — словами. Самый простой способ: прямо попроси Claude «добавь это в CLAUDE.md» или «запомни, что тесты гоняем через npm test» — он сохранит правило в файл памяти. В ряде версий работает и быстрый ввод через решётку: # всегда запускай тесты через npm test, и Claude предложит, куда сохранить.

Можно и просто открыть CLAUDE.md в любом редакторе и править руками — это обычный текстовый файл. Приём на каждый день: заметил, что Claude сделал не так, — тут же добавь через # короткое правило, чтобы в следующий раз не повторилось. Память растёт вместе с проектом.

Что писать в CLAUDE.md

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

1. Частые команды. Сборка, тесты, линт, запуск, деплой. Чтобы Claude не гадал, а брал готовое: npm run build, npm test, npm run deploy.
2. Стиль кода и соглашения. Строгий TypeScript без any, длина функций, именование, язык коммитов. Конкретно, а не «пиши красиво».
3. Структура проекта. Где что лежит: src/ — код, tests/ — тесты, куда класть новые модули. Пары строк хватает.
4. Инструменты и версии. Какой пакетный менеджер, версия Node, какие библиотеки предпочитаешь, а какие не тянуть.
5. Предупреждения. Что не трогать: боевые ключи, миграции, сгенерированные файлы. Это экономит от дорогих ошибок.
6. Правила поведения. Отвечать на русском, спрашивать перед удалением, не коммитить без запроса. Короткими пунктами.

Обрати внимание на формулировки. Конкретика бьёт общие слова. «Пиши хороший код» модель поймёт как угодно. «Функции до 40 строк, тесты обязательны, коммиты на русском» — однозначно и проверяемо. Каждое правило должно быть таким, чтобы по нему нельзя было ошибиться в трактовке.

Готовый шаблон CLAUDE.md

Чтобы не собирать с нуля, вот рабочий шаблон. Скопируй, выкинь лишнее, подставь свои команды и правила — и файл готов. Это старт, а не финал: дальше дорабатывай по ходу.

Разделы можно менять под себя: для одних проектов важнее команды, для других — предупреждения о боевых данных. Держи файл коротким и читаемым — это не документация на весь проект, а выжимка самого нужного для работы с Claude.

Почему Claude игнорирует твой CLAUDE.md

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

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

Практический вывод, который экономит нервы: короче и конкретнее. Не пытайся описать в CLAUDE.md весь проект. Держи выжимку: команды, стиль, структуру, пару важных запретов. И правь итеративно — заметил ошибку, добавил одно точное правило через #. Так файл остаётся живым и рабочим, а не превращается в свалку, которую все игнорируют.

С чего начать на этой неделе

Чтобы это не осталось теорией, вот короткий план. После него CLAUDE.md перестанет быть загадкой и станет твоим рабочим инструментом.

1. Запусти /init. Пусть Claude Code сам соберёт стартовый CLAUDE.md по твоему проекту. Это быстрее, чем писать с нуля.
2. Почисти и уточни. Выкинь общие слова, добавь конкретику: точные команды, стиль, пару запретов. Держи файл коротким.
3. Добавь пользовательский файл. В ~/.claude/CLAUDE.md впиши то, что нужно во всех проектах: язык ответа, общие привычки.
4. Работай и дописывай. Заметил, что Claude ошибся, — тут же добавь правило через #. За неделю файл сам дойдёт до ума.
5. Проверь эффект. Через несколько сессий сравни: меньше ли повторных объяснений, чаще ли Claude попадает с первого раза. Обычно разница видна сразу.

Не пытайся написать идеальный CLAUDE.md за один заход. Хороший файл памяти вырастает итеративно: маленький старт, потом по правилу за раз. Это и есть правильный способ.

Зачем это всё на самом деле

А теперь честный разворот, ради которого всё затевалось. Можно идеально настроить CLAUDE.md, вылизать каждое правило, добиться, чтобы Claude слушался с полуслова — и остаться ровно там же, где был. Потому что настроенный инструмент — это не цель. Это мощность станка. И сама по себе она не приносит ни копейки.

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

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

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

Я зарабатываю не на том, что у меня идеально настроен CLAUDE.md. Я зарабатываю на продуктах, собранных в Claude. Инструменты — это мощность станка. Без продукта станок крутится вхолостую, как его ни настрой.

Дальше у тебя два пути — и оба ведут к своему продукту. Разница в скорости и в том, сколько шишек набьёшь по дороге.

Матвей Абрамов

Профессионально монетизирую нейросети

Собираю цифровые продукты без лица на нейросетях и довожу до продаж. В блоге и канале — разборы по Claude, нейросетям и вайбкодингу и то, как на этом строить деньги, без инфоцыганщины.

Telegram-канал Клуб · 12 000 ₽