{"name":"settings.local.json","slug":"settings-local-json","family":"setting","title":"Settings keys","noun":"settings key","description":"The runner can warn about or block repo-committed settings that grant access outside the workspace.","description_source":"entry","described_by":{"version":"2.1.224","anchor":"runner-can-refuse-repo-committed-settings-that-reach-outside"},"presence":{"first_seen":null,"removed_in":null,"in_current_build":false,"newest_mined":"2.1.288","builds":0,"mined_builds":131,"first_cited":{"version":"2.1.121","released_at":"2026-04-27 19:39:46","spans":3}},"aliases":[],"entries":[{"version":"2.1.288","anchor":"settingslocaljson-wording-changed-from-checkout-to-fold","heading":"Local settings file is now described as this folder's, not this checkout's","line":"Messages about the local settings file now say \"this folder's settings.local.json\" instead of \"this checkout's settings.local.json\"","released_at":"2026-10-02 18:30:40","reason":"named in this entry, found in this entry's text"},{"version":"2.1.287","anchor":"cloud-session-hooks-panel-reworded-and-gains-plugin-hooks-se","heading":"Cloud session hooks panel reworded and gains a plugin hooks section","line":"The panel listing this machine's hooks for a cloud session has shorter text and makes room for a section about plugin hooks","released_at":"2026-10-01 16:59:25","reason":"found in this entry's text"},{"version":"2.1.284","anchor":"settings-file-reads-go-through-a-resolved-path-helper","heading":"Settings files are read from a resolved location","line":"When Claude Code updates or scans settings files, it now works out each file's resolved location before reading it","released_at":"2026-09-28 17:11:59","reason":"found in this entry's text"},{"version":"2.1.282","anchor":"new-startup-warning-when-a-projects-settings-set-telemetry","heading":"Project settings can only turn telemetry off, and Claude Code now says so","line":"A project's settings can now turn telemetry export off but not on, and a new warning points to `\/status` to show which variables applied","released_at":"2026-09-24 15:56:22","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.257","anchor":"new-user-facing-errors-for-cloud-session-sync-and-tls-pinnin","heading":"New user-facing errors for cloud session sync and TLS pinning failures","line":"New messages cover sync being switched off because settings.json could not be parsed, and sign-in aborting on a changed TLS certificate.","released_at":"2026-09-01 17:15:33","reason":"found in this entry's text"},{"version":"2.1.242","anchor":"consent-screen-explaining-what-forwarding-your-hooks-to-a-cl","heading":"Consent screen explaining what forwarding your hooks to a cloud session means","line":"A consent screen explains what letting cloud sessions run your local hooks means.","released_at":"2026-08-24 19:16:14","reason":"found in this entry's text"},{"version":"2.1.232","anchor":"new-environment-variable-for-cloud-peer-access","heading":"New environment variable for cloud peer access","line":"`CLAUDE_CODE_HARBOR_KITE_CLOUD` turns on cloud peer access; otherwise a server flag decides and it's off.","released_at":"2026-08-13 21:30:53","reason":"found in this entry's text"},{"version":"2.1.224","anchor":"runner-can-refuse-repo-committed-settings-that-reach-outside","heading":"Runner can refuse repo-committed settings that reach outside the workspace","line":"The runner can warn about or block repo-committed settings that grant access outside the workspace.","released_at":"2026-08-07 01:36:32","reason":"found in this entry's text"},{"version":"2.1.211","anchor":"bug-fixes","heading":"","line":null,"released_at":"2026-07-15 19:24:07","reason":"found in this entry's text"}],"entries_total":17,"docs":[{"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\/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\/python","title":"Agent SDK reference - Python","documented":false},{"source":"claude-code","path":"agent-sdk\/typescript","title":"Agent SDK reference - TypeScript","documented":false},{"source":"claude-code","path":"agent-sdk\/user-input","title":"Handle approvals and user input","documented":false},{"source":"claude-code","path":"agent-view","title":"Manage multiple agents with agent view","documented":false},{"source":"claude-code","path":"artifacts","title":"Share session output as artifacts","documented":false},{"source":"claude-code","path":"auto-mode-config","title":"Configure auto mode","documented":false},{"source":"claude-code","path":"changelog","title":"Claude Code changelog","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.json","slug":"settings-json","description":"Resumed sessions now carry your settings files along, with plugin registrations stripped out."},{"name":"settings.read","slug":"settings-read","description":"Plugins and hooks gain new permission scopes: session.usage, settings.read, env.get, env.set"},{"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-local-json","family_url":"https:\/\/changelogs.core-directive.com\/reference\/setting.json"}