Инструмент, который автоматически записывает, что делал агент в сессии, сжимает это в наблюдения и подмешивает нужное в следующую сессию. Разбираем установку под разные агенты, провайдеры памяти и настройку контекста.
Каждый новый чат с coding-агентом начинается с нуля: он не помнит, почему вы отказались от одного решения, какой баг чинили вчера и какие команды запускали. claude-mem решает это как отдельный слой памяти — перехватывает события сессии через хуки, сжимает их в короткие «наблюдения» и отдаёт релевантные фрагменты следующему запуску агента. Ниже — установка под разные агенты, разбор провайдеров памяти, MCP-инструменты поиска и настройка.
claude-mem — последняя версия 13.39.0claude-mem — плагин долговременной памяти для coding-агентов. Он работает не как «чат с историей», а как конвейер сжатия: во время сессии перехватываются события (запуски инструментов, правки файлов, решённые задачи, вывод команд), затем модель превращает их в компактные наблюдения и семантические саммари, а к началу следующей сессии в контекст подмешивается только релевантное.
Память хранится локально: SQLite с полнотекстовым поиском FTS5 плюс векторный слой на Chroma. Наружу ничего уходить не обязано — плагин работает и без облака, но провайдера сжатия всё равно нужно выбрать: память от разработчиков, свой ключ или ваш действующий план Anthropic. Отдельно есть теги <private>: то, что вы в них завернули, в хранилище не попадает.
Важная деталь про контекст: по умолчанию в начало сессии подмешиваются наблюдения только текущего харнесса. Если вы чередуете агентов — например Claude Code и Codex — и хотите общий контекст, этот режим включается отдельным ключом в настройках.
Механика укладывается в пять шагов. Хуки жизненного цикла вызывают один и тот же раннер claude-mem hook claude-code <событие>, локальный worker-сервис под управлением Bun собирает наблюдения и отдаёт их по HTTP, а поиск работает через MCP: агент сначала получает компактный индекс, потом таймлайн и только затем полные детали.
Базовая установка не требует ни клонирования, ни сборки: npx claude-mem install сам ставит зависимости, регистрирует хуки и добавляет раннер в PATH. Для разных харнессов есть флаг --ide — плагин знает про Claude Code, OpenCode, T3 Code, Antigravity CLI, DeepSeek Harness, OMP, Pi, Grok Bot и OpenClaw.
node -v
npx claude-mem install
npx claude-mem install --ide opencode
npx claude-mem doctor
| Аргумент | Хост | Нюанс установки |
|---|---|---|
| без флага | Claude Code | Рекомендуемый путь: plugin-маркетплейс, хуки, worker-сервис |
| --ide opencode | OpenCode | Работает с OpenCode 1.3.4 и новее, включая OpenCode 2; перезапуск обязателен |
| --ide t3code | T3 Code | Установщик находит включённые провайдеры и ставит нативные плагины |
| --ide antigravity | Antigravity CLI | Отдельный setup-гайд в документации проекта |
| --ide dsh | DeepSeek Harness | Плагин харнесса, профиль задаётся флагом --dsh-profile |
| --ide pi / --ide omp | Pi, Oh My Pi | Нативные расширения, используется worker-рантайм |
| --ide grok-bot | Grok Bot | У хоста нет хуков — наблюдение идёт за файлами лога чата |
| curl-скрипт | OpenClaw | Отдельный установочный скрипт для шлюзов |
npm install -g claude-mem ставит только SDK и библиотеку, но не регистрирует хуки и не поднимает worker-сервис. Память в этом случае просто не заработает — используйте npx claude-mem install или установку плагина из маркетплейса внутри агента.Плагин не делает сжатие сам — он вызывает модель. После установки установщик спрашивает, какую схему вы хотите: наблюдатель от разработчиков claude-mem, собственный ключ (OpenRouter или Gemini) либо ваш действующий план Anthropic. Есть и полностью локальный вариант — наблюдение на своей машине через явный --provider host.
| Провайдер | Что даёт | Стоимость |
|---|---|---|
| claude-mem observer | Память работает вне вашего плана модели | 30 дней бесплатно, далее подписка — цены уточняйте на официальном сайте |
| Свой ключ OpenRouter | Вы платите только за токены сжатия по своему тарифу | по прайсу OpenRouter — уточняйте на официальном сайте |
| Свой ключ Gemini | То же, но на модели Google | по прайсу Google — уточняйте на официальном сайте |
| План Anthropic | Память расходует лимиты вашего плана Claude | в рамках действующей подписки |
| Локальный наблюдатель (--provider host) | Сжатие на вашей машине, без внешних вызовов | бесплатно, нужны свои ресурсы |
Память не отдаётся агенту целиком — это было бы слишком дорого по токенам. Вместо этого встроен трёхслойный протокол из трёх MCP-инструментов: search возвращает компактный индекс с идентификаторами (примерно 50–100 токенов на результат), timeline показывает хронологический контекст вокруг находки, а get_observations вытягивает полные детали уже только для отобранных ID (примерно 500–1000 токенов на запись).
// 1. дешёвый индекс: тип наблюдения, лимит, проект search(query="authentication bug", type="bugfix", limit=10) // 2. посмотрели индекс, отобрали ID (например #123 и #456) get_observations(ids=[123, 456]) // всегда передавайте пачку ID // 3. при необходимости — что происходило вокруг наблюдения timeline(observation_id=123)
Авторы заявляют примерно десятикратную экономию токенов за счёт того, что детали запрашиваются только после фильтрации по индексу. Это оценка разработчика, а не независимый замер: проверять её стоит на своём проекте, сравнивая расход с обычным чтением истории.
Все параметры живут в одном файле ~/.claude-mem/settings.json — он создаётся с значениями по умолчанию при первом запуске. Там настраиваются модель сжатия, порт worker-сервиса, каталог данных, уровень логирования и то, какой контекст подмешивается в сессию. Режим работы задаётся ключом CLAUDE_MEM_MODE: он определяет и поведение конвейера, и язык сгенерированных наблюдений.
{
"CLAUDE_MEM_MODE": "code",
"CLAUDE_MEM_SESSION_START_<wbr>INCLUDE_ALL_<wbr>SOURCES": "true"
}| Параметр | Значение | Что меняет |
|---|---|---|
| CLAUDE_MEM_MODE | code | Поведение конвейера и язык наблюдений; базовый английский режим |
| CLAUDE_MEM_MODE | code--zh / code--ja | Языки по шаблону code--[код ISO 639-1]: Chinese, Japanese и другие |
| CLAUDE_MEM_SESSION_START_ | "true"/"false" | Подмешивать ли в контекст наблюдения из всех харнессов, а не только текущего |
| Порт и каталог данных | значения по умолчанию | Меняются там же; порт worker-сервиса печатается при старте |
| Уровень логирования | значения по умолчанию | Полезно, если разбираетесь, почему наблюдения не появляются |
Отдельный раздел документации посвящён Windows: хуки не требуют Git Bash, но требуют, чтобы раннер был в PATH. Установщик кладёт исполняемый файл в %LOCALAPPDATA%\claude-mem\bin и добавляет папку в пользовательский Path — после этого терминал или IDE нужно перезапустить, иначе хук его не найдёт.
npx claude-mem doctor.CLAUDE_MEM_SESSION_START_INCLUDE_ALL_SOURCES .Проект живой: за последние полгода вышло больше сотни релизов, а по звёздам на GitHub claude-mem обошёл другие открытые решения памяти для агентов. Сравнивать напрямую нужно аккуратно: claude-mem ставится как плагин через npx, а конкуренты чаще подключаются библиотекой в код проекта, поэтому недельные загрузки npm отражают не популярность, а модель дистрибуции.