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

Stable OpenClaw browser automation using Chrome remote debugging and Playwright
A developer reports success with Chrome's --remote-debugging-port=9222 flag and Playwright's chromium.connect_over_cdp() to maintain persistent browser sessions for OpenClaw, solving disconnection issues with the built-in browser and Chrome extension relay.

OpenClaw Discord proxy fix for REST API timeout issues
A user reports fixing OpenClaw Discord connection issues where WebSocket connects but REST API calls fail with "fetch failed UND_ERR_CONNECT_TIMEOUT" errors. The solution involves creating a proxy-preload.cjs file and setting global undici proxy settings.

Use CLAUDE.md to Persist Project Conventions Across Claude AI Sessions
Drop a CLAUDE.md file in your project root and Claude reads it at the start of every session, remembering your TypeScript rules, no default exports, testing conventions, and architecture context without re-explanation.

Verification Harness Fixes Claude's Plan Execution Problem
A developer built a 30-50 line bash or Python verification layer that checks whether Claude actually executes each step of its own plans by verifying artifacts like file existence, API responses, and config changes.