CLAUDE.md: памятка для ИИ, 4 прогона и замок на важное

Что такое CLAUDE.md и зачем он нужен

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

Логика простая. Помощник видит только то, что вы ему дали в этой беседе. Вчерашние договорённости он не помнит. Всё, что вы готовы повторять каждый раз, дешевле один раз записать

В официальной справке прямо назван момент, когда пора дописывать в этот файл: когда помощник второй раз делает одну и ту же ошибку, когда вы второй раз печатаете в чат ту же поправку, и когда новому человеку в команде понадобился бы ровно этот же контекст

Где лежит файл и какой из них главный

Файлов CLAUDE.md на одной задаче может работать сразу четыре, и они не спорят друг с другом, а складываются в один общий текст. Справка формулирует это дословно: «All discovered files are concatenated into context rather than overriding each other», то есть все найденные файлы склеиваются в контекст, а не перекрывают друг друга

Порядок такой: сначала общий для всей организации, потом ваш личный на весь компьютер, потом проектный, потом личный к этому проекту. Чем ближе к вашей папке, тем позже помощник это читает

Новичку нужен ровно третий: CLAUDE.md в корне проекта, то есть в той же папке, откуда вы запускаете помощника. Остальные три - на вырост

Есть тонкость, на которой спотыкаются. Помощник поднимается вверх по дереву папок и подхватывает памятки из всех папок над вашей. А файлы из подпапок он читает не сразу, а только когда доберётся до файлов в этих подпапках

Шаг 0. Что нужно до старта

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

Если его ещё нет, поставьте по отдельному гайду установки - там разобраны и оплата из России, и вход в аккаунт. Без него дальше некуда класть памятку и нечем её проверять

Проверить, что всё на месте, можно одной командой. Откройте окно в папке любого своего проекта и наберите /context: помощник покажет, что сейчас загружено в его память. Пока памятки нет, раздела с файлами памяти в этом списке не будет - ровно это и станет точкой отсчёта, с которой мы сравним результат в конце

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

Как завести памятку за 10 минут

Быстрее всего это делает встроенная команда /init: она осматривает папку и пишет первый черновик памятки сама. В справке она описана как «Initialize project with a CLAUDE.md guide»

Важная деталь: если памятка уже есть, /init её не затирает. Справка говорит, что в этом случае команда предлагает улучшения вместо перезаписи

Автоматический черновик - только заготовка. Он опишет то, что помощник и так видит в папке: какие есть файлы, какими командами всё собирается. Ценность появляется дальше, когда вы допишете то, чего он увидеть не мог

Скелет памятки: шесть блоков

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

# Проект: (название)

## Что это
(Одно-два предложения: что за проект и для кого)

## Где что лежит
- (папка) - (что в ней)
- (файл) - (за что отвечает)

## Правила работы
- (Проверяемое правило, например: имена файлов строчными буквами через дефис)
- (Ещё одно, например: новые тексты кладём в папку notes)

## Чего не делаем
- (Запрет и причина, например: не трогаем папку с готовым сайтом, там боевые файлы)

## Как проверить, что готово
- (Команда или действие, по которому видно, что работа сделана)

## Куда расти
- (Длинные пошаговые инструкции выносим в отдельные файлы, здесь только ссылка)

Скопировали, вставили, сохранили - в следующей беседе помощник прочитает это сам, и вы увидите, что он перестал переспрашивать про структуру папок

Разница между рабочим правилом и бесполезным - в проверяемости. Правило «пиши хороший код» не даёт помощнику ничего: под него нельзя подставить действие. Правило «отступ два пробела» даёт

Как выглядит зрелая памятка через полгода

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

У моего боевого файла структура сложилась такая, без единой строки самих правил - только их устройство:

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

Третий признак неочевидный: часть правил из памятки со временем уходит. Не потому что перестала быть нужной, а потому что переехала туда, где выполняется надёжнее. Об этом дальше, и это самое важное место статьи

Живая проверка: одна задача, два прогона

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

Памятка во втором прогоне несла три правила: класть текстовые файлы только в папку notes, называть их строчными латинскими буквами через дефис, первой строкой ставить пометку <!-- черновик -->. Ни одно из этих правил в самой задаче не упоминалось

Разница видна в трёх местах сразу. Без памятки файл лёг в корень проекта и получил имя прописными буквами. С памяткой - ушёл в нужную папку, получил имя по правилу и обзавёлся пометкой в первой строке

Это и есть весь смысл файла: помощник сделал три вещи, о которых его в этот раз никто не просил. Каждый прогон уложился в двадцать с небольшим секунд, версия инструмента 2.1.186, записи обоих запусков сохранены целиком

Почему правило иногда не срабатывает

Правило не срабатывает потому, что памятка приходит модели контекстом, а не настройкой, которая запрещает что-то механически. Справка Anthropic говорит об этом прямым текстом, без смягчений:

«Claude treats them as context, not enforced configuration. To block an action regardless of what Claude decides, use a PreToolUse hook instead»

Anthropic, справка Claude Code, раздел про память, 19.08.2026

Там же объяснено, почему так: содержимое памятки приходит модели обычным пользовательским сообщением после системной инструкции, и строгого исполнения никто не гарантирует

