permissions.blockWritesOutsideWorkingDirectories

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

すべての権限モード(bypassPermissions を含む)において、Write、Edit、NotebookEdit ツールがワーキングディレクトリ外のパスへの書き込みを拒否するようにする。ただし、Claude Code 自身の一部のファイルは除外される。このキーはシェルコマンド、MCP ツール、フックが実行するプログラムには適用されない。シェルコマンドの書き込み先を制限するには、サンドボックス機能を有効にすること。Claude Code v2.1.314 以降が必要。

既定値未設定の場合、ワーキングディレクトリ外への書き込みは権限モードに従う。また、管理対象設定の permissions オブジェクトを Claude Code が読み取れない場合にも、このブロックは有効になる。

記述例

{
  "permissions": {
    "blockWritesOutsideWorkingDirectories": true
  }
}

使い方・用途

  • bypassPermissions を含むすべての permission mode でも Write・Edit・NotebookEdit が作業ディレクトリ外のパスへの書き込みを拒否するようにし、プロジェクト外のファイルの意図しない変更を防ぎたいときに使う。
  • シェルコマンド経由の書き込みまで含めて制限したい場合は sandboxing を組み合わせる必要があるが、Claude のファイルツールによる書き込み範囲をまず working directory 内に閉じたいときに使う。
  • プロジェクト外の特定ディレクトリだけは書き込みを許したい場合に、/add-dir・--add-dir・additionalDirectories でそのディレクトリを working directory として追加しつつ、全体の書き込みブロックを維持したいときに使う。
英語原文

Make the Write, Edit, and NotebookEdit tools refuse paths outside your working directories in every permission mode, including bypassPermissions, apart from [some of Claude Code's own files](#what-the-write-block-refuses-and-what-stays-writable). The key doesn't limit shell commands, MCP tools, or the programs hooks run. To limit where shell commands write, turn on sandboxing. Requires Claude Code v2.1.314 or later.

関連ドキュメント

関連する変更履歴

v2.1.314(1件)

permissions.blockWritesOutsideWorkingDirectories を追加: 全ての権限モードにおいて、Write、Edit、NotebookEdit が作業ディレクトリ外のパスを拒否するようになる
英語原文を表示
Added permissions.blockWritesOutsideWorkingDirectories: Write, Edit and NotebookEdit refuse paths outside the working directories in every permission mode

変更後

設定を有効にすると、Write・Edit・NotebookEdit が作業ディレクトリ外のパスへの変更をすべての権限モードで拒否するようになり、プロジェクト外のファイルを誤って書き換えられる心配がなくなる

関連ドキュメント