Памяць для Claude Code: лакальны MCP-плагін Memento
AI-агенты кадавання ўсё забываюць паміж сесіямі. Memento, лакальны MCP-плагін для Claude Code, захоплівае, чысціць, дэдуплікуе і ўзгадвае кантэкст праекта.
Крыніцы: My AI Coding Agent Keeps Forgetting Me — So I Gave It a Brain
Уявіце вечар у втрыцьцю, адноўсім у 11 вечара. Пасля трохоў часу, які вы прызначылі на перапісваў аб’екта-посерэдніка для аўтэнтыфікацыі за дапамогою Claude Code, вы і агент спершы обгаварылі варыянт з патэрнам стратэгіі, а потым — проста фабрыку. Былі спробаваны оба падходы; фабрыка выказала ся крашчай, і токены сэсій нарэшце праходзілі праз новы шар верыфікацыі так, як і трэба. Гэта была адна з тых сэсій, калі все работае без працяў, і саавтарскае програмаванне з AI здаецца цэлеспрабным.
Наступны ранак вы пачынаеце новую сэсію і прасіце продырвацца да таго моменту, дзе застаўлі працу над аб’ектам-посерэднікам для аўтэнтыфікацыі. У вярненні яе вы пачынаеце веселае запрошэнне да дапамогі, а пасля — просьбу апісаць структуру і цілі праекту з самага початку.
Тры гадзіны спяльнага аналізу — і ўсё.
Усі сталкваліся з гэтым
Як толькі вы вжываеце які-небудзь інструменты для програмавання на базе ШЫ прыблызна больш чым тыдзень — чы гэта Claude Code, Cursor, Copilot чы Windsurf — вы неабяжна сталкнуцеся з гэтым проблемам. Кожна сесія пачынаецца з порожніх лоскуткаў, і такая рутына быстра становіцца надтаўглівай. Першыя 15–20 хвілін прыходзіць на тое, каб зноў поясніць праект: гэтая структура папак, гэта як працюе аўтэнтыфікацыя, гэта чаму Supabase ёсць лепшым выборам, чым стварэнне усяго самостайна, і ні, Redis не быў выбраны. Звычайна, інструмент не памятае. Ён не можа.
Вы заўважыце, што пачынаеце рэчы фразамі «Памятаеце, калі мы…», але не можаце продыржыць, бо з іншай стороны няма «мы». Для ШЫ не існуе вчора, ёсць толькі зараз. Гэта як калі вашы найрозумнейшы колега ўсё кожны ранак прыходзіць з абсалютным амнэзіям.
Відразу зрозумелыя рашэнні не трываюць
Першыя спробы ўсё можна ўзгадаць. Аднам з іх ёст моцны файл CLAUDE.md, заполнены сторанкамі інформацыі пра праект, дыяграмамі архітэктуры у фармаце ASCII, правіламі кодавання і структурой файлаў. Гэта дапамагае з базавымі аспектамі, таму агент ведае вашу фрэймворк-сістэму і там, дзе знаходзяцца маршруты. Але ён не можа зберагаць інформацыю пра рашынкі. Агент не будзе ведаць, што падход А быў прыменены ў празылуць паўтароўчыцу і зазнаў неудачы праз супернечку ў працы працоўніка з чэргай, і самэ гэта стало прычыной успеху падходу Б. Такія знанні накапліваюцца працуючы разам календарныя дні, а статычны файл у фармаце markdown не можа застацца актуальным, таму што праект развіваецца, а файл стае застарэлым вядома за калькі дзён.
Другі спробы — гэта сваём родзе додатковы документ, у яком запісваюцца тыя рэчы, якія трэба сказаць ШЫ на пачатку кожнай сесіі: ключовыя рашэнні, нявялікія падходы, прынцыповыя проблемы. Гэта якось працюе, але трэба зупініцца і парадкавацца, што відбуваецца. Вы ручная утрымваеце памяць для машыны, якая пішчыць код у дзесяць разоў быстрэй за вас, і ёй трэба, каб вы выступалі як яе зошыт.
Жадны з эых падходоў не прыжывае дольш чым на тыяж-два тыяжы, і вы востатком выдзяліваеце больш часу на кераванне кантэкстам ШЫ, чым на напісанне коду.
Аслівныя проблемы
У гэтых інструментаў няма памяці. Гэта і ёсць весь прынцыповы прынцып.
Чалавечы саўерэнік мае цэннае значэнне не толькі заводзкая спроможнасцю. Яны ствараюць кантэкст. Яны ведаюць, чаму быў выбраны Postgres заместо Mongo, памятаюць баг у сістэме роўнаважэння рахункоў у стылі, які выйшаў з-за памылак у вычысленнях часовых зонаў, і прыгадваюць архітэктурныя рашэнні, прыйнятыя тры спрынты таму, якія пояснююць, чаму адны модулі выглядаюць некалякава. AI не мае нічога з гэтай спакульнай історыі. За прыродай яго немае стану.
Калі гэтыя інструменты былі проста павышаныя версіямі автадаптавання, гэта майжэ не мела значэння. Цяпер яны перэрабляюць цэлыя модулі, дыягназуюць проблемы, якія выступаюць у розных службах, і дапамагаюць у справжніх архітэктурных рашэннях. Калі такі здольны інструмент не можа прыгадаць працу з вчора, разчароўванне вельмі вялікае.
Што тады, калі ён можа проста пам’ятаць? Не шляхам прымітнага введэння всьго ў запіт, а так, што ШЫ сам выкарыстоўвае значыцымы кантэкст з пакананых сесій, ствараючы яго на адной з аснов таго, над чым вы зараз працуеце, без якіх-леба запітаў.
Memento
Гэя ідэя стала Memento — так яе названа на часць фільма. Гэта плагін для Claude Code, тэхнічна MCP-сервер, які дае агенту стойкую памяць між сесіямі. Калі вы працуеце, ён у фонавым рэжыме фіксуе архітэктурныя рашэнні, выправленні бягоў і змяны конфігурацыі, і зберагае іх локальна на вашам камп’ютары. На пачатку новай сесіі ён выдае тое, што падходзіць да тэкушчага завадзя.
Першы раз, калі гэта запрацавала, усё выглядала так: у панедзелак вы лагадваеце проблему са супернаганяннем у працоўніку з чэргай. Асновная прычына — відсутнасць блакана; Claude дапамагае яе выправіць, а Memento без жадных вашых зусіль зберагае кантэкст. У срэду вы знову працуеце з працоўніком з чэргай над чымось несвязаным і зовсім не паміняеце пра панедзелак. Claude сама прамовляе, што проблема са супернаганяннем у гэтым месцы была выправлена ў панедзелак за дапамогою файла блакана, і прасіць пераканацца, чыяму гэтыя два віпадкі связаны.
Гэтае і ёсць момент, калі гэта стае можлівым. Агент запамятаў калякіясь тое, чыму ніхто яго не паведаміў — не таму, што стары кантэкст быў заклеў, і не таму, што існаваў файл з інструкцыямі, а таму, што ён справжнім чынам зберагаў памяць пра пярэдню сесію.
Унутраняе функціонаванне
Зялежэнне. Працуючы, запускаюцца два хака. Адны з яных актываецца пасля значымага вікорыстоўвання інструмента, такога як рэдагаванне файлаў і выкананне каманд, але не пасля простага чытання файлаў. Другі актываецца калі сесія завершаецца і збірае статыстыку. Усё гэта выконваецца на фоне.
Чыстка і атрыбутаванне. Перш чым ўсё будзе зберажана, спецыяліст адключае API-клучы, токены, паролі і кантракты AWS. Потым спецыяліст па атрыбутаванні сортавае інфармацыю па тыпах, такіх як рашэнне, адказка, архітэктура чы настройкі, выкарыстоўваючы патэрны. У гэтым кроку не выкананыя ніякія вызовы LLM.
Усуненне дуплікатаў. Пяцьдзесят варыянтов адной і той жа інфармацыі будуць толькі зайвасцю. Сістэма пераканальваецца на наявнасць точных дуплікатаў за дапамогою хэша, а потым пераканальваецца на косай схожасці для інфармацыі, якая мае адно значэнне, але выражаецца іншымі словамі. Калі новейшая версія мае больш дакладнасці, яна заменяе старую.
Зберагачча. По замовчанню усё зберагаецца у местных JSON-файлах, без жадных залежнасцей і без патрэбы ў налагоджэннях. Для правільнага векторнага пошуку можна выкарыстоўваць ChromaDB, а для пошуку на адной графічнай структуры — Neo4j.
Адзыявленне. Калі пачынаецца новая сесія, Memento семантычна запытае зберажаныя спомненні. Адпаведнасць шукаецца за значэнням, а не за ключоўымі словамі, таму запіт пра працэс заходжання можа выявіць спомненні пра паўерыфікацыю токена сесіі, нават якфі фразы не маюць нічыяй спольнай часткі.
Усё працюе локальна. Мадэль укладкі all-MiniLM-L6-v2 выконваецца на вашай супэльнічцы за дапамою Transformers.js, таму не выкананыя ніякія запыты API і нічога не выходзіць за межы вашага ноутбука.
Што запам’ятаецца
Пам’яткі зазначаюцца адпрацоўкай, якая з іх стварылася. Катэгорыі включаюць рашэнні (чаму быў выбраны X заместо Y), адказы (што зламалася і як гэта было вылечана), архітэктуру (як взаімаюцца компаненты) і настройкі (зменныя сераўіса і дэталі развяртання); у README перыяднаны восьмыя катэгорыі. Сэрцаўая ідэя заключаецца ў тым, што Memento не проста зберагае необработаныя логі чату. Ён класіфікуе кантэкст, таму можна розумней выбіраць тое, што ў даны момент мае значэнне.
Пам’яткі прыналежаць да практыку на адпаведны гіт-роут, таму запісы з рэпазітарыя API не прасачуцца ў працу над фронтэндам. Існуе можлівасць пошуку між практыкамі, калі гэта неабходна.
Захаванне дадзеных
Інжынерыя надзяркі гэтых сістэм дасклівае. Апарат для перывання цяга задач запобегае распространэнню проблем у базе дадзеных, журнал запісей паўтаральных дзеянняў абэрнуе втрату дакументаў у разе збою пад час запісу, а кэш LRU служыць альтэрнатываўкай, калі галоўная сховішча на час не доступна. Гэта можа здавацца занадта, але інструменты, якія таямна выкарыстоўваюць даны, ёсць справжнім раздражэннем, і мета — каб усе, што зафіксаваў Memento, засталося на месцы.
Прабаўка
Гэты праект ў фармаце адкрытага кода і публікуецца на npm. Для выканання задачы патрэбна толькі адна команда:
npx memento-memory
Эта процедура запускае сервер MCP, насталявае автаматычныя механізмы захавання даных і адкорэгуе настройкі Claude, так што наступная сесія Claude Code будзе працаваць без проблем. Таксама ёсць можлівасць абсалютнага запуску за дапамою npm install -g memento-memory, а у документацыі README пераказаны всі варыянты настройкі.
Таксама існуюць дзеякі ручныя каманды:
/recall— шукае інформацыю ў вашых «памяцях»/remember— явна захоўвае які-небудзь даныmemory_health— аддае інформацыю пра стан сістэмыmemory_list— паказвае тое, што захавана
Чаму гэта важна
Інструменты для програмавання на асывятацыі знаходзяцца у дыявольскай сітуацыі. Яны можаць перэрабіць цэлыя модулі, расплутваць складныя багі і аналізаваць архітэктуру сістэмы, пры тым кожны ранак працюючы, яны нічога не ведаюць пра вас чыста пра ваш праект. Чым болей яны становяцца спроможнымі, тым болей болючым стае гэты прыем, таму што можна відчуць, насколькі лепшая была бы сітуацыя, якбы існавала хоць якая працэйна працэйна спадчына.
Memento — гэта спроба закрыць гэты прыем. У яго ёсць недосконаласці, і без сумнення ёсць случаі, калі ён неправа класыфікуе ўсё чыста пра пропускае кантэкст, які мусіў бы быць очывітым. Тым не менш, пачатак сесіі, калі Claude ужо ведае, што адбылася ў пярэдній тыдзень, — гэта тое, як усё мало бы функцыонаваць з самага пачатку. Недастатак памяці — гэты баг.
Спадневана літэратура
- Чаму ламаюцца навыкі агента, калі іх складаць у ланцюг, і трывалы спосаб іх выправлення — Глыбокія ланцюгі навыкаў перавантажваюць кантэкст агента. Замест таго ствараюць структуры з атамаў, малекулаў і спалучэнняў, прыклады да Claude Code, LangGraph, CrewAI і Agno.
- Развіццелі WordPress і агенты для кодавання на AI: Abilities API, MCP і што трэба выучыць — Як агенты для кодавання змянююць работу з WordPress у 2026 годзе: Abilities API, AI Client, MCP Adapter, WebMCP, проблемы з верыфікацыяй і спіс навыкаў, якія варта вівучыць.