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

Claude Code v2.1.281 ·

Claude Desktop gateway sessions: lineage variable for child processes, deferred consent and managed-policy checks

Sessions run by Claude Desktop through a gateway pass that status to child processes, defer consent in background, and verify the gateway's policy

Group of 3 You'll notice Improvements
JSON All of v2.1.281
You'll noticeTier: how much it should matter to you
4Useful: my rating, 1 to 5
4Signal: worth watching, 1 to 5
GatewayArea: what it touches
ImprovementsKind: in v2.1.281,
What probably matters to youSection of the release

What

Claude Desktop can run Claude Code through an organization's gateway, a server between Claude Code and the model provider. This applies when CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST and CLAUDE_CODE_USE_GATEWAY are set. Several things changed for these sessions:

  • New environment variable CLAUDE_CODE_HOST_GATEWAY_LINEAGE. It is set to 1 for child processes spawned by such a session, including agent-team members (other Claude instances working alongside it) and subprocesses. A process that has it together with CLAUDE_CODE_HOST_CREDS_FILE is treated as gateway-managed even if Claude Desktop did not start it directly. The variable was added to Claude Code's environment variable lists, and the host-managed marker file records a lineage line. Nothing sets it by default; only a host process does.
  • Background sessions under such a gateway now defer the remote managed-settings security check instead of asking for consent. This applies when CLAUDE_CODE_SESSION_KIND is bg and the lineage variable and host credentials file are present. Before, the check was deferred only in non-interactive sessions.
  • The gateway address is now checked against forceLoginGatewayUrl and gatewayInternalNetworks. If the gateway is not an accepted source, you see "Your organization requires managed settings, but the gateway at ...". If the machine is outside the organization's network, the message says "this machine is no longer reaching it from inside your organization's network". If the gateway has no policy for the Desktop session, a warning points admins at serve_to_desktop.

Why

Helpers spawned from a Desktop gateway session keep the gateway's provider routing instead of losing it. Background workers are not stuck behind a consent dialog nobody can answer. In enterprise Desktop setups, startup can now stop with an explicit message when the gateway cannot be verified.

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.

Confirmed since Anthropic's documentation has since written up CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST, on Claude Code changelog. * Changed `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` sessions to ignore CA-bundle, tool-proxy, git TLS and git config variables like `SSL_CERT_FILE` in settings; under Claude Desktop, only in project settings changelog see the edit
Confirmed since Anthropic's documentation has since written up gatewayInternalNetworks, on Claude apps gateway deployment and operations. * **Declared block**: if your internal network uses public IPv4 space your organization owns, list the block in the `gatewayInternalNetworks` managed setting. The gateway and the user's machine must both be in that block. See [Allow a gate… claude-apps-gateway-deploy see the edit
Added since A small documentation edit on Claude apps gateway for Amazon Bedrock, Claude Platform on AWS, Google Cloud, and Microsoft Foundry touched a line naming gatewayInternalNetworks after this was published. Some organizations number their internal network from a public IPv4 block they own, such as a carrier's own address space or a legacy `/8`, so their gateway has no private address. List those blocks in the `gatewayInternalNetworks` managed… claude-apps-gateway see the edit
Confirmed since Anthropic's documentation has since written up forceLoginGatewayUrl, on All settings. * **A gateway sign-in's URL**: the session stays under `"gateway"`, and [`forceLoginGatewayUrl`](#forcelogingatewayurl) also counts as the pin settings-reference see the edit
Added since A small documentation edit on Claude apps gateway configuration touched a line naming forceLoginGatewayUrl after this was published. To stop developers from bypassing the gateway with a cloud provider variable or an `ANTHROPIC_BASE_URL` of their own, add `"allowedProviders": ["gateway"]` to the same file. Claude Code then refuses every session on the machine that isn't … claude-apps-gateway-config see the edit
How sure we are
One source agreesOne thing we can check says the same as this entry.
Anthropic's documentation agreesA small documentation edit on Claude apps gateway configuration touched a line naming forceLoginGatewayUrl after this was published.

See this entry in the whole of v2.1.281 →

Feedback