claude-code - 💡(How to fix) Fix [BUG] Windows junction/symlink project aliases create duplicate Claude Desktop projects and runtime-bound broken sessions [1 comments, 2 participants]

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…
GitHub stats
anthropics/claude-code#56173Fetched 2026-05-05 05:56:17
View on GitHub
Comments
1
Participants
2
Timeline
7
Reactions
0
Author
Timeline (top)
cross-referenced ×3labeled ×3commented ×1
RAW_BUFFERClick to expand / collapse

Preflight Checklist

  • I have searched existing issues and did not find this specific Windows junction/symlink failure mode
  • This is a single bug report
  • I am using a current Claude Desktop / Claude Code install

What's Wrong?

Claude Desktop appears to derive the .claude\projects\<slug> storage directory from the literal cwd path string used at session start, without resolving Windows junctions/symlinks first. It also appears to keep that literal cwd string bound in memory for later filesystem operations.

This creates two related failure modes:

  1. A project accessed through both a real path and a junction path becomes two separate Claude Desktop projects.
  2. Removing the junction while a session launched through that path is still alive breaks runtime filesystem access for that session.

Example:

extent analysis

TL;DR

Resolving Windows junctions/symlinks before deriving the storage directory and updating the cwd string in memory may fix the issue.

Guidance

  • Verify if the issue is caused by the literal cwd path string not being resolved to its actual path, leading to separate project instances and broken filesystem access.
  • Check if updating the cwd string to resolve junctions/symlinks before deriving the storage directory resolves the issue.
  • Consider implementing a mechanism to dynamically update the cwd string in memory when the junction is removed or changed.
  • Test the application with different junction/symlink scenarios to ensure the fix covers all related failure modes.

Example

No code snippet is provided as the issue does not contain sufficient code details.

Notes

The provided information suggests a specific issue with Windows junctions/symlinks, but the exact implementation details are not available. The suggested fix is based on the assumption that resolving the junctions/symlinks before deriving the storage directory will resolve the issue.

Recommendation

Apply a workaround to resolve Windows junctions/symlinks before deriving the storage directory, as the root cause appears to be related to the literal cwd path string not being resolved.

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] Windows junction/symlink project aliases create duplicate Claude Desktop projects and runtime-bound broken sessions [1 comments, 2 participants]