Как настроить CLAUDE.md в 2026: готовый шаблон, правила и разбор живых файлов

Открываешь Claude Code во вторник, объясняешь ему: «я делаю такой-то проект, инструменты такие, вот моя аудитория, не трогай вот это». Работает отлично. В четверг тот же чат закрылся — и ты повторяешь всё заново. В понедельник — ещё раз. Каждое новое окно начинается с пустого агента, которому ты заново диктуешь контекст.

Это лечится одним файлом. CLAUDE.md — единственный файл, который Claude Code подгружает в начале каждой сессии автоматически. Один раз настроил — и агент уже знает, кто ты, как с тобой говорить и каких ошибок не делать. Промпт в чате становится коротким: «сделай X», а не «я веду проект Y, инструменты Z, помни про A, B и C».

Я держу CLAUDE.md в каждом своём проекте больше года. Ниже — как он устроен, готовый шаблон, 6 правил, разбор моего реального файла и примеров из open-source. Без воды и без продажи курсов в конце.

Что такое CLAUDE.md и почему без него Claude — стажёр первого дня?

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

Без него каждый новый чат — это пустой стажёр. Умный, но ничего не знает про твой бизнес, твой стиль, твои правила. С живым CLAUDE.md — это сотрудник на втором году, который помнит контекст и не наступает на знакомые грабли.

Эту механику коротко описывает Boris Cherny, создатель Claude Code:

Каждый раз, когда мы видим, что Claude сделал что-то неправильно, мы дописываем это в CLAUDE.md, чтобы в следующий раз он так не делал.
— Boris Cherny, howborisusesclaudecode.com

Важная деталь, которую почти никто не объясняет: CLAUDE.md приходит к модели как сообщение пользователя после системного промпта, а не как часть системного промпта. На практике это значит — правила в нём это сильное пожелание, а не закон. Claude старается следовать, но строгой гарантии нет. Если правило обязано выполняться всегда без исключений (заблокировать опасную команду, прогнать форматтер) — его место не в CLAUDE.md, а в хуках или settings.json. Об этом ниже.

Где Claude Code ищет CLAUDE.md: четыре уровня

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

Уровень	Где лежит	Зачем
Корпоративный	/Library/Application Support/ClaudeCode/CLAUDE.md (Mac)	Правила, которые админ раскатывает на всю компанию. Соло-вайбкодеру не нужен.
Пользовательский	~/.claude/CLAUDE.md	Личные правила для всех твоих проектов: «отвечай на русском», «не используй длинное тире».
Проектный	./CLAUDE.md или ./.claude/CLAUDE.md	Правила конкретного проекта: инструменты, структура, бизнес-логика. Коммитится в git.
Локальный	./CLAUDE.local.md	Твои личные заметки по проекту, которые не должны попасть в git. Добавь в .gitignore.

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

Имя файла регистр-чувствительное. Только CLAUDE.md заглавными буквами. claude.md или Claude.md агент не прочитает — и ты будешь удивляться, почему правила не работают.

Готовый шаблон CLAUDE.md (скопируй и заполни)

Вот шаблон, который я обкатал на десятках проектов. Он держит файл в районе 80–120 строк — это диапазон, который рекомендует и Anthropic, и независимые практики. Скопируй, замени поля в квадратных скобках, сохрани в корне проекта как CLAUDE.md.

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

Читай этот файл в начале каждой сессии: где что лежит и как с этим работать.

## Что это за проект
**[НАЗВАНИЕ]** — [одно предложение: что это и для кого].
[1–2 предложения: какую задачу решает].
Подробности — в `context/INDEX.md`.

## Порядок чтения в начале сессии
1. `context/INDEX.md` — что мы делаем (продукт, аудитория, экономика)
2. CLAUDE.md (этот файл) — правила, инструменты, навигация
3. Зона задачи: нужный файл из `context/` или папка фичи в коде

## Структура проекта
[НАЗВАНИЕ]/
├── CLAUDE.md          ← этот файл
├── context/           ← контекст бизнеса (аудитория, продукт, цены)
├── plans/             ← планы фич (один план = одна фича)
└── (код проекта)

## Где что искать
| Что нужно | Куда смотреть |
|---|---|
| Для кого продукт, боли клиента | `context/audience.md` |
| Продукт, тарифы, цены | `context/product.md` |
| Технические планы | `plans/` |

## Инструменты
[Например: Next.js, TypeScript, Tailwind, Supabase]

## Правила
1. Не хардкодить цены/даты/цифры — брать из `context/`.
2. Не публиковать без явной команды от меня.
3. `git add` поимённо, никогда `git add .`.
4. Не выдумывать значения (URL, токены) — брать из кода или `.env`.

## В конце каждой задачи
- Сделай git commit с осмысленным сообщением.
- Запиши в `plans/`, что сделал и что осталось.

