Follow Discord
Sweep 22 Oct 2026 · 04:32Z Build v2.1.308 527 read Stable v2.1.308 Latest v2.1.308 Next v2.1.308 Feeds RSS JSON llms.txt llms-full.txt Unofficial

Claude Code v2.1.301 ·

Permission decisions made by hooks now record which hook made them

When a hook allows or blocks a tool, Claude Code now records the hook's event, where the hook came from and, for plugins, the plugin's ID

Under the hood Internal Changes
JSON All of v2.1.301
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 hook event, PreToolUse or tool.check.
  • The hook's source: your settings, a plugin, or a skill, with its name where there is one.
  • For a plugin, its ID in the form plugin@marketplace.

The source and plugin ID are checked against these expected forms.

Why

These look like telemetry fields, meaning usage data, that would show which hook decided a permission outcome.

Read from
Names in the bundlePreToolUse
Since it was published

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 since A 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. hooks see the edit
Confirmed since Anthropic'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/extensions see 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.

See this entry in the whole of v2.1.301 →

Feedback