Claude Codeで確認が多い設定を使うと、コマンドを承認するたびに作業が止まることがある。かといって全確認をオフにする --dangerously-skip-permissions(権限バイパス)は、プロンプトインジェクションや誤操作で家じゅうのファイルを触られかねない。確認回数を減らすときも、許可する範囲の判断は必要だ。

サンドボックスは、シェルコマンドとその子プロセスが触れるファイル・通信先をOSレベルで制限する仕組みだ。自動許可モードにすれば確認を減らす助けになるが、端末全体の保護や情報流出防止を保証するものではない。この記事では対象範囲、設定、確認を省く条件、サンドボックス外で動く経路を整理する。

30秒で結論

迷ったらここだけ

サンドボックスとは
ファイルとネットワークの触れる範囲をOSで囲う仕組み。対象は隔離して実行されるシェルと子プロセス。
なにが嬉しい
確認地獄と全バイパスの二択を解消。影響範囲を絞り、自動許可モードなら確認も減らせる。許可範囲内の破壊・送信や外側のツールは別問題。
まず何を
/sandbox を実行。macOSは即利用可、Linux/WSL2は2パッケージ導入。

※Anthropicの社内利用では、サンドボックスにより権限確認が84%削減できたと報告されている(後述・出典あり)。

1. なぜサンドボックスが要るのか

Claude Codeは、テストを走らせたりファイルを書き換えたりと実際に手を動かすAIエージェントだ。権限設定によっては、実行前に承認を求める。だが一日に何十回も確認が挟まると、作業が細切れになり、しまいには読まずにEnterを押すようになる。これが「確認疲れ(permission fatigue)」だ。

疲れた開発者が手を伸ばしがちなのが、全確認をオフにする --dangerously-skip-permissions(別名 YOLOモード)。快適だが、名前どおり危険だ。次の3つが同時に牙をむく。

💉 プロンプトインジェクション

読み込んだWebページやissueに「~/.ssh を送信せよ」と仕込まれていると、確認なしで秘密鍵が流出しうる。

🗑️ 破壊的な誤操作

生成コマンドが想定外のパスを掃除。確認がなければプロジェクト外のファイルまで消えることも。

📤 サプライチェーン汚染

悪意ある依存パッケージがインストール時に外部へデータを送信。ネットワークが素通しだと止められない。

サンドボックスは、コマンド文字列の承認とは別に実行中のプロセスが到達できる範囲を制限する。任意スクリプトにもOS側の制限が働くが、許可した書き込み先や通信先の悪用までは防げない。Anthropicは公式ブログで社内の権限確認を84%減らしたと報告した(2025年10月)。これはベンダーの社内測定であり、すべての環境の削減率や安全性を保証する数値ではない。

2. サンドボックスとは何か——2つの隔離

Claude Codeのサンドボックスは、Bash・PowerShell・Monitorのシェルコマンドと子プロセスに対して2種類の境界をかける。この2つは必ずセットで機能させる——片方だけでは穴が残る(理由は §7)。

🗂️ ① ファイルシステム隔離

既定の書き込み先は作業ディレクトリ、追加した作業ディレクトリ、ユーザー別一時領域。保護パスは別途拒否される。読み取りの既定値は広いため、秘密ファイルはdenyReadなどで制限が必要。書き込める領域の削除や改変は残る。

🌐 ② ネットワーク隔離

接続はプロキシを通り、許可ドメインで判定する。許可リストは空から始まるが、設定・権限ルールから追加される。許可外ホストの扱いは権限モード次第で、常に拒否・確認になるわけではない。許可先への秘密情報の送信も防ぐ保証はない。

肝は「Claudeが行儀よくするか」に頼らない点だ。境界をOSのセキュリティ機構——macOSは標準のSeatbelt、Linux/WSL2はbubblewrap——が強制する。だから、コマンドが呼び出したスクリプトや孫プロセスにまで同じ境界が及ぶ。これはAIガードレールのような「モデルへのお願い」ではなく、実行中のプロセスに適用されるアクセス制限だと考えるといい。

