# CLAUDE.md: что писать в память ИИ-агента, чтобы он работал как сотрудник

Что писать в CLAUDE.md, чтобы агент не начинал каждый раз с нуля: семь блоков файла, готовый скелет для копирования и три правила, без которых он вредит.

URL: https://posts.danashkin.ru/guides/chto-pisat-v-claude-md
Обновлено: 2026-08-20

---

## Коротко

**Главное**

- CLAUDE.md - это файл в корне проекта, который ИИ-агент читает перед каждой задачей. Правила, навигация, контекст. Без него ты объясняешь одно и то же в каждом новом чате.
- Внутрь идут семь блоков: что за проект, стек и команды, структура папок, правила работы, красные линии (что нельзя), куда смотреть за деталями, чему агент научился на своих ошибках.
- Три правила, без которых файл начинает вредить: до 200 строк, роутинг вместо содержания, никаких меняющихся цифр внутри.
- Главный приём: каждая ошибка агента превращается в одну строку правила. Через месяц файл становится сильнее любого промпта.
- Кому это: тем, кто уже пробовал Claude Code или другого агента и уперся в «он опять всё сделал не так».

## Почему агент каждый раз начинает с нуля

**Главное**

Агент не помнит вчерашний разговор: каждая новая сессия - чистый лист. Пока контекст живёт у тебя в голове, ты будешь пересказывать его вручную по десять раз в день.

Он не тупой. Он слепой.

Вот типичная картина. Ты второй месяц работаешь с ИИ-агентом, наладил ритм, и всё равно каждый новый чат начинается одинаково: «у меня проект на таком-то стеке, пакеты ставим вот так, не трогай эту папку, коммить только по моей команде». Пять минут пересказа. Потом задача. И так по десять раз в день.

На практике это значит одно: ты работаешь личной памятью для агента. Дорогая роль для человека, у которого есть дела поважнее.

Разберём простым языком, почему так происходит. У модели есть контекстное окно - то, что она держит перед глазами прямо сейчас. Между сессиями оно обнуляется. Агент не «забыл» твои правила, он их вообще никогда не видел в этой сессии. Всё, что ты рассказал вчера, для него не существует.

И вот тут самое интересное: лечится это не более умной моделью и не более длинным промптом. Лечится файлом.

## Что такое CLAUDE.md простыми словами

**Главное**

CLAUDE.md - текстовый файл в корне проекта, который агент читает автоматически перед работой. По сути - трудовой договор и карта офиса для нового сотрудника, только сотрудник у тебя цифровой.

CLAUDE.md - это обычный файл в формате Markdown, который лежит в корневой папке проекта. Claude Code подхватывает его сам, без напоминаний: агент открывает файл до того, как возьмётся за твою задачу. То же самое умеют и другие агенты - у каждого свой файл-память, механика одинаковая.

Я объясняю это ученикам так: представь, что к тебе вышел новый сотрудник. Очень способный, но про твою компанию не знает ничего. Ты можешь каждое утро объяснять ему, где кухня и по каким правилам мы живём. А можешь один раз выдать трудовой договор и карту офиса - и дальше он работает сам.

CLAUDE.md - это и есть договор с картой. Один раз написал - агент читает его в каждой сессии.

**Чем это отличается от автопамяти**

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

Это частный случай большой дисциплины - [контекст-инжиниринга](/concepts/context-engineering). Если коротко, суть такая: качество результата определяет не формулировка запроса, а то, что агент видит перед глазами. Подробно я разбирал это в статье про то, [почему дело не в промпте, а в папке](/guides/kontekst-inzhiniring). CLAUDE.md - первый файл этой папки и самый важный.

Осталось понять, что именно в него писать. Тут большинство и промахивается.

## Что писать внутрь: семь блоков

**Главное**

Рабочий CLAUDE.md состоит из семи блоков: проект, стек и команды, структура, правила работы, красные линии, навигация по деталям, выученные ошибки. Всё остальное - лишнее.

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

Вот семь блоков, которые реально влияют на результат.

**1. Что за проект и для кого.** Две-три строки: что мы строим, кто пользователь, какая задача решается. Без этого агент предлагает технически красивые решения, которые не нужны твоему бизнесу.

**2. Стек и команды.** Какой фреймворк, какая база, какой пакетный менеджер. И главное - как запускать. Пример из моего собственного проекта: движок статей, где вместо привычного мне менеджера пакетов нужен другой, родной для этого репозитория. Одна строка «здесь npm, не pnpm - иначе сломается сборка» экономит по часу на каждой ошибке.

**3. Структура папок.** Куда что кладём: планы сюда, черновики сюда, документы клиентов вот сюда. Агент без карты создаёт файлы там, где ему удобнее, и через месяц ты не находишь собственные материалы.

**4. Правила работы.** Как мы вообще ведём проект. Мои, например: большая задача - сначала план в отдельном файле; после каждой готовой фичи прогнать пять проверок; добавлять файлы в коммит поимённо, а не всё подряд.

