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 those forced by explicit `ask` rules, connector tools your organization set to `ask`, and MCP tools marked `requiresUserInteraction`. Root and home directory removals such as `rm -rf /` also still prompt as a circuit breaker
|
docs ↗ | ||
| default | enum |
Standard behavior: 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`, connector tools your organization set to `ask`, and MCP tools marked `requiresUserInteraction` 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. Labeled Plan in the CLI and the VS Code extension
|
docs ↗ |