Файловая система памяти Claude Code: Практичная альтернатива векторным базам данных

Claude Code использует файловый подход для памяти агента, который заменяет типичную настройку с векторной базой данных и эмбеддингами. Вместо полноценного RAG он хранит воспоминания как файлы .md с небольшими разделами frontmatter, содержащими информацию о названии, описании и типе, а также файл MEMORY.md, который служит индексом.

Как работает система

Во время выполнения система не создает эмбеддинги и не выполняет поиск по всему содержимому. Она следует этому процессу:

• Сканирует файлы памяти (ограничено примерно 200 файлами, сначала самые новые)
• Читает только первые ~30 строк (в основном метаданные)
• Создает облегченный манифест
• Использует небольшую модель для выбора ~5 наиболее релевантных воспоминаний
• Загружает в контекст только выбранные воспоминания (с ограничениями по размеру)

Ключевые преимущества

Дизайн предлагает несколько практических преимуществ:

• Экономичность: Ограниченное количество файлов, ограниченное количество токенов, предсказуемые затраты
• Быстрота: Отсутствие операций по созданию эмбеддингов или поиску сходства
• Контролируемость: Внедряет только несколько воспоминаний с жесткими ограничениями на всех этапах
• Читаемость для человека: Все хранится в виде файлов markdown
• Меньше мусора: Явно избегает хранения информации, которую уже можно получить из репозитория

Система рассматривает память как "возможно устаревшую", а не как абсолютную истину, что обеспечивает свежий подход к управлению памятью агента. Этот дизайн особенно прагматичен для агентов, занимающихся кодированием и отладкой, где большая часть "памяти" состоит из предпочтений, контекста или внешних ссылок, а не из обширных баз знаний.

Хотя этот подход не заменяет RAG для всех случаев использования, он представляет собой разумный компромисс для агентов разработки, где простота и предсказуемость важнее, чем всесторонний поиск знаний.