{"name":"CLAUDE_CODE_BG_TASKS_REPORT_RUNNING","slug":"claude-code-bg-tasks-report-running","family":"env","title":"Environment variables","noun":"environment variable","description":"Set to `0` to make a non-interactive session report an idle status to its host at every turn end, even while background work is still running. By default, the session keeps reporting a running status past turn end while background work such as a background agent or a [workflow](\/docs\/en\/workflows) run is still live. This keeps a host that watches the status, such as a remote session list, from announcing that Claude is waiting for your input mid-work. Background shell commands, such as a dev server, don't hold the running status. The running-status default and the `0` opt-out require Claude Code v2.1.269 or later; on earlier versions, set `1` to hold the running status","description_source":"docs","described_by":{"doc":"claude-code\/env-vars","title":"Environment variables"},"presence":{"first_seen":"2.1.181","removed_in":null,"in_current_build":true,"newest_mined":"2.1.309","builds":112,"mined_builds":150,"first_cited":{"version":"2.1.239","released_at":"2026-08-21 17:18:54","spans":2}},"aliases":[],"entries":[{"version":"2.1.269","anchor":"background-tasks-report-running-flag-now-defaults-to-on","heading":"Background-tasks 'report running' flag now defaults to on","line":"Background task 'running' status is now reported by default, controlled by an env var","released_at":"2026-09-11 18:12:49","reason":"found in this entry's text, named in this entry"},{"version":"2.1.261","anchor":"new-per-phase-cpu-telemetry-gated-behind-claude-code-remote","heading":"New per-phase CPU telemetry, gated behind CLAUDE_CODE_REMOTE","line":"Remote sessions now report per-phase CPU usage split between CLI and tool subprocesses.","released_at":"2026-09-04 17:49:34","reason":"found in this entry's text"},{"version":"2.1.246","anchor":"headless-idle-detection-now-waits-for-background-tasks-and-u","heading":"Headless idle detection now waits for background tasks and undelivered notifications","line":"Headless runs no longer look finished while background tasks or undelivered notifications remain.","released_at":"2026-08-25 19:17:34","reason":"found in this entry's text"},{"version":"2.1.246","anchor":"rewinding-a-remote-session-now-stops-the-background-agents-i","heading":"Rewinding a remote session now stops the background agents it rewound past","line":"Rewinding a remote session now stops the background agents started inside the rewound span.","released_at":"2026-08-25 19:17:34","reason":"found in this entry's text"},{"version":"2.1.239","anchor":"idle-detection-can-dump-its-state-for-debugging","heading":"Idle detection can dump its state for debugging","line":"Set an environment variable to dump running tasks and teammate state whenever a session is judged idle.","released_at":"2026-08-21 17:18:54","reason":"named in this entry, found in this entry's text"}],"entries_total":5,"docs":[{"source":"claude-code","path":"env-vars","title":"Environment variables","documented":true}],"docs_total":1,"gates":[],"related":[{"name":"CLAUDE_CODE_BG_CLASSIFIER_MODEL","slug":"claude-code-bg-classifier-model","description":null}],"url":"https:\/\/changelogs.core-directive.com\/reference\/env\/claude-code-bg-tasks-report-running","family_url":"https:\/\/changelogs.core-directive.com\/reference\/env.json"}