Как настроить CLAUDE.md в Claude Code: правила, шаблон, ошибки (2026)

Ты открываешь Claude Code, объясняешь: веду вот такой проект, отвечай по-русски, не трогай эти файлы, деплой только по команде. Всё работает. На следующий день окно закрылось, ты открываешь новое, и агент снова ничего не помнит. Приходится объяснять заново.

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

Коротко: словарик

• CLAUDE.md - файл с правилами проекта в формате Markdown. Лежит в корне, читается при каждом запуске Claude Code.
• Сессия - один запуск Claude Code, одно окно диалога. Новая сессия стартует с чистого контекста, поэтому и нужен файл с правилами.
• Контекст - объём текста, который модель держит в голове за раз. CLAUDE.md попадает в контекст первым и занимает часть места.
• settings.json - файл .claude/settings.json с жёсткими настройками и запретами. В отличие от CLAUDE.md, его правила агент нарушить не может.
• Роутинг - таблица «вопрос - в каком файле ответ». Помогает агенту не искать по проекту вслепую.

Зачем нужен CLAUDE.md и почему Claude забывает проект

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

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

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

С живым файлом разогрев исчезает. Правила, которые ты повторял в каждом чате, лежат в одном месте. Промпт становится коротким: «добавь на лендинг блок с отзывами», а не «я веду проект X, стек Y, стиль Z, вот эти файлы не трогай, и кстати помни про W».

Есть и третий эффект. Через CLAUDE.md ты показываешь агенту, куда идти за контекстом: где лежит портрет аудитории, где цены, где правила бренда. Без этой навигации Claude пишет тексты в вакууме, и они выходят шаблонными.

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

Где Claude Code ищет CLAUDE.md и как его назвать

CLAUDE.md это файл в формате Markdown. Claude Code смотрит его сразу в нескольких местах, и все они грузятся в контекст одновременно при старте сессии.

Для непрограммиста, который собирает один сайт или бота, хватает проектного файла в корне. Остальные уровни понадобятся позже, когда проектов станет несколько.

Имя файла строго заглавными буквами: CLAUDE.md. Файл claude.md или Claude.md строчными Claude Code просто не увидит, потому что имя регистрозависимое. Это классические грабли новичка: создал файл, написал инструкции, а агент их будто не читает. Проверь регистр первым делом.

Как собрать минимальный CLAUDE.md за пять минут

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

Вот рабочий шаблон под проект непрограммиста: сайт, лендинг, телеграм-бот или контент-проект. Замени поля в квадратных скобках на свои, сохрани в корень проекта под именем CLAUDE.md. Он держится в районе 60-90 строк, а это как раз тот диапазон, в котором агент выполняет почти все правила.

# [НАЗВАНИЕ ПРОЕКТА] - карта проекта

Этот файл читай в начале каждой сессии.
Здесь правила проекта: что делаем, где что лежит, чего не делать.

## Что за проект

**[НАЗВАНИЕ]** - [одно предложение: что это и для кого].
[Одно-два предложения: какую задачу решает и как].

## Стек

[Чем собран проект. Например: сайт на Astro, деплой на Netlify.
Или: телеграм-бот на Python, база в Supabase.
Если не знаешь термины - напиши как есть: "статический сайт", "бот".]

## Структура папок

[НАЗВАНИЕ]/
├── CLAUDE.md          ← этот файл
├── src/               ← исходники (страницы, компоненты)
├── content/           ← тексты, статьи, данные
├── public/            ← картинки и файлы
└── plans/             ← планы больших задач

## Где что искать

| Что нужно | Куда смотреть |
|---|---|
| Тексты и статьи | content/ |
| Внешний вид, стили | src/styles/ |
| Настройки, ключи | .env (не читать целиком) |
| Портрет аудитории и стиль | brand/audience.md |

## Правила проекта

1. Отвечай по-русски. Только дефис, не длинное тире.
2. Перед изменением файла объясни одной строкой, что меняешь.
3. Ничего не публикуй и не деплой без моей явной команды.
4. Не удаляй файлы без подтверждения.
5. Не выдумывай цены, даты и цифры - бери из файлов или спрашивай.
6. Тексты наружу пиши по стилю из brand/audience.md, а не "в общем".
7. .env целиком не читай. Нужна одна переменная - grep "^ИМЯ=" .env.

