[BUG] Missing or broken symlink folder causes failure to launch Claude Desktop
Resolved 💬 2 comments Opened Apr 19, 2026 by m Closed May 28, 2026
Preflight Checklist
- [x] I have searched existing issues and this hasn't been reported yet
- [x] This is a single bug report (please file separate reports for different bugs)
- [x] I am using the latest version of Claude Code
What's Wrong?
Claude Desktop fails to launch with a generic "Claude Desktop failed to launch" error when ~/Documents is a symlink pointing to a nonexistent target. The app crashes entirely instead of falling back gracefully.
(Claude Code told me to put this here even though it's a Desktop issue.)
What Should Happen?
Claude Desktop should either launch successfully despite the broken documents path, or display a helpful error message identifying the broken path (~/Documents → <missing target>).
Error Messages/Logs
Error: Failed to get 'documents' path
{}
Failed to get 'documents' path
Error: Failed to get 'documents' path
at Object.<anonymous> (app:///.vite/build/index.js:907:76077)
at Module._compile (node:internal/modules/cjs/loader:1820:14)
at Module._extensions..js (node:internal/modules/cjs/loader:1953:10)
at Module.load (node:internal/modules/cjs/loader:1540:32)
at Module._load (node:internal/modules/cjs/loader:1342:12)
at c._load (node:electron/js2c/node_init:2:18047)
at wrapModuleLoad (node:internal/modules/cjs/loader:262:19)
at Module.require (node:internal/modules/cjs/loader:1563:12)
at Module.h (app:///.vite/build/index.pre.js:5:3370)
at _require.e.require (app:///.vite/build/index.pre.js:5:2341)
at require (node:internal/modules/helpers:152:16)
at Object.<anonymous> (app:///.vite/build/index.pre.js:62:3980)
at Module._compile (node:internal/modules/cjs/loader:1820:14)
at Module._extensions..js (node:internal/modules/cjs/loader:1953:10)
at Module.load (node:internal/modules/cjs/loader:1540:32)
at Module._load (node:internal/modules/cjs/loader:1342:12)
at c._load (node:electron/js2c/node_init:2:18047)
at node:electron/js2c/browser_init:2:145374
at node:electron/js2c/browser_init:2:145583
at node:electron/js2c/browser_init:2:145587%
Steps to Reproduce
- Set ~/Documents as a symlink to a path that doesn't exist (e.g. a Dropbox or Resilio Sync folder that hasn't synced yet)
- Launch Claude Desktop
- App fails with "Claude Desktop failed to launch"
Claude Model
Not sure / Multiple models
Is this a regression?
I don't know
Last Working Version
_No response_
Claude Code Version
2.1.114 (Claude Code)
Platform
Anthropic API
Operating System
macOS
Terminal/Shell
Terminal.app (macOS)
Additional Information
Claude Desktop Version: 1.3109.0
This issue has 2 comments on GitHub. Read the full discussion on GitHub ↗