What
A cloud session runs Claude Code on a remote machine, started with --cloud. When Claude Code cannot upload your local folder and the session falls back to starting from the tip of the branch on its remote copy, the message now includes the reason the upload failed.
New wording also covers these cases:
- Upload failed: explains that you can start without syncing files by running
CLAUDE_CODE_DIR_SYNC_ENGINE=none claude --cloud. - Tracked changes only: adds that untracked files stay on your machine.
- Commits only: adds that uncommitted file contents stay on your machine.
- Unsupported host: a message for a remote on a code-hosting service that cloud sessions can't clone from yet.
- Folder too large: the refusal now suggests running with
CLAUDE_CODE_DIR_SYNC_ENGINE=none, or deletingremoteFileModefrom the folder's project entry to be asked about syncing again.
Why
When your local files do not reach the cloud session, you now learn what went wrong, what was left behind, and what to run to start anyway.