Follow Discord
Sweep 02 Oct 2026 · 18:55Z Build v2.1.288 509 read Stable v2.1.285 Latest v2.1.288 Next v2.1.288 Feeds RSS JSON llms.txt llms-full.txt Unofficial

Claude Code v2.1.288 ·

Hooks that print badly formed JSON are recorded as a separate kind of failure

A script hook whose JSON output is badly formed is now recorded as its own failure, and exit code 2 still blocks

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

Hooks are scripts you configure to run automatically at set points in a session. A script hook can print JSON, a structured text format, to tell Claude Code what to do. When that JSON does not match the expected format, Claude Code now handles it like this:

  • If the hook exited with any code other than 2, the failure is recorded as invalid hook output instead of being raised as an error.
  • If the hook exited with code 2, the failure is marked as blocked and recorded separately.

Previously any such mismatch raised an error unless the exit code was 2.

Why

If you write hooks, badly formed output is now tracked as its own kind of failure, and exiting with code 2 still blocks as before.

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 doubtIt is not clear whether the message you see when a hook's output is badly formed changed.

See this entry in the whole of v2.1.288 →

Feedback