**5. Красные линии.** Что агенту нельзя ни при каких условиях: не читать файлы с ключами и паролями, не удалять без подтверждения, не выкладывать в интернет без прямой команды. Это не паранойя, а гигиена: агент работает быстро и уверенно, в том числе когда ошибается.

**6. Навигация по деталям.** Не пересказывай в файле всю документацию - дай маршрут: «нужны цены - смотри такой-то файл», «нужен голос бренда - вот этот». Агент дойдёт сам.

**7. Выученные ошибки.** Самый ценный блок, про него отдельно ниже.

**Чего в файле быть не должно**

Ключей, паролей, токенов, номеров карт, персональных данных клиентов. CLAUDE.md - обычный текстовый файл, он уезжает в репозиторий вместе с кодом и попадает в контекст каждой сессии. Секреты живут в отдельном защищённом файле, который агенту читать запрещено.

## Готовый скелет, который можно скопировать

**Главное**

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

Не изобретай форму. Возьми этот скелет, замени содержимое на своё - и файл готов за полчаса.

```markdown
# Проект: <название>

## Что это
Что строим, для кого, какую задачу решает. 2-3 строки.

## Стек и команды
- Технологии: <фреймворк, база, хостинг>
- Пакетный менеджер: <какой именно и почему>
- Запуск: <команда>
- Сборка перед публикацией: <команда>

## Структура
- plans/ - планы больших задач
- docs/ - документация
- <папка> - <что внутри>

## Как мы работаем
- Большая задача (больше часа) - сначала план в plans/, потом код.
- После каждой фичи - самопроверка: ошибки, упущенное, безопасность.
- Файлы в коммит добавляем поимённо.

## Красные линии
- Не читать файлы с ключами и секретами.
- Ничего не удалять без моего подтверждения.
- Не публиковать наружу без прямой команды.

## Куда смотреть за деталями
- Цены и условия - <файл>
- Голос бренда и тон - <файл>
- Данные о клиентах - <файл>

## Выученные правила
- <ошибка, которая уже случалась> -> <как делать правильно>
```

Заметь, чего тут нет: длинных объяснений, философии, описания архитектуры на три экрана. Только то, что меняет поведение агента.

А теперь про три правила, которые отличают рабочий файл от мёртвого груза.

## Три правила, без которых файл начинает вредить

**Главное**

Раздутый CLAUDE.md хуже, чем его отсутствие: он ест контекст, размывает главное и устаревает. Держи до 200 строк, оставляй в нём маршруты вместо содержания, не храни меняющиеся цифры.

**Правило 1. До 200 строк.** Файл читается в каждой сессии и занимает место в контекстном окне. Раздул до полутора тысяч строк - агент начинает хуже думать, а лимиты тают быстрее. Мой личный потолок - 200 строк, и я его держу осознанно: как только упираюсь, выношу детали в отдельные файлы.

**Правило 2. Роутинг вместо содержания.** CLAUDE.md - оглавление, а не книга. Вместо трёх экранов про целевую аудиторию пишешь одну строку: «портрет аудитории - в файле audience.md». Агент откроет, когда понадобится. Так контекст остаётся чистым, а глубина не теряется.

**Правило 3. Никаких меняющихся цифр.** Цены, метрики, состав команды, дедлайны - всё это протухает, а агент будет уверенно повторять устаревшее полгода спустя. Держи такие данные в одном живом файле-источнике, а в CLAUDE.md ставь только ссылку на него.

Проверка на здоровье файла простая, и её же рекомендует официальная документация: пройди по строкам и спроси себя про каждую.

