Follow Discord
Sweep 22 Oct 2026 · 21:04Z Build v2.1.309 528 read Stable v2.1.308 Latest v2.1.309 Next v2.1.309 Feeds RSS JSON llms.txt llms-full.txt Unofficial
Home / Reference / Settings keys

remoteFileMode

setting never mined JSON

A Claude Code settings key, read out of the shipped bundle. No mined inventory carries it: everything below comes from what this site has written about it.

If you have too many untracked files, cloud seeding refuses and tells you which budget you blew.

Not Anthropic's. This is the line from the earliest changelog entry here that named it, v2.1.224.

First seen — never in a mined build
Last seen — never in a mined build
Builds0 / 150on this box, as of v2.1.309
Written about v2.1.224 first named in a changelog, 7 Aug 2026

In the changelogs

6

Releases whose published page names remoteFileMode.

  1. v2.1.281
    Cloud session bundle-upload failure now explains why and how to upload without file sync

    Cloud sessions now say why the local upload failed and how to start with CLAUDE_CODE_DIR_SYNC_ENGINE=none instead

    found in this entry's text

  2. v2.1.239
    Cloud file sync tracks deletions and tells you plainly when it recovers

    Cloud file sync now tracks deletions and tells you plainly when it recovers.

    found in this entry's text

  3. v2.1.227
    Ask before syncing a repository to cloud sessions

    A dialog can ask whether to copy your repo, including uncommitted files, into cloud sessions.

    named in this entry, found in this entry's text

  4. v2.1.224
    Cloud seeding tells you when there are too many untracked files

    If you have too many untracked files, cloud seeding refuses and tells you which budget you blew.

    found in this entry's text

  5. v2.1.224
    Untracked files can be seeded into a cloud session

    Teleporting to a cloud session can upload your untracked files so the remote starts with them.

    named in this entry, found in this entry's text

  6. v2.1.224
    Untracked files can be uploaded to a cloud session's working directory

    Cloud sessions can upload untracked files, but only behind an off-by-default gate and a project setting.

    named in this entry, found in this entry's text

First cited

1

The earliest release whose published evidence quoted remoteFileMode was v2.1.281, 23 Sep 2026. That is the oldest release this project wrote about it, so it is a floor on the name's age and not the release that introduced it. It is not a presence reading: which builds carried the name is the table below.

ReleaseDateThe span that was quoted
v2.1.28123 Sep 2026To start without this folder's files instead, run CLAUDE_CODE_DIR_SYNC_ENGINE=none claude --cloud; to be asked about syncing it again, delete "remoteFileMode" from this folder's entry in

Presence across releases

0

The miner has never read a build containing this name. It is here because a changelog entry of ours names it, which is evidence that it existed and not evidence of which releases carried it. The inventory starts at v2.1.138 and everything older than that was never mined.

Read out of the published npm bundle release by release, and out of Anthropic's own documentation as this site captured it. Nothing on this page is a description anybody here wrote about what the settings key does. All settings keys.

Feedback