Claude Code plan mode: zo doe je het, stap voor stap

Wat heb je nodig

Wat heb je nodig voor Claude Code plan mode?

Plan mode zit in elke versie van Claude Code en kost geen extra instelling. Wel moet Claude Code zelf draaien, en je wilt een project waarin je een echte wijziging klaar hebt staan. Een plan voor een verzonnen klus leert je weinig, omdat je dan niet kunt beoordelen of het klopt. Heb je Claude Code nog niet, begin dan bij Claude Code installeren.

Aanzetten

Plan mode aanzetten: Shift+Tab, /plan of een flag

Er zijn drie manieren, en ze doen hetzelfde. Kies op basis van wanneer je weet dat je wilt plannen: vooraf, midden in een sessie, of alleen voor één opdracht. Let op de statusbalk onder je invoerveld. Die is de enige betrouwbare plek om te zien in welke modus je zit.

Waarom je vaker op Shift+Tab drukt dan oude tutorials zeggen

Veel uitleg op internet zegt "druk twee keer op Shift+Tab". Dat klopte toen elke sessie in Manual startte. Sinds versie 2.1.283 start een sessie in de terminal en in VS Code standaard in auto mode, op elk plan. De eerste druk brengt je dan naar Manual, en pas de derde naar plan mode. Heb je je sessie gestart met bypass permissions, dan zitten er na plan nog extra modi in de cyclus. Kijk dus naar de statusbalk in plaats van te tellen. Meer over auto mode lees je in Claude Code-functies.

Plan mode verlaten zonder plan

Druk nog een keer op Shift+Tab om plan mode te verlaten zonder een plan goed te keuren. Handig als je merkt dat de klus kleiner is dan gedacht. Claude kan overigens ook zelf naar plan mode overschakelen: Claude Code heeft daarvoor een ingebouwde tool die geen toestemming vraagt. Zie je de statusbalk onverwacht veranderen, dan is dat de reden.

Stap voor stap

Je eerste plan in Claude Code plan mode, stap voor stap

Je oefent op een wijziging die je toch al wilde doen. Volg de stappen in deze volgorde; elke stap zegt waarom. Reken op een kwartier tot het plan er ligt, en dan nog wat tijd voor uitvoeren en controleren.

Goedkeuren

Een plan goedkeuren of bijsturen: welke optie kies je?

Als het plan klaar is, toont Claude het met een keuzemenu. Goedkeuren beëindigt plan mode en zet de sessie in de modus die bij je keuze hoort. Daarna begint Claude meteen met bouwen. Kies dus bewust: de optie bepaalt hoeveel je onderweg nog ziet.

Ctrl+G: het plan zelf bewerken

Met Ctrl+G opent het voorgestelde plan in je standaard teksteditor. Je kunt stappen schrappen, de volgorde omdraaien of een eis toevoegen, zoals "pas de bestaande tests niet aan". Sla op en kies daarna een goedkeuroptie. Dit is sneller dan Claude in een chatbericht uitleggen wat er anders moet, als je precies weet wat je wilt.

Waar het plan blijft

Claude schrijft het plan als Markdown-bestand weg, standaard in ~/.claude/plans/ in je thuismap. De bestandsnaam is afgeleid van je opdracht. Wil je plannen bij je project bewaren, bijvoorbeeld om ze met een collega te bespreken, dan zet je een eigen map in je instellingen. Hoe staat onder instellingen.

Werkt het?

Werkt het? De controle en je eerste prompt

Plan mode werkt als je drie dingen ziet: de statusbalk toont ⏸ plan mode on, Claude leest bestanden maar je ziet geen wijzigingen, en aan het eind verschijnt het keuzemenu met de goedkeuropties. Typ in een tweede terminal git status: zolang je niet hebt goedgekeurd, staan er geen nieuwe wijzigingen van Claude in je project.

Je eerste prompt om te plakken

Vervang wat tussen de haken staat en plak dit in plan mode:

/plan Ik wil dat [beschrijf de wijziging in één zin]. Het is klaar als [wat de gebruiker straks ziet of kan].
Onderzoek eerst welke bestanden dit raakt. Lever daarna een plan met:
1. de bestanden die je wijzigt, en per bestand waarom;
2. wat je bewust niet aanraakt;
3. je aannames en de vragen die je eerst aan mij wilt stellen;
4. hoe we controleren dat het werkt: welke test of welk commando, en wat de uitkomst moet zijn.
Regels voor deze klus: [bijvoorbeeld: geen nieuwe packages, bestaande tests niet aanpassen].
Stel je vragen voordat je het plan afmaakt als iets onduidelijk is.

Waarom deze prompt werkt

Punt 2 en punt 4 maken het verschil. Een plan zonder "wat ik niet aanraak" groeit makkelijk door naar bestanden die je niet bedoelde. Een plan zonder controlestap geeft je na afloop niets om de uitkomst aan te toetsen. De regels in de prompt zelf staan er omdat het zoekwerk in plan mode vaak buiten je CLAUDE.md om gaat.

Hoe je ziet dat het misgaat

Zie je tijdens het plannen toch een diff of het label "Edit" verschijnen, stop dan met Esc en kijk naar de statusbalk. Waarschijnlijk zat je niet in plan mode, of je sessie is gestart met bypass permissions. Dan blokkeert plan mode geen bewerkingen. Zie de probleemtabel.

Instellingen

Plan mode standaard maken en andere instellingen

Werk je in een project waar elke wijziging eerst een plan verdient, dan kun je plan mode als startmodus instellen. Instellingen zet je in een settings-bestand: .claude/settings.json in je project geldt voor iedereen die het project gebruikt, ~/.claude/settings.json alleen voor jou. Hieronder de instellingen die voor plan mode tellen.

Plan mode als startmodus in de terminal

Zet dit in .claude/settings.json in je project:

{
"permissions": {
"defaultMode": "plan"
}
}

Elke nieuwe terminalsessie in dit project start dan in plan mode. Waarom per project: zo plan je standaard in de klantapplicatie, terwijl je in een testmap gewoon direct doorwerkt.

Plan mode als startmodus in VS Code

De VS Code-extensie leest de startmodus niet uit de settings van je project. Zet daar in je VS Code-gebruikersinstellingen claudeCode.initialPermissionMode op plan. Kies je Plan via de modusknop, dan geldt dat alleen voor dat ene gesprek.

Plannen in je project bewaren

Met plansDirectory schrijft Claude zijn plannen in een map binnen je project in plaats van in je thuismap:

{
"plansDirectory": "./plans"
}

Het pad moet binnen je project liggen en schuine strepen naar rechts gebruiken, anders valt Claude terug op ~/.claude/plans. Handig om plannen samen te bespreken; zet de map wel in .gitignore als er klantinformatie in kan staan.

Een schone lei na het plannen

Plannen kan veel van je contextvenster gebruiken. Met deze instelling krijgt het goedkeurmenu een eerste optie die het gesprek wist en alleen met het plan verdergaat:

{
"showClearContextOnPlanAccept": true
}

Het label toont ook hoeveel context het plannen kostte. Gebruik het bij grote klussen; bij kleine verlies je juist nuttige context.

Opus laten plannen, Sonnet laten bouwen

Typ /model opusplan. Claude gebruikt dan Opus zolang je in plan mode zit en schakelt na goedkeuring over op Sonnet voor de uitvoering. Waarom: het zwaardere model doet het denkwerk, het lichtere het routinewerk, wat zuiniger is met je limiet of API-budget. Werk je al standaard op Opus en heb je ruimte genoeg, dan is dit niet nodig. De modellen en hun prijzen staan op modellen en prijzen.

Zelf elk verkenningscommando goedkeuren

Is auto mode beschikbaar, dan beoordeelt de classifier de shell-commando's die Claude tijdens het plannen draait, en zie je geen vragen. Wil je die commando's zelf zien, zet dan in je eigen settings "useAutoModeDuringPlan": false, of in /config de optie Use auto mode during plan uit. Een project kan dit niet voor jou uitzetten; het werkt alleen vanuit je eigen, lokale of beheerde instellingen.

