claude-code - 💡(How to fix) Fix [BUG] Make Claude Desktop's auto-worktree behavior optional

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…

Error Message

Error Messages/Logs

RAW_BUFFERClick to expand / collapse

Preflight Checklist

  • I have searched existing issues and this hasn't been reported yet
  • This is a single bug report (please file separate reports for different bugs)
  • I am using the latest version of Claude Code

What's Wrong?

Claude Desktop creates a git worktree under .claude/worktrees/<name>/ for every new session, with no way to disable it. The official worktrees doc confirms this is "by design and not configurable." For workflows where the user already gets isolation from a feature-branch + PR flow (the standard case for a single-developer or small-team repo), the worktree is pure ceremony — it adds a nested directory, splits the working tree across two locations, and forces extra steps to get the work into the user's main checkout.

Request: a settings.json toggle to disable auto-worktree, or a per-session opt-out in the new-session UI. The CLI's claude command already runs in the main checkout by default — Desktop should be capable of the same.

Workflow this hurts: branch-and-PR development, where the user wants to review my work as a PR on GitHub and merge it. The branch alone provides isolation; the worktree is duplicative.

What Should Happen?

it should be configuration you can turn off so the code is not duplicated inside the local repository folder, and i can use git to manage changes, which is the simpler way.

Error Messages/Logs

Steps to Reproduce

use claude code desktop tool to make changes to a project. now deal with the messiness of the worktrees.

Claude Model

Opus

Is this a regression?

Yes, this worked in a previous version

Last Working Version

No response

Claude Code Version

2.1.121

Platform

Anthropic API

Operating System

macOS

Terminal/Shell

Terminal.app (macOS)

Additional Information

No response

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

claude-code - 💡(How to fix) Fix [BUG] Make Claude Desktop's auto-worktree behavior optional