sandbox.filesystem

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

サンドボックス化されたコマンドのファイルシステムアクセス制御を設定します。

含まれる設定

6件
  • allowManagedReadPathsOnlyboolean管理設定専用。
  • allowReadstring[]denyReadで拒否された領域内の特定のパスに対して、読み取りを再許可します。
  • allowWritestring[]サンドボックス化されたサブプロセスに書き込み権限を与える追加のパスを指定します。
  • denyReadstring[]サブプロセスに対して読み取りアクセスを明示的に拒否するパスを指定します。
  • denyWritestring[]サブプロセスに対して書き込みアクセスを明示的に拒否するパスを指定し、allowWrite設定よりも優先されます。
  • disabledbooleanネットワーク分離を維持したまま、ファイルシステム分離を無効化してホストへの読み書きアクセスを許可します。

記述例

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

使い方・用途

  • sandbox.filesystem.denyRead で読み取りを拒否するパスを指定する
  • sandbox.filesystem.denyWrite で書き込みを拒否するパスを指定する
  • sandbox.filesystem.disabled を true に設定してファイルシステム分離を無効にする
英語原文

Filesystem access control for sandboxed commands. See https://code.claude.com/docs/en/sandboxing#filesystem-isolation

関連ドキュメント

関連する変更履歴

v2.1.304(1件)

sandbox.filesystem.denyRead の glob に [user-id] のようなルートフォルダなど、文字クラスではない角括弧が含まれていると Linux でサンドボックス化されたコマンドの起動に失敗する問題を修正した。
英語原文を表示
Fixed sandboxed commands failing to start on Linux when a sandbox.filesystem.denyRead glob contains brackets that are not a character class, such as a [user-id] route folder

v2.1.290(1件)

managed settings が遅いファイルシステム (特に WSL 下の Windows ドライブ) 上の多数のパスの読み取りを拒否している場合に、VS Code 拡張機能などの SDK ホストで 2.1.285 以降の起動が遅くなったり失敗したりする問題を修正した
英語原文を表示
Fixed slow or failed startup since 2.1.285 under SDK hosts such as the VS Code extension when managed settings deny reads of many paths on a slow filesystem (notably Windows drives under WSL)

関連ドキュメント

v2.1.268(1件)

Bash サンドボックスの指示が制限内容を誇張していた問題を修正した。ファイルシステム隔離がオフの場合は未強制のパスリストを表示せず、strict モードではコマンドがサンドボックス外で実行できないとは記載しなくなった
英語原文を表示
Fixed Bash sandbox instructions over-stating confinement: no unenforced path lists when filesystem isolation is off, and strict mode no longer claims commands can never run unsandboxed

関連ドキュメント

v2.1.246(1件)

コマンドサンドボックスのファイルシステム設定が --setting-sources を尊重しない問題を修正した
英語原文を表示
Fixed the command sandbox's filesystem configuration not respecting --setting-sources

v2.1.232(1件)

保護パス回避の脆弱性に対して、Linux ファイルシステムサンドボックスを強化した
英語原文を表示
Hardened the Linux filesystem sandbox against a protected-path bypass

v2.1.229(1件)

アトミックなファイル置換後にファイルウォッチャーのハンドルがリークする問題、および Windows 環境でスケジュールタスク監視がネットワークや仮想ファイルシステム上で失敗した際の未捕捉エラーを修正しました。
英語原文を表示
Fixed a file-watcher handle leak after atomic file replacements, and an uncaught error on Windows when the scheduled-tasks watcher failed on a network or virtual filesystem

v2.1.224(1件)

末尾にスラッシュを付けたパス指定（例：denyRead: "~/.aws/"）で書かれたサンドボックスのファイルアクセス拒否ルールが、LinuxおよびmacOSにおいてサイレントにバイパスされてしまう問題を修正しました。
英語原文を表示
Fixed sandbox filesystem deny entries written with a trailing slash (e.g. denyRead: "~/.aws/") being silently bypassable on Linux and macOS

変更後

セキュリティ設定ファイルのパスの書き方による偶発的な制限の漏れがなくなり、機密ファイルが含まれるディレクトリを確実に保護できます。

関連ドキュメント

v2.1.223(1件)

Linux 環境において、書き込み制限ポリシー sandbox.filesystem.denyWrite が現在の作業ディレクトリに適用されていると、サンドボックス化されたコマンドの起動に失敗する問題を修正しました。
英語原文を表示
Fixed sandboxed commands failing to start on Linux when sandbox.filesystem.denyWrite covers the working directory

