CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST
A Claude Code environment variable, read out of the shipped bundle. It has been in the build since v2.1.138, including the newest one read.
Setting CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST makes the parent process dictate your model settings, ignoring your settings file.
Not Anthropic's. This is the line from the earliest changelog entry here that named it, v2.1.222.
In the changelogs
19Releases whose published page names CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST.
-
v2.1.307
Sessions started by the desktop app can use its claude.ai sign-in
Claude Code can now use a claude.ai sign-in passed over by the launcher that started it, such as the desktop app, and drops it when conditions no longer hold
named in this entry, found in this entry's text
-
v2.1.307
An OAuth token now wins over host-managed mode
With
CLAUDE_CODE_PROVIDER_MANAGED_BY_HOSTset, Claude Code now uses a supplied OAuth token instead of the host's sign-innamed in this entry, found in this entry's text
-
v2.1.287
Telemetry and feature-flag environment variables are gathered in a new list
Claude Code now keeps a list of the environment variables that affect telemetry and feature flags
found in this entry's text
-
v2.1.285
Bedrock and Vertex AI model checks remember results and recheck before falling back
On Bedrock and Vertex AI, Claude Code now remembers per-model access results with expiry and rechecks a model live before using it
found in this entry's text
-
v2.1.281
Remote managed settings are not written to disk when the provider is managed by the host
When a host manages the provider through a gateway, remote managed settings are no longer cached to disk and host policy merges by default
found in this entry's text, named in this entry
-
v2.1.281
Remote managed settings fetch: public-address gateway refusal and richer diagnostics
Fetching remote managed settings now refuses gateways that resolve to a public address and reports more about failures
found in this entry's text
-
v2.1.281
CLAUDE_CODE_HOST_GATEWAY_LINEAGE: new env var that marks sessions spawned by a Claude Desktop gatewayNew CLAUDE_CODE_HOST_GATEWAY_LINEAGE variable keeps child processes of a Desktop-hosted gateway session treated as host-managed
found in this entry's text
-
v2.1.281
CLAUDE_CODE_AUTO_MODE_SERVER split into a tri-state user switch
CLAUDE_CODE_AUTO_MODE_SERVERis now read as on, off or unset, so Claude Code can tell an unset variable from an explicit choicefound in this entry's text
-
v2.1.281
New managed-policy check for Desktop-hosted gateways
When Claude Desktop runs Claude Code through a gateway, Claude Code now checks that gateway against your organization's policy and explains failures
found in this entry's text, named in this entry
-
v2.1.261
New provider-managed env var list for gateway policy checks
A new provider-managed env var list decides gateway sign-in error wording.
found in this entry's text, named in this entry
-
v2.1.229
OpenTelemetry can be sent through Anthropic's first-party gateway
Telemetry can route through Anthropic's own gateway, but only under a narrow set of conditions.
named in this entry, found in this entry's text
-
v2.1.225
OAuth 401 recovery no longer silently replaces a user-supplied token
Your explicitly set OAuth token is no longer silently swapped for a stored credential after a 401.
named in this entry, found in this entry's text
-
v2.1.222
Host-managed provider sessions take model policy from the parent process
Setting CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST makes the parent process dictate your model settings, ignoring your settings file.
named in this entry, found in this entry's text
-
v2.1.212
Login Method Enforcement Improvements
found in this entry's text
-
v2.1.167
Auth validation bypass for host-managed providers
found in this entry's text
-
v2.1.167
Finer-grained
managedByHostflag trackingfound in this entry's text
-
v2.1.167
Auth-helper settings filtered under explicit host management
found in this entry's text
-
v2.1.124
Gateway model discovery for
ANTHROPIC_BASE_URLfound in this entry's text
-
v2.1.83
CLAUDE_CODE_PROVIDER_MANAGED_BY_HOSTEnvironment Variablefound in this entry's text
First cited
1The earliest release whose published evidence quoted CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST was v2.1.83, 24 Mar 2026. That is the oldest release this project wrote about it, so it is a floor on the name's age and not the release that introduced it. It is not a presence reading: which builds carried the name is the table below.
Presence across releases
1Build by build
150One row per release since the first build this name was read out of. Absent means the build was read and the name was not in it, never mined means no bundle for that release was ever archived, and a declared type or a default is only ever what that release's own bundle stated.
Read out of the published npm bundle release by release, and out of Anthropic's own documentation as this site captured it. Nothing on this page is a description anybody here wrote about what the environment variable does. All environment variables.