De permission mode van Claude Code bepaalt welke acties zonder te vragen draaien. default (weergegeven als Manual) vraagt vóór bewerkingen en shell-commando's. acceptEdits laat ook bestandsbewerkingen en veelgebruikte bestandscommando's door. plan laat Claude lezen en een plan voorstellen, maar niets bewerken. auto laat een classifier op de achtergrond acties goedkeuren in plaats van jou. dontAsk weigert alles waarvoor een prompt nodig zou zijn. bypassPermissions, die je aanzet met --dangerously-skip-permissions, slaat prompts vrijwel helemaal over en is alleen bedoeld voor geïsoleerde containers of VM's. Druk op Shift+Tab om door de modes te bladeren, of start met claude --permission-mode <mode>.
Deze gids is gebaseerd op de documentatie over permission modes van Anthropic. Claude Code verandert vaak, dus check daar wat geldt voor jouw versie.
01De zes modes in één oogopslag
default (Manual)Alleen lezenElke actie controleren, gevoelig werkacceptEditsLezen, bestanden bewerken en gangbare filesystem-commando's zoals mkdir, touch, mv en cp binnen de werkmapItereren op code die je meekijktplanLezen; bewerkingen zijn geblokkeerd tot je het plan goedkeurtVerkennen voordat je iets wijzigtautoAlles, waarbij een classifier elke actie eerst controleertLange taken met minder promptsdontAskLezen in de werkmappen en vooraf goedgekeurde tools; al het andere wordt geweigerdCI en dichtgetimmerde scriptsbypassPermissionsAlles, op een paar uitzonderingen naAlleen geïsoleerde containers en VM'sdefault is de naam die in settings, hooks en de --permission-mode-flag wordt gebruikt. De CLI, de IDE-extensies en de desktop-app noemen het Manual, en de CLI accepteert manual als alias.
02Zo wissel je van modus
Druk in de terminal op Shift+Tab. De cyclus loopt default, acceptEdits, plan en daarna eventuele optionele modi die je sessie toestaat. dontAsk zit nooit in de cyclus; die stel je alleen in met de flag.
Een sessie in een bepaalde modus starten:
claude --permission-mode planWil je een modus als standaard, stel die dan in via ~/.claude/settings.json:
{
"permissions": {
"defaultMode": "acceptEdits"
}
}De flag gaat voor de setting, en de setting gaat voor de ingebouwde standaard. Eén beperking is handig om te weten: auto en bypassPermissions werken niet vanuit de .claude/settings.json of .claude/settings.local.json van een project. Een repository kan je dus niet stilletjes in bypass-modus zetten. Stel die twee in je gebruikerssettings in, of geef de flag mee.
In welke modus een nieuwe sessie start
Recente versies van Claude Code (v2.1.283 of nieuwer) starten interactieve terminal- en VS Code-sessies in auto als auto mode beschikbaar is, tenzij je settings iets anders zeggen. claude -p en Agent SDK-runs starten in default. Heb je nooit een modus gekozen en vraag je je af waarom je zo weinig prompts ziet? Dan is dit de reden.
03De modi in detail
default (Manual)
Claude mag bestanden lezen zonder te vragen. Bewerkingen, shell-commando's en netwerktoegang geven elk een prompt. Kies je bij een Bash-prompt "Yes, and don't ask again", dan wordt er een allow-regel opgeslagen in .claude/settings.local.json, zodat dat commando in deze repository niet opnieuw vraagt. Goedkeuringen voor bestandsbewerkingen gelden tot het einde van de sessie.
acceptEdits
Bewerkingen en eenvoudige bestandscommando's (mkdir, touch, rm, rmdir, mv, cp, sed) binnen je werkmap draaien zonder prompt. Andere shell-commando's vragen nog steeds. Een prima middenweg als je de diff live meekijkt.
plan
Claude verkent met reads en read-only commando's en presenteert daarna een plan. Er wordt niets in je broncode bewerkt tot je het goedkeurt. Handig voor onbekende code of riskante wijzigingen.
auto
Een apart model beoordeelt elke actie voordat die draait en blokkeert acties die verder gaan dan je verzoek, infrastructuur raken die het niet herkent, of gestuurd lijken door kwaadwillende content. Expliciete ask-regels geven nog steeds een prompt. Blokkeert de classifier drie acties op rij of twintig in een sessie, dan pauzeert auto mode en krijg je weer gewone prompts. Anthropic zegt zelf dat auto mode "reduces permission prompts but does not guarantee safety."
dontAsk
Alles wat een prompt zou geven, wordt geweigerd. Alleen allow-regels en acties die nooit goedkeuring nodig hebben, draaien. Deze modus is bedoeld voor scripts en CI, waar niemand is om te antwoorden.
bypassPermissions en --dangerously-skip-permissions
--dangerously-skip-permissions is hetzelfde als --permission-mode bypassPermissions. Prompts worden overgeslagen, ook voor writes naar beschermde paden zoals .git en .claude. Een paar dingen geven in elke modus toch een prompt of worden geweigerd, waaronder expliciete ask-regels, AskUserQuestion en sommige gevaarlijke rm-commando's. Deny-regels blokkeren nog steeds.
Anthropic raadt aan dit alleen te gebruiken in containers, VM's of dev containers zonder internettoegang. Op Mac en Linux weigert Claude Code in deze modus te starten als root of onder sudo buiten een herkende sandbox. Wil je bypass alleen beschikbaar hebben en niet meteen aan, dan voegt --allow-dangerously-skip-permissions het toe aan de Shift+Tab-cyclus zonder ernaar over te schakelen.
04Regels komen bovenop modi
Modi bepalen de basis. Permission-regels in settings stellen die nauwkeuriger af:
{
"permissions": {
"allow": ["Bash(npm run test *)"],
"ask": ["Bash(git push *)"],
"deny": ["Read(./.env)"]
}
}Regels worden gecontroleerd in de volgorde deny, ask, allow, en de eerste match beslist. Deny-regels blokkeren in elke modus, ook in bypassPermissions. Allow-regels hebben geen effect in bypassPermissions, omdat daar alles al is toegestaan. Draai /permissions om alle regels te zien en uit welk bestand ze komen.
Ook hooks kunnen meedoen. Een PreToolUse-hook kan in elke modus een tool call blokkeren. Een PermissionRequest-hook kan een prompt voor je beantwoorden, maar kan een deny-regel niet overrulen. De PermissionRequest-guide laat zien hoe.
05Een modus kiezen als je even wegloopt
Meestal grijpen mensen naar --dangerously-skip-permissions omdat ze Claude willen laten doorwerken zonder bij terugkomst een sessie aan te treffen die vastzit op een prompt. Dat is een echt probleem, maar bypass mode lost het op door je toezicht volledig weg te halen, op je eigen machine.
Een paar veiligere combinaties:
- Allow-regels voor de saaie commando's. Zet je test-, lint- en buildcommando's in
allow, houdaskopgit pushen deploys, en blijf indefaultofacceptEdits. - auto mode voor lange taken waarbij je het oordeel van een classifier over routineacties accepteert.
- Zorg dat de prompt je bereikt, waar je ook bent. Houd een modus die om toestemming vraagt en beantwoord de paar prompts die ertoe doen vanaf je telefoon.
Dat laatste is wat Claude Code Notifier doet. Het is een onafhankelijke tool, niet gemaakt door Anthropic. De command line tool, ccn, draait als Claude Code-hooks op Mac, Windows en Linux. Als Claude Code om toestemming wil vragen terwijl jij niet achter je toetsenbord zit, gaat het verzoek naar je gekoppelde iPhone of Android-telefoon, waar je eenmalig toestaat, voor de sessie toestaat of weigert. Het ziet alleen prompts die Claude Code toch al zou tonen, dus de modus en je regels bepalen nog steeds wat er gevraagd wordt. In auto mode krijg je minder verzoeken; in bypassPermissions krijg je er geen, al komen meldingen als "Claude is klaar" en vragen nog wel binnen. De handleiding voor goedkeuren via je telefoon legt de setup uit, en Is goedkeuren vanaf je telefoon veilig? behandelt de risico's.
06FAQ
Wat is het verschil tussen default en acceptEdits?
default vraagt vóór elke bestandswijziging en elk shellcommando om toestemming. acceptEdits laat bestandswijzigingen en gangbare bestandscommando's zoals mkdir, mv en cp binnen de werkmap zonder vragen uitvoeren. Voor andere shellcommando's krijg je in beide modi nog steeds een prompt.
Is --dangerously-skip-permissions hetzelfde als bypassPermissions?
Ja. De flag is gelijk aan --permission-mode bypassPermissions. Anthropic raadt het alleen aan in geïsoleerde containers of VM's, het liefst zonder internettoegang.
Hoe zorg ik dat Claude Code voor één commando niet meer om toestemming vraagt?
Kies "Yes, and don't ask again" bij de prompt, of voeg een allow-regel zoals "Bash(npm test)" toe onder permissions.allow in je settings. Dat is veiliger dan de hele modus aanpassen.
Kunnen de settings van een project me in bypassPermissions mode zetten?
Nee. bypassPermissions en auto in .claude/settings.json of .claude/settings.local.json hebben geen effect. Ze werken alleen vanuit user- of managed settings, of via de command line flag.
Draaien hooks nog in bypassPermissions mode?
Ja. Hooks draaien in elke modus, en een PreToolUse-hook die een tool call weigert, blokkeert die zelfs in bypassPermissions. Een PermissionRequest-hook draait alleen als er een prompt te beantwoorden is, dus in bypass mode gaat die zelden af.