worktree
A Claude Code settings key, read out of the shipped bundle. It was in the build from v2.1.138 and was gone by v2.1.284.
Configure how Claude Code creates git worktrees
Anthropic's own wording. Read off All settings, captured 2026-10-22.
In the changelogs
23Releases whose published page names worktree.
-
v2.1.307
Claude Code can check whether a repository's git settings pull in other files
A new check looks in a repository's
configandconfig.worktreefiles for an[includesectionfound in this entry's text
-
v2.1.299
Git clone, init and worktree commands are recognised differently
Claude Code now reads git commands in their original order when spotting
clone,initorworktree, instead of removing options firstfound in this entry's text
-
v2.1.295
Cloud agents cannot be launched from a session that restricts personal config
With
CLAUDE_CODE_RESTRICT_PERSONAL_CONFIGset, launching a cloud agent is refused and you are told to use worktree isolationfound in this entry's text
-
v2.1.284
Clearer error when a worktree's own config file blocks sending it to a remote session
When sending a git worktree to a remote session fails because of a harmless config.worktree file, Claude Code now gives a specific reason
found in this entry's text
-
v2.1.281
Bridge honours a server request to run a session in a worktree
Remote Control sessions now run in a git worktree whenever the server asks for one, and run in place if the folder is not a git repo
found in this entry's text
-
v2.1.281
New telemetry allowlist entry and small settings/schema additions
Several small internal additions, including a worktree setting beside auto_mode_environment and a new input_low_latency_submit event
found in this entry's text
-
v2.1.280
Warning added when dispatching parallel write-capable agents into the same directory
Claude now warns when dispatching multiple write-capable agents into the same working directory
named in this entry
-
v2.1.280
Git worktree config detection now distinguishes 'file' vs 'extension' vs 'absent' states
Git worktree config detection now reports 'file', 'extension', or 'absent' instead of the old three states
found in this entry's text
-
v2.1.280
New per-agent 'sharesCwd' flag drives a model-facing worktree warning on async launch
Async-launched subagents now get an internal warning when another write-capable agent is already using the same folder
named in this entry
-
v2.1.275
CLI startup: conditional auto-launch of a background helper
Claude Code startup can now auto-launch a background helper process under certain conditions
found in this entry's text
-
v2.1.275
Git-related environment variables and CLI flags now get pattern-matched for hardening
Claude Code now scans environment variables and git flags for tricks that redirect where git actually operates
found in this entry's text
-
v2.1.260
Plugin agent.spawn hooks can now rewrite or deny subagent launches
Plugin hooks can now deny or rewrite subagent launches before they start.
found in this entry's text
-
v2.1.260
Remote agent isolation falls back to worktree when unavailable
Remote agent isolation now falls back to worktree or local when remote execution isn't available.
found in this entry's text
-
v2.1.248
Background isolation read from a captured environment
Background worktree isolation now reads CLAUDE_BG_ISOLATION from a captured environment copy.
found in this entry's text
-
v2.1.247
Plain-language reasons when an unusual git checkout is refused
Refused checkouts now name the exact layout problem instead of failing vaguely.
found in this entry's text
-
v2.1.239
worktree.locationsetting for Desktop SSH sessionsA
worktree.locationsetting tells the desktop app where to create worktrees for SSH sessions; the CLI ignores it.found in this entry's text
-
v2.1.178
Agent Tool:
isolation: "remote"— Cloud-Hosted Subagentsfound in this entry's text
-
v2.1.119
Remote Control Server Configuration
found in this entry's text
-
v2.1.110
Worktree Lock on Creation
found in this entry's text
-
v2.1.73
--remote-controlCLI Flagfound in this entry's text
- v2.1.72
-
v2.1.72
Remote Control Spawn Mode Overhaul
found in this entry's text
-
v2.0.65
Git Worktree Detection
found in this entry's text
First cited
0No release's published evidence quotes this name. The ledger indexes the Evidence lines of every changelog on this site, so this says nobody here has ever quoted it; it says nothing about how old the name is.
Presence across releases
2Build by build
149One 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 settings key does. All settings keys.