Follow Discord
Sweep 02 Oct 2026 · 18:55Z Build v2.1.288 509 read Stable v2.1.285 Latest v2.1.288 Next v2.1.288 Feeds RSS JSON llms.txt llms-full.txt Unofficial

Claude Code v2.1.284 ·

Settings files reached through symlinks onto network shares are refused

Claude Code now refuses to read settings and other files through a symbolic link that leads onto a network share or automount path

Group of 4 You'll notice Internal Changes
JSON All of v2.1.284
You'll noticeTier: how much it should matter to you
2Useful: my rating, 1 to 5
1Signal: worth watching, 1 to 5
SettingsArea: what it touches
Internal ChangesKind: in v2.1.284,
ImprovementsSection of the release

What

Claude Code now checks the real location of certain files before reading them. A symbolic link, or symlink, is a file that points to another location.

  • Reading a file through a symlink that leads onto a network share or automount path now fails with ERR_SYMLINK_TO_NETWORK_PATH: "Refusing to read a file through a symbolic link that leads onto a network share or automount path; replace the link with a regular file to use it". Paths that cannot be checked, such as Windows device-namespace spellings or symlink chains too long to follow, are also refused.
  • Settings files outside the Claude config folder ~/.claude go through this check.
  • A path given to --settings is resolved through its links, with letter case normalised, before it is read and recorded. A failing path gets "Error: Cannot use settings file : ".
  • Saving settings, the legacy settings.local.json revoke and the per-key scan now read from the resolved path rather than the raw one, with one resolver for user and policy settings and another for project files.

Why

A settings file or other file that is really a link onto a network share can no longer be read through that link. If you keep settings behind such a link, replace it with a regular file or you will see these errors.

How sure we are
Something disagreesSomething we can check disagrees with this entry, or the writer said they could not settle it.
The writer flagged doubtIt is unclear how the resolved location differs from the plain path in practice.

See this entry in the whole of v2.1.284 →

Feedback