> Пиши коротко. По каждой строке спрашивай: «Если убрать это, Claude начнёт ошибаться?» Если нет - вырезай. Из-за раздутых файлов CLAUDE.md Claude игнорирует твои настоящие инструкции.
>
> Anthropic, [Claude Code: best practices](https://code.claude.com/docs/en/best-practices)

Признак, что файл перерос сам себя: ты уже прописал правило, а агент всё равно делает по-своему. Обычно это не упрямство модели, а потеря правила в шуме.

## Как наполнять файл: ошибки превращаются в правила

**Главное**

Не пиши идеальный файл сразу - его невозможно придумать заранее. Работай, лови промахи агента и после каждого дописывай одну строку. Через месяц файл станет твоим главным активом.

Вот здесь начинается настоящая работа с памятью агента, и её почти никто не делает.

Схема простая. Агент сделал не так, как ты хотел. Ты не просто поправил его в чате - ты сформулировал правило и дописал строку в CLAUDE.md. Всё. Одна ошибка - одна строка.

1. **Заметил промах**

   Агент сделал не то: не тот формат, не та папка, полез туда, куда не просили.

2. **Сформулировал правило**

   Одним предложением, в повелительном наклонении: «что делать» или «чего не делать».

3. **Дописал строку**

   В блок «Выученные правила». Коротко, без объяснений на абзац.

4. **Проверил в новой сессии**

   Открыл новый чат, дал похожую задачу. Правило сработало - оставляем.

У меня в проектах так накопились самые полезные строки. Например: «перед публикацией запускай полную сборку, а не только проверку типов - линтер ловит то, что проверка типов пропускает». Это не теория из документации. Это след от конкретного падения на боевом сервере.

На практике это значит вот что: файл, который ты ведёшь два месяца, стоит дороже любого золотого промпта из интернета. Промпт универсальный, а файл - про твой проект и твои грабли.

Отдельно про формат правила. Пиши так, чтобы его можно было проверить. «Будь аккуратнее с базой» - мусор. «Не запускай миграции на боевой базе без моего подтверждения» - правило.

Дальше сам собой возникает вопрос: если файл такой полезный, почему бы не завести один большой на все проекты?

## Один файл на проект или один на всё

**Главное**

Уровней два: личный файл с твоими сквозными привычками и проектный - с правилами конкретного проекта. Личный отвечает на вопрос «кто я», проектный - «что мы строим».

Claude Code читает память с нескольких уровней сразу: есть личный файл, который подключается во всех твоих проектах, и есть файл конкретного проекта. Работает это как слои: сначала общее, потом частное.

| Уровень | Что кладём | Пример |
|---|---|---|
| Личный (общий для всех проектов) | Кто ты, как с тобой общаться, сквозные предпочтения | «Отвечай по-русски, на ты. Оспаривай слабые решения» |
| Проектный (в корне проекта) | Стек, структура, правила и красные линии проекта | «Здесь npm, не pnpm. Не пушить без команды» |

Логика деления простая: если правило верно во всех твоих проектах - оно личное. Если только в этом - проектное. Не тащи специфику одного проекта в общий файл, иначе агент начнёт применять её там, где она вредит.

И ещё одно. CLAUDE.md - это не весь [второй мозг](/concepts/vtoroy-mozg) проекта, а его входная дверь. За ней - папки с контекстом: кто ты, что за бизнес, какие методологии используешь. Как это устроено целиком, я разбирал в гайде про [вайбкодинг для предпринимателя](/guides/vibecoding-dlya-predprinimatelya-12-principov), а сам инструмент - в статье про то, [что такое Claude Code](/guides/chto-takoe-claude-code-i-codex).

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

**Главное**

Коротко отвечаю на то, что спрашивают чаще всего: про размер, про то, читает ли агент файл на самом деле, и про другие инструменты.

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

**Как понять, что агент действительно читает мой CLAUDE.md?**

В Claude Code есть команда `/context` - она показывает, что именно загрузилось в начале сессии, включая файлы памяти. Если хочется проверить поведением, впиши в файл временное правило вроде «начинай ответ со слова 'Принято'», открой новый чат и дай любую задачу. Сработало - файл подхватывается, дальше проверку убираешь.

**Какой длины должен быть файл?**

Мой рабочий потолок - 200 строк. Меньше - хорошо, больше - повод выносить детали в отдельные файлы и оставлять в CLAUDE.md только ссылки. Длинный файл ест контекст в каждой сессии и размывает главное.

**Нужен ли такой файл, если я пользуюсь не Claude Code, а другим агентом?**

Да. Название файла у каждого инструмента своё, а принцип общий: агенту нужен постоянный контекст проекта, который он читает перед работой. Содержимое из этой статьи переносится почти без изменений.

**Можно ли попросить агента написать этот файл за меня?**

Можно, и это нормальная стартовая точка: агент осмотрит проект и соберёт черновик. Но красные линии, правила работы и выученные ошибки пиши сам - это твои решения, а не его догадки.

## Главный вывод

**Главное**

CLAUDE.md - самый дешёвый способ поднять качество работы агента. Полчаса на скелет, дальше по строке после каждой ошибки.

Если коротко, суть такая. Большинство людей, работающих с ИИ-агентами, каждый раз объясняют заново, кто они и что делают, - и упираются в потолок «модель тупая». Модель не тупая. Ей просто не дали контекст.

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

Ошибки, кстати, продолжатся - и это нормально. Разница в том, что теперь каждая из них делает твой проект сильнее, а не повторяется по кругу. Если хочется системнее посмотреть на проверку результатов работы агента - читай про [то, как ловить его галлюцинации](/guides/gallyucinacii-neyrosetey-kak-proveryat).

Как думаешь: файл-память агента - это временный костыль, пока модели не научились помнить всё сами, или постоянная часть работы, такая же обязательная, как регламент для команды?

### Источники

- [Как Claude запоминает ваш проект - официальная документация Claude Code](https://code.claude.com/docs/ru/memory)
- [Claude Code: best practices - раздел «Write an effective CLAUDE.md»](https://code.claude.com/docs/en/best-practices)
- [Manage Claude's memory - уровни файлов памяти](https://code.claude.com/docs/en/memory)