Claude Code po 30 dneh izbriše zgodovino: kako jo shraniti

Za pomoč pri uporabi storitve si oglejte dokumentacijo Ailoot.

Ali Claude Code res izbriše zgodovino sej?#

Odprete Claude Code, da bi nadaljevali sejo izpred dveh mesecev — vendar je ni več. Datoteka je bila v celoti izbrisana z diska. To ni napaka ali redek hrošč: tako deluje privzeti mehanizem čiščenja.

Čiščenje nadzira ena nastavitev: cleanupPeriodDays. Njena privzeta vrednost je 30. Vsakič, ko se Claude Code zažene, pregleda mapo z zgodovino in izbriše vse, kar je starejše od tega obdobja. Te nastavitve v moji datoteki ~/.claude/settings.json sploh ni bilo, kar pomeni, da je veljala privzeta vrednost, nekatere moje starejše seje pa so že izginile.

V Anthropicovem repozitoriju je odprtih več prijav napak v zvezi s tem, vendar ni bila odpravljena nobena.

Kje Claude Code shranjuje zgodovino sej?#

Svojo zgodovino preprosto najdete. Odprite terminal in si oglejte vsebino mape:

ls ~/.claude/projects/

Vsaka podmapa je ločen projekt. Njeno ime kodira pot: projekt v /Users/alex/dev/shop na primer postane mapa -Users-alex-dev-shop. V njej so datoteke sej:

ls -lt ~/.claude/projects/-Users-alex-dev-shop/
# 3f8a1c2e-....jsonl   ← ena seja = ena datoteka
# a91b7d40-....jsonl

Vsaka datoteka .jsonl je dnevnik po vrsticah: ena vrstica predstavlja en dogodek seje. Vsebuje več kot le besedilo pogovora. Shranjuje logiko vaših odločitev: zakaj ste izbrali določeno strukturo baze podatkov, katere možnosti ste zavrnili, kje se je Claude zmotil in kako ste napako odpravili.

V bistvu gre za dnevnik razvoja projekta. Zato je izguba tako boleča: ne izgubite »klepeta«, temveč kontekst, ki ste ga gradili več tednov. O strukturi tega konteksta sem pisal v vodniku »Claude Memory vs. CLAUDE.md«.

Zakaj Anthropic po 30 dneh izbriše prepise?#

Za brisanje obstaja razlog, ki ga je vredno razumeti, preden ga povsem izklopite. Prepis je navadno besedilo. Če je Claude med sejo prebral datoteko .env, vstavil ključ v ukaz ali pa ste v poziv prilepili geslo, se je vse to shranilo v .jsonl kot navadno besedilo. Dlje ko taka datoteka ostane na disku, večja je možnost, da bo nekega dne prišlo do uhajanja podatkov.

Anthropic to pove naravnost: prepisi lahko vsebujejo izvorno kodo, poverilnice in drugo občutljivo gradivo, njihova hramba na disku dlje, kot je potrebno, pa pomeni resnično tveganje za zasebnost. Obdobje 30 dni je bilo izbrano kot kompromis.

Pomisleki skupnosti se nanašajo na tri stvari: brisanje je tiho (med nastavitvijo ali zagonom ni opozorila), ni soglasja (nihče vas ne vpraša) in ni obnovitve (datoteke ne gredo v koš in ni povrnitve). V prijavi #59248 razvijalci prosijo za eno stvar: pravičnejše čiščenje — opozorilo, obdobje za obnovitev in manj agresivno privzeto obdobje.

Zakaj lahko varnostna kopija sama sproži brisanje?#

To je najtežji del in tu se ujamejo ljudje, ki skušajo sami zaščititi svoje podatke. Čiščenje upošteva mtime, časovni žig zadnje spremembe datoteke. Predpostavlja, da mtime odraža, kdaj ste nazadnje delali v seji. V praksi lahko mtime spremeni kar koli: odjemalec za sinhronizacijo Dropbox ali iCloud, rsync, protivirusna programska oprema, indeksator ali vaš skript za varnostno kopiranje.

Tu je past. Odločite se, da boste shranili svojo zgodovino, in nastavite sinhronizacijo v oblak za ~/.claude/projects/. V nekem trenutku storitev za sinhronizacijo prepiše datoteko in njen mtime nastavi na starejši datum (to se lahko zgodi pri obnovitvi iz kopije v oblaku). Claude Code ob zagonu zazna »staro« datoteko in jo izbriše. Želeli ste jo shraniti, a ste pospešili njeno izbrisanje.

