Экспериментальная система памяти в Claude Code

Claude Code уже строит собственную систему памяти — файл MEMORY.md, который загружается в системный промпт в начале каждой сессии. Пока она работает только локально, но скоро может стать общей для всей команды.

Это AI-перевод статьи, сделанный каналом Про AI: Лучшие Статьи и Исследования.

Экспериментальная система памяти в Claude Code

Claude Code's Experimental Memory System Автор: Giuseppe Gurgone Оригинальный текст:

Сегодня я читал про memory tool в Anthropic SDK и сразу задумался: можно ли создать что-то похожее в виде пользовательского навыка (skill) для Claude Code?

Но прежде чем пойти этим путём, я решил проверить, не строит ли Anthropic уже что-то подобное нативно — и поручил Claude Code исследовать собственный минифицированный бандл CLI. Оказалось, что да, строят.

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

Как включить

Добавьте в ~/.claude/settings.json:

{"autoMemoryEnabled": true}

В исходном коде это описано как «Enable auto-memory (research preview)».

У некоторых аккаунтов функция уже включена через серверный флаг — если директория ~/.claude/projects/<project>/memory/ уже существует, значит вы в числе участников.

Чтобы отключить: CLAUDE_CODE_DISABLE_AUTO_MEMORY=1.

Как это работает

Claude Code поддерживает файл ~/.claude/projects/<project>/memory/MEMORY.md и подставляет его содержимое в системный промпт в начале каждой сессии. Файл хранится локально на вашей машине и никогда не попадает в git.

Когда файл пуст, Claude видит такое сообщение:

Существует жёсткий лимит в 200 строк (найден прямо в бандле: var U_ = "MEMORY.md", pZ = 200). При превышении Claude получает только первые 200 строк плюс предупреждение:

Система подталкивает к паттерну, в котором MEMORY.md — это короткий индекс, а детали живут в отдельных файлах по темам. Автоматическое чтение этих тематических файлов пока не работает — это скрыто за feature flag (флаг функции) tengu_coral_fern, который по умолчанию выключен.

Области видимости памяти агентов

Для пользовательских агентов, созданных через мастер агентов Claude Code, существует отдельная система с тремя областями видимости:

• Project — .claude/agent-memory/<agent>/ — внутри репозитория, можно коммитить в git
• Local — ~/.claude/agent-memory-local/<agent>/ — локально на вашей машине
• User — ~/.claude/agent-memory/<agent>/ — глобально для всех проектов

Самая интересная — проектная область. Закоммитьте .claude/agent-memory/, и вся команда будет работать с одной и той же памятью агента.

Пробел

Основная сессия Claude Code получает только локальную память через MEMORY.md (первый уровень).

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

Что возвращает меня к тому, с чего я начал. Memory tool в SDK делает именно это. Навык для Claude Code мог бы закрыть тот же пробел, позволяя сохранять атомарные воспоминания в файлах проекта. Но учитывая, как близко Anthropic уже подобрались к решению, я, вероятно, просто подожду и посмотрю, не появится ли это нативно.

Подпишитесь на канал и каждый день читайте лучшие материалы про AI переведенные на русский!

Нашли интересную статью для перевода? Пришлите нашему боту: @ailongreadsbot