settings.json

sandbox.filesystem.allowWrite

型string[]記述場所どの設定ファイルでも可

サンドボックス化されたサブプロセスに書き込み権限を与える追加のパスを指定します。

記述例

{
  "sandbox": {
    "filesystem": {
      "allowWrite": ["/tmp/build", "~/.kube"]
    }
  }
}

使い方・用途

  • デフォルトではカレントディレクトリに制限されている書き込み権限を、kubectl や npm などのツールがプロジェクト外(~/.kube や /tmp 等)にデータを書き出す必要がある際に使用します。
  • ツールをサンドボックスから除外するのではなく、特定のパスのみにアクセスを限定することで、安全性を保ったまま必要な操作を許可できます。
英語原文(公式ドキュメントより)

Paths where subprocesses are allowed to write. Supports prefixes: // (absolute), ~/ (home directory), / (relative to settings file), ./ or no prefix (relative path). See https://code.claude.com/docs/en/sandboxing#granting-subprocess-write-access-to-specific-paths

関連する変更履歴

v2.1.299(1件)

Fixed
サンドボックスの glob allowRead および allowWrite エントリの起点ディレクトリがシンボリックリンクに置き換えられた際に再チェックされない問題を修正した
英語原文を表示
Fixed sandbox glob allowRead and allowWrite entries not being re-checked when the directory they start from is replaced by a symlink

関連ドキュメント

v2.1.78(1件)

Fixed
サンドボックスの書き込み許可設定で、絶対パスが正しく動作しない不具合を修正
英語原文を表示
Fixed sandbox.filesystem.allowWrite not working with absolute paths (previously required // prefix)

変更後

環境構築時の設定ミスが減り、サンドボックス機能をより簡単に導入できるようになります。

関連ドキュメント