{"version":"2.1.284","anchor":"settings-files-outside-claude-get-a-symlink-to-network-pa","canonical_anchor":"settings-files-outside-claude-get-a-symlink-to-network-pa","heading":"Settings files reached through symlinks onto network shares are refused","tier":"notice","area":"Settings","url":"https:\/\/changelogs.core-directive.com\/v\/2.1.284\/e\/settings-files-outside-claude-get-a-symlink-to-network-pa","release_url":"https:\/\/changelogs.core-directive.com\/v\/2.1.284","markdown":"### Settings files reached through symlinks onto network shares are refused\n\nClaude Code now refuses to read settings and other files through a symbolic link that leads onto a network share or automount path\n\n**Unclear.** The exact conditions that trigger the refusal are not fully known.\n\n**What**\n\nClaude 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.\n\n- 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.\n\n- Settings files outside the Claude config folder `~\/.claude` go through this check.\n\n- 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 : \".\n\n- 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.\n\n**Why**\n\nA 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.\n\n- Area: Settings\n- Tier: You'll notice\n- Useful: 2\/5\n- Signal: 1\/5"}