Что это такое
Memory tool позволяет Claude хранить и извлекать информацию между разговорами в директории файлов памяти: Claude может создавать, читать, обновлять и удалять файлы, которые сохраняются между сессиями, накапливая знания со временем без необходимости держать всё в окне контекста.
Инструмент работает на just-in-time подгрузке контекста: вместо того чтобы заранее загружать всю потенциально нужную информацию, агент записывает то, что узнал, в файлы памяти и читает их по запросу. Это держит активный контекст сфокусированным на текущей задаче - особенно важно для долгих сессий, которые иначе перегрузили бы окно контекста.
Как это работает
Memory tool работает на стороне клиента: Claude только запрашивает файловые операции, а выполняет их приложение разработчика. Вы сами решаете, где и как хранить данные - через собственную инфраструктуру, а не через сервер Anthropic. Путь /memories - это префикс, который обработчик приложения сопоставляет с реальным хранилищем: папкой на диске, ключами в базе данных или чем-то ещё.
При включённом memory tool Claude автоматически проверяет директорию памяти перед началом задачи, а по ходу работы записывает туда то, что узнал, и читает это обратно в следующих разговорах.
Шесть команд
view - показывает содержимое директории или файла, с опциональным диапазоном строк для больших файлов.
create - создаёт новый файл (или перезаписывает существующий).
str_replace - заменяет текст в файле; если новый текст не указан, старый просто удаляется.
insert - вставляет текст на конкретную строку.
delete - удаляет файл или директорию рекурсивно; саму папку /memories удалить нельзя.
rename - переименовывает или перемещает файл; саму папку /memories переименовать тоже нельзя.
Инструмент доступен на всех моделях Claude 4 и новее. Подключается одной записью в списке инструментов запроса - без отдельной схемы входных параметров, поскольку это готовый инструмент от Anthropic.
Защита от path traversal - забота разработчика
Все файловые операции выполняет приложение разработчика, поэтому и все меры защиты - тоже его ответственность. Вредоносный путь вроде /memories/../../secrets.env способен дотянуться до файлов за пределами папки памяти, если обработчик не проверяет каждый путь в каждой команде.
Базовые меры защиты: проверять, что все пути начинаются с /memories, приводить пути к канонической форме и убеждаться, что они остаются внутри папки памяти, отклонять последовательности вроде ../ и их URL-кодированные варианты, и использовать встроенные утилиты безопасности путей своего языка программирования.
Паттерн для проектов на несколько сессий
Для проектов, растянутых на несколько агентных сессий, файлы памяти стоит настраивать заранее, а не заполнять их случайным образом по ходу работы. Паттерн превращает память в механизм восстановления - каждая новая сессия продолжает с того состояния, которое записала предыдущая.
Стартовая сессия настраивает файлы памяти до начала содержательной работы: журнал прогресса (что сделано и что дальше), чек-лист функций (объём работы) и ссылку на установочный скрипт проекта, если он нужен.
Каждая следующая сессия начинается с чтения этих файлов памяти - это восстанавливает состояние проекта без повторного исследования кодовой базы и без пересмотра уже принятых решений.
Перед завершением сессии журнал прогресса обновляется тем, что сделано и что осталось - это гарантирует, что следующая сессия начнёт с точного состояния.
Ключевой принцип - работать над одной функцией за раз и отмечать её завершённой только после сквозной проверки, что она действительно работает, а не в момент, когда код просто написан.
Память в паре со сжатием контекста
Memory tool хорошо сочетается со сжатием контекста для управления долгими разговорами. Context editing очищает конкретные результаты вызовов инструментов на стороне клиента. Compaction автоматически сжимает весь разговор на сервере при приближении к лимиту окна контекста. Для по-настоящему долгих агентов имеет смысл сочетать оба механизма: compaction держит активный контекст компактным без ручной работы на стороне клиента, а memory сохраняет ту информацию, которая должна пережить сжатие.
Чек-лист
- Инструмент memory добавлен в список tools запроса
- Реализован обработчик всех шести команд на стороне приложения
- Добавлена проверка, что каждый путь остаётся внутри /memories
- Для многосессионных проектов настроен журнал прогресса и чек-лист функций с самого начала
- Продумано ограничение на размер файлов памяти и периодическая очистка неактуальных