II.
HookSurface overview
Reference · livehook-surface:claude.config-change
ConfigChange (Claude Code) overview
Fires when a configuration file changes during the session. Exit 2 blocks the change (except for policy_settings, which always wins). Used to enforce org-wide config invariants. Matchable by source.
Attributes
eventName
ConfigChange (Claude Code)
displayName
ConfigChange (Claude Code)
kind
native
originVendor
Anthropic
direction
pre
blocking
true
family
in-process
payloadSchema
type
object
required
- hook_event_name
- source
properties
hook_event_name
type
string
const
ConfigChange
source
type
string
enum
- user_settings
- project_settings
- local_settings
- policy_settings
- skills
previous_config
type
- object
- null
new_config
type
- object
- null
description
Fires when a configuration file changes during the session. Exit 2
blocks the change (except for policy_settings, which always wins).
Used to enforce org-wide config invariants. Matchable by source.
Outgoing edges
None.
Incoming edges
exposes1
- agent-runtime-impl:claude-code.runtime@1.x·AgentRuntimeImplClaude Code Runtime (1.x)
maps_hook1
- hook-mapping:claude-config-change·HookMapping