Как дать Claude Code память между сессиями

Коротко: Claude Code забывает проект после закрытия сессии. Добавить ему долговременную память — десять минут: поднимаем локальный MCP-сервер MaxGraph в Docker, подключаем одной командой claude mcp add, вставляем блок протокола в CLAUDE.md. Дальше агент сам запоминает решения, баги и задачи — и восстанавливает их в начале следующей сессии.

Что понадобится

• Docker (Docker Desktop на Windows/macOS, docker + compose на Linux)
• Claude Code
• 10 минут

Шаг 1. Поднять сервер памяти

git clone https://github.com/RuMemory/maxgraph
cd maxgraph
docker compose up -d

Проверка:

curl http://localhost:8787/healthz
# → ok

Шаг 2. Взять токен доступа

Токен генерируется сам при первом запуске:

# Linux / macOS
cat data/local_token.txt

# Windows
type data\local_token.txt

Это ключ от вашей памяти. Не публикуйте и не коммитьте.

Шаг 3. Подключить MaxGraph к Claude Code

Одна команда:

claude mcp add --transport http maxgraph http://localhost:8787/mcp \
  --header "Authorization: Bearer ВАШ_ТОКЕН"

Или то же самое в .mcp.json проекта:

{
  "mcpServers": {
    "maxgraph": {
      "type": "http",
      "url": "http://localhost:8787/mcp",
      "headers": { "Authorization": "Bearer ВАШ_ТОКЕН" }
    }
  }
}

Перезапустите Claude Code — в списке инструментов появятся create_entities, add_observations, search_nodes, session_start и другие.

Шаг 4. Вставить протокол памяти в CLAUDE.md

Инструменты есть — теперь скажите агенту, как ими пользоваться. Добавьте в CLAUDE.md проекта:

У тебя есть постоянная память MaxGraph (инструменты maxgraph/*).
В начале сессии вызови session_start. Факты сохраняй СРАЗУ через
add_observations; новые темы — create_entities (name = kebab-case id,
title = человеческое имя); связи — create_relations в активном залоге.
В конце сессии — session_close с итогами.
Полный протокол: https://github.com/RuMemory/maxgraph/blob/master/docs/PROTOCOL.md

Без этого блока агент будет помнить «когда вспомнит». С блоком — систематически.

Шаг 5. Проверить

Попросите агента: «Запомни: деплой у нас только через deploy-скрипт с preflight-гвардом». Закройте сессию. Откройте новую и спросите: «Что ты знаешь о нашем деплое?»

Если ответ содержит preflight-гвард — память работает. Заодно загляните в дашборд http://localhost:8787/app (вход по токену): там живой граф знаний, журнал записей и кнопка экспорта всего в JSON.

Что это даёт через неделю

• Старт сессии без пересказа проекта: агент сам читает дайджест решений, открытых багов и задач. Замеры: 1,4–3,3× меньше токенов на старте.
• Решения не теряются: «почему мы выбрали Postgres» находится одним поиском через месяц.
• Триал — 7 дней, без карты; данные лежат на вашей машине, экспорт в NDJSON в один клик.

FAQ

А если у меня Cursor / другой клиент? Подойдёт любой MCP-клиент: URL http://localhost:8787/mcp + заголовок Authorization: Bearer <токен>. Конфиги под популярные хосты — в docs/PAIRING.md.

Данные куда-то отправляются? Нет. Память лежит в data/ на вашей машине. Интернет нужен один раз — для активации лицензии после триала.

Сколько стоит после триала? 149 ₽/мес ($1.99). Ядро с экспортом и просмотром остаётся доступным и без подписки.