`parentSettingsBehavior`

setting gone documented JSON

A Claude Code settings key, read out of the shipped bundle. It was in the build from v2.1.138 and was gone by v2.1.284.

Apply or drop restrictions an SDK or IDE host passes when you deploy managed settings

Anthropic's own wording. Read off All settings, captured 2026-10-22.

First seen v2.1.138 9 May 2026

Last seen v2.1.283 25 Sep 2026, gone by v2.1.284

Builds126 / 150on this box, as of v2.1.309

Written about v2.1.133 first named in a changelog, 7 May 2026

v2.1.138in the build not in the build never minedv2.1.309

In the changelogs

Releases whose published page names parentSettingsBehavior.

v2.1.300 14 Oct 2026
Read-only folder setting now describes enforcement over SSH
The read-only folders setting's description no longer says SSH ignores it, and now lists where read-only is enforced and where it is not

found in this entry's text
v2.1.281 23 Sep 2026
Remote managed settings are not written to disk when the provider is managed by the host
When a host manages the provider through a gateway, remote managed settings are no longer cached to disk and host policy merges by default

found in this entry's text
v2.1.281 23 Sep 2026
parentSettingsBehavior defaults to "merge" in Desktop-launched gateway sessions
parentSettingsBehavior now defaults to "merge" in gateway sessions launched from Claude Desktop's Code tab, and stays "first-wins" elsewhere

found in this entry's text, named in this entry
v2.1.133 7 May 2026
Managed Settings Can Merge Parent Policy
found in this entry's text

First cited

The earliest release whose published evidence quoted parentSettingsBehavior was v2.1.133, 7 May 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.

ReleaseDateThe span that was quoted

v2.1.1337 May 2026parentSettingsBehavior

v2.1.28123 Sep 2026(e.parentSettingsBehavior ?? (HW() ? "merge" : "first-wins")) === "merge"

Presence across releases

BuildsHow manyDatesReading

v2.1.138 – v2.1.283126 builds9 May 2026 → 25 Sep 2026 ◆in the build

v2.1.284 – v2.1.30924 builds28 Sep 2026 → 22 Oct 2026 ○not in the build

Build by build

150

One row per release since the first build this name was read out of. Absent means the build was read and the name was not in it, never mined means no bundle for that release was ever archived, and a declared type or a default is only ever what that release's own bundle stated.

BuildDateStateThe record behind it

v2.1.1389 May 2026·presentverdict: present

v2.1.13911 May 2026·presentverdict: present

v2.1.14012 May 2026·presentverdict: present

v2.1.141·presentverdict: present

v2.1.142·presentverdict: present

v2.1.143·presentverdict: present

v2.1.144·presentverdict: present

v2.1.145·presentverdict: present

v2.1.146·presentverdict: present

v2.1.147·presentverdict: present

v2.1.148·presentverdict: present

v2.1.149·presentverdict: present

v2.1.150·presentverdict: present

v2.1.152·presentverdict: present

v2.1.153·presentverdict: present

v2.1.154·presentverdict: present

v2.1.156·presentverdict: present

v2.1.157·presentverdict: present

v2.1.158·presentverdict: present

v2.1.159·presentverdict: present

v2.1.160·presentverdict: present

v2.1.161·presentverdict: present

v2.1.162·presentverdict: present

v2.1.1634 Jun 2026·presentverdict: present

v2.1.1655 Jun 2026·presentverdict: present

v2.1.1665 Jun 2026·presentverdict: present

v2.1.1676 Jun 2026·presentverdict: present

v2.1.1686 Jun 2026·presentverdict: present

v2.1.1698 Jun 2026·presentverdict: present

v2.1.1709 Jun 2026·presentverdict: present

v2.1.17210 Jun 2026·presentverdict: present

v2.1.17311 Jun 2026·presentverdict: present

v2.1.17411 Jun 2026·presentverdict: present

v2.1.17512 Jun 2026·presentverdict: present

v2.1.17612 Jun 2026·presentverdict: present

v2.1.17713 Jun 2026·presentverdict: present

v2.1.17815 Jun 2026·presentverdict: present

v2.1.17916 Jun 2026·presentverdict: present

v2.1.18117 Jun 2026·presentverdict: present

v2.1.18218 Jun 2026·presentverdict: present

v2.1.18319 Jun 2026·presentverdict: present

v2.1.18520 Jun 2026·presentverdict: present

v2.1.18622 Jun 2026·presentverdict: present

v2.1.18723 Jun 2026·presentverdict: present

v2.1.19024 Jun 2026·presentverdict: present

v2.1.19124 Jun 2026·presentverdict: present

v2.1.19325 Jun 2026·presentverdict: present

v2.1.19526 Jun 2026·presentverdict: present

v2.1.19629 Jun 2026·presentverdict: present

v2.1.19730 Jun 2026·presentverdict: present

v2.1.1981 Jul 2026·presentverdict: present

v2.1.1992 Jul 2026·presentverdict: present

v2.1.2003 Jul 2026·presentverdict: present

v2.1.2013 Jul 2026·presentverdict: present

v2.1.2026 Jul 2026·presentverdict: present

v2.1.2037 Jul 2026·presentverdict: present

v2.1.2048 Jul 2026·presentverdict: present

v2.1.2058 Jul 2026·presentverdict: present

v2.1.2069 Jul 2026·presentverdict: present

v2.1.20710 Jul 2026·presentverdict: present

v2.1.20813 Jul 2026·presentverdict: present

v2.1.20914 Jul 2026·presentverdict: present

v2.1.21014 Jul 2026·presentverdict: present

v2.1.21115 Jul 2026·presentverdict: present

v2.1.21216 Jul 2026·presentverdict: present

v2.1.21317 Jul 2026·presentverdict: present