Sklep je samo eden: varnostna kopija mora biti zunaj mape ~/.claude/projects/. Čiščenje deluje samo znotraj te mape. Kopija, shranjena zunaj nje, je zunaj njegovega dosega. Rešitev bom zasnoval na tem načelu.

Kako lahko takoj ustavite brisanje zgodovine?#

Brisanje ustavite v treh korakih:

1. Odprite datoteko z nastavitvami: ~/.claude/settings.json (če datoteka ne obstaja, jo ustvarite).
2. Dodajte nastavitev cleanupPeriodDays z veliko vrednostjo:

{
  "cleanupPeriodDays": 3650
}

3. Shranite datoteko. Nastavitev bo začela veljati ob naslednjem zagonu Claude Code.

Vrednost 3650 pomeni deset let: v praksi se brisanje ne bo več izvajalo. Če želite čiščenje ohraniti, vendar dovoliti daljše obdobje, nastavite vrednost na 365 (eno leto); izginile bodo samo seje, starejše od enega leta. Ali je bila nastavitev upoštevana, lahko preverite s tem ukazom:

grep cleanupPeriodDays ~/.claude/settings.json

Ena pomembna podrobnost, ki jo je lahko spregledati: podaljšanje obdobja NE obnovi že izbrisanih podatkov. Čiščenje se izvede ob zagonu in vse, kar je bilo izbrisano v prejšnjih zagonih, je za vedno izgubljeno. Zato to nastavite najprej — s tem preprečite prihodnje izgube, ne povrnete pa že izbrisanih podatkov. Če se želite izogniti izgubi zgodovine Claude Code in projekta zaradi nenamernega ukaza, si oglejte vodnik »Kako nastaviti Claude Code, da ne bo poškodoval vašega projekta«.

Zgodovina vaših sej je del drugega možganja projekta: vsebuje logiko odločitev, ki je niste zabeležili nikjer drugje. cleanupPeriodDays ohrani datoteke, vendar jih ne spremeni v sistem, ki bi vam omogočal, da čez šest mesecev poiščete, kar potrebujete.

Kako samodejno arhivirati zgodovino zunaj mape čiščenja?#

Ideja je preprosta: pustite Claude Code, da s svojo mapo počne, kar želi, vi pa hranite ločen arhiv zunaj nje. Arhiv je zaščiten pred tem mehanizmom čiščenja, vendar se še vedno lahko izgubi zaradi odpovedi diska, nenamernega brisanja ali neuspele kopije. Nastavite ga takole:

1. Ustvarite mapo za arhiv zunaj upravljanega imenika:

mkdir -p ~/claude-history-archive

2. Tja kopirajte trenutno zgodovino. Zastavica -a ohrani strukturo in časovne žige; --ignore-existing pusti že kopirane datoteke nedotaknjene:

rsync -a ~/.claude/projects/ ~/claude-history-archive/

3. Avtomatizirajte vsakodnevno izvajanje. V macOS uporabite launchd. Ustvarite datoteko ~/Library/LaunchAgents/com.example.claudearchive.plist:

<?xml version="1.0" encoding="UTF-8"?>
<plist version="1.0">
<dict>
  <key>Label</key>
  <string>com.example.claudearchive</string>
  <key>ProgramArguments</key>
  <array>
    <string>/usr/bin/rsync</string>
    <string>-a</string>
    <string>/Users/YOUR_NAME/.claude/projects/</string>
    <string>/Users/YOUR_NAME/claude-history-archive/</string>
  </array>
  <key>StartInterval</key>
  <integer>86400</integer>
</dict>
</plist>

4. Naložite agenta, da bo deloval v ozadju:

launchctl load ~/Library/LaunchAgents/com.example.claudearchive.plist

V Linuxu enako storite z eno vrstico v crontabu (crontab -e):

0 3 * * * rsync -a ~/.claude/projects/ ~/claude-history-archive/

Zakaj to deluje, medtem ko sinhronizacija iz prejšnjega razdelka ne? Arhiv je ZUNAJ mape ~/.claude/projects/, zato ga čiščenje sploh ne more videti. Kopiranje poteka samo v eno smer (iz aktivne mape v arhiv), mtime aktivnih datotek pa se ne spreminja — zato do napake z mtime ne pride. Tudi če Claude Code jutri izbriše sejo iz svoje mape, bo njena kopija ostala v arhivu.

Kako lahko arhiv sej spremenite v iskalno drugo možganstvo?#

Samo kopičenje datotek ni dovolj — do njih morate imeti dostop. Arhiv lahko spremenite v uporabno orodje v dveh korakih.

