[DOCS] Hooks reference missing `ConfigChange` hook event and input schema

Resolved 💬 2 comments Opened Feb 19, 2026 by coygeek Closed Feb 20, 2026

Documentation Type

Missing documentation (feature not documented)

Documentation Location

https://code.claude.com/docs/en/hooks

Section/Topic

Hook events lifecycle section and event-specific schema docs.

Current Documentation

The page documents hook events and schemas, for example:

## Hook events Each event corresponds to a point in Claude Code's lifecycle where hooks can run. ### SessionStart ... ### PreCompact ... ### SessionEnd

There is currently no ConfigChange event section.

What's Wrong or Missing?

Claude Code v2.1.49 adds a new ConfigChange hook event, but the hooks reference does not document it.

That leaves hook authors without:

  • when ConfigChange fires,
  • expected matcher behavior,
  • input payload schema,
  • decision/output behavior for this event.

Suggested Improvement

Add a ### ConfigChange section in https://code.claude.com/docs/en/hooks that matches the format used for other events:

  1. When it fires (configuration files changed during an active session)
  2. Matcher semantics (if supported)
  3. Input schema with a full JSON example
  4. Decision control/output behavior
  5. Example use cases for auditing and policy enforcement

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/hooks | 551+ | Hook events reference includes event sections but no ConfigChange entry |

Total scope: 1 page affected

View original on GitHub ↗

This issue has 2 comments on GitHub. Read the full discussion on GitHub ↗