CLAUDE.md: как написать память проекта для Claude Code — шаблон и примеры
Каждая новая сессия Claude Code начинается «с чистого листа»: агент не помнит, что вчера вы договорились запускать тесты через pytest -q, а новые эндпоинты класть в src/api. CLAUDE.md — это файл, который Claude Code автоматически читает в начале каждой сессии, чтобы эти договорённости не приходилось повторять. Хорошо написанный CLAUDE.md экономит время, токены и нервы; плохо написанный — незаметно ухудшает каждый ответ.
В статье — где лежит этот файл, что в него писать, как подключать дополнительные инструкции, и готовый шаблон, с которого можно начать. Всё сверено с документацией Anthropic по состоянию на ноябрь 2026 года.
Главное за 30 секунд
./CLAUDE.mdв корне проекта — память для всей команды, коммитится в Git./initсоздаёт заготовку,/memoryпоказывает и открывает все файлы памяти.- Пишите конкретно: команды, структура, правила. Держите файл короче 200 строк.
- Детали выносите в отдельные файлы: импорт
@docs/api.mdили правила в.claude/rules/. - CLAUDE.md — контекст, а не замок: запреты задавайте в настройках разрешений и хуках.
Где лежит CLAUDE.md и в каком порядке читается
Файлов памяти может быть несколько — от общих к конкретным:
| Уровень | Расположение | Для чего |
|---|---|---|
| Организация (managed) | Системная папка, например /etc/claude-code/CLAUDE.md в Linux | Политики компании, задаёт администратор |
| Пользователь | ~/.claude/CLAUDE.md | Ваши личные привычки для всех проектов |
| Проект | ./CLAUDE.md или ./.claude/CLAUDE.md | Общие правила команды, коммитятся в Git |
| Локальный | ./CLAUDE.local.md | Ваши личные заметки к этому проекту; добавьте в .gitignore |
При запуске Claude Code загружает файлы из рабочей папки и всех папок выше, объединяя их от корня к текущей папке. CLAUDE.md во вложенных папках (например, frontend/CLAUDE.md) подгружаются, когда агент начинает работать с файлами в них. Увидеть, что именно загружено, можно командой /memory: она показывает файлы памяти и открывает их в редакторе.
Самый быстрый старт — команда /init: Claude прочитает проект и предложит начальный CLAUDE.md. Сгенерированный файл почти всегда стоит сократить: агент склонен описывать очевидное.
Что писать, а что нет
Хорошее правило: в CLAUDE.md попадает то, что новый коллега должен знать в первый день и что нельзя быстро понять из кода.
| Стоит писать | Не стоит писать |
|---|---|
| Команды сборки, тестов, линтера — точно, как их запускать | Описание языка или фреймворка в целом («React — это библиотека…») |
Где что лежит: «API-обработчики — в src/api/handlers/» | Полный список файлов — агент и так видит дерево |
| Неочевидные договорённости: стиль, названия веток, формат коммитов | Общие пожелания: «пиши хороший код», «будь внимателен» |
| Ловушки проекта: «миграции не редактировать, только новые файлы» | Секреты, пароли, токены — файл коммитится в Git |
| Как проверить результат перед завершением задачи | То, что быстро устаревает: статусы задач, даты релизов |
Документация Anthropic приводит примеры конкретных инструкций: «Use 2-space indentation», «Run npm test before committing», «API handlers live in src/api/handlers/». Сравните с размытым «соблюдай стиль проекта»: первую инструкцию можно выполнить и проверить, вторую — нет.
Шаблон CLAUDE.md
Шаблон для небольшого веб-проекта. Замените команды и пути на свои, удалите разделы, которые вам не нужны.
# Проект: трекер задач (Node.js + React)
## Команды
- Установка: `npm ci`
- Dev-сервер: `npm run dev` (http://localhost:5173)
- Тесты: `npm test` — запускай после каждого изменения кода
- Линтер: `npm run lint` — должен проходить без ошибок перед коммитом
## Структура
- `src/api/` — REST-эндпоинты (Express), один файл на ресурс
- `src/web/` — React-приложение
- `db/migrations/` — миграции; существующие НЕ редактировать, только добавлять новые
## Договорённости
- TypeScript strict, отступ 2 пробела
- Названия веток: `feature/короткое-название`, `fix/короткое-название`
- Коммиты: на английском, в повелительном наклонении ("Add task filter")
- Тексты интерфейса — только через `src/web/i18n/`, не хардкодить
## Перед завершением задачи
1. `npm run lint && npm test` проходят
2. У новых эндпоинтов есть тест в `src/api/__tests__/`
3. Кратко опиши, что изменено и как это проверить
## Дополнительно
- Описание API: @docs/api.md
Обратите внимание на три вещи. Команды записаны точно, а не «запусти тесты». Ловушки названы прямо (миграции не редактировать). Большое описание API вынесено в отдельный файл через импорт — оно не раздувает основной CLAUDE.md.
Написание CLAUDE.md под реальный проект — тема отдельного раздела практического курса Claude Code: вы пишете память для собственного проекта, а система проверяет, конкретны ли и исполнимы ли инструкции.
Импорты, .claude/rules и CLAUDE.local.md
Импорты. Строка с @путь/к/файлу подключает другой файл: See @README for project overview. Путь считается относительно файла, в котором стоит импорт; глубина вложенных импортов — до четырёх уровней. Для файлов вне проекта Claude Code попросит подтверждение.
Правила в .claude/rules/. Отдельные markdown-файлы с инструкциями, которые можно привязать к части проекта через поле paths в заголовке. Тогда правило действует, только когда агент работает с соответствующими файлами:
---
paths:
- "src/api/**/*.ts"
---
# Правила для API
- Каждый эндпоинт валидирует входные данные через zod
- Ошибки возвращаются в формате { error: { code, message } }
Личные правила для всех проектов можно класть в ~/.claude/rules/.
CLAUDE.local.md. Ваши личные заметки к конкретному проекту — например, адрес вашей тестовой базы или любимый способ запуска. Файл добавляется после CLAUDE.md и не должен попадать в Git — добавьте его в .gitignore.
Автопамять и AGENTS.md
Кроме CLAUDE.md, в Claude Code есть автопамять: агент сам записывает полезные наблюдения о проекте в ~/.claude/projects/<проект>/memory/MEMORY.md. В начале сессии загружаются первые 200 строк (или 25 КБ) этого файла. Автопамять включена по умолчанию; выключить её можно в /memory или настройкой autoMemoryEnabled. Разница простая: CLAUDE.md пишете вы и он общий для команды, автопамять ведёт агент и она только ваша.
AGENTS.md — формат инструкций, который используют разные AI-агенты. Claude Code читает его, если в проекте нет CLAUDE.md или CLAUDE.local.md, а ещё его можно явно подключить: @AGENTS.md в вашем CLAUDE.md. Похожая идея лежит в основе Agent Skills — о них мы писали в статье об открытом стандарте навыков: навык загружается, только когда нужен, поэтому туда стоит выносить длинные инструкции для отдельных задач.
Научите Claude Code работать по вашим правилам
В курсе Claude Code для начинающих память проекта — отдельный раздел, а дальше — разрешения, Git, MCP, навыки, хуки, субагенты и финальный мультиагентный проект. Практика с автоматической проверкой. Курс входит в подписку Prog Academy вместе с курсами Claude Chat, Claude Cowork и Claude in Chrome.
Типичные ошибки
- Файл на 600 строк. Он съедает контекст в каждой сессии, а важные правила теряются среди второстепенных. Цель — до 200 строк; остальное — в импорты и правила.
- Размытые инструкции. «Пиши качественный код» ничего не меняет. «У каждой новой функции в
src/apiесть unit-тест» — меняет. - Противоречия. В корневом файле «отступ 4 пробела», во вложенном — «2 пробела». Агент выберет одно из двух, и не обязательно то, что вы ждёте.
- Вера в CLAUDE.md как в защиту. Строка «никогда не читай .env» — лишь просьба. Чтобы действительно запретить, используйте правила deny, sandbox и хуки — как это сделать, мы разобрали в статье о безопасной работе с Claude Code.
- «Написал и забыл». Если агент дважды сделал одну и ту же ошибку, это сигнал добавить правило. Если правило устарело — удалите его. Можно просто попросить Claude: «добавь это в CLAUDE.md».
Если вы ещё не пробовали Claude Code на собственном проекте, начните с нашей статьи о первом проекте с Claude Code, а затем добавьте к нему CLAUDE.md по шаблону выше.
Частые вопросы
Что такое CLAUDE.md?
Это markdown-файл с инструкциями для Claude Code, который автоматически загружается в начале каждой сессии. В нём хранят то, что иначе приходилось бы объяснять каждый раз: команды сборки и тестов, структуру проекта, договорённости по коду и правила работы. Документация Anthropic называет это контекстом, а не принудительной конфигурацией.
Где должен лежать CLAUDE.md?
Для проекта — в корне репозитория (./CLAUDE.md) или в ./.claude/CLAUDE.md. Личные инструкции для всех проектов — в ~/.claude/CLAUDE.md. Личные инструкции только для одного проекта — в ./CLAUDE.local.md, который стоит добавить в .gitignore.
Как создать CLAUDE.md автоматически?
Запустите Claude Code в папке проекта и выполните команду /init. Claude проанализирует проект и предложит начальный CLAUDE.md; если файл уже существует, он предложит улучшения. Сгенерированный файл стоит просмотреть и сократить вручную.
Какого размера должен быть CLAUDE.md?
Документация советует держать каждый CLAUDE.md короче 200 строк. Длинный файл занимает контекст в каждой сессии и хуже исполняется. Крупные темы лучше вынести в отдельные файлы и подключить через импорт @ или правила в .claude/rules.
Читает ли Claude Code файл AGENTS.md?
Да, если в проекте нет CLAUDE.md или CLAUDE.local.md (в версиях 2.1.277 и новее). Также AGENTS.md можно явно подключить из CLAUDE.md через импорт @AGENTS.md — удобно, если команда использует несколько AI-агентов.
Источники
CLAUDE.md — самый простой способ сделать Claude Code предсказуемым: десять минут на файл экономят часы объяснений. Следующие шаги — разрешения, навыки, хуки и субагенты. Их системно, с практикой на собственном проекте, разбираем в курсе Claude Code для начинающих. Курс входит в подписку: за 29 $ в месяц открываются все курсы по подписке, а первые 7 дней можно попробовать за 1 $.
Читайте также
- Как безопасно работать с Claude Code: режимы разрешений, auto mode, sandbox и хуки
- Claude Code: полное руководство в 2026 году — что это, как работает и как использовать
- Agent Skills стали открытым стандартом: как написать свой первый SKILL.md
- Вайб-кодинг с Claude Code: первый проект с нуля — пошаговая инструкция для начинающих
