{"name":"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC","slug":"claude-code-disable-nonessential-traffic","family":"env","title":"Environment variables","noun":"environment variable","description":"Set to any non-empty value, such as `1`, to disable nonessential network traffic: auto-updates, telemetry, error reporting, the `\/feedback` command, [Claude-drafted feedback](\/docs\/en\/tools-reference#sendfeedback-tool-behavior), release notes, the [PR and MR status badge](\/docs\/en\/interactive-mode#pr-review-status) checks, and availability checks such as the [fast mode](\/docs\/en\/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) check. It also stops the [background runs of plugin `command` sources](\/docs\/en\/plugins\/loading#when-a-command-source-re-runs), which are local commands rather than network traffic, because they can trigger dependency installs. **Setting it to `0` or `false` still disables this traffic**, unlike most on\/off variables; unset the variable to allow it again. Also disables feature-flag fetching, which makes [Remote Control](\/docs\/en\/remote-control#requirements) and the other [features that need feature-flag fetching](#features-that-need-feature-flag-fetching) unavailable. Official plugin marketplace auto-install isn't covered; disable it with `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL`. Doesn't affect [gateway model discovery](\/docs\/en\/llm-gateway-connect#add-gateway-models-to-the-model-picker), which has its own opt-in","description_source":"docs","described_by":{"doc":"claude-code\/env-vars","title":"Environment variables"},"presence":{"first_seen":"2.1.138","removed_in":null,"in_current_build":true,"newest_mined":"2.1.309","builds":150,"mined_builds":150,"first_cited":{"version":"2.1.248","released_at":"2026-08-27 20:35:36","spans":3}},"aliases":[],"entries":[{"version":"2.1.307","anchor":"sdk-can-read-cloud-sessions-listgettranscript-with-detai","heading":"SDK programs can list and read cloud sessions","line":"Programs using the SDK can list cloud sessions, fetch one and read its transcript, with a clear reason when this is refused","released_at":"2026-10-21 20:47:18","reason":"found in this entry's text"},{"version":"2.1.304","anchor":"upload-files-error-check-replaced-by-a-bearer-keyed-answer-c","heading":"The file-upload check under the nonessential-traffic setting is now a yes-or-no check","line":"A check tied to the message about uploads being off under CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC now gives a yes-or-no answer from a saved reply","released_at":"2026-10-19 19:47:15","reason":"found in this entry's text, named in this entry"},{"version":"2.1.295","anchor":"claude-mcp-serve-gains-an-http-transport-port-and-ses","heading":"claude mcp serve gains an HTTP mode, limited to remote cloud sessions","line":"In remote cloud sessions only, `claude mcp serve` can now listen over HTTP with `--transport`, `--port` and `--session-tunnel`","released_at":"2026-10-08 18:22:58","reason":"found in this entry's text"},{"version":"2.1.287","anchor":"built-in-gh-api-stand-in-for-sessions-with-no-github-cli","heading":"Sessions without the GitHub CLI get a built-in gh api replacement","line":"When the GitHub CLI is missing, Claude Code can supply its own limited `gh` that runs `gh api` REST calls through the session's GitHub proxy","released_at":"2026-10-01 16:59:25","reason":"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.283","anchor":"remote-control-no-longer-needs-the-feature-flag-for-subscrib","heading":"Remote Control works for paid subscribers who turned telemetry off","line":"Pro, Max, Team and Enterprise users signed in with their Claude account can use Remote Control even with telemetry turned off","released_at":"2026-09-25 18:46:11","reason":"found in this entry's text"},{"version":"2.1.251","anchor":"feedback-and-bug-command-availability-checked-in-one-place","heading":"Feedback and bug command availability checked in one place","line":"The switches hiding \/feedback and \/bug now behave the same in menus and commands.","released_at":"2026-08-28 15:34:26","reason":"named in this entry, found in this entry's text"},{"version":"2.1.248","anchor":"telemetry-opt-out-variables-grouped-in-one-set","heading":"Telemetry opt-out variables grouped in one set","line":"Telemetry opt-out environment variables are now collected in one set alongside a forwarded allowlist.","released_at":"2026-08-27 20:35:36","reason":"found in this entry's text"},{"version":"2.1.218","anchor":"env-var-allowlist-greatly-expanded","heading":"Env Var Allowlist Greatly Expanded","line":null,"released_at":"2026-07-22 19:55:32","reason":"found in this entry's text"},{"version":"2.1.174","anchor":"projects-tool-read-and-write-claude-ai-project-docs","heading":"Projects Tool \u2014 Read and Write claude.ai Project Docs","line":null,"released_at":"2026-06-11 22:27:52","reason":"found in this entry's text"}],"entries_total":17,"docs":[{"source":"claude-code","path":"env-vars","title":"Environment variables","documented":true},{"source":"claude-code","path":"admin-setup","title":"Set up Claude Code for your organization","documented":false},{"source":"claude-code","path":"artifacts","title":"Share session output as artifacts","documented":false},{"source":"claude-code","path":"changelog","title":"Claude Code changelog","documented":false},{"source":"claude-code","path":"claude-apps-gateway-deploy","title":"Claude apps gateway deployment and operations","documented":false},{"source":"claude-code","path":"claude-apps-gateway-spend-limits","title":"Claude apps gateway spend limits","documented":false},{"source":"claude-code","path":"data-usage","title":"Data usage","documented":false},{"source":"claude-code","path":"devcontainer","title":"Development containers","documented":false},{"source":"claude-code","path":"fast-mode","title":"Speed up responses with fast mode","documented":false},{"source":"claude-code","path":"gateways","title":"Run Claude Code through a gateway","documented":false}],"docs_total":13,"gates":[],"related":[{"name":"CLAUDE_CODE_DISABLE_1M_CONTEXT","slug":"claude-code-disable-1m-context","description":"Set to `1` to disable [1M context window](\/docs\/en\/model-config#extended-context) support. When set, 1M model variants are unavailable in the model picker, and Claude Code holds sessions on models with a native 1M window, such as [Sonnet 5.5](\/docs\/en\/model-config#sonnet-5-5-and-sonnet-5-context-window) and the Fable models, to a 200K window; see [Extended context](\/docs\/en\/model-config#extended-context) for how the hold is enforced. Useful for enterprise environments with compliance requirements. For its role in correcting the window for an unrecognized `[1m]` model ID, see [Correct the window for a gateway or custom model ID](\/docs\/en\/model-config#correct-the-window-for-a-gateway-or-custom-model-id)"},{"name":"CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING","slug":"claude-code-disable-adaptive-thinking","description":"Set to `1` to disable [adaptive reasoning](\/docs\/en\/model-config#adjust-effort-level) on Opus 4.6 and Sonnet 4.6 and fall back to the fixed thinking budget controlled by `MAX_THINKING_TOKENS`. Has no effect on [Fable models](\/docs\/en\/model-config#extended-thinking), Sonnet 5 and later, or Opus 4.7 and later, which always use adaptive reasoning"},{"name":"CLAUDE_CODE_DISABLE_ADMIN_ENV_UNION","slug":"claude-code-disable-admin-env-union","description":"Set to `1` to stop Claude Code from merging [managed settings](\/docs\/en\/managed-settings#precedence-within-the-managed-tier) `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"},{"name":"CLAUDE_CODE_DISABLE_ADVISOR_TOOL","slug":"claude-code-disable-advisor-tool","description":"Set to `1` to disable the [advisor tool](\/docs\/en\/advisor). The `\/advisor` command becomes unavailable, any configured `advisorModel` is ignored, and the `--advisor` flag is accepted but has no effect, so existing scripts that pass it continue to work without errors"},{"name":"CLAUDE_CODE_DISABLE_AGENT_VIEW","slug":"claude-code-disable-agent-view","description":"Set to `1` to turn off [background agents and agent view](\/docs\/en\/agent-view): `claude agents`, `--bg`, `\/background`, and the on-demand supervisor. Equivalent to the [`disableAgentView`](\/docs\/en\/settings-reference#disableagentview) setting"},{"name":"CLAUDE_CODE_DISABLE_AGENTS_FLEET","slug":"claude-code-disable-agents-fleet","description":"A true value (`1`, `true`, `yes`, `on`) turns off the background-agents fleet, the same as the `disableBackgroundAgents` setting: the fleet gate that otherwise follows `tengu_slate_meadow` returns false, so `claude daemon` subcommands that need the gate stop with `'daemon' is not enabled.`, the built-in Claude agent is left out of the built-in agent list, and `claude daemon run` exits with `claude daemon: background agents disabled (ZDR\/3P\/opt-out)`."},{"name":"CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN","slug":"claude-code-disable-alternate-screen","description":"Set to `1` to disable [fullscreen rendering](\/docs\/en\/fullscreen) and use the classic main-screen renderer. The conversation stays in your terminal's native scrollback so `Cmd+f` and tmux copy mode work as usual. Takes precedence over `CLAUDE_CODE_NO_FLICKER` and the [`tui`](\/docs\/en\/settings-reference#tui) setting. You can also switch with `\/tui default`. Does not apply to background sessions opened from [agent view](\/docs\/en\/agent-view), which always use fullscreen rendering"},{"name":"CLAUDE_CODE_DISABLE_ARTIFACT","slug":"claude-code-disable-artifact","description":"Set to `1` to turn off the [Artifact](\/docs\/en\/artifacts) tool, which publishes session output as a private web page on claude.ai. Once you set it, no settings file turns the tool back on. To turn the tool off from a settings file instead, set [`enableArtifact`](\/docs\/en\/settings-reference#enableartifact) to `false`; the deprecated [`disableArtifact`](\/docs\/en\/settings-reference#disableartifact) key also turns it off"},{"name":"CLAUDE_CODE_DISABLE_ATTACHMENTS","slug":"claude-code-disable-attachments","description":"Set to `1` to disable attachment processing. File mentions with `@` syntax are sent as plain text instead of being expanded into file content"},{"name":"CLAUDE_CODE_DISABLE_ATTRIBUTION_BASELINE_REUSE","slug":"claude-code-disable-attribution-baseline-reuse","description":null}],"url":"https:\/\/changelogs.core-directive.com\/reference\/env\/claude-code-disable-nonessential-traffic","family_url":"https:\/\/changelogs.core-directive.com\/reference\/env.json"}