{"name":"managedSourcesBehavior","slug":"managedsourcesbehavior","family":"setting","title":"Settings keys","noun":"settings key","description":"Compose every [managed source](\/docs\/en\/managed-settings.md#how-claude-code-combines-managed-sources) you deploy instead of using the highest-priority one alone","description_source":"docs","described_by":{"doc":"claude-code\/settings-reference","title":"All settings"},"presence":{"first_seen":"2.1.242","removed_in":"2.1.284","in_current_build":false,"newest_mined":"2.1.309","builds":33,"mined_builds":150,"first_cited":{"version":"2.1.242","released_at":"2026-08-24 19:16:14","spans":5}},"aliases":[],"entries":[{"version":"2.1.300","anchor":"cowork-cloud-holds-on-managed-policy-settings","heading":"Cowork cloud keeps strict managed policy settings once they are set","line":"In Cowork cloud, once certain managed policy settings are tightened, a later settings update can no longer loosen them","released_at":"2026-10-14 14:27:26","reason":"found in this entry's text"},{"version":"2.1.265","anchor":"managed-settings-sources-helper-config-from-lower-priority","heading":"Managed settings sources: helper config from lower-priority sources is now ignored with a warning when merged","line":"When merging managed settings from multiple sources, policy-helper configuration from lower-priority sources is now ignored with a warning","released_at":"2026-09-08 19:05:16","reason":"found in this entry's text, named in this entry"},{"version":"2.1.265","anchor":"policyhelpers-per-source-shadowing-warning-gated-behind-man","heading":"policyHelpers per-source shadowing warning gated behind managedSourcesBehavior: \"merge\"","line":"Claude Code now warns when multiple managed settings sources define conflicting policy helper config under merge mode","released_at":"2026-09-08 19:05:16","reason":"found in this entry's text, named in this entry"},{"version":"2.1.248","anchor":"module-initialisation-moved-from-first-use-to-startup","heading":"Module initialisation moved from first use to startup","line":"Nearly all modules now load their code at startup instead of on first use, shifting timing.","released_at":"2026-08-27 20:35:36","reason":"found in this entry's text"},{"version":"2.1.248","anchor":"two-new-settings-keys-named-wsl-settings-inheritance-and-man","heading":"Two new settings keys named: WSL settings inheritance and managed-source behaviour","line":"Two settings keys are named for WSL inheriting Windows settings and managed-source behaviour.","released_at":"2026-08-27 20:35:36","reason":"named in this entry, found in this entry's text"},{"version":"2.1.242","anchor":"managed-settings-can-now-merge-across-sources-instead-of-the","heading":"Managed settings can now merge across sources instead of the top one winning","line":"Admins can set managedSourcesBehavior to merge managed settings sources instead of only the top one.","released_at":"2026-08-24 19:16:14","reason":"named in this entry, found in this entry's text"}],"entries_total":6,"docs":[{"source":"claude-code","path":"settings-reference","title":"All settings","documented":true},{"source":"claude-code","path":"claude-apps-gateway","title":"Claude apps gateway for Amazon Bedrock, Claude Platform on AWS, Google Cloud, and Microsoft Foundry","documented":false},{"source":"claude-code","path":"managed-mcp","title":"Control MCP server access for your organization","documented":false},{"source":"claude-code","path":"managed-settings","title":"Deploy managed settings","documented":false},{"source":"claude-code","path":"monitoring-usage","title":"Monitoring","documented":false},{"source":"claude-code","path":"plugins\/org","title":"Manage Claude Code plugins for your organization","documented":false},{"source":"claude-code","path":"server-managed-settings","title":"Configure server-managed settings","documented":false},{"source":"claude-docs","path":"third-party\/claude-desktop\/configuration","title":"Configuration reference","documented":false}],"docs_total":8,"gates":[],"related":[],"url":"https:\/\/changelogs.core-directive.com\/reference\/setting\/managedsourcesbehavior","family_url":"https:\/\/changelogs.core-directive.com\/reference\/setting.json"}