CLAUDE_BG_WORKSPACE_TRUSTED
A Claude Code environment variable, read out of the shipped bundle. It has been in the build since v2.1.281, including the newest one read.
Background sessions started from a trusted home directory keep that trust, and warn you when they lose it
Not Anthropic's. This is the line from the earliest changelog entry here that named it, v2.1.281.
In the changelogs
4Releases whose published page names CLAUDE_BG_WORKSPACE_TRUSTED.
-
v2.1.293
Background relaunch now also passes a prompt fingerprint variable
Claude Code now passes
CLAUDE_BG_CARRIED_PROMPTS_SHA256to background sessions alongsideCLAUDE_BG_WORKSPACE_TRUSTEDfound in this entry's text
-
v2.1.284
Background relaunch in a trusted folder passes more environment variables
When Claude Code relaunches itself with
CLAUDE_BG_WORKSPACE_TRUSTED, it now also passes along extra environment variables and clears one firstfound in this entry's text, named in this entry
-
v2.1.281
Background sessions started from a trusted home directory now carry that trust, with a warning when it is lost
Background sessions started from a trusted home directory keep that trust, and warn you when they lose it
found in this entry's text, named in this entry
-
v2.1.281
Session reattach now checks workspace trust and runs untrusted when trust isn't recorded
A reattached background session now checks workspace trust and, if none is recorded, runs untrusted with hooks and project settings env off
found in this entry's text, named in this entry
First cited
1The earliest release whose published evidence quoted CLAUDE_BG_WORKSPACE_TRUSTED was v2.1.281, 23 Sep 2026. That is the oldest release this project wrote about it, so it is a floor on the name's age and not the release that introduced it. It is not a presence reading: which builds carried the name is the table below.
Presence across releases
1Build by build
38One row per release since the first build this name was read out of. Absent means the build was read and the name was not in it, never mined means no bundle for that release was ever archived, and a declared type or a default is only ever what that release's own bundle stated.
Read out of the published npm bundle release by release, and out of Anthropic's own documentation as this site captured it. Nothing on this page is a description anybody here wrote about what the environment variable does. All environment variables.