Как составить CLAUDE.md: карта проекта для агента

Герман Коваленко · основатель ENGRAM · Обновлено 21 июля 2026 · Об авторе →

Коротко: CLAUDE.md - это файл в корне проекта, который агент автоматически читает в начале каждой сессии: что за проект, структура папок, правила и где что искать. Без него каждый новый чат начинается с чистого листа. Держите файл коротким, примерно до двухсот строк, и пишите под свой метод, а не автогенератором.

Каждая сессия Claude Code стартует с пустой памятью. Официальная документация называет два механизма, которые переносят знания между сессиями: файлы CLAUDE.md, которые пишете вы, и автопамять, которую агент копит сам по вашим поправкам. CLAUDE.md - главный из них: это ваш контракт с агентом.

Что кладут в CLAUDE.md

Шесть блоков, которых достаточно:

1. Что за проект - одно предложение и ссылка на подробности в business/.
2. Порядок чтения - какие файлы открыть в начале сессии.
3. Структура - дерево папок с пояснением в строку.
4. Где что искать - таблица «вопрос - файл».
5. Правила - что можно и что нельзя.
6. Язык - на каком языке отвечать.

Почему не больше двухсот строк

Файл читается при каждом старте сессии, целиком. Всё, что длиннее, сжигает контекст и замедляет агента на каждом запуске. CLAUDE.md - это карта, а не энциклопедия: подробности живут в папках business/ и plans/, а карта только показывает дорогу к ним.

Готовый шаблон

Команда /init создаст файл автоматически, но получится дежурный, «как у всех». Скопируйте шаблон и попросите агента заполнить скобки под ваш проект:

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

Читай этот файл в начале каждой сессии.

## Что это
[Одно предложение: что за проект и для кого.]
Подробности - в business/INDEX.md.

## Порядок чтения
1. business/INDEX.md - что мы делаем: продукт, аудитория, цели.
2. Этот файл - правила и структура.
3. Файл текущей задачи из plans/, если работаем над фичей.

## Где что искать
| Вопрос | Файл |
|---|---|
| Продукт, тарифы, цены | business/products/ |
| Аудитория и её боли | business/audience/ |
| Цели и метрики | business/goals/ |
| Текущая фича | plans/ - файл со статусом «в работе» |

## Стек
[Технологии. Не знаете - напишите: «выбери сам и зафиксируй здесь».]

## Правила
1. Большая фича - сначала план в plans/, потом код.
2. Не хардкодить цены, даты и цифры - им место в business/.
3. Не деплоить и не публиковать без моей явной команды.
4. Секреты только в .env. Файл .env не читать и не выводить.
5. После каждой фичи - проверка ошибок и security review.
6. Чего не хватает - спрашивай у меня, не выдумывай.

## Язык
Отвечай на русском. Без длинного тире.

Как файл живёт дальше

CLAUDE.md - живой документ. Поймали агента на повторяющейся ошибке - добавьте правило. Сказали «больше никогда не делай X» - попросите: «запиши это правилом в CLAUDE.md». Через месяц у проекта появляется собственная конституция, и агент не может сделать иначе: он перечитывает её каждую сессию.

Частые вопросы

Где должен лежать CLAUDE.md?

В корне папки проекта - оттуда агент читает его автоматически. Есть и общий уровень: файл в домашней папке пользователя действует на все проекты сразу, туда кладут личные правила вроде языка ответов.

У меня несколько проектов. Нужен файл в каждом?

Да, у каждого проекта своя карта: продукт, структура и правила у всех разные. Общие личные правила выносите на пользовательский уровень, чтобы не дублировать.

Чем CLAUDE.md отличается от автопамяти?

CLAUDE.md пишете вы - это ваш контракт с агентом. Автопамять агент копит сам: замечает ваши поправки и записывает выводы. Работают вместе, но контракт первичен: спорные вещи фиксируйте в файле.

Как часто обновлять файл?

По событию, а не по расписанию: новое правило, смена структуры, новый раздел проекта. Удобно просить самого агента: «обнови CLAUDE.md с учётом того, что мы сегодня решили».

Что дальше

• Урок курса «CLAUDE.md: договор с агентом» - разбор шаблона по блокам.
• Следующий слой контекста - папка business в уроке про второй мозг.
• Правила безопасности для файла - в гайде security review.