Follow Discord
Sweep 12 Nov 2026 · 23:00Z Build v2.1.323 540 read Stable v2.1.311 Latest v2.1.323 Next v2.1.323 Feeds RSS JSON llms.txt llms-full.txt Unofficial

Claude Code v2.1.323 ·

New file-tool read block that only the launching program can set

permissions.blockFileToolReadsOutsideWorkingDirectories blocks file-tool reads outside working folders, but works only when passed through --settings

Group of 2 Use it now Notable New Features
JSON All of v2.1.323
Use it nowTier: how much it should matter to you
5Useful: my rating, 1 to 5
2Signal: worth watching, 1 to 5
PermissionsArea: what it touches
New FeaturesKind: in v2.1.323,
What probably matters to youSection of the release

Unclear The exact cases in which the new setting stops a read from being allowed are not clear.

What

Claude Code has a new setting, permissions.blockFileToolReadsOutsideWorkingDirectories. It stops the file tools reading outside the working directories, the folders the session was told to work in. The file tools are how Claude reads and edits files.

  • With the setting on, a permission check that used to approve a read automatically now refuses to, when a further condition holds. The findings do not show what that condition tests.
  • A blocked read shows: "Reads outside the working directories are blocked (permissions.blockFileToolReadsOutsideWorkingDirectories)."
  • This setting, along with blockReadsExemptPaths and workingDirectoriesAsGiven, is now ignored in settings files and managed settings. Only the program that starts Claude Code can set them, through --settings. A warning says so.
  • The warning suggests settings files use permissions.blockReadsOutsideWorkingDirectories instead, which also covers shell commands.
  • A second warning appears if something other than the launching program changed the related environment during a session.

Why

If you put these keys in a settings file or managed settings, they will not take effect. Use permissions.blockReadsOutsideWorkingDirectories there instead. Programs that embed Claude Code, such as SDK hosts, need to pass these keys through --settings.

Read from
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 doubtThe exact cases in which the new setting stops a read from being allowed are not clear.
Anthropic's release notes agreeFixed a case where the Write and Edit tools could write to a path covered by a Read deny rule

See this entry in the whole of v2.1.323 →

Feedback