💡 対象はシェルコマンドと子プロセス。 サンドボックスが囲うのはBash・PowerShell・Monitorのシェルと子プロセス。Claude内蔵のRead/Edit/Write、MCPサーバー、フックは別枠(権限ルールで制御)だ。プロセス全体を丸ごと隔離したいときは、後述の @anthropic-ai/sandbox-runtime を使う。

3. 始め方——/sandbox と対応OS

サンドボックスはClaude Codeに内蔵されている。追加アカウントは不要だが、OSによって依存パッケージの準備が必要になる。セッション内で次を実行する。

/sandbox

パネルが開き、3つのタブが並ぶ。Mode(承認方式=次章)、Overrides(サンドボックスで失敗したコマンドを外で再実行させるか)、Config(解決済みの設定を確認)。Linux/WSL2で必要パッケージが未導入なら、代わりに Dependencies タブが出て、何が足りないかを教えてくれる。

OSごとの前提

🍎 macOS

導入不要。OS標準のSeatbeltを使う。/sandbox ですぐ有効化できる。

🐧 Linux / WSL2

bubblewrap と socat の2つを導入。apt-get install bubblewrap socat など。

🪟 ネイティブWindows

非対応。WSL2 の中でClaude Codeを動かす(WSL1は不可)。

Linux/WSL2では、bubblewrap(ファイル隔離を担う非特権サンドボックス)と socat(通信をプロキシへ中継)を入れる。

# Ubuntu / Debian
sudo apt-get install bubblewrap socat

# Fedora
sudo dnf install bubblewrap socat

⚠️ Ubuntu 24.04以降の注意: 既定のAppArmorポリシーが bubblewrap のユーザー名前空間作成を止めることがある。sysctl kernel.apparmor_restrict_unprivileged_userns が 1 を返すなら、bwrap 用のAppArmorプロファイルを追加して許可する(手順は公式ドキュメントに掲載)。0 かキー無しなら対応不要。WSL2でも同様に確認を。

1つ有効化しておくと便利なのが seccompフィルタ(Unixドメインソケットの遮断を追加)。任意だが、npm install -g @anthropic-ai/sandbox-runtime で導入できる。導入状況は /sandbox のDependenciesタブに ripgrep / bubblewrap / socat / seccomp として表示される。パッケージを入れたらClaude Codeを再起動してから /sandbox を開き直すこと(起動時に検出するため)。

4. 2つのモード(自動許可/通常)

Modeタブで選ぶのは、サンドボックス内のコマンドをどう承認するかだ。

既定は通常権限モード(v2.1.324 から)。 サンドボックスをオンにしただけでは、隔離されるコマンドもこれまでどおり確認が出る。v2.1.323 までは自動許可が既定だった。確認を減らしたいなら、Modeタブで自動許可を選ぶか、settings.json に sandbox.autoAllowBashIfSandboxed: true を書く(公式の設定一覧)。管理設定でサンドボックスを必須にしている組織は、最も優先される管理設定に同じ値を置く。

✅ 自動許可モード(auto-allow)

隔離されるシェルコマンドを原則として確認なしで承認する。適用されるdeny、内容指定ask、重要パスの削除判定などは残る。未知の接続先の判断と、コマンドをサンドボックス外で再実行する判断は別だ。どちらも必ず確認が出るわけではない。

🔍 通常権限モード(regular)

サンドボックスされていても、シェルコマンドは通常の権限判定を通る。制御は増えるが承認も増える。「隔離+従来どおりの確認」を両立したい慎重派向け。

どちらのモードでもファイル/ネットワークの境界は同一で、違うのは「自動で通すか、確認するか」だけだ。なお自動許可モードでも、次の安全弁は生き続ける。

  • 設定ルール同士では、一致したdenyがallowより優先し、modによる変更条件は権限ルールの記事を参照
  • /・ホームディレクトリ・重要システムパスを狙う rm / rmdir は権限モードに応じて確認または拒否になる
  • Bash(git push *) のような内容指定の ask ルールは、サンドボックス内でも確認を強制する