Это не теория из документации, на это жалуются в открытую. В трекере ошибок самого Claude Code лежит заявка «CLAUDE.md Mandatory Rules Consistently Ignored Across Multiple Repositories» от 24 июня 2025 года, где автор пишет, что инструмент ведёт себя так, будто файла нет вовсе. Вторая, «Claude Code continually ignores CLAUDE.MD file» от 13 марта 2026 года, закрыта отметкой «not planned», то есть чинить это как поломку не собираются. Разбор практика на стороне формулирует причину короче всех: «CLAUDE.md rules are probabilistic, not deterministic», а вывод делает такой же - правила, которые важны, кладут в хук

Из этого следуют три практических вывода, и все три проверяемые:

• Чем конкретнее правило, тем надёжнее оно выполняется. «Отступ два пробела» работает лучше, чем «форматируй код правильно»
• Противоречивые правила в разных файлах помощник разрешает произвольно, поэтому старые и спорящие между собой строки чистят
• Если правило обязано срабатывать всегда, одного текста мало

Отдельно стоит сверять источник нормы объёма. Ту же цифру «до 200 строк» многие статьи подают как своё правило, хотя это дословная строка официальной справки: «Size: target under 200 lines per CLAUDE.md file». Самый большой русскоязычный материал по теме я скачал и посчитал сам: в видимом тексте страницы 6 257 слов. Размер материала не делает его первоисточником, норму назначает справка, и сверять её надо там

Замок вместо просьбы: когда правило переносят в настройки

Когда цена ошибки высокая, правило перестают писать словами и вешают замок - маленький скрипт вроде zamok.sh, который запускается перед каждым действием помощника и решает, пропускать его или нет. Останавливает он действие до того, как оно случится, а не после

Я проверил обе половины на одной песочнице. Сначала положил запрет словами в памятку: «Никогда не удаляй файлы в этом проекте», и попросил удалить файл. Помощник отказался сам и процитировал памятку - правило сработало. Но сработало оно решением модели, а не механикой, и в этом вся разница

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

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

Правило простое: пока ошибка стоит переделки - хватает памятки. Как только ошибка стоит утечки или потери данных - нужен замок. Как устроены такие замки внутри и куда их прописывают, разобрано отдельно в словарной статье про хуки и в статье про файл настроек

Что в памятку не пишут никогда

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

Вторая - длинные пошаговые инструкции. Памятка грузится целиком в каждую беседу, поэтому страница инструкции, нужная раз в месяц, всё это время занимает место. Справка по навыкам говорит об этом дословно:

«Unlike CLAUDE.md content, a skill's body loads only when it's used, so long reference material costs almost nothing until you need it»

Anthropic, справка Claude Code, раздел про навыки, 19.08.2026

Третья - пересказ того, что помощник и так видит. Список файлов в папке, названия зависимостей, очевидная структура: он это прочитает сам, а место в памятке займёт

И ещё одно, менее очевидное. Общие пожелания вроде «будь хорошим инженером» не дают помощнику ничего, потому что под них нельзя подставить действие. Такая строка только разбавляет файл и снижает вес соседних строк, которые действительно что-то значат

Когда файл распух: 200 строк и что выносить

Ориентир тут один и он официальный: до 200 строк на файл, а дальше справка обещает ровно две вещи - больше съеденного места и хуже соблюдаемые правила. Формулировка дословная: «Size: target under 200 lines per CLAUDE.md file. Longer files consume more context and reduce adherence»

Когда упёрлись в потолок, содержимое разносят по трём адресам:

Про авто-память стоит знать одну цифру: в беседу загружаются только первые 200 строк её входного файла или первые 25 КБ, что наступит раньше. Всё, что ниже, помощник на старте не увидит, поэтому входной файл держат в виде оглавления, а подробности уносят в отдельные файлы рядом

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

Источники

• Anthropic, справка Claude Code, раздел про память проекта - уровни файла и порядок загрузки, норма 200 строк, формулировка про контекст против настройки, поведение при сжатии беседы, авто-память. Обращение 19.08.2026
• Anthropic, справка Claude Code, раздел про хуки - события, сигнал запрета и его эффект. Обращение 19.08.2026
• Anthropic, справка Claude Code, список команд - описания /init, /memory, /context, /compact. Обращение 19.08.2026
• Anthropic, справка Claude Code, раздел про навыки - когда раздел памятки пора выносить в навык. Обращение 19.08.2026
• Anthropic, справка Claude Code, раздел про файлы настроек - расположения, порядок приоритета, запреты по маске. Обращение 19.08.2026
• Трекер ошибок Claude Code, заявка 2544 от 24.06.2025 и заявка 34197 от 13.03.2026 - жалобы практиков на то, что правила из файла не выполняются. Обращение 19.08.2026
• Boucle, разбор «Why Claude Code Ignores Your Rules» от 24.03.2026 - формулировка «probabilistic, not deterministic» и вывод про хуки. Обращение 19.08.2026
• Собственные прогоны 19.08.2026 на версии 2.1.186, четыре запуска в пустой папке: та же задача без памятки и с памяткой, запрет словами и запрет замком. Записи прогонов сохранены целиком

Памятка: файл правил за один вечер

Семь пунктов, по которым видно, что памятка собрана, а не просто создана

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

Читайте также

Структура проекта для Claude Code: папки и файл CLAUDE.md

Как разложить папки и файлы, чтобы памятке было что описывать

Хуки (hooks) в Claude Code: что это и как настроить

Что такое замок перед действием и как его настроить

settings.json в Claude Code: где лежит и что писать

Где лежит, что в нём пишут и как он связан с запретами