{"name":"CLAUDE_CODE_DISABLE_BG_STABLE_PATH","slug":"claude-code-disable-bg-stable-path","family":"env","title":"Environment variables","noun":"environment variable","description":"On macOS, setting CLAUDE_CODE_DISABLE_BG_STABLE_PATH makes background sessions relaunch from the running program instead of the stable path","description_source":"entry","described_by":{"version":"2.1.295","anchor":"claude-code-disable-bg-stable-path-opts-out-of-the-stable-ex"},"presence":{"first_seen":"2.1.295","removed_in":null,"in_current_build":true,"newest_mined":"2.1.295","builds":1,"mined_builds":138,"first_cited":{"version":"2.1.295","released_at":"2026-10-08 18:22:58","spans":1}},"aliases":[],"entries":[{"version":"2.1.295","anchor":"claude-code-disable-bg-stable-path-opts-out-of-the-stable-ex","heading":"New setting to stop background sessions on macOS using the stable program path","line":"On macOS, setting CLAUDE_CODE_DISABLE_BG_STABLE_PATH makes background sessions relaunch from the running program instead of the stable path","released_at":"2026-10-08 18:22:58","reason":"found in this entry's text"}],"entries_total":1,"docs":[],"docs_total":0,"gates":[],"related":[{"name":"CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF","slug":"claude-code-disable-bg-exit-handoff","description":"Set to `1` to stop a [background session's](\/docs\/en\/agent-view) running background shell commands, dynamic workflows, and, as of v2.1.198, background subagents when the [supervisor](\/docs\/en\/agent-view#the-supervisor-process) stops, restarts, or updates that session's process, instead of handing them to the session's next process. Affects only that handoff: backgrounding a session with `\u2190` or [`\/background`](\/docs\/en\/agent-view#from-inside-a-session) still carries in-flight work over, and `CLAUDE_DISABLE_ADOPT` turns off both. Requires Claude Code v2.1.196 or later"},{"name":"CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP","slug":"claude-code-disable-bg-shell-pressure-reap","description":"Set to `1` to stop Claude Code from terminating [background shell commands](\/docs\/en\/interactive-mode#background-bash-commands) under memory pressure. By default, on macOS and Linux, Claude Code terminates background shells when the operating system reports critical memory pressure and the session has been idle for 30 minutes with no turn or subagent running. Windows has no memory-pressure signal, so this variable has no effect there. Requires Claude Code v2.1.193 or later"}],"url":"https:\/\/changelogs.core-directive.com\/reference\/env\/claude-code-disable-bg-stable-path","family_url":"https:\/\/changelogs.core-directive.com\/reference\/env.json"}