紛らわしい2つの「自動」に注意。 サンドボックスの自動許可モードは、権限モードのautoモードとは別物だ。前者は「OSの境界が閉じ込めるから自動で通す」、後者は「分類器がコマンドの安全性を審査して通す」。両者は組み合わせられるが、Planではauto-allowが承認範囲を広げない。auto側のホスト審査や追加の分類器審査が残る条件もある。

未知の接続先への通信

対話端末ではManual・acceptEdits・通常のPlanは確認、dontAskは拒否。autoはコマンドに列挙したホストを分類器が承認した場合に許可する。bypassと、バイパスを選択可能にしたPlanは無確認で許可する。strictAllowlist・allowManagedDomainsOnly・deniedDomainsによる拒否は別途適用される。コマンド自体はサンドボックス内に残る。

サンドボックス外での再実行

対話端末ではManual・acceptEditsは通常確認、autoは分類器、dontAskは拒否。PlanはPlan中のコマンド判定に従う。bypassや一致するallowでは確認を省くが、Bash(dangerouslyDisableSandbox:true)のaskや作業範囲外読み取りの制限などが優先する場合がある。allowUnsandboxedCommands:falseは再実行を止めるが、excludedCommandsは別。利用不能時の無隔離実行を止める設定はfailIfUnavailable。公式の例外条件も確認する。

5. settings.json で設定する

/sandbox パネルでの選択は、プロジェクトの .claude/settings.local.json に書き込まれる(gitには載らない)。全プロジェクトで常時オンにするなら、ユーザー設定 ~/.claude/settings.json に sandbox.enabled: true を置く。確認を減らしたいなら、同じ sandbox の中に autoAllowBashIfSandboxed: true も並べる(既定は false=通常権限モード)。設定は 権限ルール(allow/ask/deny)と同じ settings.json ファミリーで管理する。

書き込み先を足す・読み取りを禁じる

既定の書き込み先は作業ディレクトリ、追加作業ディレクトリ、ユーザー別一時領域。allowWriteはさらに書き込み先を追加する設定だ。denyReadは隔離されるコマンドの読み取りを制限するが、内蔵ReadツールやMCPを直接止める設定ではない。

{
  "sandbox": {
    "enabled": true,
    "filesystem": {
      "allowWrite": ["~/.kube", "/tmp/build"],
      "denyRead": ["~/"],
      "allowRead": ["."]
    }
  }
}

上の例は「ホーム全体の読み取りを禁止しつつ、いまのプロジェクトだけ読める」設定だ(. はプロジェクト設定に置いたときプロジェクトルートに解決される)。パスはOSレベルで強制されるので、npm や terraform などの子プロセスにも等しく効く。

認証情報を守る

重要な落とし穴:読み取りの初期値は「広く許可」なので、~/.aws/credentials や ~/.ssh/ はそのままだと読めてしまう。専用の sandbox.credentials(比較的新しい機能)でファイルの読み取り拒否や環境変数の除去を宣言できる。

{
  "sandbox": {
    "enabled": true,
    "credentials": {
      "files": [
        { "path": "~/.aws/credentials", "mode": "deny" },
        { "path": "~/.ssh", "mode": "deny" }
      ],
      "envVars": [
        { "name": "GITHUB_TOKEN", "mode": "deny" }
      ]
    }
  }
}

接続先を許可する

許可ドメインのリストは空から始まるが、allowedDomainsやWebFetchのドメインルールなどから追加される。未知の接続先は権限モードによって確認・拒否・無確認の許可に分かれる。接続先を必須の境界にする場合はstrictAllowlistや管理設定のallowManagedDomainsOnlyなども確認する。

{
  "sandbox": {
    "enabled": true,
    "network": {
      "allowedDomains": ["*.github.com", "registry.npmjs.org"]
    }
  }
}

