settings.json

sandbox.bwrapPath

型string記述場所管理者設定のみ

LinuxやWSLのサンドボックスで使用する、カスタムのbubblewrap(bwrap)バイナリへのパス。

記述例

{
  "sandbox": {
    "enabled": true,
    "bwrapPath": "/opt/admin/bwrap"
  }
}

使い方・用途

  • bubblewrap が OS 標準のパス以外にインストールされている特殊な環境で、サンドボックス機能を動作させるために指定します。
  • 管理設定を通じて指定することで、セキュリティ制限の厳しいシステムでも安全な隔離環境を維持できます。
英語原文(公式ドキュメントより)

(Managed setting only) Path to custom bubblewrap (bwrap) binary for Linux/WSL sandbox. Overrides default. See https://code.claude.com/docs/en/server-managed-settings

関連ドキュメント

関連する変更履歴

v2.1.232(1件)

Improved
管理設定の承認ダイアログを改善した。エンドポイント URL を表示し、テレメトリのみの変更についてはより明確な文言を使い、日常的な OpenTelemetry の項目はスキップし、サーバー管理のサンドボックスバイナリ上書き(sandbox.bwrapPath、sandbox.socatPath、sandbox.ripgrep)には承認を要求するようになった
英語原文を表示
Improved the managed settings approval dialog: shows endpoint URLs, uses clearer wording for telemetry-only changes, skips routine OpenTelemetry options, and requires approval for server-managed sandbox binary overrides (sandbox.bwrapPath, sandbox.socatPath, sandbox.ripgrep)

変更後

組織から配信される設定の承認ダイアログで、どのエンドポイント URL に接続しようとしているのかを確認できるようになり、テレメトリ関連の変更については意図が明確な表現で判断できる。日常的な OpenTelemetry 設定変更では不要な承認を求められず、サンドボックスの実行バイナリ設定がサーバー側から差し替えられた場合には必ず承認を経るため、セキュリティ上の重要な変更を見逃さずに済む。

関連ドキュメント

v2.1.133(1件)

Added
LinuxおよびWSL向けに、bubblewrapとsocatの実行ファイルのパスを指定する設定(sandbox.bwrapPath, sandbox.socatPath)を追加しました
英語原文を表示
Added sandbox.bwrapPath and sandbox.socatPath managed settings (Linux/WSL) to specify custom bubblewrap and socat binary locations

変更後

OS標準のパッケージ管理以外でツールを導入している環境でも、安全な隔離実行環境を維持できるようになります。

関連ドキュメント