Follow Discord
Sweep 25 Sep 2026 · 19:33Z Build v2.1.283 504 read Stable v2.1.274 Latest v2.1.283 Next v2.1.283 Feeds RSS JSON llms.txt llms-full.txt Unofficial

Claude Code v2.1.281 ·

Managed settings in host-managed gateway sessions: merge by default and no disk cache

In host-managed gateway sessions, parentSettingsBehavior defaults to merge and remote managed settings are no longer cached on disk

Group of 2 You'll notice Improvements
JSON All of v2.1.281
You'll noticeTier: how much it should matter to you
2Useful: my rating, 1 to 5
2Signal: worth watching, 1 to 5
Managed SettingsArea: what it touches
ImprovementsKind: in v2.1.281,
ImprovementsSection of the release

What

Managed settings are policies an organisation pushes to Claude Code. A host-managed gateway session is one where both CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST and CLAUDE_CODE_USE_GATEWAY are set. In these sessions, managed settings now behave differently.

  • parentSettingsBehavior controls whether restrictions passed in by an embedding host, such as the Claude Desktop app, are dropped or merged in. When a managed settings source does not set it, it now defaults to "merge" in a host-managed gateway session with a qualifying entrypoint, such as Claude Desktop's Code tab. Everywhere else it stays "first-wins". The setting's description was updated to match. Before, merging happened only when it was set to "merge" explicitly, or when there were no other managed settings at all.
  • Remote managed settings are no longer saved to disk in these sessions unless CLAUDE_CODE_REMOTE_SETTINGS_PATH is set. Reading the disk cache and preparing the storage backend also return early.
  • When the server replies that the settings have not changed, Claude Code skips writing the signature and skips the reset check under the same condition.
  • Each attempt to sign in for the settings fetch is now labelled with its sign-in method: gateway_jwt, oauth, api_key, profile or none. The gateway fingerprint is only worked out when the token is pinned.

Why

For Claude Desktop gateway users, the host's restrictions now combine with the organisation's policy by default instead of being dropped. These deployments also stop leaving a copy of the organisation's settings on disk.

Read from
Since it was published

The entry above is what we published on the day. These lines were added later, as Anthropic's own pages caught up, and they sit beside the original rather than replacing it.

Added since A small documentation edit on Claude Code gateway compatibility guide touched a line naming CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST after this was published. When a host platform that embeds Claude Code sets [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/en/env-vars), `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` doesn't stop auto mode sessions on Amazon Bedrock, Google Cloud's Agent Platform, Micro… llm-gateway-protocol see the edit
How sure we are
Something disagreesSomething we can check disagrees with this entry, or the writer said they could not settle it.
The writer flagged doubtThe finding does not say which entrypoints qualify for the new "merge" default.
Anthropic's documentation agreesA small documentation edit on Claude Code gateway compatibility guide touched a line naming CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST after this…

See this entry in the whole of v2.1.281 →

Feedback