{"name":"CLAUDE_CODE_DIR_SYNC_ENGINE","slug":"claude-code-dir-sync-engine","family":"env","title":"Environment variables","noun":"environment variable","description":"Set CLAUDE_CODE_LEGACY_BUNDLE to true to go back to the old single-file build shape.","description_source":"entry","described_by":{"version":"2.1.242","anchor":"claude-code-legacy-bundle-restores-the-old-non-split-bundle-"},"presence":{"first_seen":"2.1.242","removed_in":"2.1.285","in_current_build":false,"newest_mined":"2.1.308","builds":34,"mined_builds":149,"first_cited":{"version":"2.1.246","released_at":"2026-08-25 19:17:34","spans":6}},"aliases":[],"entries":[{"version":"2.1.285","anchor":"directory-sync-dir-sync-feature-removed","heading":"Directory sync for cloud sessions and its environment variables removed","line":"The directory-sync machinery for cloud sessions is gone, and its `CLAUDE_CODE_DIR_SYNC_*` and `CLAUDE_CODE_DISABLE_DIR_SYNC` variables no longer do anything","released_at":"2026-09-29 17:32:09","reason":"found in this entry's text"},{"version":"2.1.285","anchor":"cloud-sessions-dir-syncfirst-upload-and-folder-seed-paths","heading":"Cloud sessions no longer sync or seed your folder, and CLAUDE_CODE_DIR_SYNC_ENGINE is ignored","line":"Starting a cloud session no longer uses folder sync or seeding, `CLAUDE_CODE_DIR_SYNC_ENGINE` is not read, and bundle upload remains","released_at":"2026-09-29 17:32:09","reason":"found in this entry's text"},{"version":"2.1.284","anchor":"cloud-file-sync-can-now-be-paused-by-an-anthropic-side-kill","heading":"Cloud file sync can be paused from Anthropic's side without ending your session","line":"If Anthropic switches cloud file sync off, sync pauses for the session instead of ending it, and picks up again once it is back on","released_at":"2026-09-28 17:11:59","reason":"found in this entry's text"},{"version":"2.1.284","anchor":"claude-cloud-gives-a-new-hint-when-some-files-were-withh","heading":"claude --cloud explains what uploads when some files were withheld from sync","line":"When a cloud session cannot start and files were withheld from sync, `claude --cloud` now explains what the no-sync fallback would upload","released_at":"2026-09-28 17:11:59","reason":"found in this entry's text, named in this entry"},{"version":"2.1.284","anchor":"cloud-directory-file-sync-gains-device-bound-signing-and-a","heading":"Cloud file sync signs files per device and explains when that fails","line":"Cloud file sync now signs synced files with a key for this computer, and stops with a clear message if that cannot be set up","released_at":"2026-09-28 17:11:59","reason":"found in this entry's text, named in this entry"},{"version":"2.1.283","anchor":"cloud-file-sync-now-refuses-cleanly-for-organizations-whose","heading":"Cloud file sync explains when an organization's policy forbids it","line":"Organizations whose data retention policy forbids file sync now get a clear message, and cloud sessions continue without syncing","released_at":"2026-09-25 18:46:11","reason":"found in this entry's text"},{"version":"2.1.281","anchor":"claude-code-dir-sync-engine-no-longer-accepts-git-alway","heading":"CLAUDE_CODE_DIR_SYNC_ENGINE no longer accepts 'git' \/ 'always-git'","line":"CLAUDE_CODE_DIR_SYNC_ENGINE now only understands the off words, so \"git\" and \"always-git\" trigger a warning","released_at":"2026-09-23 17:01:17","reason":"found in this entry's text, named in this entry"},{"version":"2.1.281","anchor":"cloud-session-bundle-upload-failure-now-explains-why-and-how","heading":"Cloud session bundle-upload failure now explains why and how to upload without file sync","line":"Cloud sessions now say why the local upload failed and how to start with `CLAUDE_CODE_DIR_SYNC_ENGINE=none` instead","released_at":"2026-09-23 17:01:17","reason":"found in this entry's text"},{"version":"2.1.281","anchor":"cloud-cloud-fallback-messages-refactored","heading":"Cloud (--cloud) fallback messages refactored","line":"The hints shown when claude --cloud falls back now depend on the sync mode and say what gets uploaded and what stays local","released_at":"2026-09-23 17:01:17","reason":"found in this entry's text"},{"version":"2.1.280","anchor":"new-early-upload-created-empty-recovery-path-for-cloudr","heading":"New early-upload ('created_empty') recovery path for cloud\/remote-control sessions when dir sync can't seed files","line":"Cloud sessions can now upload a first-time project snapshot when directory sync isn't ready yet","released_at":"2026-09-22 15:44:39","reason":"found in this entry's text"}],"entries_total":15,"docs":[],"docs_total":0,"gates":[],"related":[{"name":"CLAUDE_CODE_DIR_SYNC_ARCHIVE","slug":"claude-code-dir-sync-archive","description":"CLAUDE_CODE_DIR_SYNC_DISABLE_ANCHORING turns off path anchoring, and seven sync variables are now stripped from child processes."},{"name":"CLAUDE_CODE_DIR_SYNC_CHAIN","slug":"claude-code-dir-sync-chain","description":"A new 'chained' directory-sync mode exists behind an undocumented CLAUDE_CODE_DIR_SYNC_CHAIN env var"},{"name":"CLAUDE_CODE_DIR_SYNC_DISABLE_ANCHORING","slug":"claude-code-dir-sync-disable-anchoring","description":"Cloud file sync writes through directory handles so a swapped symlink can't redirect it, and says when that's unavailable."},{"name":"CLAUDE_CODE_DIR_SYNC_FFWD","slug":"claude-code-dir-sync-ffwd","description":"Set CLAUDE_CODE_LEGACY_BUNDLE to true to go back to the old single-file build shape."},{"name":"CLAUDE_CODE_DIR_SYNC_GIT","slug":"claude-code-dir-sync-git","description":"You can set CLAUDE_CODE_DIR_SYNC_GIT to pick a git-based engine for syncing your directory to a cloud session."},{"name":"CLAUDE_CODE_DIR_SYNC_OVERLAY","slug":"claude-code-dir-sync-overlay","description":"CLAUDE_CODE_DIR_SYNC_DISABLE_ANCHORING turns off path anchoring, and seven sync variables are now stripped from child processes."},{"name":"CLAUDE_CODE_DIR_SYNC_STREAM","slug":"claude-code-dir-sync-stream","description":"More environment variables get carried into remote sessions; none are set by default."}],"url":"https:\/\/changelogs.core-directive.com\/reference\/env\/claude-code-dir-sync-engine","family_url":"https:\/\/changelogs.core-directive.com\/reference\/env.json"}