{"name":"CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST","slug":"claude-code-provider-managed-by-host","family":"env","title":"Environment variables","noun":"environment variable","description":"Setting CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST makes the parent process dictate your model settings, ignoring your settings file.","description_source":"entry","described_by":{"version":"2.1.222","anchor":"host-managed-provider-sessions-take-model-policy-from-the-pa"},"presence":{"first_seen":"2.1.138","removed_in":null,"in_current_build":true,"newest_mined":"2.1.308","builds":149,"mined_builds":149,"first_cited":{"version":"2.1.83","released_at":"2026-03-24 22:16:47","spans":1}},"aliases":[],"entries":[{"version":"2.1.307","anchor":"launcher-host-sign-in-for-the-desktop-app-is-new-in-this-bui","heading":"Sessions started by the desktop app can use its claude.ai sign-in","line":"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","released_at":"2026-10-21 20:47:18","reason":"named in this entry, found in this entry's text"},{"version":"2.1.307","anchor":"host-managed-auth-no-longer-overrides-an-explicit-oauth-toke","heading":"An OAuth token now wins over host-managed mode","line":"With `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` set, Claude Code now uses a supplied OAuth token instead of the host's sign-in","released_at":"2026-10-21 20:47:18","reason":"named in this entry, found in this entry's text"},{"version":"2.1.287","anchor":"telemetrygrowthbook-env-vars-added-to-a-list-likely-env-al","heading":"Telemetry and feature-flag environment variables are gathered in a new list","line":"Claude Code now keeps a list of the environment variables that affect telemetry and feature flags","released_at":"2026-10-01 16:59:25","reason":"found in this entry's text"},{"version":"2.1.285","anchor":"bedrockvertex-default-model-fallback-probing-reworked-with","heading":"Bedrock and Vertex AI model checks remember results and recheck before falling back","line":"On Bedrock and Vertex AI, Claude Code now remembers per-model access results with expiry and rechecks a model live before using it","released_at":"2026-09-29 17:32:09","reason":"found in this entry's text"},{"version":"2.1.281","anchor":"remote-managed-settings-are-not-written-to-disk-when-the-pro","heading":"Remote managed settings are not written to disk when the provider is managed by the host","line":"When a host manages the provider through a gateway, remote managed settings are no longer cached to disk and host policy merges by default","released_at":"2026-09-23 17:01:17","reason":"found in this entry's text, named in this entry"},{"version":"2.1.281","anchor":"remote-managed-settings-fetch-public-address-gateway-refusa","heading":"Remote managed settings fetch: public-address gateway refusal and richer diagnostics","line":"Fetching remote managed settings now refuses gateways that resolve to a public address and reports more about failures","released_at":"2026-09-23 17:01:17","reason":"found in this entry's text"},{"version":"2.1.281","anchor":"claude-code-host-gateway-lineage-new-env-var-that-marks-s","heading":"CLAUDE_CODE_HOST_GATEWAY_LINEAGE : new env var that marks sessions spawned by a Claude Desktop gateway","line":"New CLAUDE_CODE_HOST_GATEWAY_LINEAGE variable keeps child processes of a Desktop-hosted gateway session treated as host-managed","released_at":"2026-09-23 17:01:17","reason":"found in this entry's text"},{"version":"2.1.281","anchor":"claude-code-auto-mode-server-split-into-a-tri-state-user-swi","heading":"CLAUDE_CODE_AUTO_MODE_SERVER split into a tri-state user switch","line":"`CLAUDE_CODE_AUTO_MODE_SERVER` is now read as on, off or unset, so Claude Code can tell an unset variable from an explicit choice","released_at":"2026-09-23 17:01:17","reason":"found in this entry's text"},{"version":"2.1.281","anchor":"new-managed-policy-check-for-desktop-hosted-gateways","heading":"New managed-policy check for Desktop-hosted gateways","line":"When Claude Desktop runs Claude Code through a gateway, Claude Code now checks that gateway against your organization's policy and explains failures","released_at":"2026-09-23 17:01:17","reason":"found in this entry's text, named in this entry"},{"version":"2.1.261","anchor":"new-provider-managed-env-var-list-for-gateway-policy-checks","heading":"New provider-managed env var list for gateway policy checks","line":"A new provider-managed env var list decides gateway sign-in error wording.","released_at":"2026-09-04 17:49:34","reason":"found in this entry's text, named in this entry"}],"entries_total":19,"docs":[{"source":"claude-code","path":"agent-sdk\/typescript","title":"Agent SDK reference - TypeScript","documented":false},{"source":"claude-code","path":"changelog","title":"Claude Code changelog","documented":false},{"source":"claude-code","path":"data-usage","title":"Data usage","documented":false},{"source":"claude-code","path":"llm-gateway-protocol","title":"Claude Code gateway compatibility guide","documented":false},{"source":"claude-code","path":"mcp","title":"Connect Claude Code to tools via MCP","documented":false},{"source":"claude-code","path":"model-config","title":"Model configuration","documented":false},{"source":"claude-code","path":"network-config","title":"Enterprise network configuration","documented":false},{"source":"claude-code","path":"settings-reference","title":"All settings","documented":false}],"docs_total":8,"gates":[],"related":[{"name":"CLAUDE_CODE_3P_PROBE_WROTE_HAIKU_DEFAULT","slug":"claude-code-3p-probe-wrote-haiku-default","description":"If your cloud account cannot use a model, Claude Code can step down to the next one; `CLAUDE_CODE_DISABLE_MODEL_ACCESS_FALLBACK` turns this off"},{"name":"CLAUDE_CODE_3P_PROBE_WROTE_OPUS_DEFAULT","slug":"claude-code-3p-probe-wrote-opus-default","description":"Internal marker on third-party providers. When Claude Code itself writes `ANTHROPIC_DEFAULT_OPUS_MODEL` into its environment (the model availability probe on Bedrock, Vertex or Mantle, or a move down the model fallback ladder), it sets this variable to the same model ID. An `ANTHROPIC_DEFAULT_OPUS_MODEL` equal to it is treated as Claude Code's own choice rather than a user pin: it does not count as pinned, the probe does not skip it, and the fallback ladder may move it."},{"name":"CLAUDE_CODE_3P_PROBE_WROTE_SONNET_DEFAULT","slug":"claude-code-3p-probe-wrote-sonnet-default","description":"On third-party providers, Haiku model names are no longer skipped by the check that sets up the Sonnet default model"},{"name":"CLAUDE_CODE_3P_SEEDED_OPUS_DEFAULT","slug":"claude-code-3p-seeded-opus-default","description":"If your cloud account cannot use a model, Claude Code can step down to the next one; `CLAUDE_CODE_DISABLE_MODEL_ACCESS_FALLBACK` turns this off"},{"name":"CLAUDE_CODE_3P_SEEDED_SONNET_DEFAULT","slug":"claude-code-3p-seeded-sonnet-default","description":"If your cloud account cannot use a model, Claude Code can step down to the next one; `CLAUDE_CODE_DISABLE_MODEL_ACCESS_FALLBACK` turns this off"},{"name":"CLAUDE_CODE_ACCESSIBILITY","slug":"claude-code-accessibility","description":"Set to `1` to keep the native terminal cursor visible and disable the inverted-text cursor indicator. Allows screen magnifiers like macOS Zoom to track cursor position"},{"name":"CLAUDE_CODE_ACCOUNT_TAGGED_ID","slug":"claude-code-account-tagged-id","description":"Overrides the `user.account_id` attribute Claude Code attaches to its OpenTelemetry data. It applies only when an account UUID is known and `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` is not turned off (default on); when unset or empty, `user.account_id` is derived from the account UUID as a tagged ID of the form `user_01...`."},{"name":"CLAUDE_CODE_ACCOUNT_UUID","slug":"claude-code-account-uuid","description":"The device bridge is skipped entirely when the host's account UUID doesn't match the stored one."},{"name":"CLAUDE_CODE_ACT_DONT_REDERIVE","slug":"claude-code-act-dont-rederive","description":"Three existing feature gates moved position; their defaults are unchanged."},{"name":"CLAUDE_CODE_ACTION","slug":"claude-code-action","description":"Marks a run as coming from the Claude Code GitHub Action. A truthy value (`1`, `true`, `yes` or `on`) makes Claude Code set `CLAUDE_CODE_ENTRYPOINT` to `claude-code-github-action`, but only when `CLAUDE_CODE_ENTRYPOINT` is not already set and the command is not `claude mcp serve`. It is also reported as `isClaudeCodeAction` in the environment details attached to telemetry."}],"url":"https:\/\/changelogs.core-directive.com\/reference\/env\/claude-code-provider-managed-by-host","family_url":"https:\/\/changelogs.core-directive.com\/reference\/env.json"}