{"name":"ConfigChange","slug":"configchange","family":"hook","title":"Hook events","noun":"hook event","description":"When a configuration file changes during a session","description_source":"docs","described_by":{"doc":"claude-code\/hooks","title":"Hooks reference"},"presence":{"first_seen":null,"removed_in":null,"in_current_build":false,"newest_mined":"2.1.308","builds":0,"mined_builds":149,"first_cited":{"version":"2.1.277","released_at":"2026-09-18 16:22:26","spans":3}},"aliases":[],"entries":[{"version":"2.1.288","anchor":"config-settings-reapply-path-removed","heading":"The path for reapplying settings changes after a ConfigChange hook was removed","line":"Claude Code no longer has its separate step that ran ConfigChange hooks and then reloaded a changed settings file","released_at":"2026-10-02 18:30:40","reason":"found in this entry's text, named in this entry"},{"version":"2.1.287","anchor":"new-settings-review-and-claude-accept-command-for-staged","heading":"Held settings changes can be accepted or discarded, including for cloud sessions","line":"Settings edits Claude made without your approval are held for you to accept, discard or leave, and cloud sessions use only accepted versions","released_at":"2026-10-01 16:59:25","reason":"found in this entry's text"},{"version":"2.1.277","anchor":"plugin-dir-file-watcher-with-adaptive-polling-and-configchan","heading":"Plugin-dir file watcher with adaptive polling and ConfigChange hook gate","line":"Plugin skill directories now get watched for changes, with adaptive polling and a ConfigChange hook gate","released_at":"2026-09-18 16:22:26","reason":"found in this entry's text"},{"version":"2.1.229","anchor":"hooks-are-handed-a-session-object-instead-of-reading-globals","heading":"Hooks are handed a session object instead of reading globals","line":"Hooks now get an explicit session with id, working directory and project root instead of guessing from globals.","released_at":"2026-08-12 19:28:48","reason":"found in this entry's text"},{"version":"2.1.48","anchor":"http-hooks","heading":"HTTP Hooks","line":null,"released_at":"2026-02-19 20:50:30","reason":"found in this entry's text"},{"version":"2.1.48","anchor":"configchange-hook-event","heading":"ConfigChange Hook Event","line":null,"released_at":"2026-02-19 20:50:30","reason":"found in this entry's text"}],"entries_total":6,"docs":[{"source":"claude-code","path":"hooks","title":"Hooks reference","documented":true},{"source":"claude-code","path":"agent-sdk\/hooks","title":"Intercept and control agent behavior with hooks","documented":true},{"source":"claude-code","path":"agent-sdk\/typescript","title":"Agent SDK reference - TypeScript","documented":false},{"source":"claude-code","path":"changelog","title":"Claude Code changelog","documented":false},{"source":"claude-code","path":"hooks-guide","title":"Automate actions with hooks","documented":false},{"source":"claude-code","path":"security","title":"Security","documented":false},{"source":"claude-code","path":"server-managed-settings","title":"Configure server-managed settings","documented":false},{"source":"claude-code","path":"settings","title":"Claude Code settings","documented":false}],"docs_total":8,"gates":[],"related":[],"url":"https:\/\/changelogs.core-directive.com\/reference\/hook\/configchange","family_url":"https:\/\/changelogs.core-directive.com\/reference\/hook.json"}