⌨️ConfigChange Hook
Also known as ConfigChange
The event when a settings or skill file changes.
Think of it like
It is like an alarm on a cupboard. It tells you when someone opens it.
Example
Jack's team wants a log of every settings change. Their ConfigChange hook writes what changed to an audit file.
Why it matters
Settings decide what Claude may do. A quiet change there is worth knowing about.
Definition
Example code
json
{
"hooks": {
"ConfigChange": [
{ "matcher": "project_settings|local_settings", "hooks": [{ "type": "command", "command": "./audit-config.sh" }] }
]
}
}Common mistake
Key takeaways
- 1When settings change. Or skills.
- 2Can block. Not policy.
- 3Some changes skip it. Saved answers.