Najprej ga različicite z gitom. V mapi za arhiv inicializirajte repozitorij:

cd ~/claude-history-archive
git init
git add -A && git commit -m "Prvi posnetek zgodovine Claude Code"

V isto dnevno opravilo kot rsync dodajte git add -A && git commit. Zdaj imate zgodovino različic: vidite lahko, kaj se je pojavilo in kdaj, ter z enim ukazom razveljavite nenamerno prepisovanje.

Drugič, iščite. Datoteke .jsonl so JSON, razdeljen po vrsticah, zato lahko uporabite znana orodja. Poiščite, v kateri seji je bila obravnavana določena tema:

grep -rl "selitev baze podatkov" ~/claude-history-archive/

Iz seje pridobite samo besedilo svojih pozivov (z uporabo jq, saj gre za JSON):

jq -r 'select(.type=="user") | .message.content' session.jsonl

Na tej točki začne zgodovina sej delovati kot drugo možganstvo projekta: kot zbirka podatkov, v kateri lahko v nekaj sekundah poiščete »kako smo se o tem odločili marca«. Za ločen pregled tega, kam gre kontekst v seji in kako ga upravljati, si oglejte »Kam gredo tokeni v Claude Code«.

Ali lahko obnovite že izbrisane seje?#

Pošten odgovor: verjetno ne. Claude Code nima funkcije za obnovitev, koša ali dnevnika razveljavitev za izbrisane prepise. Datoteka preprosto izgine z diska.

Obstaja ena možnost: varnostne kopije sistema, če so bile vnaprej omogočene:

1. macOS Time Machine — če je posnetek zajel ~/.claude/projects/ pred brisanjem, lahko datoteko pridobite iz varnostne kopije za želeni datum.
2. Zgodovina različic OneDrive / Dropbox — če se je mapa sinhronizirala z omogočenim shranjevanjem različic, poiščite datoteko v zgodovini različic v oblaku (vendar ne pozabite na past z mtime: sinhronizacija je lahko sprožila tudi brisanje).
3. Ročne kopije — kateri koli rsync/cp, ki ste ga ročno zagnali in kopiral datoteke nekam zunaj upravljane mape.

Če nič od tega ni obstajalo, je seja izgubljena. In to ni redkost: enemu avtorju napake v Anthropicovem repozitoriju je bilo poškodovanih 26 od 38 zapisov, kar je predstavljalo več mesecev dela. Edina zanesljiva zaščita je tista, ki je vzpostavljena PRED izgubo. Nastavite cleanupPeriodDays in samodejno arhiviranje še danes, dokler je še kaj za rešiti.

Katero vrednost izbrati za cleanupPeriodDays?#

Nastavitev je ena, vendar ima lahko več pomenov. Primerjajte možnosti in izberite tisto, ki ustreza vaši uporabi:

Pomembno varnostno opozorilo: če nastavite 3650 in obdržite vse, se strinjate s shranjevanjem prepisov na disku, ki lahko vsebujejo ključe in kodo. To je zavesten kompromis: priročnost arhiva proti tveganju. Zmanjšajte tveganje: arhiv hranite na šifriranem disku (FileVault v macOS), ne shranjujte ga v javnem oblaku in ga ne oddajte v javni repozitorij git. Pripravil sem ločen vodnik o tem, kateri podatki lahko uidejo prek Claude Code: »Varnost podatkov v Claude Code«.

Kaj storiti danes: kontrolni seznam#

Zaščito nastavite po korakih:

1. V datoteki ~/.claude/settings.json nastavite cleanupPeriodDays: 3650 — brisanje ste ustavili.
2. Ustvarite ~/claude-history-archive zunaj upravljane mape in prvič zaženite rsync -a.
3. Načrtujte vsakodnevno izvajanje z launchd (macOS) ali cron (Linux).
4. V arhivu inicializirajte git in istemu opravilu dodajte git add -A && git commit.
5. Preverite, ali je arhiv na šifriranem disku in se ne sinhronizira z javnim oblakom.
6. Pri vsaki načrtovani izvedbi preverite uspešno kopiranje, nato preglejte nedavno arhivirano sejo in redno obnovite vzorec v ločeno začasno mapo ter preverite berljivost.
7. Če želite zaščito pred izgubo naprave ali diska, hranite neodvisno shranjeno varnostno kopijo z ustreznim nadzorom dostopa in preizkusite tudi njeno obnovo. Zgodovina Git na istem disku ni neodvisna varnostna kopija.

Zgodovina sej je le ena od plasti konteksta, zaradi katerih je Claude zanesljiv.

Spoznajte Ailoot.