Claude Code Plan Mode: eerst onderzoeken, dan uitvoeren

Je vraagt om een exportknop en Claude Code begint meteen bestanden te veranderen. Terwijl nog niet vaststaat welke gegevens in de export horen. Plan Mode geeft je een moment om die keuzes eerst te bekijken. Claude onderzoekt het project en stelt een aanpak voor; jij beoordeelt die voordat de uitvoering begint.

Hier gaat het om de werkmodus van Claude Code. We gebruiken een fictieve app voor zaalreserveringen als voorbeeld. De beheerder wil een CSV-export van de getoonde reserveringen. Geen deelnemerslijst, geen extra persoonsgegevens en geen verbouwing van het hele boekingssysteem.

Start in de terminal bijvoorbeeld met:

In een lopende CLI-sessie kun je met Shift+Tab door de modi schakelen tot de statusbalk plan mode on toont. Tel geen vast aantal toetsaanslagen: de startmodus kan verschillen. Voor een afzonderlijke prompt is /plan met je opdracht een andere ingang. De officiële uitleg over permissiemodi beschrijft de bediening.

In de VS Code-extensie kies je Plan via de modusbediening bij het invoerveld. Daar ondersteunt de huidige versie ook /plan; de documentatie vermeldt die bediening vanaf Claude Code 2.1.280. Controleer wat jouw interface daadwerkelijk aangeeft voordat je de opdracht verstuurt.

Voor onze reserveringsapp zou ik dit vragen:

Die opdracht bevat een zichtbaar eindpunt. Als de lijst drie reserveringen toont, verwachten we drie gegevensregels. Namen en e-mailadressen horen er niet bij. Het onderzoek moet ook uitwijzen of de huidige lijst alle resultaten bevat of alleen de eerste pagina. Anders kan “zichtbare selectie” twee verschillende dingen betekenen.

Dat laatste is een echte keuze voor jou als opdrachtgever. Wil je alleen de huidige pagina of alle resultaten die aan de filters voldoen? Laat Claude die vraag stellen wanneer de code daar geen eenduidig antwoord op geeft.

Een bruikbaar plan voor dit voorbeeld wijst eerst aan waar de filters worden toegepast en waar de exportactie hoort. Vervolgens benoemt het de gekozen rijen, kolommen en manier waarop speciale tekens in CSV worden verwerkt. Ten slotte beschrijft het hoe de bestaande toegangscontrole blijft gelden. Die informatie helpt je een concrete wijziging beoordelen.

Staat er alleen “exportfunctie toevoegen en testen”, dan ontbreekt het belangrijkste werk nog. Vraag welke gegevensbron wordt gebruikt en hoe de test aantoont dat de export de selectie volgt. Laat geen onbekende bibliotheek installeren voordat de reden duidelijk is. Misschien bestaat er al een geschikte exportfunctie in het project.

Een korte open vraag is nuttiger dan een lang plan dat stilzwijgend de verkeerde gebruiker of dataset kiest. Ik zou hier pas verdergaan zodra duidelijk is of drie getoonde reserveringen ook werkelijk drie exportregels betekenen.

Onze acceptatie begint met een gewone selectie: twee reserveringen voor zaal Noord en één voor zaal Zuid. Filter op Noord en verwacht alleen de twee Noord-regels. Test daarna een lege selectie: die krijgt het afgesproken gedrag, bijvoorbeeld een bestand met alleen de kolomkoppen. Laat dat vooraf kiezen.

Neem ook een zaalnaam met een komma op, zoals “Noord, eerste verdieping”. Die naam moet één CSV-veld blijven. Vraag daarnaast om beoordeling van spreadsheetformules in tekstvelden als de app zulke invoer toestaat. Dat vraagt om een geschikte exportaanpak, niet om een willekeurige string met komma's aan elkaar plakken.

De officiële workflowdocumentatie behandelt plannen vóór bewerken. Onze concrete gevallen geven die werkwijze een toetsbaar doel. Het plan mag vermelden dat aanvullende kennis nodig is; het mag de controle niet vervangen door de belofte dat alles goed komt.

Wanneer Claude het plan presenteert, kun je doorgaan, handmatig wijzigingen laten goedkeuren of verder plannen. De precieze opties hangen van je sessie af. Met Ctrl+G kun je in de CLI het voorgestelde plan in je editor openen. Goedkeuren verlaat Plan Mode en kiest de aangegeven uitvoermodus.

Voor onze CSV-knop zou ik eerst een kleine implementatie laten maken met dezelfde lijst en filters. Een voorstel om meteen alle rapportages te centraliseren gaat buiten het doel. Geef die terugkoppeling in het planstadium. Dan beoordeel je de keuze voordat hij verspreid over meerdere bestanden is uitgevoerd.

De CLI-reference is de bron voor de startvlag. Je hoeft voor deze werkwijze geen ander model of een ander abonnement te kiezen.

Normaal blokkeert Plan Mode bronwijzigingen totdat je het plan goedkeurt. Er kunnen wel onderzoekscommando's worden uitgevoerd en het plan zelf wordt geschreven. Bovendien documenteert Claude een uitzondering voor interactieve terminalsessies waarin bypass permissions beschikbaar zijn. Beschouw Plan Mode daarom niet als een zelfstandige sandbox.

Gebruik voor ons exportvoorbeeld een oefenproject met fictieve reserveringen en passende rechten. Er is geen reden om een productiegegevensbron beschikbaar te maken om kolomkeuzes te bespreken. Als het onderzoek onverwacht een echte export wil uitvoeren, controleer dan welke data en handeling gevraagd worden. De tekst van een plan geeft geen algemene toestemming voor iedere volgende stap.

Laat na de implementatie zien welke bestanden veranderden en welke tests werkelijk draaiden. Open vervolgens zelf de fictieve lijst, kies Noord en bekijk het bestand. Controleer de twee gegevensregels, de kolommen en de zaalnaam met komma. Een groene test is nuttig bewijs; het uitgevoerde gebruikerspad maakt duidelijk of knop en selectie samen werken.

Wijzigt de opdracht onderweg, keer dan terug naar planning voor het onzekere deel. De korte uitleg over Plan Mode helpt de bediening onthouden. Wil je dit toepassen op eigen ontwikkelwerk, bekijk Claude Code voor gevorderden. Neem een wijziging mee waarbij één verkeerde aanname veel vervolgwerk kan veroorzaken.