iCloud Desktop/Documents Sync Causes File Loss Issues with Claude on Mac
The Problem with iCloud Sync and Claude
A user on r/ClaudeAI reported significant issues when using iCloud Drive's Desktop and Documents folder sync feature with Claude on Mac. The problem occurs specifically when Claude is working in folders that have iCloud sync enabled.
How iCloud Sync Affects Claude
According to the source, iCloud Sync doesn't back up files in the traditional sense - it actually removes files from your local hard drive and redirects the directory to /iCloud Drive instead of your user documents folder. This causes Claude to lose track of original files and start creating duplicate "2" versions because it can't find the originals.
The user reported that "lots of little things stop working correctly" when this happens. The situation becomes worse if you try to turn off iCloud Sync for those folders - it will delete all of your local files from your computer.
Critical Data Loss Risk
Most concerning is that iCloud doesn't back up hidden files or folders. This means everything in your /.claude folder is completely gone if you enable this sync feature. The user experienced this firsthand and had to recover most files from GitHub, with some files requiring recreation.
The user admitted fault but noted that Claude helped them get everything up and running again after the incident.
📖 Read the full source: r/ClaudeAI
👀 See Also
Get Emoji-Decorated Checklists in Claude by Adding One Line to CLAUDE.md
Add a one-line marker set to your user-level CLAUDE.md to make Claude decorate checklists with status emojis — 14 fixed icons for done, running, failed, blocked, etc.
AGENTS.md Pattern for React Native: Claude Code Generates Better Project-Aware Code
A Reddit user shares their AGENTS.md file for React Native/Expo projects that includes folder structure, theme tokens, custom hooks, and component patterns. The result: Claude Code and Cursor generate code using the exact project conventions instead of generic React Native code.
Claude Prompt for Visualizing Thinking Structure: Intent, Reality, Gap
A Reddit user shares a 100-word prompt for Claude that asks the AI to notice and reflect back the structural patterns in conversation—categorized as Intent (what you WANT), Reality (what IS), and Gap (what's UNRESOLVED)—rather than the content itself.
Pre-coding routine with Claude Code: 5 MCP servers before writing a line
A developer shares a 60-90 second routine using 5 MCP servers (memory, codebase graph, Tavily search, Context7 docs) and safety hooks to dramatically reduce hallucinations and wasted edits.