Follow Discord
Sweep 22 Oct 2026 · 04:32Z Build v2.1.308 527 read Stable v2.1.308 Latest v2.1.308 Next v2.1.308 Feeds RSS JSON llms.txt llms-full.txt Unofficial
HomeReleasesv2.1.247entry #130

Claude Code v2.1.247 ·

Warning when ~/.claude.json cannot be watched for outside edits

You're now warned when your settings file isn't being watched, so other sessions' edits won't appear.

You'll notice Improvements
JSON All of v2.1.247
You'll noticeTier: how much it should matter to you
3Useful: my rating, 1 to 5
2Signal: worth watching, 1 to 5
SettingsArea: what it touches
ImprovementsKind: in v2.1.247,
ImprovementsSection of the release
What

If the file-watch fallback is off for the process, Claude Code now warns that it is not watching ~/.claude.json, meaning changes made by other Claude Code processes will not be picked up in this one.

Details
  • Emits the warning plus a global_config_unwatched counter.
  • Global config state gained a fileWatchFallback field and setter that records whether the fs.watchFile fallback is available.
  • Silent when watching works normally.
Evidence

Not watching ~/.claude.json for other processes: the fs.watchFile fallback is off for this process

Strings lifted out of the shipped bundle, so the claim above can be checked against them.

Read from
Names in the bundle~/.claude.json
Since it was published

The entry above is what we published on the day. These lines were added later, as Anthropic's own pages caught up, and they sit beside the original rather than replacing it.

Added since A small documentation edit on Use Claude Code features in the SDK touched a line naming ~/.claude.json after this was published. When you omit `settingSources`, `query()` reads the same filesystem settings as the Claude Code CLI: user, project, and local settings, CLAUDE.md files, and `.claude/` skills, agents, and commands. To run without these, pass `settingSource… agent-sdk/claude-code-features see the edit
Confirmed since Anthropic's documentation has since written up ~/.claude.json, on CLI reference. | `claude project purge [path]` | Delete all local Claude Code state for a project: transcripts, task lists, debug logs, file-edit history, prompt history lines, and the project's entry in `~/.claude.json`. Omit `[path]` to pick from an in… cli-reference see the edit
How sure we are
One source agreesOne thing we can check says the same as this entry.
Anthropic's documentation agreesAnthropic's documentation has since written up ~/.claude.json, on CLI reference.

See this entry in the whole of v2.1.247 →

Feedback