CLAUDE.md и память

Файлы памяти Claude Code: project, user, local и авто-память. Что куда писать, чтобы агент не забывал важное между сессиями.

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

Главный из них — CLAUDE.md. Это обычный Markdown-файл с инструкциями «как работать в этом проекте»: архитектура, команды сборки, соглашения, грабли, которые нельзя повторять.

Зачем

Без памяти вы каждый раз объясняете одно и то же: «у нас тесты в tests/, импорты через алиасы, не трогай legacy-папку». С CLAUDE.md это написано один раз — и агент учитывает это всегда.

Память — это не «чат-история». Это правила и факты, которые должны действовать постоянно. История разговора живёт отдельно и стирается между сессиями.

Уровни памяти

Память бывает разной по охвату — от «для всей команды» до «только для меня на этой машине»:

Файл	Где лежит	Для кого	В гите?
Project	`./CLAUDE.md` или `./.claude/CLAUDE.md`	вся команда	да
User	`~/.claude/CLAUDE.md`	ты, во всех проектах	нет
Local	`./CLAUDE.local.md`	ты, в этом проекте	нет (gitignore)

Логика простая: командные договорённости → project (коммитишь, все видят). Личные привычки на все проекты («отвечай по-русски») → user. Личное и только для этого репо → local.

Авто-память

Claude Code умеет вести собственные заметки — складывает выводы, паттерны и предпочтения в отдельные файлы и подтягивает их в следующих сессиях. Ты можешь их читать и править, но создаёт их сам агент. Полезно: накопленные «грабли» переживают перезапуск.

Посмотреть и отредактировать всю память разом — команда /memory.

Минимальный пример

# CLAUDE.md

## Архитектура
- Тесты в `tests/`, страницы в `src/pages/`.
- Импорты только через алиасы (`@components`, `@steps`).

## Правила
- Не трогать папку `legacy/`.
- Перед коммитом гонять `npm run typecheck`.

Точный формат, импорты через @file и приоритеты уровней — в официальной документации по памяти.

Сгенерировать CLAUDE.md автоматически — `/init`

Писать CLAUDE.md с нуля не обязательно. На уже существующем проекте запусти команду /init — агент пройдётся по кодовой базе (структура, стек, скрипты сборки, конвенции) и соберёт черновик CLAUDE.md сам.

/init

Дальше его обязательно причеши руками: убери лишнее и допиши то, чего в коде не видно — бизнес-договорённости, грабли, «не трогать legacy». /init экономит время на старте, но не заменяет твоё понимание проекта: относись к результату как к заготовке, а не финалу.

Не пихай в CLAUDE.md всё подряд — он жрёт контекст в каждой сессии. Держи коротким: только то, что реально влияет на работу. Длинные детали выноси в отдельные файлы и подключай по ссылке.

Проверь себя

1. Зачем нужен CLAUDE.md?
2. Командные договорённости, которые должны видеть все, кладут в…
3. Почему не стоит делать CLAUDE.md огромным?