組織で必須化するには。 管理設定で sandbox.enabled: true に加え、failIfUnavailable: true(サンドボックスが起動できなければClaude Codeを起動させない)と allowUnsandboxedCommands: false(外での再実行という「逃げ道」を封じる=厳格モード)を置くと、利用不能時の無隔離実行と外側への再実行を制限できる。ただしexcludedCommandsや内蔵ファイルツール、MCPなどは別経路なので、それだけで全操作を隔離する保証にはならない。

6. 権限モード・権限ルールとの関係

混同しやすいが、Claude Codeの安全機構は役割の違う3層だ。サンドボックスはその1層で、他の2つを置き換えるものではなく補完する。

層 制御するもの 強制する主体 対象
権限ルール どのツール/コマンドを使えるか Claude Code(実行前) 全ツール
権限モード 確認をどれだけ出すか Claude Code(実行前) モード次第
サンドボックス 走った後に何へ触れるか OS(カーネル) シェルコマンドと子プロセス

権限ルールは実行前のツール呼び出しを判定し、サンドボックスはその中で動くプロセスのファイル・通信アクセスを制限する。コマンドの別表記に依存しない利点はあるが、外側のツール、除外コマンド、外側での再実行、広い許可を残すと、その経路には同じ境界が効かない。

バイパスは確認と分類器を省く権限モード、サンドボックスは実行範囲を制限する層であり、役割が違う。組み合わせた場合も、バイパスでは未知のホストや外側での再実行が無確認で通る条件がある。日常の端末を使うだけで安全とは判断せず、許可範囲・例外・資格情報を合わせて確認したい。

7. 限界と注意点——過信は禁物

サンドボックスは強力だが、完全な隔離ではない。ハードなセキュリティ境界として頼り切る前に、公式が明示する限界を押さえておく。

🔓 TLSは既定で中身を見ない

プロキシはホスト名で許可判定するだけで、暗号化通信の中身は検査しない(既定)。github.com のような広いドメインを許すと、ドメインフロンティング等で外部へデータを逃がす余地が残る。許可リストは狭く。

🔌 Unixソケットの開放は危険

/var/run/docker.sock を許すと、Dockerソケット経由でホスト全体に手が届く=実質サンドボックス突破。開けるソケットは慎重に。

📈 広すぎる書き込み許可

$PATH 上の実行ファイルや .bashrc 等へ書けると、別文脈でのコード実行に化ける。allowWrite は最小限に。

Linux・WSL2 では、サンドボックス内のコマンドはユーザー名前空間を作れない(既定)。Chromium・Electron 自身のサンドボックスや、入れ子の bubblewrap・unshare を使うには、~/.claude/settings.json で sandbox.allowNestedUserNamespaces を true にする(v2.1.305 以降。プロジェクトの設定では有効にできない)。ただし公式は、これでセキュリティの境界が1つ外れると警告している。サンドボックス内のコマンドのコードが、サンドボックスの外で動きうるためだ。rootless Podman・Buildah はこの設定だけでは動かない(公式の説明)。

内蔵Read/Edit/Write、WebFetch/WebSearch、MCP、Hooks、LSP、補助コマンドは内蔵サンドボックスの外で動く。プロセス全体を制限するには、コンテナ・VM・sandbox-runtimeなど別の境界を検討する。その場合も、マウント・通信・ソケット・資格情報の許可範囲が重要だ。

8. dev container・VMとの使い分け

Claude Codeの隔離手段はサンドボックスだけではない。手軽さと隔離の強さはトレードオフなので、用途で選ぶ。

サンドボックス(内蔵)

シェルコマンドと子プロセスを隔離。Docker不要・導入最小。自動許可モードにすれば、日常開発で確認を減らす主力。

sandbox-runtime

Claude Codeと、それが起動するローカル子プロセスを包む。リモートMCPサーバー自体の隔離とは別。Docker不要。

dev container

開発環境ごとコンテナ化。チームで環境を揃える標準化に。Docker必須。

VM(仮想マシン)

