Prog Academy
RU UA
Black Friday — скидки до 50% + 50 IT-курсов в подарокСмотреть предложения →
Лист с заметками проекта, от которого к терминалу тянутся линии контекста
AI

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 — о них мы писали в статье об открытом стандарте навыков: навык загружается, только когда нужен, поэтому туда стоит выносить длинные инструкции для отдельных задач.

CC

Научите 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 →

Фото автора: Всеволод Евгиенко

Об авторе

CEO и основатель Prog Academy

Разработчик программного обеспечения, специалист по информационной безопасности и преподаватель Java. Руководит Prog Academy и пишет о программировании, данных и AI-инструментах.

Читайте также

Контакт

Записаться на консультацию

Укажите актуальный номер, мы позвоним в любую страну :)