{"name":"settings.read","slug":"settings-read","family":"setting","title":"Settings keys","noun":"settings key","description":"Plugins and hooks gain new permission scopes: session.usage, settings.read, env.get, env.set","description_source":"entry","described_by":{"version":"2.1.267","anchor":"new-pluginhook-capability-scopes-sessionusage-settingsr"},"presence":{"first_seen":null,"removed_in":null,"in_current_build":false,"newest_mined":"2.1.319","builds":0,"mined_builds":159,"first_cited":{"version":"2.1.267","released_at":"2026-09-09 18:25:42","spans":4}},"aliases":[],"entries":[{"version":"2.1.304","anchor":"new-settingsread-plugin-event-mods-runtime","heading":"Plugin modules can now see and override settings through a settings.read event","line":"Plugin modules can subscribe to a settings.read event that shows them the settings in effect and lets them override values","released_at":"2026-10-19 19:47:15","reason":"found in this entry's text, named in this entry"},{"version":"2.1.304","anchor":"queue-and-plugin-input-hold-refactor-with-a-plugin-settings","heading":"Plugins can intercept queued messages, and session.send checks the input hold","line":"Hook plugins can now intercept a queued message, and a plugin's session.send is refused if Claude Code cannot read whether plugin input is held","released_at":"2026-10-19 19:47:15","reason":"found in this entry's text"},{"version":"2.1.304","anchor":"hooks-module-settingsread-merge-is-re-raised-when-plugins-o","heading":"Settings supplied by hook plugins are re-read when settings or plugins change","line":"Claude Code now re-reads settings supplied by settings.read hooks whenever your settings or loaded plugins change","released_at":"2026-10-19 19:47:15","reason":"found in this entry's text, named in this entry"},{"version":"2.1.280","anchor":"builtin-hooks-module-capability-manifests-expanded","heading":"Builtin hooks-module capability manifests expanded","line":"Builtin plugin hook modules were granted access to more host calls, including two new environment variables","released_at":"2026-09-22 15:44:39","reason":"found in this entry's text"},{"version":"2.1.267","anchor":"new-pluginhook-capability-scopes-sessionusage-settingsr","heading":"New plugin\/hook capability scopes: session.usage, settings.read, env.get, env.set","line":"Plugins and hooks gain new permission scopes: session.usage, settings.read, env.get, env.set","released_at":"2026-09-09 18:25:42","reason":"found in this entry's text, named in this entry"},{"version":"2.1.267","anchor":"plugin-api-gains-fsreadwritelist-rename-plus-new-settings","heading":"Plugin API gains fs.read\/write\/list rename plus new settings.read, env.get, env.set","line":"Claude Code's plugin API renames its file actions and adds settings.read, env.get and env.set","released_at":"2026-09-09 18:25:42","reason":"found in this entry's text, named in this entry"},{"version":"2.1.267","anchor":"pluginhook-capability-namespace-gains-session-and-env-acces","heading":"Plugin\/hook capability namespace gains session and env access","line":"Hooks and plugins can now access session usage stats and read\/write environment variables","released_at":"2026-09-09 18:25:42","reason":"found in this entry's text"}],"entries_total":7,"docs":[{"source":"claude-code","path":"changelog","title":"Claude Code changelog","documented":false},{"source":"claude-code","path":"plugins\/mods\/admin","title":"Manage mods for your organization","documented":false},{"source":"claude-code","path":"plugins\/mods\/api","title":"Use the mods API","documented":false},{"source":"claude-code","path":"plugins\/mods\/events","title":"React to events with a mod","documented":false},{"source":"claude-code","path":"plugins\/mods\/reference","title":"Mods reference","documented":false},{"source":"claude-code","path":"plugins\/mods\/troubleshoot","title":"Troubleshoot a mod","documented":false},{"source":"claude-docs","path":"cowork\/changelog","title":"Changelog","documented":false},{"source":"claude-docs","path":"government\/connectors\/microsoft-365","title":"Set up the Microsoft 365 connector","documented":false},{"source":"claude-docs","path":"third-party\/claude-desktop\/connectors-m365","title":"Connect to Microsoft 365","documented":false}],"docs_total":9,"gates":[],"related":[{"name":"settings","slug":"settings","description":"The runner can pass a settings file to sessions; its Windows hooks guard never actually fires."},{"name":"settings.env","slug":"settings-env","description":"When settings.env changes, Claude Code reapplies config environment variables and no longer saves and restores CLAUDE_CODE_REPL itself"},{"name":"settings.json","slug":"settings-json","description":"Resumed sessions now carry your settings files along, with plugin registrations stripped out."},{"name":"settings.local.json","slug":"settings-local-json","description":"The runner can warn about or block repo-committed settings that grant access outside the workspace."},{"name":"settings_still_on","slug":"settings-still-on","description":null},{"name":"settingsHooksOff","slug":"settingshooksoff","description":"A new settingsHooksOff option can disable all hook execution for a given agent or subagent run"}],"url":"https:\/\/changelogs.core-directive.com\/reference\/setting\/settings-read","family_url":"https:\/\/changelogs.core-directive.com\/reference\/setting.json"}