Admin settings tiers now union their env blocks, with an opt-out

Admin and managed settings now merge their env blocks instead of one replacing the other; you can opt out.

Use it now Notable No documentation found New Features

JSON All of v2.1.223

Use it nowTier: how much it should matter to you

4Useful: my rating, 1 to 5

0Signal: worth watching, 1 to 5

SettingsArea: what it touches

New FeaturesKind: in v2.1.223, 05 Aug 26

What probably matters to youSection of the release

What

Managed and admin settings tiers used to let the winning tier's env replace the ones below it; the blocks are now merged key by key.

Details

merging is case-insensitive for a known prefix set, and accounts for OTel-header helpers and per-tier suppression sets
set CLAUDE_CODE_DISABLE_ADMIN_ENV_UNION to true to restore replace-wins behaviour
diagnostic counters record whether the union changed the effective env and which tiers were present
CLAUDE_CODE_MANAGED_SETTINGS_PATH and CLAUDE_CODE_DISABLE_ADMIN_ENV_UNION were added to the settings env allowlists and the sensitive/managed env sets, alongside new local-OAuth and bridge dev variables CLAUDE_BRIDGE_BASE_URL, CLAUDE_BRIDGE_OAUTH_TOKEN and CLAUDE_BRIDGE_SESSION_INGRESS_URL

Evidence

CLAUDE_CODE_DISABLE_ADMIN_ENV_UNION, CLAUDE_BRIDGE_SESSION_INGRESS_URL

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

Read from

How sure we are

One source agreesOne thing we can check says the same as this entry.

The name it cites is new in this buildNew in this build: CLAUDE_CODE_DISABLE_ADMIN_ENV_UNION

The build it came inv2.1.223

5 Aug 2026 · 201 entries, this one is #17.

Either side of it

Open the release →

Names in this entry

settingenv
Set environment variables for every session and its subprocesses
envCLAUDE_CODE_DISABLE_ADMIN_ENV_UNION
Set to 1 to stop Claude Code from merging managed settings env blocks per key across admin sources, so only the highest-priority source's whole env block applies, as before v2.1.223. Set it in the environment that launches Claude Code, since Claude Code ignores a copy delivered through a settings env block. Requires Claude Code v2.1.223 or later
envCLAUDE_CODE_MANAGED_SETTINGS_PATH
Admin and managed settings now merge their env blocks instead of one replacing the other; you can opt out.
envCLAUDE_BRIDGE_BASE_URL
Admin and managed settings now merge their env blocks instead of one replacing the other; you can opt out.
envCLAUDE_BRIDGE_OAUTH_TOKEN
Admin and managed settings now merge their env blocks instead of one replacing the other; you can opt out.
envCLAUDE_BRIDGE_SESSION_INGRESS_URL
Admin and managed settings now merge their env blocks instead of one replacing the other; you can opt out.

Is this right?