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
PermissionsSettings
効果がなかった --sandbox と --no-sandbox フラグを claude remote-control から削除しました。どちらかを指定するとエラーで終了します。セッションをサンドボックス化するには、設定で 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

変更前

claude remote-control では --sandbox と --no-sandbox フラグを指定できたが、これらはセッションの動作に何の影響もなかった。ユーザーはこの無効なフラグを指定しても気づけないまま使っていた。

変更後

この2つのフラグが削除され、指定するとエラーで終了するようになった。セッションをサンドボックス化するには、設定ファイルで sandbox.enabled を設定する方式に統一された。

ユーザーへの恩恵

無効なフラグによる誤解を防ぎ、サンドボックス化は設定ファイル経由で明示的に行うようになる。

関連ドキュメント

v2.1.78(1件)

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

変更前

サンドボックス設定が有効でも、必要なツールがない場合に無言で機能がオフになっており、セキュリティ上の死角となっていました。

変更後

起動時に依存関係の不足を明示的に警告するようになり、安全な状態であるかどうかを確実に把握できるようになりました。

ユーザーへの恩恵

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

関連ドキュメント