{"name":"env","slug":"env","family":"setting","title":"Settings keys","noun":"settings key","description":"Set [environment variables](\/docs\/en\/env-vars#in-settings-files) for every session and its subprocesses","description_source":"docs","described_by":{"doc":"claude-code\/settings-reference","title":"All settings"},"presence":{"first_seen":"2.1.138","removed_in":"2.1.302","in_current_build":false,"newest_mined":"2.1.308","builds":127,"mined_builds":149,"first_cited":null},"aliases":[],"entries":[{"version":"2.1.307","anchor":"policyonlyleads-now-disables-the-admin-env-union-opt-out","heading":"A managed policy can override CLAUDE_CODE_DISABLE_ADMIN_ENV_UNION","line":"When a managed policy sets `policyOnlyLeads`, Claude Code merges admin `env` blocks even if `CLAUDE_CODE_DISABLE_ADMIN_ENV_UNION` is set","released_at":"2026-10-21 20:47:18","reason":"found in this entry's text"},{"version":"2.1.307","anchor":"bun-spawn-options-now-keep-a-users-bun-options-with-a-more","heading":"Your BUN_OPTIONS value is now passed on to child processes from more places","line":"Processes Claude Code starts now keep your `BUN_OPTIONS` value from the process, settings or system environment, still after `--install=disable`","released_at":"2026-10-21 20:47:18","reason":"found in this entry's text"},{"version":"2.1.305","anchor":"api-timeout-ms-error-hint-now-read-from-the-settings-env-sh","heading":"Timeout hint now notices API_TIMEOUT_MS set in settings","line":"The hint to raise API_TIMEOUT_MS after a timeout now uses the value from settings too, and only appears when it is above zero","released_at":"2026-10-20 19:29:36","reason":"found in this entry's text"},{"version":"2.1.302","anchor":"new-no-llm-gateway-error-for-background-sessions-opened-fr","heading":"Clear gateway message for background sessions opened from another folder","line":"A background session opened from another folder without its LLM gateway now says so, instead of asking you to log in","released_at":"2026-10-16 16:48:28","reason":"found in this entry's text"},{"version":"2.1.301","anchor":"hooks-are-tagged-as-organization-owned-or-not-before-they-ru","heading":"Hooks are now marked as your organization's or yours before they run","line":"Claude Code now labels each hook, `statusLine` and `fileSuggestion` command as organization-owned or not before running it","released_at":"2026-10-15 14:34:23","reason":"found in this entry's text"},{"version":"2.1.299","anchor":"billing-header-adds-cc-gateway-marker","heading":"Requests through a non-Anthropic gateway carry a gateway marker","line":"When you use a gateway whose address is not a trusted Anthropic host, Claude Code's attribution header adds a `cc_gateway` marker","released_at":"2026-10-14 00:23:19","reason":"found in this entry's text"},{"version":"2.1.299","anchor":"settings-env-filtering-tracks-a-dropped-git-key","heading":"Claude Code notes when a git-related variable is dropped from a settings file","line":"When applying environment variables from settings files, Claude Code now records when a git-related key was dropped and reads each layer's own block","released_at":"2026-10-14 00:23:19","reason":"found in this entry's text"},{"version":"2.1.295","anchor":"new-claude-code-restrict-personal-config-mode-limits-what-a","heading":"A new setting limits what your own skills, agents and hooks can do","line":"Setting CLAUDE_CODE_RESTRICT_PERSONAL_CONFIG stops your own skills, agents and hooks from widening permissions, and makes key hooks required","released_at":"2026-10-08 18:22:58","reason":"found in this entry's text"},{"version":"2.1.293","anchor":"env-var-scan-of-settings-files-now-returns-names","heading":"Settings check now lists which environment variables your settings files set","line":"A check on your settings files now reports the names of environment variables they set, and treats project settings as their own level","released_at":"2026-10-07 17:18:04","reason":"found in this entry's text"},{"version":"2.1.293","anchor":"desktop-config-schema-new-claudecodeprocesswrapperenabled-k","heading":"Desktop app can start its Claude Code through a corporate launcher","line":"A new managed setting, `claudeCodeProcessWrapperEnabled`, makes the desktop app start Claude Code through the launcher named in `processWrapper`","released_at":"2026-10-07 17:18:04","reason":"found in this entry's text"}],"entries_total":60,"docs":[{"source":"claude-code","path":"settings-reference","title":"All settings","documented":true},{"source":"claude-code","path":"settings","title":"Claude Code settings","documented":true}],"docs_total":2,"gates":[],"related":[],"url":"https:\/\/changelogs.core-directive.com\/reference\/setting\/env","family_url":"https:\/\/changelogs.core-directive.com\/reference\/setting.json"}