## Язык
Всегда отвечай на русском. Только дефис, не длинное тире.

Чтобы не заполнять руками, дай Claude промпт — он сам прочитает проект и подставит значения:

Создай в корне проекта файл CLAUDE.md по этому шаблону:

[ВСТАВЬ ШАБЛОН ЦЕЛИКОМ]

Действуй так:
1. Прочитай файлы проекта и пойми, что это за проект и кто я.
2. Заполни все поля в квадратных скобках на основе того, что нашёл.
3. Если данных не хватает — задай мне вопросы по одному, с вариантами ответа.
4. Проверь, что итог не больше 200 строк.
5. Покажи мне файл и спроси, что доработать.

6 правил живого CLAUDE.md

Шаблон — это старт. Дальше файл должен жить. Эти 6 правил превращают его из «создал и забыл» в рабочий документ, к которому агент обращается каждую сессию.

Правило 1. Держи файл под 200 строк

Это потолок от Anthropic. Длинный CLAUDE.md убивает себя двумя путями: жжёт токены в каждой сессии и заставляет модель игнорировать правила (важное теряется в шуме). Оптимум — 80–120 строк, помещается на пару экранов. Если разросся — выноси детали в отдельные файлы (про это правило 3 и раздел про .claude/rules/ ниже).

Правило 2. После каждой ошибки агента — дописывай строку

Это главное правило, на котором держится живой файл. Агент один раз сделал не то — ты добавляешь одну строку, и больше он так не делает. Примеры из моего реального файла, каждый появился после конкретной аварии: «git add поимённо, не git add .», «не выдумывать URL и токены — брать из кода». Каждая строка — след от граблей, на которые ты уже наступил.

Правило 3. Роуть агента к контексту, а не вписывай всё в файл

Самая сильная вещь для вайбкодера. Заведи папку с контекстом бизнеса (аудитория, продукт, цены, тон) и в CLAUDE.md просто укажи, куда смотреть: «при работе с текстами — сначала открой context/audience.md». Без этого Claude пишет «в общем стиле качественного сайта». С этим — под твоего клиента, твоим голосом. CLAUDE.md — это оглавление, а не вся книга.

Правило 4. Коммить файл в git и дописывай часто

Проектный CLAUDE.md живёт в репозитории, чтобы вся команда (и будущий ты) работали по одним правилам. Команда Boris Cherny, по его словам, дописывает общий CLAUDE.md несколько раз в неделю. Файл компаундится — со временем он становится ценнее любой документации.

Правило 5. Конкретика вместо «будь хорошим инженером»

«Пиши чистый код», «думай как senior» — это слова, которые ничего не меняют. Claude и так старается. Такие строки только жрут контекст. Замена: «функции не длиннее 30 строк», «не используй any в TypeScript», «отступы 2 пробела». Проверяемо — значит работает.

Правило 6. Критичную безопасность держи в settings.json, не в CLAUDE.md

Правило в CLAUDE.md — это пожелание, агент может его нарушить. Если нужно жёстко запретить действие — это файл .claude/settings.json и хуки. Туда идёт: запрет rm -rf, запрет читать .env целиком, блок git push --force. Граница простая: совет — в CLAUDE.md, блокировка — в settings.json.

Что делает команда /init и почему её мало?

Команда /init в Claude Code создаёт стартовый CLAUDE.md автоматически: сканирует проект, распознаёт стек по package.json и подобным файлам, прописывает команды сборки и тестов. Это нормальная отправная точка, но не финал.

Что /init делает хорошо: распознаёт инструменты, прописывает команды, подхватывает конвенции из конфигов (.eslintrc и т.п.), встраивает релевантное из существующего AGENTS.md.

Что /init не сделает: не узнает, кто твой клиент; не пропишет твой тон и стоп-слова; не поставит правила про ошибки (их ещё не было); не сделает таблицу «где что искать» под твою структуру. Поэтому сценарий такой: запусти /init → получишь техническую основу на 30–50 строк → накати поверх шаблон из этой статьи → дальше дописывай после каждой ошибки.

Размер: почему длинный CLAUDE.md убивает контекст?

Короткий ответ: чем больше CLAUDE.md, тем сильнее агент его игнорирует. Парадокс — написал 500 правил, чтобы Claude всё помнил, и Claude не помнит ничего.

Дело в том, как модели работают с инструкциями. Системный промпт Claude Code сам по себе занимает порядка 50 инструкций. Frontier-модели надёжно держат примерно 150–200 инструкций, дальше начинается деградация: правила в тексте есть, но агент перестаёт их выполнять (так называемый «context rot»). У моделей послабее качество падает ещё быстрее. Длинный CLAUDE.md эту проблему усиливает — правила, которые ты считал важными, молча перестают работать.

Anthropic в документации формулирует прямо:

Раздутые CLAUDE.md заставляют Claude игнорировать твои реальные инструкции.
— Anthropic, Claude Code best practices

Практическая шкала размеров:

• 80–120 строк — оптимум. Агент выполняет 90%+ правил.
• 150–200 строк — потолок Anthropic. Работает, но требует ревизии раз в пару недель.
• 200–400 строк — тревожная зона. Половина правил молча игнорируется.
• 400+ строк — функционально мёртвый файл. Агент его «видит», но «не слышит». Резать.

Тест на каждую строку от Anthropic: «Если убрать эту строку, начнёт ли Claude ошибаться?» Если нет — удаляй. CLAUDE.md не место для документации, истории решений и философии. Только правила, без которых агент облажается.

Что НЕ класть в CLAUDE.md

Половина успеха — это то, чего в файле нет. Вот таблица из практики Anthropic.

✅ Класть	❌ Не класть
Команды, которые Claude не угадает	То, что Claude поймёт, прочитав код
Стиль кода, отличный от дефолтного	Стандартные конвенции языка, которые он и так знает
Как запускать тесты, какой раннер	Подробную документацию API (лучше ссылка)
Правила репозитория (ветки, PR)	То, что часто меняется
Неочевидные архитектурные решения	Пофайловое описание кодовой базы
Особенности окружения (нужные env-переменные)	Очевидное вроде «пиши чистый код»

Отдельно: не заставляй LLM делать работу линтера. «Ставь точки с запятой», «убирай неиспользуемые импорты» — это работа ESLint, Prettier, Biome, RuboCop. Они быстрее, дешевле и детерминированы. Если за правило отвечает автоматический инструмент — ему не место в CLAUDE.md.

.claude/rules/: как дробить правила вместо раздувания

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

.claude/
├── CLAUDE.md           # основное, общее
└── rules/
    ├── testing.md      # правила тестов
    ├── api-design.md   # правила API
    └── security.md     # безопасность

Главная фишка — правила можно привязать к путям. Через YAML-заголовок paths правило грузится в контекст только тогда, когда Claude работает с подходящими файлами, а не висит в каждой сессии:

---
paths:
  - "src/api/**/*.ts"
---

# Правила для API
- Все эндпоинты валидируют вход
- Единый формат ошибок

То есть правила про API не занимают место, пока ты не трогаешь API. Это и есть способ иметь много правил, не убивая контекст. Для вайбкодера на одном проекте хватит и простого CLAUDE.md, но как только файл переваливает за 200 строк — выноси темы в .claude/rules/.

CLAUDE.md vs AGENTS.md vs MEMORY.md vs hooks: кто за что отвечает

Четыре похожих механизма, которые легко перепутать. Вот кто что делает.

Механизм	Кто пишет	Что это	Жёсткость
CLAUDE.md	Ты	Правила и контекст проекта	Совет (агент может нарушить)
AGENTS.md	Ты	Те же правила, но для других агентов (Codex, Cursor)	Совет
MEMORY.md	Claude сам	Авто-заметки про твои привычки	Контекст
settings.json / hooks	Ты	Жёсткие запреты и авто-действия	Блокировка (100%)

AGENTS.md — это универсальный стандарт для разных кодинг-агентов. Claude Code его нативно не читает. Если в репо уже есть AGENTS.md (для Cursor или Codex), не дублируй — импортируй его в CLAUDE.md одной строкой:

@AGENTS.md

## Claude Code
Дополнительные правила только для Claude.

Так оба инструмента читают один источник правды. MEMORY.md — это отдельная система: Claude сам ведёт заметки про тебя («предпочитает короткие ответы», «работает на macOS»). Ты её не пишешь руками, но можешь открыть командой /memory, проверить и поправить. Если в MEMORY.md появилось что-то, что должно стать правилом, — перенеси в CLAUDE.md.

Разбор живых CLAUDE.md: мой и из open-source

Шаблоны — это хорошо, но полезнее увидеть реальные файлы. Покажу свой и пару из крупных open-source проектов.

Мой проектный CLAUDE.md (обезличено)

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

# Кто я и проект
- Полный контекст — в `context/ME.md` (кто я, цели, проекты, стек)

# Ключевые пути
- Контент-проект: `/nakodil-site/`
- Сервер: `ssh root@`

# Правила
- Общайся на русском, конкретно и прямо, без воды
- Каждую задачу проверяй через финансовый фильтр: ведёт к цели по MRR → делаем
- Не добавляй лишнего — делай только то, что просят
- Не трогай файлы вне рабочей директории без спроса

# Дисциплина работы с кодом
- Перед редактированием файла — прочитай его
- Перед изменением функции — найди всех, кто её вызывает
- В промптах указывай точное место: `file.rb:42-87`, а не «посмотри там»