## Большая задача = план в plans/

Любую задачу дольше часа сначала оформи планом в папке plans/:
1. Имя файла: ГГГГ-ММ-ДД-название.md.
2. Раздели на шаги. Каждый шаг - галочка [ ] или [x].
3. В конце плана итог: сделано целиком или что осталось.

## В конце сессии

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

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

Если возиться с полями лень, поручи сборку самому Claude. Он прочитает проект, разберётся в структуре и заполнит шаблон за тебя. Дай ему такой промпт:

Собери мне файл CLAUDE.md для этого проекта.
 
Порядок действий:
1. Осмотри проект: какие есть папки, чем он собран, что в корне.
2. Заполни по этому шаблону поля в квадратных скобках на основе того, что нашёл:
[ВСТАВЬ СЮДА ШАБЛОН ИЗ СТАТЬИ ЦЕЛИКОМ]
3. Если каких-то данных не хватает (например, кто моя аудитория) - задавай вопросы по одному, с 3-4 вариантами ответа на выбор.
4. Проверь: файл не длиннее 150 строк. Если длиннее - убери воду, но раздел с правилами и планами не трогай.
5. Покажи готовый CLAUDE.md и спроси, что поправить.
 
Отвечай по-русски.

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

Шесть правил, которые делают CLAUDE.md живым

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

Правило 1. Держи короткий. Anthropic рекомендует держать файл в пределах 200 строк, практики целятся в 80-150. Причина простая: файл грузится в каждое окно и занимает место в контексте. Чем он длиннее, тем меньше токенов остаётся на работу и тем чаще модель начинает игнорировать правила. Файл на 800 строк агент видит, но не слышит.

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

Правило 3. Роутинг важнее правил. Таблица «вопрос - файл» это сердце CLAUDE.md. Без неё агент гадает, где лежит ответ, и пишет наугад. С ней идёт прямо к источнику: нужен стиль текстов - открывает brand/audience.md, нужны цены - открывает файл с ценами. Роутинг делает тексты твоими, а не «средними по интернету».

Правило 4. Правила должны быть проверяемыми. «Пиши хорошо» это пустая строка: агент и так старается писать хорошо. «Абзацы по одному-три предложения», «в конце CTA с UTM-меткой», «не используй слово прокачай» - вот это работает. Правило либо можно проверить глазами, либо оно не нужно.

Правило 5. Безопасность в settings.json, не тут. Про .env в CLAUDE.md можно написать «не читай целиком», но это пожелание. Настоящую блокировку опасных команд делаешь в .claude/settings.json. Про это отдельный раздел ниже.

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

Команда /init: с чего начать и почему её мало

В Claude Code есть команда /init. Она сканирует проект и собирает стартовый CLAUDE.md сама: определяет стек, прописывает команды сборки, подхватывает конвенции из существующих файлов настроек. Это нормальная точка старта, особенно если проект уже большой.

Но /init делает только техническую половину. Она не знает, кто твоя аудитория, какой у тебя стиль текстов и какие ошибки агент уже совершал (их ещё не было). Файл после /init получается общим и техническим.

Правильный порядок такой:

1. Запусти /init в Claude Code. Получишь стартовый файл на 30-50 строк со стеком и командами.
2. Накати поверх шаблон из этой статьи: добавь роутинг, правила проекта, блок про планы.
3. Дай агенту промпт «прочитай проект и заполни поля», если что-то осталось пустым.
4. Прогони стресс-тест: попроси Claude найти в файле двусмысленности, из-за которых он как агент может понять правило неправильно. Получишь список правок.
5. Дальше живи с файлом: после каждой ошибки дописываешь строку.

Через две-три недели такой работы файл перестаёт быть «документом, который мы написали и забыли».

CLAUDE.md против settings.json: где ставить запреты

Это разные инструменты, и путать их дорого. CLAUDE.md это правила-пожелания: агент читает и старается следовать, но контекст длинный, и одно правило из сотни может выпасть. .claude/settings.json это жёсткие настройки: если прописать там запрет команды, агент физически не сможет её выполнить.

