COURSE 01 · Harness Engineering
サンドボックスの仕組み(OSレベル)
ツールに外界を触らせるなら、どこまで触れるかを囲う必要がある。ファイルとネットワークの2層、OSネイティブの仕組み(Landlock・seccomp・Seatbelt)、既定で狭くする設計を深く見る。
これは詳細編「詳しく学ぶ(トピック別)」のレッスンです。前の実行環境とサンドボックスの基本が概観で、ここはその仕組みの深掘りです。
触らせるなら、囲う
ツールでシェルやファイルを動かせるようにした瞬間、「どこまで触れてよいか」を決める必要が生まれます。その囲いがサンドボックスです。緩すぎれば事故や情報漏れにつながり、狭すぎれば仕事になりません。ここをどう引くかが設計です。
2つの独立した層
公式ドキュメントによると、サンドボックスは独立した2つの層で考えます。
- ファイルの隔離:どのパスを読める/書けるかを制御する
- ネットワークの隔離:どのドメインに届けるかを制御する
この2つは別物です。片方を絞っても、もう片方が開いていれば抜けます。公式も、ネットワークの送信(egress)を許せば、エージェントが読めたデータは外へ漏れうるし、プロジェクトを書き込み可能にすれば、そのコードは書き換えられうる、と指摘しています。だから両方を別々に絞ります。
OSネイティブの仕組み
囲いは、OSが持つ仕組みで強制するのが確実です(調査時点:2026年11月)。
- Linux:Landlock(ファイルやポートの範囲を制限)、seccomp(システムコールを絞る)、名前空間による隔離(Bubblewrapなど)
- macOS:Seatbelt(
sandbox-exec)で、読み書きできるパスを制限する
コンテナを使わずに、OSレベルでファイルとネットワークの制限をかける実装もあります(Anthropicのsandbox-runtimeなど)。コンテナやVMで丸ごと隔離する方式とあわせ、どこで動かすかは選べます。
設計の芯:既定で狭く
通底する原則は、入口レッスンと同じです。既定で狭く、必要な分だけ開ける。全開にしてから塞ぐのではなく、閉じた状態から、作業に要る分だけ穴を開けます。
各ハーネスでの現れ方は、もう見ました。Codexの sandbox_mode(read-only/workspace-write/danger-full-access)や、Claude Codeの保護パスは、この2層と原則の具体例です(Codex・Claude Code)。
次に読む
次はスキルと段階的開示で、ツールが「何ができるか」なら、スキルが「どうやるか」を必要なときに渡す仕組みを見ます。