Under the hoodTier: how much it should matter to you
2Useful: my rating, 1 to 5
2Signal: worth watching, 1 to 5
HooksArea: what it touches
Internal ChangesKind: in v2.1.301,
Internal ChangesSection of the release
Unclear Whether Claude Code sends these details by default is not clear.
What
A hook is a command you or a plugin set up to run automatically at certain moments, for example PreToolUse, which runs before Claude uses a tool and can block it. When a hook decides whether Claude may go ahead, Claude Code can now record three extra details:
The entry above is what we published on the day. These lines were added later, as Anthropic's own pages caught up, and they sit beside the original rather than replacing it.
Added sinceA small documentation edit on Hooks reference touched a line naming PreToolUse after this was published.An [Agent SDK callback hook](/docs/en/agent-sdk/hooks) on `PreToolUse` that exceeds its timeout blocks the tool call, and Claude receives an error result naming the timeout.hookssee the edit
Confirmed sinceAnthropic's documentation has since written up PreToolUse, on MCP, plugins, skills, and hooks.A [`PreToolUse`](https://code.claude.com/docs/en/hooks#pretooluse) hook that runs this way and has no `onFailure` field blocks the tool call when it fails or times out. The hook error that Claude receives includes `blocking because Git Bas…third-party/claude-desktop/extensionssee the edit
How sure we are
Something disagreesSomething we can check disagrees with this entry, or the writer said they could not settle it.
The writer flagged doubtWhether Claude Code sends these details by default is not clear.
Anthropic's documentation agreesAnthropic's documentation has since written up PreToolUse, on MCP, plugins, skills, and hooks.