Claude Code: permission modes en Plan-modus uitgelegd
11 min leestijd
De eerste keer dat Claude Code voor de vijfde keer op rij vraagt "Do you want to proceed?", doen mensen een van twee dingen. Sommigen klikken op Yes zonder te lezen. Anderen geven Claude Code op omdat het steeds onderbreekt. Beide zijn dezelfde fout: ze behandelen toestemming als een vaste instelling in plaats van als een keuze die je per soort werk maakt.
Een permission mode beantwoordt één vraag: wat mag Claude doen zonder het eerst aan mij te vragen?
Deze gids legt elke modus uit, laat zien hoe je met één toetsaanslag wisselt en geeft je een simpele regel om de juiste te kiezen. Ook de Plan-modus komt aan bod, voor beginners de nuttigste en minst gebruikte functie.
Wat een permission mode bepaalt
Als Claude Code iets wil doen dat je computer kan veranderen, zoals een bestand bewerken of een commando draaien, gebeurt een van twee dingen. Het doet het meteen, of het stopt en vraagt het je. De permission mode (permission mode) van je sessie bepaalt welke van de twee.
De modus geldt voor de sessie waarin je zit. Je account en je andere projecten veranderen niet. Je kunt op elk moment wisselen zonder de conversatie kwijt te raken.
De modi in één oogopslag
Claude Code heeft zes modi. De meeste dagen gebruik je er drie.
| Modus | Statusregel toont | Wat zonder vragen draait |
|---|---|---|
Handmatig (Manual, config default) | manual mode on | Alleen lezen. Het vraagt voor bewerkingen en commando's. |
| Edits accepteren (Accept edits) | accept edits on | Lezen, bestandsbewerkingen en gewone bestandscommando's zoals mkdir, mv, cp en rm, binnen je projectmap. |
| Plan | plan mode on | Lezen. Het verkent en schrijft een plan, en bewerkingen blijven geblokkeerd tot jij goedkeurt. |
| Auto | auto mode on | Bijna alles, waarbij een apart model op de achtergrond elke actie beoordeelt. |
| Niet vragen (Don't ask) | don't ask on | Alleen lezen en vooraf goedgekeurde tools. Alles wat zou vragen wordt in plaats daarvan geweigerd. |
| Rechten omzeilen (Bypass permissions) | bypass permissions on | Alles. Geen controles. |
Schrijfacties naar beschermde plekken, zoals de map .git, .claude, het opstartbestand van je shell en .mcp.json, worden in elke modus strenger behandeld, behalve bij omzeilen.
Wissel van modus met Shift+Tab
Je hoeft dit niet bij naam te onthouden. Druk in een sessie op Shift+Tab en de modus verandert. De statusregel onderaan toont waar je uitkwam.
Je kunt ook bij het starten van Claude Code een modus kiezen, zo bereik je de modi die niet in de cyclus zitten:
$ claude --permission-mode plan$ claude --permission-mode acceptEdits$ claude --permission-mode dontAsk
Wil je een modus als standaard, stel dan permissions.defaultMode in een instellingenbestand in. Twee van de waarden, auto en bypassPermissions, worden genegeerd als ze in de eigen instellingenbestanden van een project staan.
In welke modus start een sessie?
Dat hangt af van hoe je Claude Code draait en welke versie je hebt.
| Hoe je het draait | Start in |
|---|---|
| Terminal of VS Code, Claude Code 2.1.283 of nieuwer | Auto |
| Een eerdere versie | Handmatig (auto alleen bij sommige abonnementen, in sommige sessies) |
claude -p voor losse vragen in scripts | Handmatig, en alles wat goedkeuring nodig heeft wordt geweigerd tenzij toegestaan |
| Auto uitgezet door je organisatie | Handmatig |
Kiest een sessie auto maar is auto niet beschikbaar voor jou, dan start ze in Handmatig. Het gaat erom dat je de statusregel controleert in plaats van aan te nemen. Staat er niet wat je verwacht, druk dan op Shift+Tab.
Handmatig: jij keurt elke stap goed
In de Handmatig-modus (Manual) kan Claude je bestanden vrij lezen en vraagt het voordat het een bestand bewerkt of een commando draait. Dit is de juiste modus als je nieuw bent, als de code gevoelig is of als je het project niet goed kent.
De prijs is onderbrekingen. Het voordeel is dat er niets gebeurt wat jij niet zag. Begin voor een eerste sessie hier en let op waar Claude om vraagt. Zo leer je snel welke verzoeken routine zijn.
Edits accepteren: snel itereren op code die je gaat nakijken
Met Edits accepteren (Accept edits) mag Claude bestanden in je projectmap wijzigen en gewone bestandscommando's draaien zonder te vragen. Voor andere commando's en alles buiten je map vraagt het nog steeds.
Dit is de modus voor werk aan code die je achteraf gaat lezen. Je beschrijft een wijziging, Claude voert die door en jij bekijkt de diff in je editor of met git. Het bespaart de meeste klikken tegen het minste risico.
Plan-modus: eerst denken, later wijzigen
In de Plan-modus leest Claude je bestanden, verkent het project en schrijft dan een plan. Je bronbestanden kan het niet bewerken tot jij dat plan goedkeurt.
- 1
Zet hem aan
Druk op
Shift+Tabtot de statusregel plan mode toont, of begin één verzoek met/planervoor, of start met--permission-mode plan. - 2
Beschrijf het doel, niet de stappen
Zeg wat er waar moet zijn als het werk klaar is, en wat niet mag veranderen. Claude verkent en stelt je vragen waar het onzeker is.
- 3
Lees het plan als een voorstel
Controleer welke bestanden het gaat aanraken, in welke volgorde en wat het niet gaat doen. Druk op
Ctrl+Gom het plan in je editor te openen als je het wilt aanpassen. - 4
Keur goed of ga ertegenin
Als Claude het plan presenteert, kun je het goedkeuren en Claude laten bewerken in auto-modus, het goedkeuren maar bewerkingen handmatig blijven goedkeuren, of nee zeggen en verder plannen.
Ik wil onze datumopmaak verplaatsen naar één gedeelde helper. Lees hoe datums in src/ worden opgemaakt, som elke plek op die er een opmaakt en stel een plan voor, gesorteerd op risico. Wijzig nog geen enkel bestand. Vertel me op welke plekken je het minst zeker bent.
”De Plan-modus komt tot zijn recht als een wijziging veel bestanden raakt, als je de code nog niet begrijpt of als een fout duur zou zijn. Vijf minuten een plan lezen scheelt vaak een uur het ongedaan maken van een verkeerde bewerking.
Niet elke taak heeft een plan nodig
Kun je de wijziging in één zin beschrijven, zoals een typfout herstellen of een variabele hernoemen, sla het plannen dan over en vraag er direct om. Plan als de diff groot of verrassend zou zijn.
Auto-modus: minder onderbrekingen, met een veiligheidscontrole
Auto-modus is voor lange taken waar je niet bij wilt blijven zitten. In plaats van je bij elke actie te vragen, beoordeelt een apart model elke actie op de achtergrond en blokkeert het de risicovolle.
De volgorde is simpel. Regels die jij instelt gelden eerst. Bestanden in je project lezen en bewerken wordt automatisch goedgekeurd. Al het andere gaat naar het beoordelende model, en blokkeert dat iets, dan hoort Claude waarom en probeert het een andere weg.
- Standaard geblokkeerd: een script van internet downloaden en uitvoeren, gevoelige data naar externe adressen sturen, uitrollen naar productie of migraties draaien, force pushes, harde resets die werk weggooien en een pull request mergen dat niemand heeft goedgekeurd.
- Standaard toegestaan: lokaal bestandswerk in je project, afhankelijkheden installeren die in je lockbestanden staan, webverzoeken om alleen te lezen en pushen naar branches van de huidige repository (behalve branches die als uitrolbestemming zijn genoemd).
Blokkeert de beoordelaar drie acties op rij, of twintig in totaal, dan pauzeert de auto-modus en gaat Claude weer aan jou vragen. Keur je de actie goed waarom het vraagt, dan hervat de auto-modus. Geblokkeerde acties staan onder /permissions, op het tabblad Recently denied.
Vermindert vragen, garandeert geen veiligheid
De auto-modus maakt het minder waarschijnlijk dat fouten erdoor glippen, maar het is geen garantie. Gebruik voor werk dat iets onherstelbaars kan beschadigen een modus waarin je elke stap goedkeurt, en houd je project in git.
De auto-modus heeft een ondersteund model nodig en kan bij Team- en Enterprise-abonnementen door een beheerder worden uitgezet. Daarom controleer je de statusregel.
Niet vragen en omzeilen: voor scripts en geïsoleerde machines
Twee modi bestaan voor automatisering, en ze zijn niet voor dagelijks werk.
Niet vragen (Don't ask) weigert alles wat normaal zou vragen. De sessie wacht nooit op jou en voert alleen uit wat je vooraf hebt goedgekeurd. Het past bij afgeschermde scripts en CI, waar je precies opsomt wat is toegestaan:
$ claude -p 'run the test suite' --permission-mode dontAsk --allowedTools 'Bash(npm test)' 'Read'Rechten omzeilen (Bypass permissions) slaat elke controle over, ook de bescherming van gevoelige mappen. Deny-regels blijven gelden en een paar kritieke acties vragen nog steeds. Het bestaat voor geïsoleerde omgevingen zoals een container of een virtuele machine zonder internet, omdat het geen bescherming biedt tegen een kwaadaardige instructie verstopt in een bestand of webpagina. Je kunt er niet naartoe wisselen vanuit een sessie die er niet mee is gestart, en bij de eerste start vraagt Claude Code je de verantwoordelijkheid te aanvaarden.
Gebruik omzeilen niet op je eigen laptop
Weet je niet zeker of je het nodig hebt, dan heb je het niet nodig. Gebruik Edits accepteren voor snelheid en auto voor lange taken.
Regels liggen bovenop modi
Een modus bepaalt de basis. Je kunt regels toevoegen voor exacte commando's, en die gelden in elke modus die toestemmingen controleert:
- Allow-regels keuren een tool of commando vooraf goed, bijvoorbeeld
Bash(npm test). - Ask-regels forceren een vraag, ook in de auto-modus.
- Deny-regels blokkeren een actie in elke modus, ook bij omzeilen.
Regels staan in instellingenbestanden: ~/.claude/settings.json voor jou, .claude/settings.json voor het project en .claude/settings.local.json voor privéoverschrijvingen. Een smalle allow-regel zoals Bash(npm test) is de beste eerste om toe te voegen, want je draait je tests voortdurend.
In Claude Tutorial
Bepalen hoeveel je uit handen geeft is een vaardigheid
Kiezen wat je overdraagt en wat je blijft nakijken is het oordeelsvermogen dat de app opbouwt over veel taken, en het geldt ver buiten code.
Welke modus moet ik gebruiken?
Stem de modus af op de situatie, niet op gewoonte.
| Situatie | Modus |
|---|---|
| Je bent nieuw, of de code is gevoelig | Handmatig |
| Je wilt een project begrijpen voordat je het wijzigt | Plan |
| Je itereert op code die je in git gaat nakijken | Edits accepteren |
| Een lange taak waar je niet naar wilt kijken | Auto |
| Een script of CI-taak met een exacte lijst van toegestane acties | Niet vragen |
| Een wegwerpcontainer zonder internet | Omzeilen |
Een goed standaardritme voor een echte wijziging: eerst plannen, het plan goedkeuren, Claude laten werken in Edits accepteren of auto, en dan zelf de diff nakijken. Behandel wat eruit komt als de pull request van een collega.
Veelgestelde vragen
Hoe wissel ik van permission mode in Claude Code?
Druk in een sessie op Shift+Tab om tussen modi te wisselen. Start met een specifieke modus via claude --permission-mode <naam>, of stel een standaard in met permissions.defaultMode in je instellingen.
Wat is de Plan-modus in Claude Code?
Een modus waarin Claude je project leest en verkent en een plan schrijft, maar je bestanden niet kan bewerken tot jij het plan goedkeurt. Je komt erin met Shift+Tab, /plan voor een verzoek of --permission-mode plan.
Is de auto-modus veilig?
Het is veiliger dan blind goedkeuren, omdat een apart model elke actie controleert en risicovolle blokkeert, zoals uitrol naar productie en force pushes. Het is geen garantie. Houd je werk in git en bekijk het resultaat.
Wat doet de modus Edits accepteren?
Claude mag in je project bestanden bewerken en gewone bestandscommando's draaien, zoals mkdir, mv en cp, zonder te vragen. Voor andere commando's blijft het vragen.
Waarom blijft Claude Code om toestemming vragen?
Waarschijnlijk zit je in de Handmatig-modus, of raakt Claude iets buiten je project of een beschermde map aan. Kijk op de statusregel en voeg een allow-regel toe voor commando's die je vertrouwt, zoals je testcommando.
Wat is --dangerously-skip-permissions?
Hetzelfde als de modus Rechten omzeilen. Het slaat alle vragen en controles over en mag alleen in geïsoleerde omgevingen worden gebruikt.
Je toestemmingenchecklist
Je kunt de statusregel lezen en zeggen in welke modus je zit
Je weet dat
Shift+Tabde modus wisselt enEscClaude stoptJe gebruikt de Plan-modus vóór elke wijziging die veel bestanden raakt
Je project staat in git, zodat elke wijziging makkelijk te beoordelen of terug te draaien is
Je hebt een allow-regel voor de commando's die je elke dag goedkeurt, zoals je tests
Verder lezen
- Claude Code voor beginners: installeren, inloggen en je eerste taak als dit je eerste sessie is.
- CLAUDE.md uitgelegd: leer Claude Code één keer je project kennen om niet steeds dezelfde instructies te herhalen.
- Claude Code: gewoonten voor betere resultaten voor prompts, controles en contextbeheer.
- Zo voer je wijzigingen in meerdere bestanden door met Claude Code voor een wijziging waarbij je eerst plant, in de praktijk.
