Claude Code снова всё забыл: как файл CLAUDE.md избавляет от повторных объяснений
Вы уже объясняли Claude Code, что у вас за проект, каких поставщиков не трогать и в каком тоне отвечать клиентам. Через два дня открываете новую сессию — и агент снова спрашивает то же самое, будто вчерашнего разговора не было.
Claude Code не хранит прошлые сессии автоматически, если вы не сказали ему, что запоминать. Механизм для этого есть — файл CLAUDE.md, который агент сам подгружает в начале каждой новой сессии. Обычно дело не в инструменте — файл просто никто не заполнил.
Ниже — что писать в CLAUDE.md, если вы не пишете код. Вся русскоязычная выдача в Яндексе по этому запросу сейчас написана для разработчиков: объясняет стек технологий и правила именования переменных.
Что такое CLAUDE.md и зачем он агенту без программирования
Формально CLAUDE.md — обычный текстовый файл в формате Markdown. По официальному описанию Anthropic, его содержимое передаётся Claude как сообщение сразу после системного промпта — агент читает файл первым делом, ещё до вашего первого сообщения в чате.
Разработчик обычно кладёт туда стек технологий и команды сборки. Меняется только содержание, не механика: вместо код-конвенций в файле живут правила проекта — какой это бизнес, какие данные под запретом, какие форматы документов приняты, кого нельзя упоминать без согласования. Получается что-то вроде инструкции для нового сотрудника, только перечитывает её агент перед каждой сессией, а человек — один раз при найме.
Механизм не привязан к коду вообще. Один автор на Хабре ведёт через Claude Code базу знаний в Obsidian, обрабатывает заметки со встреч и пишет черновики писем, ни разу не открыв редактор кода. CLAUDE.md там описывает структуру папок базы, типовые процессы и шаблоны заметок — тот же принцип, что и в примере с агентством ниже, только применённый к личной задаче.
Уровни файла — что положить в какой
CLAUDE.md существует не в одном экземпляре. Документация Claude Code описывает четыре уровня, которые действуют совместно — правила накапливаются от уровня к уровню. Для предпринимателя без своей команды разработчиков из них практически всегда актуальны три.
Глобальный уровень
~/.claude/CLAUDE.md действует во всех ваших проектах сразу. Сюда логично класть личные предпочтения: на каком языке отвечать, насколько подробно, в каком тоне.
Проектный уровень
./CLAUDE.md в корне проекта хранит общие правила именно этой задачи. Его стоит держать вместе с остальными файлами проекта, чтобы правила не терялись при переносе на другой компьютер.
Локальный уровень
./CLAUDE.local.md не покидает вашу машину. Сюда идут тестовые доступы и личные заметки на ходу — то, что не нужно видеть даже коллеге с доступом к тому же проекту.
Четвёртый уровень — управляемая политика организации — настраивают администраторы корпоративных аккаунтов Team и Enterprise; соло-предпринимателю или небольшой команде без выделенного айтишника он обычно не понадобится. При конфликте между уровнями локальный файл побеждает проектный, а тот — глобальный: чем ближе правило к конкретной задаче, тем больше у него веса.
Что реально писать, если вы не пишете код
Контекст проекта
Файл начинается с пары предложений о самом бизнесе — того, что агенту иначе неоткуда взять: чем занимается компания, для кого делается конкретная задача, что уже пробовали и почему не сработало.
Ограничения
Агент не должен без вашего явного разрешения связываться с реальными клиентами напрямую, менять цифры в уже отправленном документе или трогать боевую базу данных. Формулировка от противного работает здесь лучше общих пожеланий: агент не додумывает границы там, где их назвали прямо.
Форматы и шаблоны
Дальше — то, что у вас уже принято: как оформляется коммерческое предложение, каким тоном идёт переписка с клиентами, какие термины использовать в текстах для них. Часть инструментов в связке ждёт похожий файл под именем AGENTS.md — механика та же, только имя другое.
Пример того, как это может выглядеть для небольшого агентства:
## Проект Маркетинговое агентство, 6 человек. Ведём таргет и контент для B2B-клиентов малого бизнеса. Claude Code использую для отчётов клиентам и черновиков коммерческих предложений — не для кода. ## Ограничения - Не отправлять готовые тексты клиентам напрямую — только черновик мне на проверку - Цифры в отчётах брать только из выгрузки Excel, не досчитывать самому - Не упоминать в текстах имена клиентов, которые просили конфиденциальность ## Форматы - Коммерческое предложение — по шаблону в /templates/kp-template.md - Тон переписки — на "вы", без канцелярита, без "будем рады сотрудничеству" - Отчёт клиенту — таблица метрик + три абзаца выводов, без воды
Разработчик в таком же файле подробно описал бы стек и архитектуру — у бизнес-задачи вместо этого практика и ограничения, но общий принцип идентичен: если правило важно и повторяется, оно живёт в файле, а не в вашей голове, где о нём легко забыть между сессиями.
Есть ещё официальная рекомендация — держать файл короче 200 строк. Разросшийся файл технически не запрещён, но начинает работать против вас: чем больше текста агент вынужден удерживать в контексте, тем хуже он соблюдает именно те инструкции, ради которых файл заводили. Исследование Chroma по деградации точности LLM с ростом контекста показывает падение точности до 30%+, если нужный факт расположен в середине длинного документа — этим и объясняется, почему раздутый CLAUDE.md работает хуже короткого.
Что бывает без записанных правил
Насколько сильно это ощущается на практике, показывает разбор одного разработчика на Хабре. Он подробно описал, как без выстроенной системы памяти агент трижды заходил не туда: пытаясь «починить» рабочий адрес, сломал загрузку файлов в проекте; открыл двенадцать SSH-подключений в минуту и словил получасовую блокировку от fail2ban; один раз удалил рабочие данные вместо того, чтобы их перенести. После того как он записал правила в систему памяти, повторных ошибок того же типа не случилось — 27 передач задачи между сессиями за четыре дня прошли без единой из них.
Это кейс продвинутого разработчика с редким по сложности сетапом — экстраполировать его напрямую на типичную ситуацию предпринимателя без своего программиста нельзя. Механизм при этом тот же самый: агент действует по лучшей догадке именно там, где правило не было записано явно, и догадка не всегда совпадает с тем, что вы имели в виду.
Частые ошибки при заполнении
Формулировки вроде «работать аккуратно» или «не терять данные» не дают агенту ничего проверяемого — их не с чем сверить, и он трактует их как получится. Работает конкретика: не отправлять письма клиентам без вашего просмотра, не менять цифры в уже согласованном документе.
Другая ловушка — считать CLAUDE.md жёстким регламентом, который агент обязан выполнить дословно. Сама документация Anthropic прямо предупреждает: файл задаёт контекст, но не гарантирует строгое выполнение — особенно для расплывчатых или конфликтующих инструкций. Если правило действительно не должно нарушаться никогда — например, запрет удалять файлы без подтверждения, — за это в Claude Code отвечает отдельный, более строгий механизм: hooks.
Проект тем временем меняется, а правила в файле часто застревают на той версии, что была месяц назад, — агент продолжает следовать уже неактуальной инструкции. Разумная привычка — превращать в правило каждую повторяющуюся ошибку агента сразу после того, как она случилась, не откладывая до следующей ревизии. С тем, что вообще делегировать Claude Code на старте, если вы не пишете код, разбирались в отдельном материале.
Частые вопросы
Как сделать CLAUDE.md, если вы не пишете код? Через обычный текстовый редактор — это markdown-файл, никакого программирования не требуется. Можно попросить сам Claude Code сгенерировать стартовый вариант командой /init: агент проанализирует проект и предложит черновик, который останется только поправить под себя.
Чем CLAUDE.md отличается от AGENTS.md? По задаче — ничем: оба формата решают одну и ту же проблему, просто прижились в разных инструментах. Если ваша связка агентов ожидает AGENTS.md вместо CLAUDE.md, переименуйте файл — содержимое от этого не меняется.
Обязательно ли класть CLAUDE.md в Git вместе с остальным проектом? Только проектный уровень. Локальный файл CLAUDE.local.md для того и существует, чтобы личные заметки и тестовые доступы не попадали в общий репозиторий и оставались видны только вам.
Что будет, если файла нет вообще? Ничего катастрофического — Claude Code продолжит работать и без него, просто каждый раз будет опираться только на то, что вы напишете в моменте. Правила, которые не менялись бы от сессии к сессии, придётся объяснять заново каждый раз.
Что делать, если агент всё равно нарушает записанное правило? Проверить в первую очередь длину файла и формулировку самого правила — расплывчатая инструкция вроде «работать аккуратно» соблюдается хуже конкретной. Если правило сформулировано чётко и всё равно нарушается регулярно, а не критично, чтобы держаться железно, — это сигнал перенести его из CLAUDE.md в hooks, более строгий механизм именно для таких случаев.
Заключение
CLAUDE.md решает узкую, но постоянно всплывающую проблему: избавляет от необходимости стартовать с нуля там, где правила уже известны и не меняются. Внимание к работе агента файл не отменяет — он снимает необходимость тратить это внимание на объяснение одного и того же в третий раз за неделю. Такие практические настройки предприниматели разбирают на живых встречах клуба — присоединяйся к AI Practiq, если хочешь сверить свою связку инструментов с чужой, прежде чем набьёшь на ней свою шишку.