{"name":"settings.json","slug":"settings-json","family":"setting","title":"Settings keys","noun":"settings key","description":"Resumed sessions now carry your settings files along, with plugin registrations stripped out.","description_source":"entry","described_by":{"version":"2.1.222","anchor":"resume-snapshots-carry-user-settings-without-plugin-keys"},"presence":{"first_seen":null,"removed_in":null,"in_current_build":false,"newest_mined":"2.1.309","builds":0,"mined_builds":150,"first_cited":{"version":"2.1.47","released_at":"2026-02-18 20:15:11","spans":5}},"aliases":[],"entries":[{"version":"2.1.305","anchor":"plugin-loader-gains-containment-checks-and-an-optional-direc","heading":"Plugin checking gains a folder-layout check and a --profile directory option","line":"`claude plugin validate` now also runs a folder-layout check, and plugin loading now checks key plugin files stay within allowed folders","released_at":"2026-10-20 19:29:36","reason":"found in this entry's text"},{"version":"2.1.305","anchor":"plugin-manifest-monitors-and-settings-reads-refuse-paths-th","heading":"Plugins can no longer read their manifest or settings from outside their folder","line":"Claude Code now refuses to load a plugin whose manifest, monitors or settings file links to a location outside the plugin's folder","released_at":"2026-10-20 19:29:36","reason":"found in this entry's text"},{"version":"2.1.302","anchor":"idle-compaction-the-tengu-sunny-locket-constant-is-factored","heading":"Idle compaction messages now explain the timing and how to turn it off","line":"When Claude Code compacts while you are idle, it now says it did so before the prompt cache expired and how to turn this off","released_at":"2026-10-16 16:48:28","reason":"found in this entry's text"},{"version":"2.1.286","anchor":"hooks-dialog-now-opens-on-a-flat-list-of-configured-hooks","heading":"The \/hooks menu now opens on a list of your hooks","line":"`\/hooks` now opens on a list of every configured hook with its event, source, command and matcher, with the event list one step away","released_at":"2026-09-30 17:14:38","reason":"found in this entry's text"},{"version":"2.1.280","anchor":"settings-validation-now-warns-about-invalid-values-instead-o","heading":"Settings validation now warns about invalid values instead of silently misbehaving","line":"Claude Code now warns when a settings.json value fails validation instead of silently ignoring it","released_at":"2026-09-22 15:44:39","reason":"found in this entry's text"},{"version":"2.1.277","anchor":"task-max-output-length-removed-from-recognized-settings-list","heading":"TASK_MAX_OUTPUT_LENGTH removed from recognized settings list","line":"The TASK_MAX_OUTPUT_LENGTH environment variable is no longer a recognized setting","released_at":"2026-09-18 16:22:26","reason":"found in this entry's text"},{"version":"2.1.274","anchor":"claude-code-footer-indicator-env-var-now-overrides-settings","heading":"CLAUDE_CODE_FOOTER_INDICATOR env var now overrides settings config directly","line":"CLAUDE_CODE_FOOTER_INDICATOR environment variable now overrides the footer_indicator setting","released_at":"2026-09-16 22:36:09","reason":"found in this entry's text"},{"version":"2.1.271","anchor":"config-duplication-now-copies-configjson-and-additional-c","heading":"Config duplication now copies .config.json and additional .claude*.json profile files","line":"Duplicating a config\/session directory now also copies .config.json and additional .claude*.json profile files","released_at":"2026-09-14 19:45:19","reason":"found in this entry's text"},{"version":"2.1.271","anchor":"self-hosted-runner-gains-host-config-snapshotting-for-sessio","heading":"Self-hosted runner gains host-config snapshotting for sessions","line":"The self-hosted runner can now snapshot an operator's Claude config and seed it into every session, with a drain-marker mechanism","released_at":"2026-09-14 19:45:19","reason":"found in this entry's text"},{"version":"2.1.271","anchor":"bridge-child-auto-mode-permission-defaulting-gated-off","heading":"Bridge child auto-mode permission defaulting, gated off","line":"Bridge-spawned child sessions may be defaulted to auto permission mode, gated off","released_at":"2026-09-14 19:45:19","reason":"found in this entry's text"}],"entries_total":59,"docs":[{"source":"claude-code","path":"accessibility","title":"Use Claude Code with a screen reader","documented":false},{"source":"claude-code","path":"admin-setup","title":"Set up Claude Code for your organization","documented":false},{"source":"claude-code","path":"agent-sdk\/claude-code-features","title":"Use Claude Code features in the SDK","documented":false},{"source":"claude-code","path":"agent-sdk\/hooks","title":"Intercept and control agent behavior with hooks","documented":false},{"source":"claude-code","path":"agent-sdk\/migration-guide","title":"Migrate to Claude Agent SDK","documented":false},{"source":"claude-code","path":"agent-sdk\/modifying-system-prompts","title":"Modifying system prompts","documented":false},{"source":"claude-code","path":"agent-sdk\/permissions","title":"Configure permissions","documented":false},{"source":"claude-code","path":"agent-sdk\/python","title":"Agent SDK reference - Python","documented":false},{"source":"claude-code","path":"agent-sdk\/session-storage","title":"Persist sessions to external storage","documented":false},{"source":"claude-code","path":"agent-sdk\/subagents","title":"Subagents in the SDK","documented":false}],"docs_total":12,"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.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.read","slug":"settings-read","description":"Plugins and hooks gain new permission scopes: session.usage, settings.read, env.get, env.set"},{"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-json","family_url":"https:\/\/changelogs.core-directive.com\/reference\/setting.json"}