Answer: Ask Claude to "use worktrees for your agents", or make the isolation permanent for a custom subagent by adding `isolation: worktree` to its frontmatter. Status: Confirmed Entry: tool/claude-code/agents-and-automation/isolate-subagents-worktrees Revision: 4 Digest: sha256:647fdcd6ed72d968 (changes whenever the content changes) Timeline: Created: 2026-11-13T03:06:10Z Last changed: 2026-11-19T12:21:30Z (minimum version for submodule check: — → v2.1.274) Last verified: 2026-11-20T12:26:23Z Next check: 2026-11-21T12:26:23Z Check interval: Daily Expected change: No fixed schedule Data: Field | Value | Source | As of instruction to Claude | use worktrees for your agents | [1] | 2026-11-20 frontmatter setting | isolation: worktree | [1] | 2026-11-20 subagent directory | .claude/agents/ | [1] | 2026-11-20 minimum version for submodule check | v2.1.274 | [1] | 2026-11-20 Sources: [1] Anthropic. "Run parallel sessions with worktrees". https://code.claude.com/docs/en/worktrees.md Role: primary. Accessed: 2026-11-20T12:26:23Z Quote: "Ask Claude to "use worktrees for your agents"" (Supports: instruction to Claude) Quote: "adding `isolation: worktree` to its frontmatter" (Supports: frontmatter setting) Quote: "This subagent in `.claude/agents/` always runs in its own worktree" (Supports: subagent directory) Quote: "This check requires Claude Code v2.1.274 or later." (Supports: minimum version for submodule check) Published: 2026-11-20T03:10:58Z Snapshot SHA-256: 5b800b1cd50f91f0fb7e85a6810c9f3d3ddfa3d9f191fe64be019213a52257f1 (captured 2026-11-19T12:21:26Z) Verification: Method: Automated extraction from [1] with deepseek-flash (JSON output, thinking disabled). Every value was checked by code to appear verbatim in a quoted passage of [1]. On this check the text of [1] was unchanged since 2026-11-19T12:21:30Z, so the values verified then were kept. Cross-check: not-available at 2026-11-20T12:26:23Z. No independent second source is configured for this entry Last successful check: 2026-11-20T12:26:23Z Last attempt: 2026-11-20T12:26:23Z Notes and limitations: Extracted automatically from a single official source (section "Isolate subagents with worktrees"). Related: https://latestn.com/tool/claude-code/agents-and-automation/load-plugin-in-sdk How do I load a plugin in the Claude Code Agent SDK? https://latestn.com/tool/claude-code/agents-and-automation/message-between-sessions-mod How do I send and receive messages between sessions in Claude Code mods? https://latestn.com/tool/claude-code/agents-and-automation/minimal-agent-sdk-example Where can I find a minimal Claude Code Agent SDK example project to start with? https://latestn.com/tool/claude-code/agents-and-automation/handle-tool-approval-requests How do I handle tool approval requests from Claude Code in my SDK application? https://latestn.com/tool/claude-code/agents-and-automation/hook-exit-codes What exit codes do Claude Code hooks use and what does exit code 2 do? https://latestn.com/tool/claude-code/agents-and-automation/hook-matcher-patterns How do matcher patterns work for Claude Code hooks, including matching MCP tools? https://latestn.com/tool/ All entries in AI tools Change log: Time | Event | Change | Source 2026-11-19T12:21:30Z | changed | minimum version for submodule check: — → v2.1.274 | [1] 2026-11-19T12:21:30Z | changed | subagent directory: — → .claude/agents/ | [1] 2026-11-19T12:21:30Z | changed | frontmatter setting: — → isolation: worktree | [1] 2026-11-19T12:21:30Z | changed | instruction to Claude: — → use worktrees for your agents | [1] 2026-11-19T12:21:30Z | changed | Base branch behavior: worktree.baseRef → — | [1] 2026-11-19T12:21:30Z | changed | Subagent directory: .claude/agents/ → — | [1] 2026-11-19T12:21:30Z | changed | Frontmatter setting for permanent isolation: isolation: worktree → — | [1] 2026-11-19T12:21:30Z | changed | How to request worktrees for agents: use worktrees for your agents → — | [1] 2026-11-17T12:32:34Z | changed | Base branch behavior: — → worktree.baseRef | [1] 2026-11-17T12:32:34Z | changed | Subagent directory: — → .claude/agents/ | [1] 2026-11-17T12:32:34Z | changed | Frontmatter setting for permanent isolation: — → isolation: worktree | [1] 2026-11-17T12:32:34Z | changed | How to request worktrees for agents: — → use worktrees for your agents | [1] 2026-11-17T12:32:34Z | changed | subagent directory: .claude/agents/ → — | [1] 2026-11-17T12:32:34Z | changed | frontmatter setting: isolation: worktree → — | [1] 2026-11-17T12:32:34Z | changed | instruction to Claude: use worktrees for your agents → — | [1] 2026-11-14T12:22:06Z | changed | subagent directory: — → .claude/agents/ | [1] 2026-11-14T12:22:06Z | changed | instruction to Claude: — → use worktrees for your agents | [1] 2026-11-14T12:22:06Z | changed | cleanup version: v2.1.274 → — | [1] 2026-11-14T12:22:06Z | changed | method: use worktrees for your agents → — | [1] 2026-11-13T03:06:10Z | added | Entry created | — Changes for this entry as a feed: https://latestn.com/tool/claude-code/agents-and-automation/isolate-subagents-worktrees/latest Challenge this entry: Open challenges: None How: If a value here is wrong or out of date, send what is wrong and a link to evidence. Challenges are queued and checked against the evidence; they do not change the entry by themselves. If the entry changes as a result, the change log says so. Form: https://latestn.com/dispute/tool/claude-code/agents-and-automation/isolate-subagents-worktrees POST: https://latestn.com/dispute/tool/claude-code/agents-and-automation/isolate-subagents-worktrees with claim, evidence_url, and optionally field and contact (form-encoded or JSON) GET: https://latestn.com/dispute/tool/claude-code/agents-and-automation/isolate-subagents-worktrees?claim={what is wrong}&evidence_url={link} How to cite: LatestN. (2026). How do I isolate subagents in separate worktrees in Claude Code? Revision 4, last verified 2026-11-20T12:26:23Z. https://latestn.com/tool/claude-code/agents-and-automation/isolate-subagents-worktrees (accessed 2026-11-21T09:58:07Z). @misc{LatestN_tool_claude_code_agents_and_automation_isolate_subagents_worktrees_r4, title = {How do I isolate subagents in separate worktrees in Claude Code?}, author = {{LatestN}}, year = {2026}, howpublished = {\url{https://latestn.com/tool/claude-code/agents-and-automation/isolate-subagents-worktrees}}, note = {Revision 4; digest sha256:647fdcd6ed72d968; last verified 2026-11-20T12:26:23Z; accessed 2026-11-21T09:58:07Z} } Reuse: License: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/) Attribution: Copying and adapting are allowed, including commercially, if you credit LatestN and link to the entry you used. Each entry ends with a ready-made citation. URL: https://latestn.com/tool/claude-code/agents-and-automation/isolate-subagents-worktrees