Claude Code-sessie hervatten en geschiedenis vinden
Lees hoe u een Claude Code-sessie hervat met --continue, --resume of /resume en waar de platte teksttranscripten lokaal worden opgeslagen.
Hoe hervat u een Claude Code-sessie
Om een Claude Code-sessie te hervatten, voert u claude --continue uit voor het meest recente gesprek in de huidige map, of claude --resume om een ouder gesprek uit een lijst te kiezen. Vanuit een actieve sessie schakelt het commando /resume u naar een ander gesprek zonder de sessie te beëindigen. De korte vormen zijn -c en -r.
claude --continue
claude --resume
claude --resume auth-refactorAls u de sessienaam of het ID al kent, geeft u dit op als argument. Claude Code gaat dan direct naar die sessie zonder de keuzelijst te tonen.
Alles hieronder komt overeen met de officiële sessiedocumentatie van november 2026. Claude Code brengt regelmatig updates uit en vlaggen of sneltoetsen kunnen tussen versies wijzigen. Beschouw daarom claude --help en die pagina als de bron van waarheid wanneer iets hier niet overeenkomt met wat uw terminal toont.
Wat een sessie daadwerkelijk is
Een sessie is één opgeslagen gesprek dat aan een projectdirectory is gekoppeld. De sessie bevat de volledige berichtgeschiedenis, inclusief de tool-aanroepen die Claude heeft gedaan en de resultaten daarvan. Claude Code schrijft deze gegevens voortdurend naar schijf terwijl u werkt, en niet pas aan het einde. Daardoor blijft een gesprek behouden wanneer u de terminal sluit of de SSH-verbinding verliest.
Hervatten herstelt meer dan alleen de tekst. De volledige gesprekgeschiedenis komt terug, samen met het model dat de sessie gebruikte en de subagent waarmee de sessie is gestart, als u --agent hebt gebruikt. Ook de machtigingsmodus wordt hersteld wanneer u vanuit de shell hervat met --continue of een sessie-ID. Er is één veiligheidsuitzondering: de modus bypass-permissions wordt nooit hersteld. Een sessie die in deze modus eindigde, wordt daarom hervat in de modus waarmee een nieuwe sessie zou starten. De planmodus wordt wel hersteld, ook wanneer u de sessie selecteert in de kiezer of ernaar overschakelt met /resume. Deze twee routes nemen anders geen opgeslagen modus over. Hervatten vanuit de terminal herstelt de planmodus sinds v2.1.290. De kiezer en /resume doen dit sinds v2.1.292. In eerdere releases ging de planmodus bij hervatten eveneens verloren. Vanuit de shell overschrijft --permission-mode de modus die wordt hersteld.
Sommige zaken komen niet terug, omdat het flags bij het starten waren en geen opgeslagen status. Directories die met --add-dir zijn toegevoegd en opties zoals --mcp-config, --settings en --plugin-dir moet u opnieuw doorgeven wanneer u hervat. Instellingenbestanden zoals settings.json worden bij het starten opnieuw ingelezen. Wat daarin staat, hoeft u dus niet opnieuw op te geven. Hetzelfde geldt voor inloggegevens. Claude Code bepaalt bij het starten hoe het zich authenticeert, op basis van uw login en omgeving. De gegevens worden niet samen met het gesprek hersteld. Als in de shell op een VPS bijvoorbeeld ongemerkt ANTHROPIC_API_KEY is ingesteld, krijgt u bij het hervatten de foutmelding voor een ongeldige API-sleutel, ook als de sessie de vorige keer wel goed werkte.
Waarom sessiegeschiedenis belangrijker is op een VPS
Dit is het feit dat mensen vaak verrast. Het transcript wordt geschreven op de machine waar de agent werd uitgevoerd. Het wordt niet in uw account bewaard en niet gesynchroniseerd met een cloud. Het is een bestand op de schijf van die specifieke machine.
Een sessie die u in een tmux-venster op uw VPS hebt achtergelaten, verschijnt dus niet in de kiezer op uw laptop, en een sessie vanaf uw laptop verschijnt niet op de VPS. Er wordt niets tussen deze apparaten uitgewisseld. Als u werkt zoals de meeste mensen wanneer u Claude Code in tmux op een VPS uitvoert, is de server de plek waar uw werkelijke gespreksgeschiedenis zich ophoopt, en toont de kiezer die u lokaal ziet een andere en veel kleinere set.
Dezelfde splitsing geldt voor verschillende interfaces. De desktop-app en de VS Code-extensie houden elk hun eigen sessiegeschiedenis bij, en geen van beide is de geschiedenis van de CLI, hoewel de desktop-app ook een CLI-sessie kan hervatten. Claude Code op het web houdt eveneens een eigen geschiedenis bij. Cowork bevindt zich nog verder daarbuiten: de sessies daarvan draaien standaard in de cloud van Anthropic en worden opgeslagen in uw Claude-account in plaats van op hardware die u bezit, waarbij lokale uitvoering alleen behouden blijft voor bestaande desktop-implementaties. Dus als u Cowork afweegt tegen Claude Code, is de locatie waar het transcript terechtkomt onderdeel van de beslissing.
Binnen één machine is de zoekopdracht breder dan u wellicht verwacht. claude --resume <session-id> zoekt eerst in de huidige projectmap en de bijbehorende git-worktrees, en vervolgens in elk ander project op die machine. De zinsnede die u moet onthouden is "op die machine". Een sessie-ID van een andere host levert niets op, en Claude Code meldt dit aan u met No conversation found with session ID: <session-id>.
Waar slaat Claude Code de sessiegeschiedenis op
Standaard bevinden transcripten zich in uw Claude Code-configuratiemap, op een pad van de vorm ~/.claude/projects/<project>/<session-id>.jsonl.
<project> is het pad van uw werkmap waarbij elk niet-alfanumeriek teken is vervangen door een koppelteken. Een sessie die is gestart in /home/deploy/apps/api wordt dus opgeslagen in een map met de naam -home-deploy-apps-api. Als deze geconverteerde naam langer zou zijn dan 200 tekens, kort Claude Code deze in en voegt een hash van het volledige pad toe, zodat de mapnaam binnen de limieten van het bestandssysteem blijft.
Het bestand is JSONL: één JSON-object per regel. Elke regel bevat een bericht, een toolgebruik of het resultaat daarvan, een verslag van een verzoek dat Claude Code naar het model stuurde, of een metagegeven-item. Het is leesbare tekst en het is toegestaan om deze te lezen.
Het schrijven van een parser hiervoor is niet toegestaan. Het formaat van de items is intern aan Claude Code en verandert tussen versies. Een script dat deze bestanden direct leest, kan dus bij elke update defect raken. De documentatie van Anthropic zelf adviseert om /export of de gedocumenteerde scriptinterfaces te gebruiken, wat om precies die reden een goed advies is.
Twee instellingen veranderen de uitgangspunten. CLAUDE_CONFIG_DIR verplaatst de volledige configuratiemap; dit is hoe u transcripten op een apart of versleuteld volume plaatst. cleanupPeriodDays in settings.json bepaalt hoe lang ze worden bewaard. De standaardwaarde is 30 dagen, met een minimum van 1.
Wat staat er precies in die transcriptbestanden
Elk resultaat van een tool wordt vastgelegd, wat betekent dat een transcript de inhoud bevat van bestanden die Claude heeft gelezen en de output van commando's die Claude heeft uitgevoerd. De pagina over datagebruik van Anthropic stelt het duidelijk: Claude Code slaat sessietranscripts lokaal op als platte tekst in ~/.claude/projects/. Omdat het transcript ook vastlegt wat Claude Code naar het model verstuurt, kan het de systeemprompt, tooldefinities, requestparameters en de geladen CLAUDE.md-bestanden bevatten.
Denk na over wat dit betekent op een server. Als Claude een .env-bestand heeft gelezen om te achterhalen waarom een service niet wilde starten, staat de inhoud van dat bestand nu in een JSONL-bestand in uw homedirectory. Als een commando een connection string toonde, staat die string daar ook in. Er is geen sprake van een lek. Het transcript heeft vastgelegd wat er is gebeurd, wat precies het doel ervan is, en dat is de reden waarom het onderdeel moet zijn van uw dreigingsmodel.
- Back-ups: een standaard back-up van
/homeof/rootkopieert uw transcripts naar de locatie waar back-ups worden opgeslagen. Voeg een uitsluiting toe, of accepteer dat kopieën van uw prompts en de inhoud van uw bestanden nu in uw back-upopslag staan. - Snapshots en images: een VPS-snapshot die om welke reden dan ook wordt gemaakt, bevat de volledige directory. Dat geldt ook voor een image die u kloont om een tweede server op te bouwen.
- Andere accounts op de server: controleer de rechten zelf met
ls -ld ~/.claude ~/.claude/projectsin plaats van ervan uit te gaan dat deze strikt zijn. - Bewuste uploads: het
/feedback-commando verstuurt gespreksgeschiedenis doelbewust naar Anthropic, en/bugen/sharerapporteren via hetzelfde pad. Het feedbackvenster kan ook andere sessies van hetzelfde project van de afgelopen 24 uur of 7 dagen bevatten, niet alleen de huidige sessie. Dit zijn acties waar u zelf voor kiest, dus wees u bewust van waar u mee akkoord gaat voordat u bevestigt.
Als u liever heeft dat er geen transcript wordt aangemaakt, onderdrukt CLAUDE_CODE_SKIP_PROMPT_HISTORY het schrijven van transcripts, en --no-session-persistence onderdrukt ze voor een enkele niet-interactieve claude -p-run. Wees u bewust van de consequenties voordat u een van beide instelt. Transcripts worden gebruikt door de resume-functie, dus geen transcript betekent geen mogelijkheid tot hervatten.
Hoe vindt u een oude conversatie
Open de kiezer met claude --resume, of vanuit een actieve sessie met /resume. Elke rij toont de sessienaam als u deze heeft ingesteld, of een gegenereerde titel als u dat niet heeft gedaan, samen met de tijd sinds de laatste activiteit, de git-branch en de bestandsgrootte.
De kiezer ondersteunt zoekopdrachten. Druk op /, of begin direct met typen, om de lijst te filteren. De sneltoetsen die de zoekopdracht verbreden zijn het meest nuttig: Ctrl+A toont sessies van elk project op deze machine, Ctrl+W toont elke worktree van de huidige repository, en Ctrl+B filtert op de huidige git-branch. Druk op Space om een voorbeeld van de inhoud van een sessie te bekijken voordat u deze opent, en op Ctrl+R om de geselecteerde sessie te hernoemen.
Het benoemen van sessies maakt dit proces aanzienlijk eenvoudiger. Start een sessie met claude -n auth-refactor, of voer /rename auth-refactor uit tijdens een sessie, op het moment dat u merkt dat de conversatie uitmondt in serieus werk. Een benoemde sessie kan vervolgens direct vanuit de shell op naam worden hervat.
Een naamloze sessie krijgt nog steeds een gegenereerde titel, geschreven door een achtergrondverzoek aan een klein, snel model dat uw eerste prompt samenvat. Die titel helpt u de rij in de kiezer te herkennen en werkt ook als een handle om de sessie te hervatten: claude --resume lost deze op dezelfde manier op als een door u ingestelde naam. Wat niet werkt, is de standaard weergavenaam, zoals my-app-3f, die een naamloze interactieve sessie in lijsten met actieve sessies draagt. Geef deze door aan claude --resume en Claude Code zal de sessie niet vinden.
Transcripts doorzoeken om de juiste sessie te vinden
Soms herinnert u zich alleen een specifieke zin. Omdat de transcripts uit tekst bestaan, kunt u deze doorzoeken.
grep -rl "nftables" ~/.claude/projects/Dit commando toont de paden van de overeenkomende transcripts. De bestandsnaam zonder de .jsonl-extensie is het sessie-ID, en claude --resume <session-id> accepteert dit ID. claude --resume accepteert ook direct het absolute pad van het transcript. Gebruik grep om te bepalen welke sessie u nodig heeft, en hervat of exporteer deze vervolgens om de inhoud te lezen.
Twee belangrijke kanttekeningen. De inhoud is JSON-geëscaped; een zin die aanhalingstekens bevat of over een regeleinde is gesplitst, komt mogelijk niet overeen als letterlijke tekenreeks. Bovendien betekent een treffer in een toolresultaat dat Claude die tekst heeft gezien, niet dat iemand deze zelf heeft ingevoerd.
Een conversatie lezen en exporteren
/export geeft de huidige conversatie weer als platte tekst, waarbij berichten en tool-output leesbaar worden uitgeschreven in plaats van als JSON. Zonder argument opent het een menu met de optie om naar het klembord of een bestand te kopiëren. Met een bestandsnaam schrijft /export handover.txt direct naar dat pad. Dit is de juiste manier om een conversatie van een server naar uw laptop te verplaatsen of om deze toe te voegen aan een ticket.
Gebruik voor geautomatiseerde taken de interfaces die bedoeld zijn om stabiel te blijven. Hooks en statusregelcommando's ontvangen een transcript_path-veld als input, waardoor een SessionEnd-hook een transcript kan archiveren wanneer een sessie eindigt. U kunt ook een vraag stellen aan een opgeslagen sessie zonder deze te openen:
claude -p --resume <session-id> --output-format json "summarize what we changed" | jq -r '.result'Dit verstuurt een vervolgprompt naar de oude conversatie en retourneert gestructureerde JSON. Dit is een veel betere basis dan het parsen van een JSONL-formaat dat in een volgende release kan wijzigen.
Wanneer een nieuwe sessie starten beter is dan hervatten
Hervatten brengt de volledige geschiedenis terug, en die volledige geschiedenis wordt bij elk volgend verzoek meegestuurd. Een gesprek dat gisteren vier uur duurde, is vandaag kostbaar om voort te zetten, en hoe tokenverbruik oploopt tijdens een lange sessie legt uit waar die kosten vandaan komen.
Claude Code kiest soms een tussenweg voor u. Als u een lang gesprek in een interactieve terminalsessie onbeheerd achterlaat en het gebruikmaakt van de prompt-cache van één uur — wat een Claude-abonnement standaard biedt voor het hoofdgesprek binnen uw abonnementslimieten — dan voert de inactieve compactie na ongeveer 54 minuten een verkleining uit, kort voordat de cache verloopt. Dit gebeurt zodra de context van het gesprek een token-drempelwaarde bereikt (standaard 200.000), mits automatische compactie is ingeschakeld en de machine op dat moment actief is. Vóór v2.1.314 moest Claude Code hiervoor ook feature-flags ophalen bij Anthropic, waardoor abonnees met uitgeschakelde telemetrie deze functie niet kregen; sinds v2.1.314 werkt dit ook voor hen, evenals in het chatpaneel van de VS Code-extensie en het tabblad Code in de desktop-app. Er wordt vooraf geen toestemming gevraagd. Wanneer u terugkeert, toont het gesprek een regel die begint met Compacted while idle, before the prompt cache expired, en uw volgende bericht verstuurt een samenvatting in plaats van de volledige geschiedenis.
- Laat het ingeschakeld en latere verzoeken zijn goedkoper, maar alles wat door de samenvatting is weggelaten, is niet langer beschikbaar. U kunt de drempelwaarde verlagen met
CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS, hoewel waarden onder 100.000 worden verhoogd naar 100.000. - Schakel het uit door
idleCompactionin te stellen opfalseinsettings.json, of via de rij Idle compaction in/configvanaf v2.1.302 of later. Het gesprek blijft dan volledig, tegen kosten per verzoek die schalen met de omvang van het gesprek. Als de cache is verlopen tegen de tijd dat u uw volgende bericht verstuurt, verwerkt dat verzoek de volledige geschiedenis eenmalig opnieuw.
Op Pro- en Max-abonnementen voegde v2.1.304 een extra controle toe, en de huidige documentatie vermeldt ook Ultra-abonnementen. Wanneer u een lang gesprek hervat na een lange pauze, of op een ander model, en dit een aanzienlijk deel van uw gebruikslimiet van 5 uur zou verbruiken, toont een Resume this conversation?-dialoogvenster dat geschatte aandeel. U kunt vervolgens alsnog hervatten of een nieuw gesprek starten. Wanneer de optie voor een nieuw gesprek dit aangeeft, kan Claude het vorige gesprek raadplegen als u ernaar verwijst.
De afweging is eenvoudiger dan het lijkt. Hervat het gesprek wanneer het volgende dat u wilt typen afhankelijk is van wat er al is gezegd. Start een nieuwe sessie wanneer dat niet het geval is. Afwijkingen zijn gemakkelijk te herkennen als u erop let: Claude verwijst naar een bestand dat u een uur geleden hebt verwijderd, of voert opnieuw een discussie over een besluit dat u aan het begin van de sessie al had genomen. Dat is verouderde context, en het meeslepen daarvan kost u zowel tokens als nauwkeurigheid.
Als het nuttige deel van een oud gesprek een besluit of een feit is dat u opnieuw nodig zult hebben, vertrouw er dan niet op dat hervatten dit behoudt. Noteer het op een plek waar elke sessie het kan zien; daar zijn Claude Code's geheugenbestanden voor bedoeld.
/branch is hier ook nuttig om te kennen. Het kopieert het gesprek tot het huidige punt en schakelt over naar de kopie, waarbij het origineel intact blijft en beschikbaar in de kiezer. Gebruik dit om een tweede aanpak te proberen zonder de eerste te verliezen.
Verschil tussen hervatten, compactie en geheugen
Deze begrippen worden constant verward, terwijl ze verschillende problemen oplossen.
Hervatten gaat over het terugkrijgen van een conversatie nadat u deze heeft verlaten, het systeem opnieuw heeft opgestart of bent overgeschakeld naar een andere taak. Compactie heeft betrekking op het contextvenster binnen een actieve conversatie: /compact vervangt wat Claude bij zich draagt door een samenvatting, zodat latere verzoeken minder tokens verbruiken. Als uw probleem is dat het contextvenster vol is, is compactie het juiste hulpmiddel, en het beheren van het Claude Code-contextvenster behandelt dit uitgebreid.
Geheugen is weer iets anders. CLAUDE.md-bestanden en automatisch geheugen bevatten instructies en feiten die aan het begin van elke sessie worden geladen; het is dus geen conversatie waar u naar terugkeert. Het is informatie die u vastlegt zodat u nooit meer naar een specifieke sessie hoeft terug te keren.
Als u twee conversaties tegelijkertijd wilt laten draaien en deze wilt coördineren, is dat een afzonderlijk mechanisme. Claude Code-sessies kunnen elkaar berichten sturen terwijl beide actief zijn; dit is een ander probleem dan het ophalen van de sessie van gisteren vanaf de schijf.
FAQ
Waar slaat Claude Code mijn sessiegeschiedenis op?
Standaard onder uw configuratiemap, op ~/.claude/projects/<project>/<session-id>.jsonl, waarbij <project> het pad naar de werkmap is met niet-alfanumerieke tekens vervangen door koppeltekens. Elk bestand is JSONL: één JSON-object per regel voor een bericht, een toolgebruik of het resultaat daarvan, een record van een verzoek dat naar het model is verzonden, of een metagegeven-item. CLAUDE_CONFIG_DIR verplaatst de configuratiemap naar een andere locatie, en cleanupPeriodDays in settings.json stelt in hoe lang transcripten worden bewaard, met een standaard van 30 dagen en een minimum van 1.
Waarom zie ik mijn VPS-sessie niet in de kiezer op mijn laptop?
Omdat transcripten worden geschreven naar de schijf van de machine waar de agent werd uitgevoerd, en er geen synchronisatie tussen machines plaatsvindt. Een gesprek dat u voerde binnen tmux op uw VPS bestaat alleen op de VPS. Hervat het daar via SSH, of voer /export uit binnen de sessie en kopieer het tekstbestand als u een lokaal record wilt hebben.
Kan ik een sessie hervatten die ik in een andere map ben gestart?
Ja, als u het sessie-ID heeft. claude --resume <session-id> zoekt eerst in de huidige projectmap en de bijbehorende git-worktrees, en vervolgens in elk ander project op dezelfde machine. Binnen de kiezer verbreedt Ctrl+A de lijst naar elk project op de machine en verbreedt Ctrl+W deze naar elke worktree van de huidige repository. Als er geen overeenkomst wordt gevonden, meldt Claude Code No conversation found with session ID: <session-id>.
Moet ik een oude sessie hervatten of een nieuwe starten?
Hervat een sessie wanneer uw volgende bericht afhankelijk is van wat er al in dat gesprek is gezegd. Start een nieuwe sessie wanneer dit niet het geval is, omdat het hervatten de volledige geschiedenis opnieuw inlaadt en elk daaropvolgend verzoek deze geschiedenis meedraagt. Let op voor drift: een sessie die blijft verwijzen naar bestanden die u al heeft verwijderd, bevat verouderde context, en die context kost u tokens en nauwkeurigheid bij elke beurt.
Kan ik voorkomen dat Claude Code transcripten naar de schijf schrijft?
Ja. CLAUDE_CODE_SKIP_PROMPT_HISTORY onderdrukt het schrijven van transcripten, en --no-session-persistence onderdrukt dit voor een enkele niet-interactieve claude -p-run. Begrijp eerst de consequenties, want transcripten zijn wat de hervattingsfunctie leest; het uitschakelen ervan betekent dus dat --continue en --resume niets hebben om te laden. Als uw zorg de locatie van de bestanden is in plaats van het feit dat ze bestaan, wijs CLAUDE_CONFIG_DIR dan naar een versleuteld volume en verlaag in plaats daarvan cleanupPeriodDays.