Claude Code + Obsidian: perzistentná pamäť pre AI agentov
Claude Code stratí pamäť na konci každej session. Komunita to rieši cez Obsidian vault — lokálnu Markdown databázu, ktorú agent číta aj sám dopĺňa. Návod, porovnanie a kedy ktorý prístup zvoliť.
TL;DR: Claude Code v základnej podobe stratí pamäť na konci každej session — pri otvorení nového okna musíte všetko vysvetľovať odznova. Anthropic to v marci 2026 čiastočne vyriešil oficiálnou auto memory funkciou (MEMORY.md v ~/.claude/projects/<projekt>/memory/, dostupná od verzie v2.1.59). Komunita však zašla ďalej: pripojila Claude Code priamo k Obsidianu — lokálnej Markdown databáze poznámok — a vytvorila tzv. second brain, ktorý si AI agent čítu a sám dopĺňa. Výsledkom je perzistentný, projektovo organizovaný kontext, ktorý šetrí tokeny aj čas. V tomto článku rozoberieme, prečo to vzniklo, ako to nastaviť za hodinu a kedy má zmysel kombinovať oficiálne Anthropic riešenie s Obsidianom.
Prečo Claude Code "zabúda" každú session
Claude Code je terminálový AI agent od Anthropicu, ktorý dokáže čítať a upravovať váš kód, spúšťať príkazy a viesť dlhé refaktoringy. Má však jednu vlastnosť, ktorá pri každodennom používaní bolí: pri každom novom otvorení začína s prázdnym kontextom. Konverzácia nie je perzistentná medzi sessionmi — keď v utorok dokončíte debug a v stredu sa vrátite, agent nevie, čo ste včera vyriešili.
Podľa oficiálnej dokumentácie Anthropic ide o cielený dizajn: každá session dostáva čistý kontextový blok, aby sa nehromadili neaktuálne pravdy a halucinácie z minulosti. Pre používateľa to ale znamená, že musí:
- opakovane vysvetľovať architektúru projektu, build príkazy a názvy súborov,
- znovu spustiť agentov "obhliadku" repozitára (Claude Code prečíta projektové súbory, aby sa zorientoval),
- duplicitne riešiť rovnaké chyby, lebo si agent nepamätá, že tú istú regresiu pred tromi dňami opravoval.
README súborov do konverzácie. Aj v našom tíme sme to roky robili rovnako — pred každou agentskou session sme do okna nakopírovali rovnaký kontextový blok o brand voice, štruktúre webu a otvorených úlohách. Niektoré nezávislé case studies popisujú, že session bez perzistentnej pamäte spotrebuje 70 až 80 tisíc tokenov len na úvodnú orientáciu — čísla sa líšia podľa veľkosti projektu, ale princíp je rovnaký: bez pamäte platíte za to isté znova a znova.
Oficiálne riešenie: CLAUDE.md a Auto memory
Anthropic v priebehu roka 2026 doplnil do Claude Code dva natívne mechanizmy, ktoré perzistujú znalosti medzi sessionmi. Oficiálna dokumentácia ich popisuje ako komplementárne, nie konkurenčné.
CLAUDE.md — inštrukcie písané používateľom
INLINECODE_3 je obyčajný Markdown súbor s pravidlami, ktoré chcete, aby Claude dodržiaval pri každej session. Vznikol pôvodne ako alternatíva k AGENTS.md (konvencia iných coding agentov ako Cursor) a Anthropic ho oficiálne preferuje.
Súbor môže žiť na štyroch úrovniach:
- Managed policy (
/etc/claude-code/CLAUDE.mdalebo Windows ekvivalent) — organizačné pravidlá nasadené cez MDM/Group Policy, - Projekt (
./CLAUDE.mdalebo./.claude/CLAUDE.md) — zdieľané cez Git s celým tímom, - User (
~/.claude/CLAUDE.md) — vaše osobné preferencie naprieč všetkými projektmi, - Local (
./CLAUDE.local.md) — projektovo špecifické, ale len pre vás (typicky.gitignore-ovaný).
CLAUDE.md pod 200 riadkov — dlhšie súbory spotrebujú viac kontextu a paradoxne znižujú mieru, akou ich Claude dodržiava.
Pre väčšie projekty existuje .claude/rules/ adresár, kde môžete inštrukcie rozdeliť na samostatné súbory a scopnúť ich na konkrétne cesty cez glob pattern v YAML frontmatter. Pravidlo s paths: ["src/api/*/.ts"] sa načíta až vtedy, keď Claude reálne pracuje s API kódom.
Auto memory — Claude si píše sám
INLINECODE_14 je novšia funkcia (vyžaduje Claude Code v2.1.59 alebo novší). Princíp: Claude sám rozhoduje, čo si zapamätá. Keď ho opravíte ("nepoužívaj npm, používaj pnpm"), keď si všimne opakujúci sa pattern v debugovaní alebo keď objaví build príkaz, ktorý ste mu predtým nepovedali, zapíše si poznámku do:
CODEBLOCK_0
Pri štarte session Claude načíta prvých 200 riadkov alebo 25 KB z MEMORY.md (čo nastane skôr). Detailné tématické súbory ako debugging.md sa neaktivujú automaticky — Claude si ich prečíta, keď ich potrebuje. Tým sa vyhne zbytočnému plytvaniu kontextom.
Funkciu vypnete buď cez /memory príkaz v aktívnej session, nastavením autoMemoryEnabled: false v settings.json, alebo environment premennou CLAUDE_CODE_DISABLE_AUTO_MEMORY=1.
Pozn.: Auto memory je machine-local. Súbory nie sú zdieľané medzi zariadeniami ani s cloud sandboxmi — ak Claude Code spustíte na inom laptope, začínate od nuly.
Príkaz /memory v session zobrazí všetky CLAUDE.md aj auto-memory súbory, ktoré sa do aktuálneho kontextu načítali — môžete ich otvoriť, editovať alebo zmazať.
Čo je Obsidian a prečo sa hodí pre AI pamäť
Obsidian je bezplatná desktopová aplikácia na poznámky, ktorú vytvoril tím okolo Erica a Shidy z roku 2020. Kľúčové sú dva atribúty:
.md Markdown súbory v normálnom priečinku na vašom disku — Obsidian nepoužíva vlastnú databázu, cloud ani proprietárny formát.Práve táto kombinácia robí Obsidian ideálnym pre Claude Code:
- Priečinok s poznámkami (vault) je z pohľadu agenta len bežná zložka so súbormi.
- Claude Code natívne vie čítať, písať a grepovať Markdown — nepotrebuje žiaden plugin, MCP server ani API.
- Vy zároveň môžete tie isté súbory čítať a editovať v GUI s graph view, backlinks panelom a search-om.
Setup Claude Code + Obsidian: krok za krokom
Toto je minimalistický návod. Predpokladám, že už máte nainštalovaný Claude Code a Obsidian.
1. Vytvorte Obsidian vault pre projekt
Vault je obyčajný priečinok. Vytvorte ho kdekoľvek na disku:
CODEBLOCK_1
Otvorte ho v Obsidian aplikácii cez Open folder as vault. Obsidian si v ňom vytvorí skrytý .obsidian/ priečinok s konfiguráciou — ten nechajte tak.
2. Navrhnite štruktúru priečinkov
Pasquale Pillitteri vo svojom popise second brain setupu odporúča MECE priečinkovú štruktúru:
CODEBLOCK_2
Žiadna z týchto zložiek nie je povinná — princíp je len, aby si Claude dokázal nájsť kontext bez prečítania celej databázy.
3. Napíšte zakladajúci CLAUDE.md
V koreni vaultu vytvorte CLAUDE.md so základnými pravidlami. Príklad pre obsahový projekt:
CODEBLOCK_3
Tento súbor je v rovnakom adresári ako vault — Claude Code ho načíta pri každom spustení v tomto priečinku.
4. Spustite Claude Code priamo vo vaulte
V termináli sa prepnite do vaultu a spustite agenta:
CODEBLOCK_4
Claude pri štarte načíta CLAUDE.md, naskenuje top-level priečinky a uvidí všetky vaše poznámky. Žiadna inštalácia, žiadny plugin, žiadne API kľúče navyše.
5. Zadefinujte ranný a večerný protokol
Komunitná konvencia, ktorá sa osvedčila, je dvojica jednoduchých fráz:
- "Good morning" alebo "Dobré ráno" — Claude otvorí dnešný
Daily/súbor, prejde si nedokončené úlohy z včerajška, prečíta dlhodobé ciele zContext/a urobí krátky recap. - "Sme hotoví na dnes" — Claude sa spýta na uzavreté úlohy, naučené veci a priority na zajtra, a poznámky uloží do správnych zložiek.
CLAUDE.md.
Self-evolving memory: Claude Code hooks + Obsidian
Predošlý setup je manuálny — vy musíte povedať "dobré ráno", aby si Claude prečítal kontext. Pokročilejšia verzia využíva Claude Code Hooks, ktoré sa spúšťajú automaticky pri lifecycle udalostiach.
Kľúčový je Stop hook, ktorý sa exekvuje na konci každej session. MindStudio v návode na self-evolving memory popisuje setup, kde Stop hook vyvolá Python skript:
CODEBLOCK_5
Skript prečíta transkript skončenej session, pošle ho menšiemu modelu (typicky Claude Haiku) s promptom "extrahuj patterns, mistakes, decisions, context" a výstup zapíše ako Markdown poznámky do Obsidian vaultu. Pri ďalšej session Claude tieto poznámky automaticky uvidí cez CLAUDE.md, ktorý ich referencuje.
MindStudio uvádza, že typická 2 000-tokenová session pri použití Haiku ako extrakčného modelu stojí pod $0.01 — pri dennom použití hovoríme o haléri.
Niektoré komunitné projekty idú ešte ďalej. Repozitár claude-code-memory-setup tvrdí až 71,5× menej tokenov per session vďaka kombinácii Obsidianu, codebase knowledge grafu a importu starých chatov — výsledok závisí od veľkosti projektu, ale princíp je zrejmý: agent nemusí znova čítať desiatky súborov, lebo má pripravený sumár.
Auto Dream: experimentálna konsolidácia pamäte
Časť pokročilej komunity píše aj o tzv. Auto Dream — funkcii, ktorú popisuje claudefa.st ako periodický background proces, ktorý prejde existujúce memory súbory, zmaže zastarané, vyrieši protirečenia a reorganizuje index.
Upozornenie: Auto Dream nie je oficiálne dokumentovaná funkcia v Anthropic Claude Code memory dokumentácii. V čase písania tohto článku (máj 2026) ide o komunitnú interpretáciu mechaniky, nie o garantovanú funkcionalitu. Ak na ňu narazíte v tutoriáloch, berte ju ako experimentálnu vrstvu, nie ako stabilné API.
Princíp je však užitočný a viete si ho replikovať aj manuálne: raz týždenne spustite v Claude Code session s príkazom "prejdi všetky súbory v memory adresári, odstráň duplicity a zastarané poznámky". Funguje to spoľahlivo, lebo agent má prístup ku všetkým súborom a vie ich editovať.
Porovnanie prístupov: kedy ktorý použiť
| Prístup | Setup čas | Tím-friendly | Token úspora | Vhodné pre |
|---|---|---|---|---|
| Len CLAUDE.md | 5 minút | áno (cez Git) | nízka–stredná | Malé tímy, jasne definované pravidlá |
| CLAUDE.md + Auto memory | 0 minút (default) | čiastočne (auto memory je machine-local) | stredná | Sólo vývojári |
| CLAUDE.md + Obsidian vault | 1–2 hodiny | áno (vault môžete dať do Gitu) | stredná–vysoká | Obsahoví tvorcovia, strateické projekty |
| Obsidian + Stop hook | 2–4 hodiny | obmedzene | vysoká | Power useri, denné používanie |
| Plný knowledge graf | dni | áno | veľmi vysoká | Veľké tímy a multi-mesiacové projekty |
Z praxe v našom tíme sme zistili, že najlepšie funguje postupné nabaľovanie: začnite s CLAUDE.md a Auto memory, a Obsidian pridajte až keď zistíte, že vám chýba doménová pamäť mimo kód — napríklad brand voice, rozhovory s klientmi alebo dlhodobé strategické rozhodnutia.
Čo to znamená pre AI optimalizáciu a GEO
V kontexte optimalizácie webu pre AI vyhľadávače je perzistentná pamäť agentov dôležitá z troch dôvodov:
Library/, predošlé klientske volania v Daily/), generovaný obsah obsahuje konkrétne čísla a citácie. To je presne tá kvalita obsahu, ktorú Perplexity, ChatGPT a Google AI Mode preferujú pri citáciách.Pre menšie firmy je Obsidian + Claude Code priamou cestou, ako bez najímania ďalších ľudí prevádzkovať obsahovú prevádzku, ktorá je AI-citable by default. Pre agentúry je to spôsob, ako udržať konzistentný výstup naprieč desiatkami klientov bez toho, aby každý copywriter pamätal každú nuancu každej značky.
Záver: pamäť je infraštruktúra, nie feature
Pred dvanástimi mesiacmi sa o AI agentoch hovorilo ako o stateless nástrojoch, ktoré si nájmete na hodinu. V máji 2026 sa rovnaký Claude Code stáva kolegom, ktorý má prístup k tímovej Wikipédii — a tým, kto definuje, čo do tej Wiki patrí, je naďalej človek.
Či už zostanete pri oficiálnom CLAUDE.md + Auto memory, alebo zájdete ďalej s Obsidianom a hookmi, dôležité je začať. Každý mesiac bez perzistentnej pamäte je mesiac, počas ktorého platíte za to isté vysvetľovanie znova a znova.
Často kladené otázky
Je Obsidian zadarmo na komerčné používanie?
Áno, Obsidian je zadarmo na osobné aj komerčné použitie. Platené sú len doplnkové služby ako Obsidian Sync a Obsidian Publish — ani jedna nie je potrebná pre integráciu s Claude Code, lebo všetko ide cez lokálne súbory.
Potrebujem Obsidian plugin alebo MCP server pre Claude Code?
Nie. Claude Code číta .md súbory priamo z filesystému cez svoje natívne nástroje. Stačí spustiť claude v koreni Obsidian vaultu a agent vidí všetky poznámky. Komunitné MCP servery existujú, ale pre základné použitie sú zbytočná komplexita.
Aký je rozdiel medzi CLAUDE.md a MEMORY.md?
CLAUDE.md je súbor, ktorý píšete vy ako používateľ — obsahuje pravidlá, konvencie a architektonické rozhodnutia. MEMORY.md je súbor, ktorý si Claude píše sám cez Auto memory funkciu — obsahuje pozorovania, learnings a patterns, ktoré odhalí počas práce. Oba sa načítajú do kontextu pri štarte session, ale CLAUDE.md je zámerná inštrukcia, MEMORY.md je auto-generovaný zápisník.
Ako sa pamäť zdieľa medzi mojím laptopom a serverom?
Auto memory od Anthropicu je striktne machine-local — súbory v ~/.claude/projects/<projekt>/memory/ nie sú nikam synchronizované. Ak chcete pamäť zdieľať medzi zariadeniami alebo s kolegom, použite Obsidian vault verzionovaný v Git repozitári, alebo synchronizovaný cez Dropbox, iCloud či Obsidian Sync.
Môžem Obsidian vault zdieľať s celým tímom?
Áno. Najčastejším setupom je commitnúť vault (alebo aspoň CLAUDE.md a Context/ priečinok) do Git repozitára. Každý člen tímu má potom rovnaký východiskový kontext pre Claude Code. Osobné poznámky v Daily/ alebo CLAUDE.local.md sa typicky pridávajú do .gitignore.
Aké modely podporujú perzistentnú pamäť?
Auto memory funguje s každým modelom, ktorý beží cez Claude Code (Sonnet, Opus, Haiku) od verzie v2.1.59 vyššie. Obsidian setup je úplne nezávislý od modelu — funguje rovnako s Claudom, ako by fungoval s GPT cez OpenAI Codex CLI alebo Gemini CLI, lebo všetky tieto agenti vedia čítať Markdown.
Stratím pamäť po /compact príkaze?
Nie pri CLAUDE.md v koreni projektu — Claude ho po kompakcii znovu načíta z disku. Vnorené CLAUDE.md v podpriečinkoch sa však neaktívne nereinjektnú, takže ak ich potrebujete, otvorte súbor v podpriečinku a Claude ich znovu načíta. Auto memory MEMORY.md sa pri kompakcii nereinjektne automaticky, ale ostáva uložené na disku a Claude si ho prečíta hneď, ako mu to napadne.
Odporúčame prečítať
Sledujte, ako AI vyhľadávače citujú váš web
Vyskúšajte Optimalizáciu pre AI zadarmo