Search the documentation
8 pages for permissiondecision.
Titles and paths first, then pages whose text carries it. Each row opens that page as this site last read it.
Use Claude Code features in the SDK
Claude Code CLI · in the page
agent-sdk/claude-code-features
…oceed. To block execution, return a `hookSpecificOutput` object with `permissionDecision: "deny"` and a `permissionDecisionReason`. The reason is sent to Claude as the tool result. See the [hooks guid…
Intercept and control agent behavior with hooks
Claude Code CLI · in the page
agent-sdk/hooks
…(step 4), checks if the file path targets a `.env` file, and returns `permissionDecision: "deny"` to block the operation (step 5): <CodeGroup> ```python Python theme={null} import asyncio from…
Agent SDK reference - Python
Claude Code CLI · in the page
agent-sdk/python
…permission request was triggered. Forwarded from a PreToolUse hook's `permissionDecisionReason` when the hook returned `"ask"`…
Agent SDK reference - TypeScript
Claude Code CLI · in the page
agent-sdk/typescript
…user turn, such as startup errors. When a `PreToolUse` hook returns `permissionDecision: "defer"`, the result has `stop_reason: "tool_deferred"` and `deferred_tool_use` carries the pending tool's `id…
Manage costs effectively
Claude Code CLI · in the page
costs
…ed_cmd" \ '{hookSpecificOutput: {hookEventName: "PreToolUse", permissionDecision: "allow", updatedInput: (.tool_input + {command: $filtered})}}' else echo "{}" fi ``` </Tab…
Hooks reference
Claude Code CLI · in the page
hooks
…reads the JSON input from stdin, extracts the command, and returns a `permissionDecision` of `"deny"` if it contains `rm -rf`. Save it to `.claude/hooks/block-rm.sh` in your project and make it execut…
Automate actions with hooks
Claude Code CLI · in the page
hooks-guide
…} { "hookSpecificOutput": { "hookEventName": "PreToolUse", "permissionDecision": "deny", "permissionDecisionReason": "Use rg instead of grep for better performance" } } ``` With `"den…
Week 14 · March 30 – April 3, 2026
Claude Code CLI · in the page
whats-new/2026-w14
…<code>r</code></div> <div>New <code>defer</code> value for <code>permissionDecision</code> in <code>PreToolUse</code> hooks: <code>-p</code> sessions pause at a tool call and exit with a <code>de…