Anthropic - Claude Code Docs Changes 2026-05-04 04:18 UTC → 2026-05-04 06:55 UTC

2413```2413```

2414 2414 

2415| Field | Description |2415| Field | Description |

2416| :------- | :--------------------------------------------------------- |2416| :------- | :------------------------------------------------------- |

2417| `ok` | `true` allows the action, `false` prevents it |2417| `ok` | `true` allows the action, `false` blocks it |

2418| `reason` | Required when `ok` is `false`. Explanation shown to Claude |2418| `reason` | Required when `ok` is `false`. Explanation for the block |

2419 

2420For `Stop` and `SubagentStop`, an `ok: false` reason is fed back to Claude as its next instruction and the turn continues. For all other supported events, the turn ends and the reason appears in the chat as a warning line; Claude does not see it. This is equivalent to returning `"continue": false` from a command hook. If you need different blocking semantics on those events, use a [command hook](#command-hook-fields) with the per-event fields described in [Decision control](#decision-control).

2419 2421 

2420### Example: Multi-criteria Stop hook2422### Example: Multi-criteria Stop hook

2421 2423 

735The model's only job is to return a yes/no decision as JSON:735The model's only job is to return a yes/no decision as JSON:

736 736 

737* `"ok": true`: the action proceeds737* `"ok": true`: the action proceeds

738* `"ok": false`: the action is blocked. The model's `"reason"` is fed back to Claude so it can adjust.738* `"ok": false`: the action is blocked. For `Stop` and `SubagentStop` hooks, the `reason` is fed back to Claude so it keeps working. For other events, the turn ends and the `reason` appears in the chat as a warning line. Claude does not see it.

739 739 

740This example uses a `Stop` hook to ask the model whether all requested tasks are complete. If the model returns `"ok": false`, Claude keeps working and uses the `reason` as its next instruction:740This example uses a `Stop` hook to ask the model whether all requested tasks are complete. If the model returns `"ok": false`, Claude keeps working and uses the `reason` as its next instruction:

741 741