Permissions
Permissions
.claude/settings.json
Vendor docs
config
| name | type | required | meaning | concept | |
|---|---|---|---|---|---|
| acceptEdits | enum |
Automatically accepts file edits and common filesystem commands such as `mkdir`, `touch`, `mv`, and `cp` for paths in the working directory or `additionalDirectories`
|
docs ↗ | ||
| auto | enum |
Auto-approves tool calls with background safety checks that verify actions align with your request
|
docs ↗ | ||
| bypassPermissions | enum |
Skips permission prompts, except for the actions no mode auto-approves
|
docs ↗ | ||
| default | enum |
Prompts for permission on first use of each tool. Labeled Manual in the CLI, the VS Code and JetBrains extensions, and the desktop app, and Claude Code accepts `manual` as an alias. The label and alias require Claude Code v2.1.200 or later. The desktop app's label doesn't depend on your CLI version
|
docs ↗ | ||
| dontAsk | enum |
Auto-denies tools unless pre-approved via `/permissions` or `permissions.allow` rules. `AskUserQuestion`, MCP tools marked `requiresUserInteraction`, and connector tools your organization set to `ask` in sessions where that setting reaches Claude Code are denied even if you've allowed them
|
docs ↗ | ||
| plan | enum |
Claude reads files and runs read-only shell commands to explore but doesn't edit your source files; with auto mode available, classifier-approved commands also run. Labeled Plan in the CLI and the VS Code extension
|
docs ↗ |