Система памяти агента - Тюнинг Claude Code

Клод запоминает иначе -_-

В ChatGPT есть функция автоматической памяти. Общаясь с тобой, он подмечает детали и учитывает их при дальнейших диалогах.

У Claude Code тоже появилась автоматическая память — «Auto Memory». Он записывает заметки в файл MEMORY.md между сессиями (мы об этом говорили в уроке про CLAUDE.md). Но работает она не_надёжно: может записать не то, пропустить важное, или превратить файл в свалку заметок. Поэтому полагаться только на неё не стоит.

О памяти всё ещё нужно заботиться самому. И вот как.

Четыре вида памяти 📦

Чтобы братишка лучше нас понимал, нам надо следить за:

[ x ] CLAUDE.md — паспортом проекта. Там будут постоянные правила: как всё устроено внутри, что с чем связано, как делать можно и нельзя.

[ x ] «Skills» — навыками агента. Правила, которые объясняют ему как выполнять конкретные задачи. Интересная деталь: скиллы подгружаются в память только когда ты их вызываешь. То есть пока скилл не нужен — он не забивает контекст.

[ x ] MEMORY.md — автоматические заметки агента. Claude сам записывает наблюдения между сессиями. Устроено это хитрее чем кажется: MEMORY.md — это короткий индекс (до 200 строк), а детали Claude раскладывает по отдельным файлам (debugging.md, patterns.md и т.д.) которые подгружает по необходимости. Проблема: без регулярной чистки эти заметки превращаются в хлам.

[ x ] «Handoff» — передача контекста между сессиями. Файл, в который записывается что делали сегодня, что планируется на завтра, какие были выводы. Это удобная практика, которая помогает не терять нить между рабочими днями.

Каждый вид памяти отвечает на свой вопрос:

CLAUDE.md: «Как работать с этим проектом?»
«Skills»: «Как выполнять конкретные задачи?»
MEMORY.md: «Что я уже знаю об этом проекте?»
«Handoff»: «Где мы щас и чё делаем?»

Как организовать память правильно

Когда информации становится много, один файл CLAUDE.md не вывозит. Вот что помогает:

Ссылки на другие файлы (@import)

В CLAUDE.md можно сослаться на любой файл проекта:

                    Правила API описаны в @docs/api-rules.md
Стиль кода — @docs/code-style.md
                

Символ @ говорит Claude: прочитай этот файл. Вместо 50 правил в CLAUDE.md — одна строка и отдельный документ. Ссылки работают рекурсивно — до 5 уровней вложенности.

Модульные правила (.claude/rules/)

Можно создать папку .claude/rules/ и положить туда файлы с правилами по темам:

                    .claude/rules/
├── api-style.md        ← правила для API кода
├── testing.md          ← как писать тесты
└── security.md         ← требования безопасности
                

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

                    ---
paths:
  - "src/api/**/*.ts"
---
Все API эндпоинты должны валидировать входные данные.
                

Это мощная штука: правила не засоряют основной CLAUDE.md, и применяются точечно.

Общий принцип: разделяй информацию по файлам

Не пихай всё в один документ. Правила проекта > в CLAUDE.md. Правила по темам > в .claude/rules/. Навыки > в скиллы. Текущий контекст > в «handoff». Агент сам подтянет нужное.

«Handoff» — передача смены

Это файл с контекстом между сессиями. Обычно .claude/handoff.md — лежит в папке проекта.

Минимальные разделы:

На завтра — что нужно сделать
Сделано — что закончили
Обещания — что обещал людям Можно добавить раздел "Планируется" с напоминаниями типа "через неделю проверить прогресс у конкретного клиента" ✏️

Как не забывать

Про «handoff» легко забыть. Но если прописать его в команды, то обновление данного файла может происходить автоматически. Например, в одном из моих проектов есть:

Команда которая запускает работу (/morning) и в которой есть пункт:

                    Прочитай .claude/handoff.md — там контекст из прошлой сессии.
Покажи что будем делать сегодня.
                

Команда которая завершает день (/endday) и в которой есть пункт:

                    Обнови .claude/handoff.md:
- Запиши что сделали
- Запиши что на завтра
- Обнови обещания если были
                

Когда «handoff» встроен в команды, он ведётся сам 😎

Как создать 🛠️

Попроси братишку:

Создай файл handoff.md в .claude/
Там должны быть разделы: ... (на завтра, сделано, ...)
Добавь чтение этого файла в команду /morning
Добавь обновление файла в команду /endday

Если у тебя ещё нет команд для начала и завершения рабочей сессии – самое время их сделать!

«Context rot» — почему больше ≠ лучше 🧠

Есть важный момент, который Anthropic называют «context rot». Суть: чем больше информации загружено в контекст, тем хуже модель вспоминает каждый конкретный факт.

Поэтому цель = не «запомнить всё», а собрать минимальный набор важной информации, которая даёт максимальный результат. Три строчки точных правил лучше, чем три страницы размытых пожеланий.

Большинство ошибок агента это не ошибки модели. Это ошибки контекста. Агент не тупой. Он просто не знает того, что ты забыл ему рассказать, или перегружен лишней информацией.

Сжатие контекста ✂️

У Claude Code ограничен размер памяти внутри каждого чата. Когда контекст подходит к пределу, происходит автоматическое сжатие.

Что выживает при сжатии:

Твои сообщения и ключевые фрагменты кода
CLAUDE.md и MEMORY.md перезагружаются заново
Общее резюме разговора

Что может потеряться:

Детальные инструкции из начала диалога
Полные результаты выполненных команд
Нюансы, которые не попали в резюме

Ручное сжатие: команда /compact — можно добавить фокус: /compact сосредоточься на работе с API. Тогда при сжатии Claude сохранит именно то, что важно для текущей задачи.

Важно: если ты работал два часа и не сохранял «handoff», детали могут потеряться при сжатии. Поэтому лучше обновлять его по несколько раз за длинный диалог.

Обнови «handoff» с тем что мы сделали за последний час.

Три принципа хорошей памяти

1. Разделяй: что пишешь ты, что пишет агент

CLAUDE.md, «handoff», правила — пишешь ты (или контролируешь). MEMORY.md пишет агент сам. Не смешивай. Если агент начнёт перезаписывать твои правила — будет бардак.

2. Чисти регулярно

Память без обслуживания превращается в свалку. Старые задачи, устаревшие решения, неактуальные заметки — всё это мешает агенту работать. Раз в неделю проси Claude: «Почисти файлы памяти, убери устаревшее».

3. Конкретика побеждает объём

«Пиши хороший код» — бесполезно. «Используй TypeScript strict mode, обрабатывай ошибки через Result type» — работает. Несколько точных правил дадут больше, чем страница общих пожеланий.

Автоматизация через хуки ⏰

Можно настроить автоматическое сохранение «handoff». Тогда Claude Code будет сам записывать контекст в конце сессии или перед сжатием. Без твоих команд.

Для этого используются хуки. О них поговорим в следующем уроке.

Ну а в целом, не усложняй

Начни с одного файла «handoff» — на завтра, сделано, обещания. Этого хватит на первые недели. Когда почувствуешь, что информации стало много и она путается — используй .claude/rules/, ссылки через @, и разделяй правила по файлам. Это естественный процесс роста.

💭 От Тома:
Охуенная тема эта память. Объяснять Клоду каждый день на чём мы [вчера] остановились, быстро заёбывает. А когда для передачи ему этой информации, не нужно даже открывать рот – работать становится немножечко проще. И чем больше у тебя проектов, тем важнее нормально организовать память — иначе утонешь. Советую, в общем. Погнали дальше.