{"name":"worktree","slug":"worktree","family":"setting","title":"Settings keys","noun":"settings key","description":"Configure how Claude Code creates git [worktrees](\/docs\/en\/worktrees)","description_source":"docs","described_by":{"doc":"claude-code\/settings-reference","title":"All settings"},"presence":{"first_seen":"2.1.138","removed_in":"2.1.284","in_current_build":false,"newest_mined":"2.1.308","builds":126,"mined_builds":149,"first_cited":null},"aliases":[],"entries":[{"version":"2.1.307","anchor":"git-config-include-detection-added","heading":"Claude Code can check whether a repository's git settings pull in other files","line":"A new check looks in a repository's `config` and `config.worktree` files for an `[include` section","released_at":"2026-10-21 20:47:18","reason":"found in this entry's text"},{"version":"2.1.299","anchor":"git-cloneinitworktree-detection-changed-for-option-skippin","heading":"Git clone, init and worktree commands are recognised differently","line":"Claude Code now reads git commands in their original order when spotting `clone`, `init` or `worktree`, instead of removing options first","released_at":"2026-10-14 00:23:19","reason":"found in this entry's text"},{"version":"2.1.295","anchor":"cloud-agent-launch-refused-when-claude-code-restrict-persona","heading":"Cloud agents cannot be launched from a session that restricts personal config","line":"With `CLAUDE_CODE_RESTRICT_PERSONAL_CONFIG` set, launching a cloud agent is refused and you are told to use worktree isolation","released_at":"2026-10-08 18:22:58","reason":"found in this entry's text"},{"version":"2.1.284","anchor":"remote-session-git-bundle-recognises-an-inert-configworkt","heading":"Clearer error when a worktree's own config file blocks sending it to a remote session","line":"When sending a git worktree to a remote session fails because of a harmless config.worktree file, Claude Code now gives a specific reason","released_at":"2026-09-28 17:11:59","reason":"found in this entry's text"},{"version":"2.1.281","anchor":"bridge-honours-a-server-request-to-run-a-session-in-a-worktr","heading":"Bridge honours a server request to run a session in a worktree","line":"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","released_at":"2026-09-23 17:01:17","reason":"found in this entry's text"},{"version":"2.1.281","anchor":"new-telemetry-allowlist-entry-and-small-settingsschema-addi","heading":"New telemetry allowlist entry and small settings\/schema additions","line":"Several small internal additions, including a worktree setting beside auto_mode_environment and a new input_low_latency_submit event","released_at":"2026-09-23 17:01:17","reason":"found in this entry's text"},{"version":"2.1.280","anchor":"warning-added-when-dispatching-parallel-write-capable-agents","heading":"Warning added when dispatching parallel write-capable agents into the same directory","line":"Claude now warns when dispatching multiple write-capable agents into the same working directory","released_at":"2026-09-22 15:44:39","reason":"named in this entry"},{"version":"2.1.280","anchor":"git-worktree-config-detection-now-distinguishes-file-vs-e","heading":"Git worktree config detection now distinguishes 'file' vs 'extension' vs 'absent' states","line":"Git worktree config detection now reports 'file', 'extension', or 'absent' instead of the old three states","released_at":"2026-09-22 15:44:39","reason":"found in this entry's text"},{"version":"2.1.280","anchor":"new-per-agent-sharescwd-flag-drives-a-model-facing-worktre","heading":"New per-agent 'sharesCwd' flag drives a model-facing worktree warning on async launch","line":"Async-launched subagents now get an internal warning when another write-capable agent is already using the same folder","released_at":"2026-09-22 15:44:39","reason":"named in this entry"},{"version":"2.1.275","anchor":"cli-startup-conditional-auto-launch-of-a-background-helper","heading":"CLI startup: conditional auto-launch of a background helper","line":"Claude Code startup can now auto-launch a background helper process under certain conditions","released_at":"2026-09-17 20:20:31","reason":"found in this entry's text"}],"entries_total":23,"docs":[{"source":"claude-code","path":"settings-reference","title":"All settings","documented":true},{"source":"claude-code","path":"agent-sdk\/hooks","title":"Intercept and control agent behavior with hooks","documented":false},{"source":"claude-code","path":"agent-sdk\/mcp","title":"Connect to external tools with MCP","documented":false},{"source":"claude-code","path":"agent-sdk\/python","title":"Agent SDK reference - Python","documented":false},{"source":"claude-code","path":"agent-sdk\/sessions","title":"Work with sessions","documented":false},{"source":"claude-code","path":"agent-sdk\/typescript","title":"Agent SDK reference - TypeScript","documented":false},{"source":"claude-code","path":"agent-teams","title":"Orchestrate teams of Claude Code sessions","documented":false},{"source":"claude-code","path":"agent-view","title":"Manage multiple agents with agent view","documented":false},{"source":"claude-code","path":"agents","title":"Run agents in parallel","documented":false},{"source":"claude-code","path":"best-practices","title":"Best practices for Claude Code","documented":false}],"docs_total":13,"gates":[],"related":[],"url":"https:\/\/changelogs.core-directive.com\/reference\/setting\/worktree","family_url":"https:\/\/changelogs.core-directive.com\/reference\/setting.json"}