Долгосрочная память агента Claude Code в 2026

Долгосрочная память агента Claude code делается не волшебной кнопкой, а понятной системой: правила проекта лежат в CLAUDE.md, принятые решения в журнале, а большие материалы агент находит через поиск. Так новый запуск не начинает работу с амнезии и не заставляет тебя в пятый раз объяснять, почему кнопку нельзя перекрашивать в кислотный лайм.

Я, Арина Михална, обычно начинаю именно с файлов. Без базы, без модного слова RAG, без попытки построить космический корабль для списка из десяти правил. Если агент каждый день делает одну и ту же работу, ему нужна не «безграничная память», а нормальная тетрадка, где не размазано всё подряд.

Долгосрочная память агента Claude Code: что она решает

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

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

Это особенно заметно в трёх ситуациях:

Ситуация	Что забывает агент без памяти	Что положить в память
Сайт или приложение развивается месяцами	стек, команды запуска, запреты на правки	CLAUDE.md в корне репозитория
Несколько людей работают с агентом	договорённости и причины решений	журнал docs/decisions.md
Документов много	где искать нужный регламент или описание	индексируемая папка знаний или база поиска
Агент делает повторяющуюся операцию	порядок шагов и критерий готовности	отдельный skill с инструкцией

CLAUDE.md не заменяет скилл. Он отвечает за правила конкретного проекта: стек, команды, границы доступа, стиль работы. Скилл описывает повторяемую профессию или процесс. Если ещё путаются эти две штуки, вот мой разбор: что такое скиллы Claude и где они живут.

Три слоя, чтобы агент не превратил память в свалку

Первый слой, постоянный. Это короткий CLAUDE.md: как устроен проект, как запускать тесты, что нельзя удалять, какие соглашения соблюдать. Он должен быть скучным, конкретным и небольшим. «Пиши качественный код» агенту ни о чём не говорит. «Перед изменением схемы БД создай миграцию и запусти npm test» уже говорит.

Второй слой, решения. Создай docs/decisions.md или отдельные заметки по датам. Туда попадает не история каждого чиха, а выбор, который иначе придётся расследовать снова: почему выбрали эту библиотеку, почему не трогаем старый API, какой формат данных согласован с клиентом.

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

Вот минимальная запись для журнала. Её можно завести сегодня, без подключения внешних сервисов:

Дата: {{2026-09-02}}
Решение: {{что выбрали}}
Причина: {{какую проблему это снимает}}
Где затронуто: {{папки, сервисы или документы}}
Нельзя ломать: {{ограничение}}
Как проверить: {{команда или критерий готовности}}

Встроенные файлы, Mem0, Semantica и AgentMemory: что выбирать

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

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

Вариант	Как ищет информацию	Скорость старта	Задержка ответа	Объём и цена	Когда брать
CLAUDE.md и папка Markdown	агент читает указанные файлы	сразу	зависит от объёма контекста	ограничение практическое: контекст и порядок в файлах; отдельной цены нет	один проект, понятные правила
Mem0	отдельный слой памяти с поиском по сохранённым данным	нужна настройка и схема данных	зависит от развёртывания и поиска	лимиты и цена зависят от выбранного плана или своей инфраструктуры	много повторяющихся пользовательских фактов
Semantica	внешний слой семантического поиска	нужна интеграция	зависит от индекса и запроса	проверяй текущие лимиты у поставщика перед внедрением	большой архив, где нужен смысловой поиск
AgentMemory	отдельное хранилище памяти агента	нужна интеграция и контроль доступа	зависит от хранилища и retrieval-цепочки	зависит от выбранной реализации	несколько агентов с общей базой знаний

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

Исследователи Hugging Face в материале про Funes как раз поднимают проблему долговременной памяти агентов: хранить информацию мало, надо ещё уметь доставать нужное в нужный момент. Это и есть место, где красивый демо-ролик обычно заканчивается, а настоящая работа начинается.

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

Как подключить приватные документы и не слить лишнее

Допустим, у тебя есть база регламентов, брифов и внутренних инструкций. Не надо выдавать Claude Code ключи от всего диска с формулировкой «разберись». Агент буквально попробует разобраться, а потом ты будешь разбираться, почему он прочитал не тот файл.

Нормальная схема выглядит так:

1. Отдели документы, которые агенту действительно нужны для задачи.
2. Удали из них пароли, токены, персональные данные клиентов и договоры, которые нельзя отправлять во внешний сервис.
3. Назначь владельца памяти: кто решает, что запись ещё актуальна.
4. Дай агенту доступ только на чтение, пока нет причины разрешать запись.
5. Добавь проверку актуальности: дата, источник и статус каждой важной заметки.

В официальной документации Anthropic о памяти Claude Code есть базовая логика работы с инструкциями в файлах. От неё и отталкивайся. А подключение собственной БД оставь следующим шагом, когда простой порядок уже перестал справляться.

Где память не спасёт, сорян

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

Она также не решит:

• задачу, где нет критерия готовности;
• конфликт между старыми правилами и новым решением;
• доступ к закрытым данным, который ты не настроила;
• ошибку в документации, которую никто не обновляет;
• рискованное действие без подтверждения человека.

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

Дорожная карта: от файла к общей памяти агентов

Не надо строить сложную систему в первый вечер. Сделай её по ступенькам:

1. Добавь CLAUDE.md с командами, стеком и запретами.
2. Заведи журнал решений, который обновляется после важных изменений.
3. Вынеси повторяющийся процесс в skill. Например, сбор брифа, проверку текста или подготовку релиза.
4. Когда архив перестал быть обозримым, подключи поиск по отобранной папке знаний.
5. Только потом объединяй память нескольких агентов и настраивай синхронизацию с приватной БД.

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

По материалам: Hugging Face о Funes и долговременной памяти агентов, документации Anthropic по памяти Claude Code и документации Mem0.

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

• Claude MCP в 2026: что это и зачем нужен Claude Code
• Субагенты в Claude Code: AI-агенты 2026
• Как проверять код после AI-агента: чек-лист 2026
• На портале «Мастерская нейросетей»: Как создать AI-агентов для SMM и SEO в Claude Code