Граница простая. Всё, что должно соблюдаться на сто процентов и связано с деньгами, потерей данных или безопасностью, идёт в settings.json. Всё остальное в CLAUDE.md.

Типичный набор запретов в settings.json для непрограммиста:

• rm -rf - рекурсивное удаление файлов. Одна опечатка агента, и проект стёрт.
• Чтение .env целиком. Там ключи и токены, им не место в контексте модели.
• git push --force без согласования. Может затереть чужую работу в общем репозитории.

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

Семь ошибок, которые делают CLAUDE.md мёртвым

Эти промахи я вижу в чужих файлах чаще всего. Почти все они это вариации одной проблемы: человек пытается сделать CLAUDE.md красивым документом проекта, вместо того чтобы держать его рабочим инструментом агента.

Ошибка 1. «Пиши как профи». Общие пожелания вроде «пиши качественный код», «думай как эксперт», «делай красиво» ничего не значат. Агент и так старается. Эти строки занимают место в контексте и не влияют ни на одно решение. Замена: конкретика. Не «пиши красиво», а «абзацы по одному-три предложения».

Ошибка 2. Дубли того, что модель и так знает. Объяснения, как работает git, что такое HTML или как устроен Astro, агент знает с обучения. Дубль в CLAUDE.md не добавляет ничего, только режет твой контекст.

Ошибка 3. Длинные пошаговые инструкции внутри файла. Инструкция «как задеплоить сайт» на тридцать строк раздувает файл. Место длинных инструкций в отдельных файлах, которые агент открывает по надобности. В CLAUDE.md строка-ссылка: «деплой смотри в docs/deploy.md».

Ошибка 4. Правила из головы, которые ты повторяешь в каждой сессии. Если ты второй раз за неделю говоришь «не делай X» вслух, это правило должно жить в файле, а не у тебя в голове. Повторил дважды - иди и запиши.

Ошибка 5. Секреты в файле. Токены и пароли в CLAUDE.md попадают в git и в контекст модели. Только .env и .gitignore. Разобрал выше, но повторяю, потому что это самая опасная ошибка.

Ошибка 6. Файл-помойка на 500 строк. Разросся, дублирует сам себя, противоречит в разных местах, никто не помнит, что там. Агент игнорирует половину. Признаки: больше 300 строк, повторяющиеся правила, ссылки на файлы, которых уже нет, «исторические» пометки. Лечение: раз в две недели давай Claude ревизию по тесту «если убрать эту строку, агент начнёт ошибаться? Если нет - удаляй».

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

Как обновлять CLAUDE.md, чтобы он рос сам

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

## В конце сессии

Проверь два вопроса:
- узнал ли я что-то новое о проекте или о том, как со мной работать?
- нарушил ли я правило, которое теперь стоит зафиксировать?

Если да - предложи одну строку для раздела "Правила проекта".
Я не пишу правила руками: я говорю "не так, надо вот так",
а ты оформляешь это в короткую строку.

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

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

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

Чек-лист: что у тебя теперь есть

Пройди по списку. Если файл собран правильно, все пункты закрыты.

• Файл называется CLAUDE.md строго заглавными буквами и лежит в корне проекта.
• В первых строках понятно, что за проект и для кого.
• Есть раздел со стеком: чем собран проект.
• Есть схема структуры папок с короткими пояснениями.
• Есть таблица роутинга «вопрос - в каком файле ответ».
• Есть раздел правил, где каждое правило конкретное и проверяемое.
• Прописано правило про план для больших задач.
• Прописан блок «в конце сессии проверь, что добавить».
• Критичные запреты (.env, rm -rf) продублированы в .claude/settings.json.
• Файл короче 200 строк.
• Внутри нет секретов, паролей и токенов.

Если больше двух пунктов с «нет», открой Claude и дай простой промпт: «прочитай мой CLAUDE.md, сверь с этим чек-листом, по каждому пункту скажи да, нет или частично и что поправить». Получишь список правок за минуту.

Дальше правило одно: не относись к файлу как к документу, который написал и закрыл. Каждая ошибка агента это новая строка. Через пару недель CLAUDE.md станет тем, к чему Claude реально обращается в начале каждой сессии, и разогрев по пять минут на окно пропадёт навсегда.