localSettings
A Claude Code settings key, read out of the shipped bundle. No mined inventory carries it: everything below comes from what this site has written about it.
"Always allow" options in consent dialogs now use pre-validated rule rows instead of building rules at click time
Not Anthropic's. This is the line from the earliest changelog entry here that named it, v2.1.235.
In the changelogs
27Releases whose published page names localSettings.
-
v2.1.288
Served folders with no terminal ignore that folder's local settings and hooks
When Claude Code serves a folder with no terminal attached, it skips the folder's local settings and hooks and tells you they were not used
found in this entry's text, named in this entry
-
v2.1.282
CLAUDE.md search skips project folders when project and local settings are off
Claude Code no longer walks up your project folders looking for CLAUDE.md files when both project and local setting sources are turned off
found in this entry's text
-
v2.1.280
New skill-state, sandbox, and Claude-in-Chrome settings-write APIs
Three new internal settings-write functions handle per-skill state, sandbox mode, and Claude-in-Chrome default-enabled toggle
found in this entry's text
-
v2.1.277
update_settings tool can now target more than localSettings, including userSettings.effortLevel
The internal update_settings tool can now write userSettings.effortLevel, not just localSettings
found in this entry's text
-
v2.1.269
New generic 'TextEdit' settings field for plugin-provided config values
Settings screen gains a generic text-input field type for plugin-defined configuration values
found in this entry's text
-
v2.1.269
Output style change now requires localSettings and warns on redundant switch
Switching output style in /config is now safer for shared sessions and won't let you reselect the current style
found in this entry's text
-
v2.1.268
Model-override settings-source enumeration reworked
Internal check for model-override settings now filters sources instead of excluding one
found in this entry's text
-
v2.1.260
Bash approvals can now auto-add a standing allow rule
Approving some Bash commands can now silently save a standing allow rule for next time.
found in this entry's text
-
v2.1.260
Host profile collection has its own telemetry
Forced-ask permission decisions now include a suggested standing allow rule where applicable.
found in this entry's text
-
v2.1.257
New SDK control command: update_settings
SDK clients can send an update_settings control command, limited to changing outputStyle in local settings.
found in this entry's text
-
v2.1.257
Warning path for local settings tracked in git
Claude Code now notes whether your .claude/settings.local.json is tracked in git and uses that when resolving permissions.
found in this entry's text
-
v2.1.257
Additional working directories now track which settings file 'owns' them
Extra working directories are now attributed to project or local settings correctly, and mis-recorded ones are backfilled.
named in this entry, found in this entry's text
-
v2.1.248
MCP server allow and deny lists get settings keys
You can allow or block specific MCP servers with allowedMcpServers and deniedMcpServers settings.
found in this entry's text
-
v2.1.235
Always-allow options are now pre-validated permission "rows" instead of rules built at click time
"Always allow" options in consent dialogs now use pre-validated rule rows instead of building rules at click time
found in this entry's text
-
v2.1.235
"Don't ask again" and "apply suggestions" now take rules from one validated suggestion row
"Don't ask again" and "apply suggestions" now build permission updates from a validated suggestion row
found in this entry's text
-
v2.1.213
Hook System:
policySettingsSourcefound in this entry's text
- v2.1.211
-
v2.1.211
settings.local.json Ownership Verification Before Canonicalization
found in this entry's text
-
v2.1.207
Auto Mode Settings Locked to Trusted Sources
found in this entry's text
-
v2.1.195
Skill Override Lookup Extended to Local Settings
found in this entry's text
-
v1.0.87
Working Directory Source Tracking
found in this entry's text
-
v1.0.78
Enhanced Agent Configuration
found in this entry's text
-
v1.0.61
New Features
found in this entry's text
-
v0.2.93
Breaking Changes
found in this entry's text
-
v0.2.85
New Features
found in this entry's text
-
v0.2.69
Improved Rule Management
found in this entry's text
-
v0.2.57
Project-Level Tool Permissions
found in this entry's text
First cited
6The earliest release whose published evidence quoted localSettings was v2.1.211, 15 Jul 2026. That is the oldest release this project wrote about it, so it is a floor on the name's age and not the release that introduced it. It is not a presence reading: which builds carried the name is the table below.
Presence across releases
0The miner has never read a build containing this name. It is here because a changelog entry of ours names it, which is evidence that it existed and not evidence of which releases carried it. The inventory starts at v2.1.138 and everything older than that was never mined.
Read out of the published npm bundle release by release, and out of Anthropic's own documentation as this site captured it. Nothing on this page is a description anybody here wrote about what the settings key does. All settings keys.