Skip to content
BENIBIX Learn

blockReadsOutsideWorkingDirectories

AI⌨️ Claude CodeConfiguration

Also known as blockWritesOutsideWorkingDirectories, permissions.blockReadsOutsideWorkingDirectories

A setting that keeps the file tools in your work folders.

Think of it like

It is like a fence round the yard. It holds even when the gate is open.

Example

Emma runs Claude in auto mode on a work laptop. She turns this on, so even auto mode cannot read her home folder.

Why it matters

Modes like bypassPermissions skip prompts. This fence stays up in all of them.

Definition

blockReadsOutsideWorkingDirectories is a setting in the permissions part of a settings file. It makes Claude's file tools refuse to read outside your work folders. It holds in every mode, even the one that skips all prompts. A twin, for writes, stops edits out there. Neither one limits shell commands. Pair them with the sandbox.

Example code

json
{
  "permissions": {
    "blockReadsOutsideWorkingDirectories": true,
    "blockWritesOutsideWorkingDirectories": true
  }
}
Fence the file tools in, in every mode.
This fence is the outer line.

Common mistake

Thinking it stops cat ~/.ssh/id_rsa in Bash. It covers file tools. Use the sandbox for the shell.

Key takeaways

  1. 1
    Every mode. Bypass too.
  2. 2
    Reads and writes. Two settings.
  3. 3
    File tools only. Sandbox the shell.