settings.json

sandbox.failIfUnavailable

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

trueに設定すると、必要な依存関係が不足している場合にサンドボックスの起動を警告ではなく致命的なエラーとして扱います。

記述例

{
  "sandbox": {
    "enabled": true,
    "failIfUnavailable": true
  }
}

使い方・用途

  • セキュリティガバナンスが厳格な環境で、意図しない非保護状態(サンドボックスなし)でのコマンド実行を確実に阻止したい場合に有効化します。
  • サンドボックスの起動失敗を無視せずプロセスを停止させることで、安全性が確認できない状態での作業を防止します。
英語原文(公式ドキュメントより)

When true, make sandbox startup a hard failure if required sandbox dependencies are missing. Default: false (sandbox is skipped with a warning). See https://code.claude.com/docs/en/sandboxing#enable-sandboxing

関連ドキュメント

関連する変更履歴

v2.1.83(1件)

Added
サンドボックスが有効な場合に起動できない時は、サンドボックスなしで実行せずエラーで終了する sandbox.failIfUnavailable 設定を追加しました
英語原文を表示
Added sandbox.failIfUnavailable setting to exit with an error when sandbox is enabled but cannot start, instead of running unsandboxed

変更後

厳格なセキュリティポリシーを必要とするエンタープライズ環境において、安全性が確認できない状態でのコマンド実行を確実に阻止できるようになり、セキュリティガバナンスが強化されます。

関連ドキュメント