Follow Discord
Sweep 22 Oct 2026 · 04:32Z Build v2.1.308 527 read Stable v2.1.308 Latest v2.1.308 Next v2.1.308 Feeds RSS JSON llms.txt llms-full.txt Unofficial

Claude Code v2.1.242 ·

Policy helper output can merge into a source's settings instead of replacing it

Policy helper output can merge into a source's settings, so a failure costs less.

Use it now New Features
JSON All of v2.1.242
Use it nowTier: how much it should matter to you
2Useful: my rating, 1 to 5
2Signal: worth watching, 1 to 5
Managed SettingsArea: what it touches
New FeaturesKind: in v2.1.242,
What probably matters to youSection of the release
What

An entry in an enterprise policy helper can declare how its produced managed settings combine with the settings of the source that delivered it: replace, the default and current behaviour, or merge, a deep merge over that source's own settings. Under merge a helper that fails costs only the keys it would have contributed, rather than the whole policy.

Details
  • Under merge, helper keys win and arrays replace rather than concatenate.
  • Helper validation now also records the script's size and a flag for whether the entry merges its output.
  • Status notices include non-status errors when the helper merges.
Evidence

"How the helper's managedSettings compose with the settings of the source that delivered this entry: 'replace' (default) — the output is the policy; 'merge' — the output is deep-merged over that source's own settings (helper keys win, arrays replace), so a failed helper costs only the delta"

Strings lifted out of the shipped bundle, so the claim above can be checked against them.

Read from
Names in the bundlemergereplace
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 apps gateway configuration touched a line naming merge after this was published. Set it to `1` only in the policies whose groups you want traced. A policy that doesn't set it inherits the value from your `match: {}` catch-all policy if that policy sets one, per the [merge rules](#managed). To keep a group's clients fro… claude-apps-gateway-config see the edit
Confirmed since Anthropic's documentation has since written up replace, on Error reference. | `the source file has the replacement character U+FFFD` | [Tool errors](#the-source-file-is-not-valid-utf-8-text) | errors see the edit
Added since A small documentation edit on Share session output as artifacts touched a line naming replace after this was published. | Source file types | The published file must be `.html`, `.htm`, or `.md`, and must decode as UTF-8, or as little-endian UTF-16 by its byte-order mark. Markdown files render as styled HTML. A file that doesn't decode, or that contains the… artifacts see the edit
Confirmed since Anthropic's documentation has since written up merge, on Give Claude access to your tools. **Security Guidance** is off by default. Add it directly on a scope, or turn it on in a bundle's **Plugins** tab, and new threads in covered channels pick it up. The plugin flags problems and suggests fixes; it doesn't block a commit or a … claude-tag/admins/add-connections see the edit
How sure we are
One source agreesOne thing we can check says the same as this entry.
Anthropic's documentation agreesAnthropic's documentation has since written up merge, on Give Claude access to your tools.

See this entry in the whole of v2.1.242 →

Feedback