Sweep 19 Sep 2026 · 02:36Z Build v2.1.278 500 read Stable v2.1.267 Latest v2.1.278 Next v2.1.278 Feeds RSS JSON llms.txt Unofficial
Claude Code v2.1.271 ·

Settings file watcher falls back to polling when native fs events don't fire

Claude Code now falls back to polling settings files when native file-watching doesn't work on your system

TierYou'll noticehow much it should matter to you
Useful2my rating, 1 to 5
Signal1worth watching, 1 to 5
AreaSettingswhat it touches
KindBug Fixesin v2.1.271,
You'll notice

Claude Code now falls back to polling settings files when native file-watching doesn't work on your system

What

Claude Code's detector for settings-file changes now checks whether native filesystem watching actually delivers change events on your machine. If the check finds the watcher stays silent, or fails outright (for example due to EMFILE, ENFILE, or ENOSPC errors — signs the system has run out of file-watch resources), it switches to checking settings files and directories on a timer instead of relying on native watching, and logs a warning plus a telemetry event.

Why

On some systems, native file-watching silently doesn't work, which would mean changes to settings files go unnoticed. This fallback makes sure settings changes are still picked up even when that happens.

See this entry in the whole of v2.1.271 →