Harness Atlas

COURSE 01 · Harness Engineering

サンドボックスの仕組み(OSレベル)

ツールに外界を触らせるなら、どこまで触れるかを囲う必要がある。ファイルとネットワークの2層、OSネイティブの仕組み(Landlock・seccomp・Seatbelt)、既定で狭くする設計を深く見る。

これは詳細編「詳しく学ぶ(トピック別)」のレッスンです。前の実行環境とサンドボックスの基本が概観で、ここはその仕組みの深掘りです。

触らせるなら、囲う

ツールでシェルやファイルを動かせるようにした瞬間、「どこまで触れてよいか」を決める必要が生まれます。その囲いがサンドボックスです。緩すぎれば事故や情報漏れにつながり、狭すぎれば仕事になりません。ここをどう引くかが設計です。

2つの独立した層

公式ドキュメントによると、サンドボックスは独立した2つの層で考えます。

  • ファイルの隔離:どのパスを読める/書けるかを制御する
  • ネットワークの隔離:どのドメインに届けるかを制御する
ファイルの隔離 許可パスだけ ツール実行 シェル・ファイル ネットワークの隔離 許可ドメインだけ 既定で狭く、必要な分だけ開ける(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)。

次に読む

次はスキルと段階的開示で、ツールが「何ができるか」なら、スキルが「どうやるか」を必要なときに渡す仕組みを見ます。

前のレッスンコースへ戻る次のレッスン