v2.1.222(1件)

ファイル監視がファイルシステムエラーを検出した際、またはファイル監視の終了処理中に、極稀に発生するクラッシュを修正しました。
英語原文を表示
Fixed rare crashes when a file watcher hit a filesystem error or during file-watcher teardown

v2.1.216(1件)

ファイルシステム隔離を無効化しつつネットワーク制御を維持する設定 sandbox.filesystem.disabled を追加
英語原文を表示
Added sandbox.filesystem.disabled setting to skip filesystem isolation while keeping network egress control

変更後

ファイルシステム隔離の制限を気にせず、ネットワーク環境の制約がある場所での操作を完結できます。

関連ドキュメント

v2.1.210(1件)

Windows やネットワークファイルシステムにおいて、プラグインのキャッシュ書き込みが失敗する問題を修正した。
英語原文を表示
Fixed plugin cache writes leaving temp files behind on failure and failing on locked-file renames on Windows and network filesystems

変更後

Windows 環境でプラグインのインストールや更新が失敗して環境が汚れる心配がなくなります。

関連ドキュメント

v2.1.191(1件)

claude agentsのジョブ一覧表示において、貼り付けた画像がファイルパスではなく「[Image #N]」というプレースホルダーとして正しく表示されるように修正しました。
英語原文を表示
Fixed claude agents job rows showing full filesystem paths for pasted images instead of the [Image #N] placeholder

変更後

背景で実行中のエージェントの状態を一覧で確認する際、視認性が向上し、重要な情報に集中しやすくなります。

関連ドキュメント

v2.1.119(1件)

タスク一覧を表示する TaskList において、タスクが ID 順ではなくファイルシステムの任意の順序で返される問題を修正しました
英語原文を表示
Fixed TaskList returning tasks in arbitrary filesystem order instead of sorted by ID

変更後

タスクの実行順序や依存関係を直感的に把握しやすくなり、複雑なマルチタスクの管理がスムーズになります。

関連ドキュメント

v2.1.98(1件)

編集自動承認(Accept Edits)モードにおいて、安全な環境変数やプロセスラッパーが先頭に付いたファイルシステムコマンドを自動承認するよう改善しました。
英語原文を表示
Improved Accept Edits mode to auto-approve filesystem commands prefixed with safe env vars or process wrappers

v2.1.97(1件)

「編集を自動承認(Accept Edits)」モードにおいて、安全な環境変数やラッパーがプレフィックスとして付いたファイルシステムコマンド(LANG=C rm fooやtimeout 5 mkdir outなど)を自動承認するように改善しました。
英語原文を表示
Improved Accept Edits mode to auto-approve filesystem commands prefixed with safe env vars or process wrappers (e.g. LANG=C rm foo, timeout 5 mkdir out)

変更後

実質的に安全なコマンドでの不必要な中断が減り、コーディングのテンポが向上します。

関連ドキュメント

v2.1.78(1件)

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

変更後

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

関連ドキュメント

v2.1.77(1件)

サンドボックスのファイルシステム設定に、denyRead 領域内での読み取りを再許可する allowRead を追加しました
英語原文を表示
Added allowRead sandbox filesystem setting to re-allow read access within denyRead regions

変更後

サンドボックスのセキュリティ制限を維持しつつ、必要なファイルへのアクセスだけをピンポイントで許可できるため、柔軟な環境構築が可能です。

関連ドキュメント

v2.1.47(1件)

NFS/FUSEファイルシステムでゼロinodeを報告するものにおいて、ユーザー定義エージェントが1つのファイルしかロードしない問題を修正しました(anthropics/claude-code#26044)。
英語原文を表示
Fixed user-defined agents only loading one file on NFS/FUSE filesystems that report zero inodes (anthropics/claude-code#26044)

変更後

NFS/FUSEファイルシステムを利用する環境でのエージェントの利用が改善され、より多くのプロジェクトでカスタムエージェントが期待通りに動作するようになりました。

v2.1.3(1件)

ExFAT のような大規模な inode を持つファイルシステムでのスキルの重複検出における誤検出を、inode 値に 64 ビット精度を使用することで修正しました。
英語原文を表示
Fixed false skill duplicate detection on filesystems with large inodes (e.g., ExFAT) by using 64-bit precision for inode values