CLAUDE.md — это файл, который Claude Code читает в начале каждой сессии. Разберём, что туда класть, готовый шаблон на копипаст и правила живого файла, который не превращается в свалку.
Каждая новая сессия Claude Code начинается с чистого листа: модель не помнит, что было вчера. И если ты в каждом чате заново диктуешь «тесты через vitest», «коммиты на русском», «миграции руками не трогай» — ты теряешь время и токены. CLAUDE.md решает это раз и навсегда. Это текстовый файл с правилами проекта, который Claude подхватывает автоматически и держит в голове всю работу.
Что узнаешь из гайда
/initЧасть 1 · Понятие
Главное
CLAUDE.md — это память проекта: файл с правилами, который Claude читает в начале каждой сессии и держит в контексте всё время работы. Один раз записал — больше не объясняешь.
Технически это обычный markdown-файл. Но роль у него особая: Claude Code загружает его содержимое в контекст автоматически, без всякой команды, как только ты открываешь проект. Всё, что в нём написано, модель воспринимает как постоянные инструкции — не «просьбу на один чат», а правила, которые действуют всегда.
Важно понимать, чем CLAUDE.md отличается от README.md. README — это документация для людей: как поднять проект, что за архитектура. CLAUDE.md — инструкции для агента: как тебе вести себя в этом репозитории. Они могут пересекаться, но цель разная. README объясняет проект, CLAUDE.md задаёт поведение.
README — для людей. CLAUDE.md — для агента. Не путай документацию с правилами поведения.
Ещё есть второй механизм памяти — auto memory. Это заметки, которые Claude ведёт сам: замечает твои поправки и предпочтения и складывает их в отдельную папку, чтобы подтянуть в следующей сессии. CLAUDE.md пишешь ты, auto memory — модель. Работают они вместе, но управляешь ты именно CLAUDE.md, поэтому с него и начинаем.
Часть 2 · Локации
Главное
Три места, от общего к частному: проектный (./CLAUDE.md, в гит, на всю команду), личный (~/.claude/CLAUDE.md, на все твои проекты) и локальный (CLAUDE.local.md, личные заметки по проекту, мимо гита).
Claude читает их по порядку — от широкого к узкому — и складывает в один общий набор правил. Чем ближе файл к конкретному проекту, тем специфичнее инструкции. Разберём по таблице.
| Файл | Где | Для чего |
|---|---|---|
~/.claude/CLAUDE.md | Домашняя папка | Личные привычки на все проекты: язык ответов, стиль, общие запреты |
./CLAUDE.md | Корень проекта | Правила проекта на всю команду — едет в гит |
CLAUDE.local.md | Корень проекта, в .gitignore | Твои личные заметки по проекту, которые команде не нужны |
На практике почти всё кладут в проектный ./CLAUDE.md в корне — это главный файл, его видит вся команда после git pull. Личный ~/.claude/CLAUDE.md заводят под сквозные привычки: «отвечай на русском», «не запускай деплой без спроса». А CLAUDE.local.md — для мелочей, которые касаются только тебя: личные пути, временные обходы.
Важно
В монорепо CLAUDE.md можно класть и во вложенные папки — Claude подтянет файл из той директории, в которой работает. Так у каждого пакета свои правила, а корневой держит общие. Не сваливай всё в один гигантский файл, если проект делится на части.
Часть 3 · Шаблон
Самый быстрый старт — команда /init в корне проекта. Claude пройдётся по репозиторию, подтянет команды из конфигов, опишет стек и структуру и соберёт черновой CLAUDE.md. Дальше его правят руками.
# Собрать стартовый CLAUDE.md по текущему проекту
/init
# Claude прочитает package.json, структуру, конфиги
# и сложит черновик. Останется почистить под себя.Если хочешь написать сам — вот рабочий каркас. Он короткий специально: CLAUDE.md ценен не объёмом, а тем, что в нём только важное и выполнимое.
# Проект: <название>
Кратко: что это за проект в одном-двух предложениях.
## Команды
- Запуск: npm run dev
- Тесты: npm run test
- Линт и типы: npm run lint && npm run typecheck
- Сборка: npm run build
## Стек
- Next.js (App Router), TypeScript, Tailwind
- БД: Postgres через Prisma
## Правила
- Отвечай на русском, комментарии в коде на русском.
- Перед коммитом гоняй lint и typecheck.
- Миграции БД не пиши руками — только через prisma migrate.
- Не запускай деплой без явной просьбы.
## Чего НЕ трогать
- Сгенерированные файлы в /generated
- Конфиг CI без согласования
## Стиль кода
- Маленькие чистые функции, ранний возврат.
- Никаких новых зависимостей без обсуждения.Заметь структуру: команды, стек, правила, запреты, стиль. Этого хватает на 90% проектов. Не надо описывать каждую папку — Claude и сам прочитает код. Файл нужен для того, что из кода не вычитать: договорённости, предпочтения, границы.
Большие куски правил можно вынести в отдельные файлы и подключить через @-импорт — Claude подставит их содержимое при загрузке:
# Дополнительные инструкции
- Гит-воркфлоу: @docs/git-instructions.md
- Конвенции API: @docs/api-conventions.md
# Так основной файл остаётся коротким,
# а детали живут в отдельных .md и подтягиваются автоматически.Часть 4 · Содержание
Главное
В CLAUDE.md идёт то, что из кода не вычитать и повторяется в каждой сессии: команды, договорённости, границы. Всё, что Claude найдёт сам в репозитории, дублировать не нужно.
Главная ошибка новичка — превратить CLAUDE.md в подробную документацию проекта на тысячу строк. Это вредит: файл загружается в контекст целиком и в каждой сессии, поэтому раздутый CLAUDE.md просто жжёт токены и размывает важное. Держи его плотным.
docs/, а не в память агента.Проверка на пользу
Перед тем как добавить строку, спроси: «это правило действует в каждой сессии или только сейчас?» и «Claude вычитает это из кода сам?». Если правило разовое или очевидно из репозитория — в CLAUDE.md ему не место.
Часть 5 · Жизнь файла
Главное
CLAUDE.md — живой документ, а не «написал и забыл». Самый быстрый способ дополнить — начать сообщение с #: Claude сам предложит, в какой файл памяти записать.
Лучшие CLAUDE.md растут из практики. Поймал себя на том, что в очередной раз объясняешь Claude одно и то же, — это сигнал занести правило в файл. Делать это руками необязательно: есть быстрый способ.
Начни ввод с символа # — и дальше напиши правило. Claude предложит, в какой файл памяти его сохранить (проектный, личный или локальный), и допишет туда. Это самый быстрый путь дополнить память прямо в потоке работы.
# всегда запускай тесты через vitest, не jest
# Claude уточнит, в какой CLAUDE.md записать,
# и сам добавит строку — без ручного редактирования файла.Команда /memory открывает все загруженные файлы памяти — CLAUDE.md, локальный, а заодно и auto memory, которую Claude ведёт сам. Через неё удобно ревизовать, что накопилось, и почистить лишнее. Раз в пару недель пройтись по файлу и выкинуть устаревшее — полезная привычка.
Когда CLAUDE.md не нужен
Для разовых задач и одноразовых уточнений — это обычный промт, не память проекта. Не превращай файл в дневник: правила «на один раз» только засоряют контекст. И не дублируй сюда то, что у тебя уже оформлено как скил — скил подключается под свою задачу, CLAUDE.md действует всегда.
Коротко
./CLAUDE.md (в гит), личный ~/.claude/CLAUDE.md, локальный CLAUDE.local.md./init; дополнять быстро — через #; ревизовать — через /memory.Вопросы
CLAUDE.md — это файл-память проекта: текстовый файл с инструкциями, который Claude Code читает в начале каждой сессии и держит в контексте всё время работы. В него кладут правила проекта: команды сборки и тестов, стиль кода, архитектурные договорённости, чего касаться нельзя. Каждая новая сессия начинается с чистого контекста, и CLAUDE.md — это способ не объяснять одно и то же заново.
Основной файл — CLAUDE.md в корне проекта: он едет в гит и работает на всю команду. Личные привычки на все проекты кладут в ~/.claude/CLAUDE.md. Личные заметки по одному проекту, которые не нужны команде, — в CLAUDE.local.md рядом с проектным (его добавляют в .gitignore). Claude читает их от общего к частному и складывает вместе.
Запусти команду /init в корне проекта — Claude Code пройдётся по репозиторию и сам соберёт стартовый CLAUDE.md: подтянет команды из package.json, опишет структуру и стек. Дальше файл правят руками под себя. Это быстрее, чем писать с нуля, и сразу даёт рабочий каркас, который останется только почистить.
CLAUDE.md ты пишешь сам — это правила и договорённости проекта. Auto memory Claude ведёт сам: записывает заметки на основе твоих поправок и предпочтений в отдельную папку и подгружает их в сессию. Оба механизма работают вместе, но управляешь ты только CLAUDE.md. Auto memory можно смотреть и чистить командой /memory.
Читать дальше
Хороший CLAUDE.md — половина дела. Вторая половина — скилы под повторяющиеся задачи. В маркетплейсе ИИ-офиса 1300+ готовых навыков для Claude Code: бери, разбирай, собирай свой набор.
Открыть маркетплейс скиловА разборы, эфиры и живое сообщество вайбкодеров — в Telegram ИИ-офиса.