Permissions (Claude Code)
Tool : A precise action the AI can call · requires claude-code
Allow, deny, and ask rules per tool and per pattern.
The simplest safeguard for a code agent, to be configured before anything else.
Security reflects where data goes, requested permissions and incidents on record at the verification date. It is not a guarantee of zero risk: check the deployment mode and the connections you enable.
What it does, concretely
When a code agent can read, modify, and execute files without restriction, the risk of an unwanted action is real. Claude Code's permission system addresses this by letting you define precisely what the agent is allowed to do, tool by tool and command by command.
In practice, each rule follows the format Tool or Tool(specifier) and can be of type allow, deny, or ask. Deny rules are evaluated first, then ask, then allow: the first match wins. A deny rule on a bare tool name removes that tool from the agent's context entirely, while a scoped rule like Bash(rm *) keeps the tool available but blocks matching calls.
These rules are stored in versionable settings.json files, allowing a team to share a common configuration while letting each developer adjust their own preferences. The /permissions dialog lets you view and modify rules mid-session, even while an agent is working.
This tool is aimed at developers using Claude Code who want to constrain the agent's actions without disabling its capabilities. It is not relevant for those who do not use Claude Code or who prefer to let the agent work without restrictions.
What it offers
- ·Three rule types (allow, deny, ask) configurable per tool and per command or path pattern.
- ·Rules evaluated in a fixed order: deny first, then ask, then allow, regardless of rule specificity.
- ·Complete removal of a tool from the agent's context via a bare-name deny rule, without a specifier.
- ·Per-repository persistence of approvals for Bash commands and WebFetch domains, saved to .claude/settings.json.
- ·/permissions dialog accessible mid-session to add or remove rules with immediate effect on the next tool call.
- ·Ability to attach a comment when answering a permission prompt, forwarded to Claude as context.
- ·Several permission modes available: manual, acceptEdits, plan, auto, dontAsk, bypassPermissions, with the option to disable auto and bypassPermissions via configuration files.
- ·Input parameter matching for deny and ask rules, for example Agent(model:opus) or Bash(run_in_background:true).
In practice
- Price
- Free
- Commercial use
- Commercial use: yes
- Available on
- claude-code
- Host
- claude-code
- FR interface
- No
Security and data
- Rating
- Security: nothing to flag
- Capabilities
- readswritesexecutesnetwork
- Your data
- Data stays local
- Maintenance
- Active
Links and repository checked on 25 October 2026 · added on 1 February 2025
How to install Permissions (Claude Code)
.claude/settings.json → permissions