claude-code - 💡(How to fix) Fix Claude Desktop Cowork fails with virtiofs mount error when ~/Documents is a symlink to OneDrive [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#52842Fetched 2026-04-25 06:19:26
View on GitHub
Comments
1
Participants
2
Timeline
6
Reactions
0
Author
Timeline (top)
labeled ×3commented ×1cross-referenced ×1subscribed ×1

Error Message

RPC error: failed to mount /mnt/.virtiofs-root/shared/Users/patelgv/Documents/Claude/Artifacts/jira-user-stories-by-status as .artifacts/jira-user-stories-by-status: source path does not exist and could not be created: mkdir /mnt/.virtiofs-root/shared/Users/patelgv/Documents: file exists

Root Cause

Root Cause: ~/Documents is a symlink:

~/Documents -> /Users/patelgv/Library/CloudStorage/OneDrive-ReedElsevierGroupICOReedElsevierInc/Documents

Fix Action

Fix / Workaround

Workaround: None available without breaking OneDrive sync or running sudo commands. This is a common corporate Mac setup where OneDrive backs up ~/Documents.

Code Example

RPC error: failed to mount /mnt/.virtiofs-root/shared/Users/patelgv/Documents/Claude/Artifacts/jira-user-stories-by-status as .artifacts/jira-user-stories-by-status: source path does not exist and could not be created: mkdir /mnt/.virtiofs-root/shared/Users/patelgv/Documents: file exists

---

~/Documents -> /Users/patelgv/Library/CloudStorage/OneDrive-ReedElsevierGroupICOReedElsevierInc/Documents
RAW_BUFFERClick to expand / collapse

Environment:

  • macOS 24.6.0 (Darwin)
  • Claude Desktop (latest)
  • ~/Documents is a symlink to OneDrive (common corporate setup)

Error:

RPC error: failed to mount /mnt/.virtiofs-root/shared/Users/patelgv/Documents/Claude/Artifacts/jira-user-stories-by-status as .artifacts/jira-user-stories-by-status: source path does not exist and could not be created: mkdir /mnt/.virtiofs-root/shared/Users/patelgv/Documents: file exists

Root Cause: ~/Documents is a symlink:

~/Documents -> /Users/patelgv/Library/CloudStorage/OneDrive-ReedElsevierGroupICOReedElsevierInc/Documents

The virtiofs sandbox cannot traverse symlinks when mounting artifact paths.

Expected Behavior: Claude Desktop should resolve symlinks before mounting paths in the virtiofs sandbox.

Workaround: None available without breaking OneDrive sync or running sudo commands. This is a common corporate Mac setup where OneDrive backs up ~/Documents.

extent analysis

TL;DR

The issue can be resolved by configuring Claude Desktop to resolve symlinks before mounting paths in the virtiofs sandbox.

Guidance

  • Investigate the possibility of updating the virtiofs configuration to follow symlinks when mounting artifact paths.
  • Consider creating a temporary workaround by copying the necessary files to a non-symlinked location, allowing Claude Desktop to mount the paths successfully.
  • Review the OneDrive setup to determine if there are any alternative configurations that can avoid using a symlink for the ~/Documents directory.
  • Evaluate the feasibility of using a different syncing solution that does not rely on symlinks.

Example

No code snippet is provided as the issue is related to configuration and setup rather than code.

Notes

The provided workaround is not feasible as it would break OneDrive sync or require running sudo commands, which may not be desirable in a corporate setup.

Recommendation

Apply a workaround by copying necessary files to a non-symlinked location, as updating the virtiofs configuration may not be possible without breaking OneDrive sync. This allows Claude Desktop to function while a more permanent solution is explored.

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