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 to1for 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 withCLAUDE_CODE_HOST_CREDS_FILEis 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 alineageline. 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_KINDisbgand 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
forceLoginGatewayUrlandgatewayInternalNetworks. 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 atserve_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.
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.
* 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 settingschangelog see the edit
* **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
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
* **A gateway sign-in's URL**: the session stays under `"gateway"`, and [`forceLoginGatewayUrl`](#forcelogingatewayurl) also counts as the pinsettings-reference see the edit
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
A small documentation edit on Claude apps gateway configuration touched a line naming forceLoginGatewayUrl after this was published.