CLAUDE.md: как научить Claude запоминать ваш проект
Один файл с правилами — и Claude помнит архитектуру, соглашения и привычки вашего кодбейса в каждой сессии. Готовые шаблоны для разработки и контента.
Адаптация официальной документации Anthropic по памяти в Claude Code. источник ↗, проверено 12.07.2026
Коротко: суть CLAUDE.md
- Память между сессиями: Claude помнит архитектуру, команды и правила вашего проекта без повторных объяснений.
- Три основных уровня хранения: проектный (./CLAUDE.md), личный (~/.claude/CLAUDE.md) и локальный (./CLAUDE.local.md).
- Экономия времени: не нужно повторять контекст — Claude сразу знает, как запустить тесты, стиль кода и структуру папок.
- Для всех проектов: особенно полезно в командной разработке и долгосрочных проектах.
Суть: файл правил, который Claude читает в каждой сессии
Claude Code начинает каждую сессию с пустым контекстом. CLAUDE.md — это файл, который Claude читает в начале каждой сессии и учитывает как рабочие инструкции. Архитектуру, команды для запуска тестов, соглашения по коду, даты релизов — всё это Claude заново читает при каждом запуске.
Нет CLAUDE.md — приходится объяснять одно и то же: «где хранится конфиг?», «как запустить тесты?», «какой стиль у переменных?». Есть CLAUDE.md — Claude уже знает эти ответы и работает быстрее.
Где хранить CLAUDE.md
Проектный уровень
./CLAUDE.md
Инструкции, которые знает вся команда. Версионируется, коммитится в git, обновляется вместе с кодом. Сюда пишем команды для тестов, правила стиля, описание архитектуры.
Личный уровень
~/.claude/CLAUDE.md
Ваши личные привычки и предпочтения для всех проектов. Какая ваша любимая IDE, какие инструменты вы всегда используете, стиль оформления — это остаётся локально.
Локальный уровень
./CLAUDE.local.md
Добавьте в .gitignore. Тестовые данные, твоя локальная БД, sandbox-ссылки — то, что не должно видеть команда.
Что писать в CLAUDE.md
Команды и инструменты
Что писать:# Запуск тестов
npm test
Зачем: Claude научится запускать тесты без вопросов, вместо того чтобы гадать: npm или yarn?
Архитектура и структура
Что писать:- src/components/ — React компоненты
- src/api/ — обработчики запросов
- tests/ — Jest тесты
Зачем: Claude быстрее ориентируется в папках и находит нужное место для новых файлов.
Правила и соглашения
Что писать:- Всегда используй named exports, не default
- Переменные в camelCase
- Если меняешь схему БД — добавь миграцию
Зачем: нет бесконечных «стоп, а у нас тут convention X», Claude уже знает.
Для контент-проектов
CLAUDE.md работает не только для кода. Если вы ведёте блог, канал, социалку или пишете тексты, создайте CLAUDE.md для своего контента:
Три ключевых идеи
Иерархия файлов
Проектный CLAUDE.md — для команды. Личный ~/.claude/CLAUDE.md — для вас. Локальный CLAUDE.local.md (в .gitignore) — для вашего ноутбука. Три основных уровня, каждый со своей целью.
Краткость спасает
Держите CLAUDE.md коротким: файл целиком загружается в контекст каждой сессии, и лишние строки съедают полезное место. Если разрастается — выносите подробное в `.claude/rules/` или отдельные файлы.
Конкретика работает
«Используй правильный стиль» работает хуже, чем «используй 2-space indentation». Claude лучше следует точным инструкциям, чем общим рекомендациям.
Auto memory помогает
Если включить auto memory, Claude будет писать заметки сам. Заметки о том, как вы поправили его, какие ошибки случаются, какие лайфхаки сработали. Это дополнение к CLAUDE.md.
Одна сессия — одна сессия
CLAUDE.md загружается в начале каждой сессии. Если вы меняли его во время работы — изменения видны в следующей сессии. Это нормально, не переживайте.
Живое исправление
Если Claude нарушил правило — не ругайтесь. Скажите «добавь это в CLAUDE.md» и Claude учтёт это в следующих сессиях: один раз ввёл — и правило подхватывается при каждом запуске.
Откуда это
- Официальная документация Anthropic: «How Claude remembers your project» — всё о CLAUDE.md, auto memory и механизме загрузки.
- Гайд по лучшим практикам: Best practices — когда добавлять в CLAUDE.md, а когда в skills или hooks.
- Проверено на опыте Humster Club: этот гайд основан на том, как команда использует CLAUDE.md в своих проектах (12 июля 2026).
Начни с CLAUDE.md прямо сейчас
Создай файл ./CLAUDE.md, добавь две строки команд для тестов, закоммить. В следующей сессии Claude снова загрузит твой стек в контекст — без повторных объяснений.
Вступить в Telegram ↗CLAUDE.md: где хранить, что писать и как он сохраняет контекст проекта
Где хранить CLAUDE.md файл?
CLAUDE.md хранится в трёх уровнях иерархии: на проектном уровне (корень проекта), личном уровне (~/.claude/CLAUDE.md) и локальном уровне (settings.json). Claude читает файл в начале каждой сессии автоматически, без расхода контекста. Рекомендуется выбрать один основной уровень, чтобы избежать конфликтов правил между файлами разных уровней.
Что писать в CLAUDE.md?
В CLAUDE.md пишут 4 основных типа контента: команды и инструменты (alias, hook), архитектуру и структуру (папки, модули, паттерны), правила и соглашения (стиль кода, наименование). Для контент-проектов добавляют словарь терминов, платформенные лимиты и инфостиль. Каждый раздел должен быть конкретным и исполнимым — инструкция с примерами, а не философия.
Как CLAUDE.md помогает Claude помнить проект между сессиями?
CLAUDE.md (500–3000 слов инструкций) читается в начале каждой сессии без расхода токенов контекста. Файл содержит то, что не меняется между сессиями: архитектуру, соглашения, команды, внутренний язык проекта. Благодаря этому Claude сразу включается в работу и не просит уточнения архитектуры заново, что экономит время на каждой сессии.
Частые вопросы
Что такое CLAUDE.md и зачем он нужен?
CLAUDE.md — это файл с правилами и инструкциями для Claude Code, который инструмент читает в начале каждой сессии. Благодаря этому файлу Claude запоминает архитектуру вашего проекта, соглашения по коду, команды для запуска тестов и другие привычки — и не нужно объяснять всё заново в каждой сессии.
Где хранить CLAUDE.md — в корне проекта или в папке .claude?
CLAUDE.md может находиться на трёх основных уровнях: в корне проекта (./CLAUDE.md или ./.claude/CLAUDE.md) для инструкций всей команды, в ~/.claude/CLAUDE.md для личных привычек или в ./CLAUDE.local.md для локальных тестовых данных (добавьте в .gitignore).
Что писать в CLAUDE.md — все ли команды и правила?
Пишите самое важное: как запустить тесты, основные команды, архитектуру папок, соглашения по коду, где хранятся конфиги, как работает CI/CD и какие правила действуют в проекте. Не нужно писать очень большие куски кода — лучше ссылки на файлы.
Работает ли CLAUDE.md с другими инструментами ИИ кроме Claude Code?
CLAUDE.md — это стандарт для Claude Code. Другие инструменты ИИ могут использовать похожие подходы, но CLAUDE.md специально разработана для того, чтобы Claude в начале сессии читал этот файл и вспоминал контекст проекта.
Нужна ли CLAUDE.md в каждом проекте?
Для небольших личных проектов — нет, не обязательно. Для командной разработки или долгосрочного проекта, где вы часто работаете с Claude Code — очень рекомендуется. Он экономит время на объяснения и снижает число ошибок.
Что будет, если я неправильно напишу правила в CLAUDE.md?
Claude прочитает ваши инструкции и постарается им следовать. Если инструкции противоречивы или неясны, Claude может попросить уточнение или будет действовать по своему усмотрению. Всегда можно отредактировать CLAUDE.md и запустить сессию заново.