Cmd. /permissions
Manage allow, ask, deny, and Auto rules (/allowed-tools).
Written and reviewed by Eric Han · Co-founder & CTO, reopt
Key takeaways
- Manage allow, ask, deny, and Auto rules (
/allowed-tools). - Check the input surface and availability before using the examples below.
Purpose
Manage allow, ask, deny, and Auto rules (/allowed-tools).
/permissionsAvailability
| Field | Value |
|---|---|
| Input surface | Running CLI prompt |
| Kind | Built-in |
| Status | Current reference |
| Aliases | /allowed-tools |
| Documented minimum | Not specified |
| Reviewed against | 2026-10-23 · Claude Code 2.1.308 |
The installed command menu and account or organization settings determine availability.
Examples
/permissionsEffects and persistence
Inspect allow, ask, and deny rules at their effective scope. Interactive terminal/VS Code sessions default to auto (reference v2.1.283+, every-plan changelog v2.1.284). The current Permission modes reference states that -p and Agent SDK runs default to Manual (default) from v2.1.302. permissions.defaultMode and --permission-mode take precedence; project settings cannot enable auto or bypassPermissions.
From v2.1.302, -p and SDK sessions on third-party providers, with telemetry off, or on fresh installs start in default unless a mode is specified. v2.1.307 fixes retry handling of shell commands approved through Recently denied.
Cautions
Read allow, ask, and deny rules at their actual scope; a project rule may be constrained by managed policy. Interactive terminal and VS Code sessions with no configured permission mode start in auto mode on every plan and provider; the Permission modes reference states v2.1.283 or later, while the changelog records the every-plan change under v2.1.284. claude -p and Python Agent SDK sessions on third-party providers or with telemetry off follow from v2.1.285. permissions.defaultMode and --permission-mode still override it. From v2.1.290, the Bash tool asks before running pyright and more forms of ps.