{"name":"CLAUDE_BG_BACKEND","slug":"claude-bg-backend","family":"env","title":"Environment variables","noun":"environment variable","description":"With the daemon background backend, the display survives stdout disappearing instead of dying.","description_source":"entry","described_by":{"version":"2.1.227","anchor":"renderer-survives-a-dead-stdout-under-the-daemon-background-"},"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.227","released_at":"2026-08-10 20:56:57","spans":2}},"aliases":[],"entries":[{"version":"2.1.292","anchor":"alt-screen-repaint-uses-a-different-erase-unless-daemon-back","heading":"Full-screen redraws may clear the screen differently","line":"When Claude Code redraws its full-screen view, it may now clear old content a different way, except when `CLAUDE_BG_BACKEND` is `daemon`","released_at":"2026-10-06 17:10:31","reason":"found in this entry's text, named in this entry"},{"version":"2.1.290","anchor":"new-backgroundpty-env-vars-added-to-a-passthrough-list","heading":"Seven background-session environment variable names added to an internal list","line":"Claude Code adds seven environment variable names for background sessions and terminal hosts to a list it keeps of such names","released_at":"2026-10-05 18:12:44","reason":"found in this entry's text"},{"version":"2.1.269","anchor":"synchronized-output-detection-function-rewritten-from-git-ob","heading":"Synchronized-output detection function rewritten from git object-format check to terminal sync-output gate","line":"Terminal sync-output detection rewritten from a git repo check to a real synchronized-output check","released_at":"2026-09-11 18:12:49","reason":"found in this entry's text"},{"version":"2.1.251","anchor":"background-daemon-workers-try-to-claim-a-controlling-termina","heading":"Background daemon workers try to claim a controlling terminal","line":"Daemon-mode background workers now try to claim a controlling terminal at startup.","released_at":"2026-08-28 15:34:26","reason":"found in this entry's text"},{"version":"2.1.227","anchor":"renderer-survives-a-dead-stdout-under-the-daemon-background-","heading":"Renderer survives a dead stdout under the daemon background backend","line":"With the daemon background backend, the display survives stdout disappearing instead of dying.","released_at":"2026-08-10 20:56:57","reason":"found in this entry's text"}],"entries_total":5,"docs":[],"docs_total":0,"gates":[],"related":[{"name":"CLAUDE_BG_AUTH_SNAPSHOT_PATH","slug":"claude-bg-auth-snapshot-path","description":"Bridge-spawned child sessions no longer inherit your credential environment variables."},{"name":"CLAUDE_BG_AUTO_MEMORY_OFF","slug":"claude-bg-auto-memory-off","description":"Claude Code now tracks auto-memory being off for a session and adds a notice that memory is still paused from earlier"},{"name":"CLAUDE_BG_CARRIED_PROMPTS_SHA256","slug":"claude-bg-carried-prompts-sha256","description":"Claude Code now passes `CLAUDE_BG_CARRIED_PROMPTS_SHA256` to background sessions alongside `CLAUDE_BG_WORKSPACE_TRUSTED`"},{"name":"CLAUDE_BG_CLAIM_AUTH","slug":"claude-bg-claim-auth","description":"Claude Code adds seven environment variable names for background sessions and terminal hosts to a list it keeps of such names"},{"name":"CLAUDE_BG_DISPATCHER_RATE_LIMIT_TIER","slug":"claude-bg-dispatcher-rate-limit-tier","description":"Two env vars let background dispatchers inherit your plan and rate tier without an API call."},{"name":"CLAUDE_BG_DISPATCHER_SUBSCRIPTION_TYPE","slug":"claude-bg-dispatcher-subscription-type","description":"Two env vars let background dispatchers inherit your plan and rate tier without an API call."},{"name":"CLAUDE_BG_GATEWAY_WITHHELD","slug":"claude-bg-gateway-withheld","description":"`CLAUDE_BG_GATEWAY_WITHHELD` is now removed along with other background-session variables, so it does not carry into sessions started from there"},{"name":"CLAUDE_BG_ISOLATION","slug":"claude-bg-isolation","description":"Background worktree isolation now reads CLAUDE_BG_ISOLATION from a captured environment copy."},{"name":"CLAUDE_BG_MEMORY_TOGGLED_OFF","slug":"claude-bg-memory-toggled-off","description":"Background sessions now start from a cleaned environment, with login variables added back and some internal variables left out"},{"name":"CLAUDE_BG_POST_CLEAR_RESPAWN","slug":"claude-bg-post-clear-respawn","description":"Set to `1` by the background-session daemon when it respawns a background session whose session id changed since it was dispatched, as after a `\/clear`. When truthy at startup, two checks that otherwise apply to launches without `--resume` or `--continue` are skipped: validation of an inline `--agents` JSON string and the `--agent '<name>' not found` error."}],"url":"https:\/\/changelogs.core-directive.com\/reference\/env\/claude-bg-backend","family_url":"https:\/\/changelogs.core-directive.com\/reference\/env.json"}