# Деплой статьи (порядок)
1. Написать HTML, проверить локально на localhost:3001
2. `kamal deploy`
3. Создать статью на сервере отдельно — локальная и серверная БД разные

Обрати внимание: тут нет ни строчки про «пиши чистый код». Только то, без чего агент реально ошибётся: мои пути, мой порядок деплоя (который он иначе делает неправильно), мой финансовый фильтр для приоритетов. Каждый блок отвечает на вопрос «без этого Claude сделал бы не так?».

Примеры из open-source

У крупных проектов файлы агента лежат открыто — можно подсмотреть структуру:

• cloudflare/workers-sdk — таблица «где что искать» и явная секция Anti-Patterns: чего агенту делать нельзя.
• getsentry/sentry — иерархия файлов: корневой + отдельные в src/ и tests/.
• josix/awesome-claude-md — коллекция из сотни реальных CLAUDE.md с фильтрами по языку и типу проекта.

Заметь общий паттерн: индустрия постепенно мигрирует с CLAUDE.md на AGENTS.md как универсальный стандарт. Если начинаешь с нуля и работаешь только в Claude Code — оставайся на CLAUDE.md. Если жонглируешь несколькими агентами — заводи AGENTS.md и импортируй его.

7 ошибок, из-за которых CLAUDE.md мёртвый

Эти ошибки я регулярно вижу в чужих файлах. Большинство — вариации одной проблемы: человек делает из CLAUDE.md «документ проекта» вместо рабочего инструмента агента.

Ошибка 1. «Будь хорошим инженером»

Общие пожелания вроде «пиши качественный код» ничего не меняют и жрут контекст. Заменяй на проверяемую конкретику.

Ошибка 2. Дубли того, что Claude и так знает

Объяснения, как работает git или npm, описания стандартных конвенций языка. Claude это знает с тренировки — дубль только режет контекст.

Ошибка 3. Длинные пошаговые инструкции

«Как развернуть проект» на 40 строк — это не для CLAUDE.md. Длинные процедуры выноси в скиллы (грузятся по запросу) или в docs/, а в CLAUDE.md оставь ссылку одной строкой.

Ошибка 4. Правила, которые проверяет линтер

«Ставь точки с запятой», «единые кавычки» — работа ESLint и Prettier, а не агента.

Ошибка 5. Секреты в файле

Токены, пароли, строки подключения к базе. CLAUDE.md коммитится в git — секреты оттуда утекают. Им место в .env и менеджере секретов.

Ошибка 6. Файл-помойка на 500+ строк

Чем длиннее, тем хуже работает. Если разнесло — дроби по .claude/rules/ или режь по тесту «убери строку».

Ошибка 7. Создал и забыл

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

Чек-лист аудита CLAUDE.md и 3 промпта

Пройдись по своему файлу:

• Имя файла — ровно CLAUDE.md заглавными?
• Размер под 200 строк (лучше под 120)?
• Каждая строка проходит тест «убери — Claude ошибётся»?
• Нет «будь хорошим инженером» и подобной воды?
• Нет правил, которые делает линтер?
• Нет секретов (токены, пароли)?
• Команды записаны точно — Claude выполнит их как есть?
• Есть роутинг к контексту («где что искать»)?
• Критичные запреты вынесены в settings.json?
• Файл закоммичен в git?

И три промпта, которые экономят время. Стресс-тест — прогнать перед большой задачей:

У меня есть CLAUDE.md. Найди 10 двусмысленностей, из-за которых
ты как агент можешь понять меня неправильно, и пробелы, где
решения придётся выдумывать. Критикуй жёстко. В конце дай
список конкретных правок.

Прунинг — когда файл разнесло:

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

Органический рост — вместо точечных исправлений. Когда агент сделал не то, говори не «исправь», а:

Добавь в CLAUDE.md правило, чтобы ты больше так не делал.

Это и есть весь секрет живого CLAUDE.md. Начни с шаблона на 80 строк, прогоняй стресс-тест, дописывай по строке после каждой ошибки — через месяц у тебя будет файл, который превращает Claude из умного стажёра в агента, который знает твой проект.

Источники

1. Anthropic — How Claude remembers your project (memory docs)
2. Anthropic — Claude Code best practices
3. Anthropic — Using CLAUDE.md files
4. Boris Cherny — How Boris uses Claude Code
5. HumanLayer — Writing a good CLAUDE.md
6. Builder.io — How to Write a Good CLAUDE.md File
7. DataCamp — Writing the Best CLAUDE.md
8. cloudflare/workers-sdk — AGENTS.md
9. josix/awesome-claude-md — коллекция реальных файлов

Читать дальше

• Как установить Claude Code: два способа для новичков
• Структура папки .claude: что куда класть
• 7 скиллов для Claude Code с первого дня
• Как эффективно использовать Claude Code
• Всё про Claude Code — каталог и гайды