permissions.blockReadsOutsideWorkingDirectories

settings.json型boolean記述場所どの設定ファイルでも可

Claude のファイルツールに、bypassPermissions を含むすべてのパーミッションモードで作業ディレクトリ外の読み取りを拒否させる。Claude Code はこれらのパスへの Read、Grep、Glob、LSP の呼び出しを拒否し、/add-dir でディレクトリを追加するよう Claude に指示する。スキル、プラグイン、ルール、エージェント、コマンド、~/.claude/ 配下の CLAUDE.md メモリファイルなど、Claude Code 自身が必要とするファイルは引き続き読み取り可能である。Claude Code v2.1.257 以降が必要。

既定値未設定であるため、作業ディレクトリ外の読み取りはパーミッションモードに従う。

記述例

{
  "permissions": {
    "blockReadsOutsideWorkingDirectories": true
  }
}

使い方・用途

  • bypassPermissions モードを含むすべての権限モードで、作業ディレクトリ外のファイル読み取りを防ぎたい場合に使う。
  • Read・Grep・Glob・LSP による作業ディレクトリ外のパスへのアクセスを拒否し、代わりに /add-dir でディレクトリ追加を Claude に促したい場合に使う。
  • ゲートウェイ経由で Claude Desktop を管理する組織で、メンバーの読み取り範囲をポリシーとして一括制御したい場合に使う。
英語原文

Make Claude's file tools refuse reads outside your working directories in every permission mode, including bypassPermissions. Claude Code denies Read, Grep, Glob, and LSP calls on those paths and tells Claude to ask you to add the directory with /add-dir. Files Claude Code itself needs stay readable, such as your skills, plugins, rules, agents, commands, and the CLAUDE.md memory file under ~/.claude/. Requires Claude Code v2.1.257 or later.

関連ドキュメント

関連する変更履歴

v2.1.311(1件)

Linux: --plugin-dir フォルダが追加ディレクトリでもあり、permissions.blockReadsOutsideWorkingDirectories が有効な場合に、サンドボックス化された Bash コマンドが bwrap: Can't create file で失敗する問題を修正した
英語原文を表示
Linux: Fixed sandboxed Bash commands failing with bwrap: Can't create file when a --plugin-dir folder was also an added directory and permissions.blockReadsOutsideWorkingDirectories was on

変更後

Linux 環境で --add-dir で追加したディレクトリが --plugin-dir と兼ねていても、サンドボックス化された Bash コマンドが bwrap の「Can't create file」エラーで失敗しなくなる。読み取り制限が有効な環境でも、プラグインディレクトリ内のファイルにコマンドから安全にアクセスできる。

関連ドキュメント

v2.1.290(1件)

プロジェクトの CLAUDE.md、ルール、AGENTS.md がワーキングディレクトリ外へのシンボリックリンクでも、permissions.blockReadsOutsideWorkingDirectories や Read の deny ルールの下で読み込まれてしまう問題を修正した
英語原文を表示
Fixed a project CLAUDE.md, rule or AGENTS.md symlinked outside the working directories loading under permissions.blockReadsOutsideWorkingDirectories or a Read deny rule

関連ドキュメント

v2.1.288(1件)

permissions.blockReadsOutsideWorkingDirectories が有効な間、git 設定ファイルに対する sandbox.credentials.files のエントリが効かない問題を修正した
英語原文を表示
Fixed sandbox.credentials.files entries on git config files not taking effect while permissions.blockReadsOutsideWorkingDirectories is on

v2.1.281(1件)

desktop ポリシーブロック内の新しい Claude Desktop キーについて、Claude apps gateway のサポートを追加した。対象には blockReadsOutsideWorkingDirectories と disableBypassPermissionsMode が含まれる
英語原文を表示
Added Claude apps gateway support for newer Claude Desktop keys in desktop policy blocks, including blockReadsOutsideWorkingDirectories and disableBypassPermissionsMode

変更後

Claude Desktop 向けの新しい管理キー blockReadsOutsideWorkingDirectories と disableBypassPermissionsMode を desktop ポリシーブロックで設定できるようになり、ゲートワーク経由でメンバーの Claude Desktop に対して、作業ディレクトリ外の読み取り禁止や許可モードの無効化といったより細かいセキュリティポリシーを一元的に配布できるようになりました。

関連ドキュメント

v2.1.273(2件)

permissions.blockReadsOutsideWorkingDirectories 設定下で、権限チェッカーが完全に解析できない Bash コマンドが確認プロンプトをスキップする問題と、bypass モードでサブシェルが危険な rm を隠蔽する問題を修正する
英語原文を表示
Fixed Bash commands the permission checker cannot fully analyze skipping the prompt under permissions.blockReadsOutsideWorkingDirectories, and a subshell hiding a dangerous rm in bypass mode

関連ドキュメント

permissions.blockReadsOutsideWorkingDirectories の問題を修正する。リポジトリの設定によって選択されたメモリディレクトリが、プロンプトへの読み込み、呼び出し、インデックス作成、メモリ抽出で使用されなくなった
英語原文を表示
Fixed permissions.blockReadsOutsideWorkingDirectories: a memory directory chosen by a repository's settings is no longer loaded into the prompt, recalled, indexed, or used by memory extraction

関連ドキュメント

v2.1.271(1件)

ディレクトリ移動を 2 回行うコマンド、サブシェル、cd+git の連鎖を含む Bash コマンドが、bypass モードと auto モードの permissions.blockReadsOutsideWorkingDirectories で確認をスキップする問題を修正した。
英語原文を表示
Fixed Bash commands with two directory changes, a subshell, or a cd+git chain skipping the prompt under permissions.blockReadsOutsideWorkingDirectories in bypass and auto mode

関連ドキュメント

v2.1.260(1件)

macOS で permissions.blockReadsOutsideWorkingDirectories により、サンドボックス化された git からユーザーの git config が見えなくなり、worktree 分離されたサブエージェントの自分のチェックアウトも見えなくなる問題を修正した。
英語原文を表示
Fixed permissions.blockReadsOutsideWorkingDirectories on macOS hiding the user's git config from sandboxed git and hiding a worktree-isolated sub-agent's own checkout

関連ドキュメント

v2.1.257(1件)

auto モードで、作業ディレクトリ外のファイルを初めて読み取る前に 1 回だけプロンプトを表示するようにした。そのような読み取りをブロックするオプション（permissions.blockReadsOutsideWorkingDirectories）も追加した
英語原文を表示
Added a one-time prompt in auto mode before the first file read outside the working directories, with the option to block such reads (permissions.blockReadsOutsideWorkingDirectories)

変更後

ワーキングディレクトリ外のファイルへの最初の読み取り時に、許可するかブロックするかを一度だけ確認できるようになり、意図しない範囲のファイルアクセスを防げる。

関連ドキュメント