claude-mem: чтобы не объяснять проект заново каждое утро

Каждый, кто работал с ИИ дольше недели, знает этот ритуал. Открываешь новую сессию — и снова: «у меня проект на Next.js, вот структура, вот что мы вчера сделали, вот почему нельзя трогать этот файл». Десять минут на пересказ того, что вы уже рассказывали вчера. И позавчера.

Это не лень модели. Сессия заканчивается — контекст исчезает. Инструмент буквально не помнит вас.

Что он делает

claude-mem встраивается в Claude Code и работает в фоне. Пока вы что-то делаете, он записывает наблюдения: какие файлы открывались, что было исправлено, к какому решению пришли. В конце сессии сжимает это в короткие сводки. В начале следующей — подкладывает те, что относятся к делу.

Со стороны это выглядит так, будто инструмент вас помнит. Вы садитесь утром, и он уже в курсе, чем вчера кончилось.

Как он устроен внутри

Это не одна программа, а несколько частей, и полезно понимать, что именно поселяется на компьютере.

1. 1

   Пять хуков жизненного цикла

   Точки, где плагин цепляется к Claude Code: старт сессии, отправка запроса, после вызова инструмента, остановка, конец сессии. Отсюда он и знает, что происходило.

2. 2

   Локальный сервис

   Небольшой HTTP-сервер на вашей машине с веб-интерфейсом для просмотра памяти и поиска по ней. Управляется рантаймом Bun.

3. 3

   База SQLite

   Обычный файл на диске: сессии, наблюдения, сводки. Никакого облака.

4. 4

   Векторная база Chroma

   Поиск по смыслу, а не по совпадению слов. Именно она позволяет найти «то место, где мы чинили авторизацию», не помня точных формулировок.

5. 5

   Навык поиска

   Отдельный skill, через который вы спрашиваете память обычными словами.

Отдельно стоит отметить, как сделан поиск — это редкий случай, когда экономия продумана заранее. Вместо того чтобы вываливать в контекст всё найденное, он работает в три слоя: сначала компактный список результатов (50–100 токенов на штуку), потом хронология вокруг интересного, и только потом полные детали по отобранным записям. Разработчики заявляют примерно десятикратную экономию токенов по сравнению с наивным «загрузить всё».

Как запустить за пять минут

Одна команда, и она же самая важная деталь всего разбора.

npx claude-mem install

После этого перезапустите Claude Code. Контекст из прошлых сессий начнёт появляться сам.

Если вы пользуетесь плагинами Claude Code, можно поставить оттуда:

/plugin marketplace add thedotmack/claude-mem
/plugin install claude-mem

Что окажется на компьютере: нужен Node.js версии 20 или новее. Bun и uv (менеджер пакетов Python, нужен для векторного поиска) плагин ставит сам, если их нет. SQLite идёт в комплекте. На Windows чаще всего спотыкаются не о плагин, а о то, что Node не прописан в PATH — тогда терминал просто не узнаёт команду npm.

Кому стоит, а кому нет

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

Честный итог

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

Что смущает: зависимостей многовато для инструмента, который «просто помнит». Bun, uv, векторная база — каждая из них ставится автоматически, но каждая может однажды сломаться, и чинить это придётся вам. Триста с лишним открытых issues говорят, что ломается не только у нас.

Лицензия Apache-2.0 — можно встраивать куда угодно, включая коммерческие продукты. README переведён на тридцать с лишним языков, русский среди них.