Problemen

Plan mode werkt niet zoals verwacht: meldingen en oplossingen

De meeste problemen met plan mode komen door een andere startmodus dan je denkt, of door een instelling die in de verkeerde file staat. Zoek je situatie op in de tabel. Staat hij er niet bij, draai dan eerst claude update en probeer het opnieuw, want plan mode is in recente versies vaak verbeterd.

Ons oordeel

Ons oordeel: wanneer plan mode wel en wanneer niet

In onze trainingen zien we dat plan mode beginners veel herstelwerk bespaart, omdat hij je dwingt om vóór de eerste wijziging na te denken. Maar niet elke klus heeft een plan nodig. Een plan voor het aanpassen van één tekst kost je meer tijd dan het oplevert.

De fout die we beginners het vaakst zien maken

Het eerste plan direct goedkeuren. Het plan ziet er verzorgd uit, met kopjes en genummerde stappen, en dat voelt als kwaliteit. Maar een net plan kan uitgaan van een verkeerde aanname, zoals een bestand dat niet meer gebruikt wordt of een klanttype dat niet in je data staat. Lees altijd de aannames en de controlestap. Ontbreekt de controlestap, kies dan No, keep planning en vraag erom.

Een MKB-voorbeeld

Stel: een installatiebedrijf met een klein intern offerteprogramma wil een kortingsregel voor vaste klanten op elke offerte. In plan mode vraag je: "Zet een kortingsregel voor vaste klanten op elke offerte. Klaar als een offerte voor een vaste klant de regel toont en de totalen kloppen." Het plan laat zien dat er drie plekken geraakt worden: het offertesjabloon, de berekening en de pdf-export. In de aannames staat dat Claude een veld "vaste klant" verwacht in het klantenbestand. Bestaat dat veld niet, dan weet je dat nu, en niet na drie aangepaste bestanden. Je stuurt bij, keurt goed met handmatige goedkeuring en controleert met een testofferte.

Plan mode is geen privacyfilter

Plan mode voorkomt dat Claude je bestanden wijzigt. Het voorkomt niet dat Claude ze leest, en wat Claude leest gaat naar het model bij Anthropic. Staat er een export met klantgegevens of een .env met wachtwoorden in je projectmap, blokkeer die dan met een deny-regel zoals Read(./.env) in je settings. Dat blokkeert Claudes bestandstools voor dat pad, in elke modus. Voor de AVG-kant lees je Claude Code privacy.

Leren werken met plannen in een team

Plan mode is pas echt waardevol als een team dezelfde gewoonte heeft: eerst plannen bij werk boven een bepaalde omvang, plannen bewaren en samen bespreken. In de Claude Code Masterclass oefenen we dat op jullie eigen code, inclusief een CLAUDE.md die de regels vastlegt.

Wat nu?

Wat nu? Je volgende stap na plan mode

Werkt plan mode, dan zit de volgende winst in de dingen eromheen: vaste regels die elk plan meeneemt, controles die altijd draaien en een review van het resultaat.

Leg je regels vast in CLAUDE.md

Alles wat je in elke planprompt opnieuw typt, hoort in een CLAUDE.md. Vergeet niet dat het zoekwerk tijdens plannen daar soms buiten valt; de uitvoering na goedkeuring leest hem wel.

Laat controles automatisch draaien

Met hooks draait na elke wijziging bijvoorbeeld je formatter of je tests, ook als het plan dat vergeet. Zo wordt de controlestap uit je plan een vaste regel.

Review wat er gebouwd is

Na de uitvoering laat je Claude de wijziging nakijken met code review. Vraag dan expliciet of het resultaat het plan volgt.

Verder lezen

Werk je liever in een editor, volg dan Claude Code in VS Code. Alle modi naast plan mode staan in Claude Code-functies, alle commando's in Claude Code commands. Hoe plan mode zich tot je limiet verhoudt lees je bij Claude Code-limieten. En de korte definitie staat in het woordenboek bij plan mode.