OSごと分離。別のゲストOSを使う隔離。共有フォルダ・通信・資格情報の設定が重要。信頼できないコードを扱う時に。手間は最大。

実務の勘どころ:まず内蔵サンドボックスを常時オンにし、自動許可モードで日々の確認を減らし、無人で回す・信頼できない依存を扱うときだけ sandbox-runtime やコンテナ/VMへ格上げする。クラウド操作をAIに任せるような本番に手が届く作業では、最小権限の資格情報と併せて隔離を一段強くしておくと安心だ。

まとめ

  • サンドボックスは「触れる範囲をOSで囲う」仕組み。確認疲れと全バイパスの二択を解消する。
  • 隔離はファイルシステム+ネットワークの2つをセットで。強制はmacOS=Seatbelt/Linux・WSL2=bubblewrap。
  • /sandbox で開始。macOSは即利用可、Linux/WSL2は bubblewrap+socat、ネイティブWindowsは非対応(WSL2で)。
  • 既定は通常権限モード(v2.1.324 から)。確認を減らすには自動許可モードを選ぶ。確認なしでも、許可範囲内の改変や送信は残る。deny・危険な rm・内容指定askは残る。
  • 権限ルール/モードとは役割の違う補完層。サンドボックスは実行中にOSがアクセスを制限。サンドボックス外の経路は別。
  • ただし完全な壁ではない——TLS非検査・Unixソケット・広すぎる許可に注意。対象は隔離されるシェルと子プロセス。

確認を減らすときは、許可範囲とサンドボックス外の経路を先に確認することが重要だ。設定の正確な最新仕様は、公式のサンドボックス設定ドキュメントを一次情報として確認してほしい。

FAQ

Q. サンドボックスと --dangerously-skip-permissions は何が違う?

A. バイパスは確認と分類器を省く権限モードです。サンドボックスは隔離されるシェルと子プロセスの到達範囲を制限します。内蔵ファイルツールやMCPは対象外で、許可範囲内の改変・送信も残ります。両方を使うと未知のホストや外側の再実行が無確認で通る条件もあるため、端末全体が安全になるとはいえません。

Q. Windowsで使える?

A. ネイティブWindowsは非対応で、WSL2内で利用します。Windowsバイナリへのアクセス制限はseccompやUnixソケットの設定によって変わり、一律に起動不能とはいえません。excludedCommandsで除外したコマンドはサンドボックス外で動くため、その影響範囲を別途確認してください。

Q. 有効にすると遅くなる?

A. この調査では、全環境に適用できる性能測定値を確認できませんでした。確認の回数が減ることと、コマンド自体の実行時間が短くなることは別です。同じビルドやテストで、実行時間・承認回数・失敗を記録して比較してください。

Q. サンドボックスがあれば秘密鍵は絶対に漏れない?

A. 「絶対」ではない。読み取りの初期値は広い許可なので、~/.ssh や ~/.aws/credentials は既定では読めてしまう。sandbox.credentials や denyRead で隔離されるシェルの読み取りを制限し、ネットワーク許可リストを狭く保つこと。内蔵ReadやMCPは別途制御が必要で、filesystem.disabled:trueでファイル隔離を無効にするとdenyReadと資格情報ファイルのdenyは効かない。ファイル隔離とネットワーク隔離は必ずセットで効かせる。

Q. MCPサーバーやフックもサンドボックスされる?

A. 内蔵サンドボックスの対象はBash・PowerShell・Monitorのシェルコマンドと子プロセスです。MCP・Hooks・内蔵Read/Edit/Writeなどは外側で動きます。プロセス全体を包むsandbox-runtime、コンテナ、VMなどを検討する場合も、その環境で許可した通信・マウント・資格情報は別途確認してください。

変更せず調査・助言だけを依頼する場合は、Codex・Claude Codeを調査専用で使う手順へ。サンドボックスは既定で作業領域への書き込みを許すため、読み取り専用とは区別してください。

権限・隔離の対象範囲と例外条件は2026年10月9日に公式原文を再照合しました。端末設定の変更や起動試験は行っていません。