settings.json

sandbox.enabled

型boolean既定値false記述場所どの設定ファイルでも可

Bashコマンドのサンドボックス実行を有効にします。

記述例

{
  "sandbox": {
    "enabled": true
  }
}

使い方・用途

  • 信頼できないコードの実行や意図しないシステム変更、ネットワークアクセスをOSレベルの機能で制限し、開発環境の安全性を高めたい場合に使用します。
  • 依存関係が不足している場合は起動時に警告が表示されるため、セキュリティ境界が正しく機能しているかを確実に把握できます。
英語原文(公式ドキュメントより)

Enable sandboxed bash. See https://code.claude.com/docs/en/sandboxing#enable-sandboxing

関連ドキュメント

関連する変更履歴

v2.1.300(1件)

Removed
claude remote-control から効果のなかった --sandbox と --no-sandbox フラグを削除した。どちらかを渡すとエラーで終了する。セッションをサンドボックス化するには設定で sandbox.enabled を設定する
英語原文を表示
Removed the --sandbox and --no-sandbox flags from claude remote-control, which had no effect; passing either now exits with an error. Set sandbox.enabled in settings to sandbox sessions

変更後

remote-control に無意味な --sandbox / --no-sandbox フラグを渡しても、意図に反してサンドボックスなしでセッションが動作する事態を防げる。フラグを渡した場合はエラーで起動が止まり、代わりに settings で sandbox.enabled を設定するよう明示される。

関連ドキュメント

v2.1.78(1件)

Changed
セキュリティ：サンドボックス依存関係が不足している場合に警告なしで無効化される問題を修正し、起動時に警告を表示
英語原文を表示
**Security:** Fixed silent sandbox disable when sandbox.enabled: true is set but dependencies are missing — now shows a visible startup warning

変更後

設定したセキュリティ境界が機能していないことに気づかないまま作業を続けるリスクを回避できます。

関連ドキュメント