Terug naar Woordenboek
intermediateTechnisch
3 min leestijd

Checkpoints

Checkpoints & Rewind (AI-codeertools)

Dennis ClaassenDoor Dennis Claassen · Laatst bijgewerkt feb 2026

Simpele Uitleg

Checkpoints zijn automatische momentopnames van je code en gesprek waar een AI-codeertool naar terug kan springen — zodat één foute edit nooit je hele werk sloopt. Zie het als een undo-knop voor AI-agents: de tool bewaart de staat vóór elke wijziging, dus als de AI de verkeerde kant op gaat, draai je in één handeling alles terug in plaats van elke aanpassing handmatig te ontwarren. Het terugkeren heet meestal rewind of revert. Het is het vangnet dat experimenteren veilig maakt: probeer een aanpak, bevalt het niet, spring terug.

Technische Definitie

Een checkpoint is een opgeslagen projectstaat (snapshot) waar een agentic tool naartoe kan terugkeren via een rewind of revert. In Claude Code heet de feature officieel "Checkpoints" / "checkpointing"; terugkeren doe je via /rewind of door tweemaal Esc te drukken, met herstel van code, gesprek of beide. De Claude Agent SDK biedt programmatische file checkpointing (enable_file_checkpointing, rewind_files()). Windsurf Cascade gebruikt "Named Checkpoints and Reverts". Anders dan Git worktrees zijn checkpoints vluchtig en sessiegebonden, geen branches.

Waarom Dit Belangrijk Is

Wat gebeurt er als een AI-agent in één beurt tien bestanden tegelijk verkeerd aanpast? Zonder checkpoints zit je elke wijziging handmatig terug te draaien. Met checkpoints klik je één keer en ben je terug bij hoe het wás.

Dat verandert hoe je werkt. Je durft de AI grotere, riskantere taken te geven, want de weg terug is altijd open — "fearless" experimenteren. Mislukt een aanpak, dan spring je terug en probeer je iets anders, zonder schade.

Belangrijk: het is een vangnet bovenop versiebeheer, geen vervanging. Anthropic adviseert checkpoints expliciet samen met Git te gebruiken. In een goede AI-codeerworkflow combineer je checkpoints, Git en worktrees tot een veilig geheel.

Hoe Het Werkt

De tool maakt automatisch een momentopname vóór elke wijziging — geen instelling nodig. In Claude Code open je het menu met /rewind of door tweemaal Esc te drukken (bij een leeg invoerveld). Je kiest dan wat je terugzet: alleen de code, alleen het gesprek, of beide.

Let op de scope. Checkpoints dekken alleen de edits die de AI maakt via de Write-, Edit- en NotebookEdit-tools. Je eigen handmatige wijzigingen en Bash-commando's (zoals echo of sed) worden niet getrackt. Daarom is Git je echte vangnet.

In de Agent SDK herstelt rewind alleen bestanden op schijf — het gesprek en de context blijven intact. Andere tools werken anders: Windsurf Cascade laat je een checkpoint een naam geven en terugzetten via een revert-pijl, maar daar is een revert onomkeerbaar — dus voorzichtig.

Use Cases

Risicovolle refactor veilig terugdraaien

Je laat de AI een grote refactor uitvoeren over meerdere bestanden. Het loopt mis. In plaats van elke edit te ontwarren, typ je /rewind, kies je het checkpoint van vóór de refactor en ben je in één klik terug.

Meerdere aanpakken vergelijken

Probeer een implementatie, bekijk het resultaat, spring terug naar het checkpoint en laat de AI een totaal andere aanpak proberen. Zo test je varianten zonder rommel achter te laten.

Per ongeluk te veel weggegooid

De AI verwijderde meer dan bedoeld. Met "Restore code" haal je de bestandsstaat terug zonder het gesprek te verliezen — handig als je de context nog nodig hebt.

Voorbeelden

Claude Code: /rewind of Esc Esc

Open het checkpoint-menu met /rewind of door tweemaal op Esc te drukken bij een leeg invoerveld. Kies vervolgens "Restore code", "Restore conversation" of beide. Gelanceerd in Claude Code v2.0 (29 september 2025) — versie- en menu-details kunnen wijzigen, check zo nodig de live help.
/rewind

Agent SDK: file checkpointing

Programmatisch inschakelen met enable_file_checkpointing=True (Python) of enableFileCheckpointing: true (TS), terugzetten via rewind_files() of rewindFiles(). Belangrijk: dit herstelt alleen bestanden op schijf, niet het gesprek. Werkt binnen dezelfde sessie en alleen voor lokale bestandsinhoud.
enable_file_checkpointing=True

Veelgemaakte Fouten

"Een checkpoint draait ook mijn eigen edits en Bash-commando's terug"

Nee. Checkpoints gelden alleen voor de AI-edits via Write, Edit en NotebookEdit. Handmatige wijzigingen en Bash-commando's (zoals echo of sed) worden niet getrackt. Anthropic adviseert daarom checkpoints te combineren met versiebeheer.

"Checkpoints vervangen Git"

Niet doen. Een checkpoint is een snel, vluchtig en sessiegebonden vangnet — geen versiebeheer. Git is je echte history (commits, branches, remote). Gebruik beide: checkpoints voor het moment, Git voor de lange termijn.

Tools Die Dit Gebruiken

Claude CodeClaude Agent SDKWindsurfCascadeGit

Veelgestelde Vragen

Wat is een checkpoint in Claude Code?
Een checkpoint is een automatische momentopname van je code (en gesprek) die Claude Code vóór elke wijziging opslaat, zodat je in één klik terug kunt naar een eerdere staat. Je opent het menu met /rewind of door tweemaal op Esc te drukken. Het is geen instelling — het gebeurt automatisch.
Hoe maak ik een AI-wijziging ongedaan in Claude Code?
Typ /rewind of druk tweemaal op Esc bij een leeg invoerveld. Kies dan een checkpoint en selecteer wat je terugzet: "Restore code", "Restore conversation" of beide. Zo draai je een verkeerde AI-edit in één handeling terug.
Wat is het verschil tussen /rewind en git?
/rewind is een snel, vluchtig sessie-vangnet voor de eigen edits van de AI; Git is je echte versiebeheer met commits en branches. Anthropic adviseert beide samen te gebruiken, want checkpoints dekken geen Bash-commando's of je eigen handmatige wijzigingen. Een checkpoint vervangt Git dus niet.
Draait een checkpoint ook mijn eigen handmatige wijzigingen terug?
Nee. Checkpoints gelden alleen voor de AI-edits via de Write-, Edit- en NotebookEdit-tools. Jouw eigen handmatige wijzigingen en Bash-commando's worden niet getrackt. Voor die wijzigingen leun je op Git.
Wat is het verschil tussen Claude Code rewind en Windsurf checkpoints?
Beide zijn momentopnames om naar terug te keren. Windsurf Cascade gebruikt "Named Checkpoints and Reverts" — je kunt ze een naam geven, maar let op: een revert is daar onomkeerbaar. In Claude Code heet het terugkeren /rewind en kun je code en/of gesprek selectief herstellen.
Hoe laat ik meerdere AI-agents tegelijk veilig werken?
Niet met checkpoints, maar met Git worktrees: geef elke agent een eigen geïsoleerde werkmap die dezelfde repo deelt. Checkpoints zijn een vangnet binnen één sessie; worktrees isoleren parallel werk over meerdere agents.

Wil je deze term in de praktijk leren toepassen?