خلّ حماية Claude Code تفشل بشكل مغلق مع onFailureMake Claude Code Hooks Fail Closed with onFailure Block

Key terms

Hook

A script Claude Code runs automatically at a set moment, for example before it uses a tool.

PreToolUse

The hook moment that fires just before Claude runs a tool such as Bash. Your script can allow or block the call.

Fail open

If the hook itself breaks, the action still runs. This is the default.

Fail closed

If the hook breaks, the action is blocked. This is what onFailure block gives you.

The steps

1. 1

   Step 1

   Check your version

   The onFailure option needs Claude Code 2.1.295 or later. Run the command below in your terminal. If the number is lower, update Claude Code first.

   Older versions ignore the option, so the hook would still fail open and you would not know.

   PromptVersion check

   Copy

   claude --version