v2.1.21418 Jul 2026·presentverdict: present

v2.1.21519 Jul 2026·presentverdict: present

v2.1.21620 Jul 2026·presentverdict: present

v2.1.21721 Jul 2026·presentverdict: present

v2.1.21822 Jul 2026·presentverdict: present

v2.1.21924 Jul 2026·presentverdict: present

v2.1.22024 Jul 2026·presentverdict: present

v2.1.2213 Aug 2026·presentverdict: present

v2.1.2224 Aug 2026·presentverdict: present

v2.1.2235 Aug 2026·presentverdict: present

v2.1.2247 Aug 2026·presentverdict: present

v2.1.2257 Aug 2026·presentverdict: present

v2.1.2268 Aug 2026·presentverdict: present

v2.1.22710 Aug 2026·presentverdict: present

v2.1.22811 Aug 2026·presentverdict: present

v2.1.22912 Aug 2026·presentverdict: present

v2.1.23113 Aug 2026·presentverdict: present

v2.1.23213 Aug 2026·presentverdict: present

v2.1.23314 Aug 2026·presentverdict: present

v2.1.23417 Aug 2026·presentverdict: present

v2.1.23518 Aug 2026·presentverdict: present

v2.1.23619 Aug 2026·presentverdict: present

v2.1.23719 Aug 2026·presentverdict: present

v2.1.23820 Aug 2026·presentverdict: present

v2.1.23921 Aug 2026·presentverdict: present

v2.1.24022 Aug 2026·presentverdict: present

v2.1.24122 Aug 2026·presentverdict: present

v2.1.24224 Aug 2026·presentverdict: present

v2.1.24324 Aug 2026·presentverdict: present

v2.1.24525 Aug 2026·presentverdict: present

v2.1.24625 Aug 2026·presentverdict: present

v2.1.24726 Aug 2026·presentverdict: present

v2.1.24827 Aug 2026·presentverdict: present

v2.1.25027 Aug 2026·presentverdict: present

v2.1.25128 Aug 2026·presentverdict: present

v2.1.25231 Aug 2026·presentverdict: present

v2.1.2571 Sep 2026·presentverdict: present

v2.1.2581 Sep 2026·presentverdict: present

v2.1.2592 Sep 2026·presentverdict: present

v2.1.2603 Sep 2026·presentverdict: present

v2.1.2614 Sep 2026·presentverdict: present

v2.1.2636 Sep 2026·presentverdict: present

v2.1.2658 Sep 2026·presentverdict: present

v2.1.2668 Sep 2026·presentverdict: present

v2.1.2679 Sep 2026·presentverdict: present

v2.1.26810 Sep 2026·presentverdict: present

v2.1.26911 Sep 2026·presentverdict: present

v2.1.27012 Sep 2026·presentverdict: present

v2.1.27114 Sep 2026·presentverdict: present

v2.1.27214 Sep 2026·presentverdict: present

v2.1.27315 Sep 2026·presentverdict: present

v2.1.27416 Sep 2026·presentverdict: present

v2.1.27517 Sep 2026·presentverdict: present

v2.1.27618 Sep 2026·presentverdict: present

v2.1.27718 Sep 2026·presentverdict: present

v2.1.27819 Sep 2026·presentverdict: present

v2.1.28022 Sep 2026·presentverdict: present

v2.1.28123 Sep 2026·presentverdict: present

v2.1.28224 Sep 2026·presentverdict: present

v2.1.28325 Sep 2026·presentverdict: present

v2.1.28428 Sep 2026·removedverdict: removed

v2.1.28529 Sep 2026·absent—

v2.1.28630 Sep 2026·absent—

v2.1.2871 Oct 2026·absent—

v2.1.2882 Oct 2026·absent—

v2.1.2893 Oct 2026·absent—

v2.1.2905 Oct 2026·absent—

v2.1.2916 Oct 2026·absent—

v2.1.2926 Oct 2026·absent—

v2.1.2937 Oct 2026·absent—

v2.1.2948 Oct 2026·absent—

v2.1.2958 Oct 2026·absent—

v2.1.2969 Oct 2026·absent—

v2.1.29914 Oct 2026·absent—

v2.1.30014 Oct 2026·absent—

v2.1.30115 Oct 2026·absent—

v2.1.30216 Oct 2026·absent—

v2.1.30318 Oct 2026·absent—

v2.1.30419 Oct 2026·absent—

v2.1.30520 Oct 2026·absent—

v2.1.30621 Oct 2026·absent—

v2.1.30721 Oct 2026·absent—

v2.1.30822 Oct 2026·absent—

v2.1.30922 Oct 2026·absent—

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.

Documentation pages 14

All settingsreference tableClaude Code CLI
Claude Code settingsreference tableClaude Code CLI
Agent SDK reference - TypeScriptmentions itClaude Code CLI
Claude apps gateway for Amazon Bedrock, Claude Platform on AWS, Google Cloud, and Microsoft Foundrymentions itClaude Code CLI
Claude apps gateway configurationmentions itClaude Code CLI
Claude apps gateway deployment and operationsmentions itClaude Code CLI
Deploy Claude apps gateway on AWSmentions itClaude Code CLI
Deploy Claude apps gateway on Google Cloudmentions itClaude Code CLI
Deploy managed settingsmentions itClaude Code CLI
Week 19 · May 4–8, 2026mentions itClaude Code CLI
Connect Claude Code to Claude for Governmentmentions itClaude Documentation
Security and data handlingmentions itClaude Documentation
Code in Claude Desktop on 3Pmentions itClaude Documentation
Configuration referencementions itClaude Documentation

A reference table page is one whose own table defines this name, and it is where the description above came from. A page that mentions it carries the name somewhere in its text and may say nothing about it at all. Every page carrying it.