PreToolUse Hook - Claude Code
Fires before any tool executes. Allow, deny, defer, or modify the call.

PreToolUse is the most powerful hook point. Every tool call flows through it, and the hook can allow, deny, defer, or rewrite the call before it executes.
What it does
The hook receives the tool name and arguments. Return values drive decision: allow the call as-is, deny with a reason, defer (ask the user), or modify (adjust arguments before execution). This is the extension point for custom policy engines, dynamic rewriting, and fine-grained safety controls.
When to use it
- Enforcing "no Bash commands from this list" policies.
- Rewriting edits to match house style automatically.
- Auditing every tool call to an external system.
- Deferring specific calls to a human reviewer even in auto mode.
Gotchas
- Every tool call pays the hook's latency cost. Keep the hook fast.
- Modifying arguments without telling the user can cause confusion. Log changes clearly.
- A bad hook can block every tool call and wedge the session. Test in a throwaway session first.
Official docs: https://code.claude.com/docs/en/hooks.md#pretooluse
Technical content at the intersection of AI and development. Building with AI agents, Claude Code, and modern dev tools - then showing you exactly how it works.
Was this helpful?
Related Guides
Related Tools
Claude Agent SDK
Anthropic's SDK for building agents on the same tools, agent loop, and context management that power Claude Code. Python...
View ToolClaude Code
Anthropic's agentic coding CLI. Runs in your terminal, edits files autonomously, spawns sub-agents, and maintains memory...
View ToolCodeburn
Interactive TUI dashboard that shows exactly where your Claude Code and Cursor tokens are going, in real time.
View ToolConductor
Mac app for running parallel Claude Code, Codex, and Cursor agents in isolated workspaces. Watch every agent work at onc...
View ToolRelated Videos

Claude Code Just Killed After Effects
Create motion graphics and launch videos using natural language — no traditional video editor required. 🔗 Try Higgsfield Katana in Claude:** https://higgsfield.ai/s/katana-inside-claude-yt-developer...

Generate Videos in Codex + Claude Code with This...
Check out HeyGen! https://heygen.1stcollab.com/developersdigest The video introduces HeyGen, an AI video generation platform with a rich API and a CLI that lets developers create, fetch, and manipula...

10x Design in Claude Code and Codex
Try Higgsfield: https://higgsfield.ai/s/higgsfield-general-campaign-developersdigest-juDMTi AI coding agents can build entire websites in minutes, but the default results often still look generic and...
Related Posts

Claude vs Claude Code: What the Difference Is and Which to Use (2026)
Claude vs Claude Code: one app for chat, docs and general work, one agent for your codebase. Same model family and share...

Claude Security Continuous Scanning: Fix Tracking, API and MCP
Claude Security now rescans repos as commits land, marks findings fixed when the fix ships, and adds an API, MCP connect...

Claude Fable 5.1 in Claude Code: How to Switch, Pin, and Pay Less
Claude Code v2.1.257 points /model fable at Fable 5.1: 1M context, $10/$50 per MTok, $0.25 cache reads. Setup, gotchas,...

Claude Design, Slides and Docs in Any Chat: How to Use Them
Claude Design, Slides and Docs now open in any Claude chat, Claude Code session or the Artifacts tab, on every plan. Exa...

Claude for Startups Offer Paused: What Founders Do Now
Claude for Startups paused its free Claude Team year and $1,000 API credit offer at capacity. What the program page says...

Claude Advisor Tool vs a Bigger Model: When the Pairing Pays
Anthropic's own runs: a Fable 5.1 advisor added 1.7 points to Opus 5.5 for 2.1x the cost. When the Claude advisor tool p...
