Auto Memory в Claude Code: 3 слоя памяти 2026

Полтора месяца я держал в одном проекте CLAUDE.md на 740 строк - и каждый раз, когда правил пятый раздел, выпрыгивал баг в третьем. Потом обновил Claude Code до v2.1.59, ввёл команду /memory и обнаружил, что половину этого файла агент уже собрал за меня сам. В отдельном MEMORY.md, на моей же машине, в локальной папке, о которой я даже не знал.

Это Auto Memory. Новая память Claude Code 2026 года. Она заполняется автоматически - агент сам записывает, какие команды сработали, на какие тесты падает проект, какие пути нельзя трогать. Не в облаке - локально. Не по запросу - в фоне. И почти у всех включена по умолчанию.

Дальше - 12 минут чтения: что это, где лежит, что в Auto Memory кладёт агент, что должен оставить в CLAUDE.md ты, и почему мой 740-строчный файл превратился в 180 строк - без потери качества.

В Claude Code теперь три слоя памяти. Два старых - и один свежий, про который никто не успел написать гайды.

Memory в Claude.ai. Облачная, привязана к аккаунту. Anthropic сделал её бесплатной 2 марта 2026 - на всех тарифах, включая Free. Работает в браузере и мобильном приложении. В Claude Code не подтягивается.

CLAUDE.md в Claude Code. Файл с правилами. Пишешь руками. Лежит в корне проекта или в ~/.claude/. Грузится в каждую сессию агента целиком.

Auto Memory в Claude Code. Появилась в версии v2.1.59+ и включена по умолчанию. Агент сам пишет заметки про твой проект в локальную папку:

Внутри - файл MEMORY.md плюс отдельные файлы под разные темы. Это не CLAUDE.md и не Memory из Claude.ai. Это третья сущность, которую большинство людей в 2026 ещё не открывало.

Самый быстрый способ проверить, что у тебя там. Запусти Claude Code в терминале проекта, набери:

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

Я в первый раз открыл /memory на проекте, который пилю четвёртый месяц, - и увидел заметку: «в этом проекте перед запуском тестов нужен pnpm install - один раз падало на отсутствующих типах». Я этого ему не говорил. Он сам зафиксировал из контекста.

По официальной документации Claude Code:

В переводе: CLAUDE.md - инструкции, которые пишешь ты. Auto Memory - заметки, которые Claude пишет сам себе на основе твоих исправлений и предпочтений.

На практике в моём MEMORY.md за 6 недель агент насобирал:

Последнее - после того, как я однажды громко на него выругался, что задеплоил без сборки. Он это запомнил. Не в CLAUDE.md, не в Memory - в Auto Memory.

Разница не косметическая - это два разных инструмента.

Кто пишет. CLAUDE.md - ты руками. Auto Memory - агент сам, без твоего участия.

Где живёт. CLAUDE.md в корне проекта, часть репозитория. Auto Memory - локально на твоей машине, не в репе.

Что грузится. CLAUDE.md - целиком, в каждый запрос. Auto Memory - только индекс, первые 200 строк или 25KB.

Где видно команде. CLAUDE.md уходит в git, видят все. Auto Memory - только у тебя.

Что писать. В CLAUDE.md - стабильные правила и бизнес-логика. В Auto Memory - технические грабли и рабочие команды.

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

CLAUDE.md = регламент компании на стене офиса. Auto Memory = блокнот сотрудника на его собственном столе.

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

Можно решить, что Auto Memory заменяет CLAUDE.md - агент же сам запомнит. Не заменяет. Auto Memory собирает то, что произошло в работе с агентом. Он не угадает, какой у тебя стиль коммитов, какие папки чувствительные, как называются твои бизнес-сегменты. Это надо положить руками - в CLAUDE.md.

Мой переход с 740 строк до 180 случился не потому, что Auto Memory взяла на себя всё. Она взяла на себя технику - команды, лимиты, типичные грабли. Я оставил в CLAUDE.md только то, что нельзя автоматически собрать: устройство папок, правила работы, бизнес-логика проекта, ограничения юристов.

Локально, в твоей домашней директории:

Имя проекта - кодированный путь к репозиторию, превращённый в kebab-case. Открываешь свой репо в Claude Code, агент сам подбирает папку.

Тут важная деталь, которая не очевидна. Сам файл MEMORY.md может быть любого размера - агент в него дописывает. Но в каждую сессию подгружаются только первые 200 строк или 25KB - что наступит раньше. Это защита от того, чтобы Claude не утоп в собственных заметках за полгода работы.

Что это значит на практике: если у тебя в MEMORY.md стало 600 строк, агент видит первые 200 и пропускает остальное. Часть заметок - тех, что снизу - в работу не идёт.

Самый простой способ - команда /memory в Claude Code. Открывается редактор, удаляешь неактуальное руками.

Если хочешь почистить с командной строки - открой файл напрямую:

(точный путь подставляется по имени папки твоего репо).

Если по каким-то причинам не хочешь, чтобы агент собирал автозаметки - есть три способа:

Я бы не выключал. Минусов нет - всё лежит на твоей машине, ничего не уходит в облако, в git, к Anthropic. Плюсы - агент перестаёт повторять одни и те же ошибки между сессиями.

Раньше в моём CLAUDE.md был раздел «Команды» на 30 строк - запуск dev-сервера, тесты, миграции базы, деплой. После пары недель работы Auto Memory собрала ровно это сама. Я удалил раздел из CLAUDE.md - агент стал брать команды из MEMORY.md, ничего не сломалось.

Это работает, потому что команды - это техника, и она у каждого своя. На моей машине pnpm 9.4, на твоей может быть npm. Auto Memory подхватит твою специфику автоматически. CLAUDE.md этого делать не должен - он коммитится в git и должен работать у всех в команде.

Когда я начинал проект, в CLAUDE.md был раздел «Известные грабли» - prisma не регенерится в Docker, redis иногда не цепляется при первом запуске, yandex.ru даёт 503 без user-agent. Часть устарела за месяц, часть Auto Memory сама дописала через мои реакции. К пятому месяцу проекта раздел в CLAUDE.md я удалил - оставил только пункт, который касается всех в команде («перед деплоем всегда pnpm build»). Остальное - в Auto Memory, специфично для моей машины.

В моём текущем проекте 130 папок. Раньше в CLAUDE.md висел раздел «Где смотреть» - 5 путей к API, бизнес-логике, шаблонам email, боту, cron. После того как агент пару раз сам поискал и нашёл, эти пути появились в Auto Memory. CLAUDE.md я сократил до маршрутов уровня: «бизнес-контекст - в business/, технические доки - в docs/». Конкретные пути к коду агент держит в Auto Memory.

Итог: что в Auto Memory кладёт агент, в CLAUDE.md класть бессмысленно. Это дублирование, которое забивает контекстное окно и снижает качество ответов.

Ни одна из них не выдаст ошибку. Агент просто начнёт хуже работать. Я наступал на все три - запишу, чтобы ты не повторял.

Соблазн появляется, когда диск засорился. Открываешь du -sh ~/.claude - видишь несколько мегабайт. Решаешь почистить. Удаляешь папку projects/.

Что произойдёт: агент при следующем запуске начнёт собирать Auto Memory заново. Месяцы наблюдений по всем проектам пропадут. Я потерял заметки про 7 проектов одной командой rm -rf.

Как избежать. Чисти точечно через /memory или прямую правку MEMORY.md в конкретном проекте. Папку projects/ целиком не трогай - это твой архив.

Однажды я попросил агента: «запомни, что в этом проекте мы никогда не используем длинное тире, только дефис». Он записал это в MEMORY.md.

Через неделю обновил CLAUDE.md, добавил это правило туда. Удалил из MEMORY.md.

В чём была проблема: Auto Memory локальна. Это правило должно работать у всех в команде, не только у меня. Если оно в моей MEMORY.md - оно сработает у меня, а коллега через неделю опять засадит длинные тире во весь репо.

Как избежать. Любое правило, которое касается команды или бизнеса - в CLAUDE.md. В Auto Memory - только то, что твоё личное.

Auto Memory дописывается в фоне - не моментально. Если ты сделал серию правок, агент что-то усвоил, и ты в этот момент жёстко прибил процесс (Ctrl+C, закрыл вкладку) - часть заметок может потеряться. Не критично - просто следующий раз он эти же выводы соберёт заново. Но 5-10 минут наблюдений уходит в пустоту.

Как избежать. Если делаешь большую сессию правок, заканчивай её через /exit или хотя бы Ctrl+D. Это даст агенту секунду на флаш заметок.

Это главное, что я понял за месяц с Auto Memory.

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

В 2026 этот совет устарел. И вот почему.

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

Anthropic в документации прямо рекомендует: 100-200 строк. После 200 - точность падает.

С Auto Memory можно убрать из CLAUDE.md всё, что агент соберёт сам:

Оставить в CLAUDE.md только то, что нельзя автоматизировать:

У меня после такого разделения файл схлопнулся с 740 до 180 строк. Качество ответов агента выросло: меньше шума, больше точности на бизнес-задачах.

После этого работай обычно. Через неделю снова открой /memory - увидишь, что Auto Memory наполнилась. Через месяц - что у тебя на руках полная связка: 150-200 строк правил в CLAUDE.md и живой архив наблюдений рядом.

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

Будущее работы с агентами - в том, что человек пишет смыслы, а агент пишет технику. Auto Memory - первый видимый шаг в эту сторону: впервые агент сам ведёт заметки о работе, и тебе не нужно их формулировать.

А ты уже открывал /memory на своём основном проекте? Что там написал агент, чего ты ему не говорил - напиши в комментариях.