Follow Discord
Sweep 09 Oct 2026 · 17:27Z Build v2.1.296 517 read Stable v2.1.287 Latest v2.1.296 Next v2.1.296 Feeds RSS JSON llms.txt llms-full.txt Unofficial

Claude Code v2.1.296 ·

Claude Code now explains why your hooks are not running

Claude Code shows notices saying why hooks are off, covering unreadable managed settings, bare mode, safe mode, managed policy and --settings

You'll notice Improvements
JSON All of v2.1.296
You'll noticeTier: how much it should matter to you
3Useful: my rating, 1 to 5
1Signal: worth watching, 1 to 5
HooksArea: what it touches
ImprovementsKind: in v2.1.296,
ImprovementsSection of the release
What

Hooks are commands Claude Code runs automatically at set moments, for example before a tool is used. Claude Code now shows notices that explain why hooks are not running. The reasons they cover include:

  • a managed policy, meaning settings your organization controls
  • bare mode
  • safe mode
  • --settings, the flag that loads settings from a file or inline JSON for one session

One case is handled specially. If your project settings set disableAllHooks and a managed-settings source could not be read, Claude Code cannot tell whether your organization allows those hooks, so project hooks are turned off. Depending on the hooks involved, the session either stops or shows a notice.

When CLAUDE_CODE_USE_COWORK_PLUGINS is set, a notice says which settings file Claude Code reads instead.

Why

If your hooks stop running, you now get a reason instead of silence. In the case where Claude Code cannot read your organization's settings, it stops rather than guessing, so it does not run hooks that might not be allowed.

What the documentation says
--settings Claude Code changelog modified, high confidence * Fixed `claude agents` offering bypass permissions that background sessions then ignored when consent was saved only in `.claude/settings.local.json` or a `--settings` file; it now asks for consent first, and a session that ignores bypass… see the edit
How sure we are
One source agreesOne thing we can check says the same as this entry.
Anthropic's documentation agrees--settings on Claude Code changelog

See this entry in the whole of v2.1.296 →

Feedback