純正サンドボックス・コンテナ機能ガイド
Claude Code / Codex CLI に組み込まれたセキュリティ機能の使い方
内容の最終更新: 2026-11-02(公式ドキュメント・openai/codex のソース・CHANGELOG と照合)
/sandbox コマンドで即有効化。macOS は何もインストール不要(Seatbelt)。Linux は bubblewrap + socat を apt install するだけ。ただし隔離されるのは Bash・PowerShell・Monitor ツールのコマンドとその子プロセスだけで、file tools・MCP・hook は対象外
sandbox_mode を config.toml で設定。Docker 内では danger-full-access + approval_policy = "never" がベストプラクティス
sbx run codex ~/project だけで動く。単体の sbx CLI で、Docker Desktop は不要
enableWeakerNestedSandbox: true を有効にする(隔離は大きく弱まるので、外側のコンテナが境界になっている前提で)
このページは Claude Code と Codex CLI を中心に扱います。ほかのツールにも内蔵のサンドボックスがあります: Kiro の Local Command Sandbox(IDE v1.3.0 / CLI v2.31.0 から)、Copilot CLI の /sandbox・--sandbox(v1.0.93 から全員に開放)、Antigravity CLI のターミナルサンドボックス。詳しくは各ツールのベストプラクティスページを参照してください。
| 項目 | Claude Code /sandbox | sandbox-runtime | Codex CLI sandbox_mode | Docker Sandboxes (sbx) |
|---|---|---|---|---|
| 提供元 | Anthropic | Anthropic(ベータ・研究プレビュー) | OpenAI | Docker |
| 対象ツール | Claude Code のみ | Claude Code(他プロセスもラップ可) | Codex CLI のみ | Claude Code / Codex 両対応 |
| 分離レベル | Bash・PowerShell・Monitor ツールのコマンド(file tools/MCP/hookは対象外) | プロセス全体(file tools・MCP・hookも含む) | プロセス(OS sandbox) | microVM(独自カーネル) |
| macOS | Seatbelt 追加DL不要 | Seatbelt | Seatbelt | macOS Apple Silicon・macOS 14 以降(Docker Desktop は不要) |
| Linux | bubblewrap + socat 要インストール | bubblewrap | bubblewrap(同梱・Landlock はレガシー) | Linux 対応(KVM が必要) |
| Windows | 非対応 WSL2内のみ | 非対応 WSL2内のみ | ネイティブ対応([windows] sandbox = "elevated" / "unelevated")・WSL2 も可 |
対応(Windows Hypervisor Platform を有効化) |
| ネットワーク制限 | ドメイン allowlist(プロキシ経由) | デフォルト全拒否(設定ファイルで許可リスト指定) | デフォルト OFF(設定で制限可) | あり(VM境界) |
| 起動方法 | /sandbox コマンド |
npm install -g @anthropic-ai/sandbox-runtime → srt claude |
config.toml または CLI フラグ | sbx run codex ~/project |
| コスト | 無料(Claude Code 内蔵) | 無料(OSSパッケージ) | 無料(Codex CLI 内蔵) | 無料(Docker アカウントが必要) |
| 成熟度 | 安定版 | ベータ(研究プレビュー・設定形式が変わる可能性) | 安定版 | 安定版 |
● Claude Code
# 前提: Dev Containers 拡張 # コマンドパレット: Ctrl+Shift+P Dev Containers: Reopen in Container # または左下の "><" アイコン # → "Reopen in Container" # コンテナ起動後 claude
docker run -it --rm \ --cap-add=NET_ADMIN \ --cap-add=NET_RAW \ -e ANTHROPIC_API_KEY \ -v "$HOME/.claude":/home/node/.claude \ -v "$(pwd)":/workspace \ -w /workspace \ <image> claude # 非対話型 docker run --rm ... \ claude -p "タスク説明"
# 初回のみ: APIキー登録 sbx secret set -g anthropic # 起動 sbx run claude ~/my-project # または cd してから cd ~/my-project sbx run claude # 非対話型 sbx run claude . -- \ --dangerously-skip-permissions \ -p "タスク"
● Codex CLI
# 対話型 docker run --rm -it \ -e OPENAI_API_KEY \ -v "$HOME/.codex":/root/.codex \ -v "$(pwd)":/workspace \ <Codex CLI 入りの自作イメージ> \ codex # 言語バージョン固定 -e CODEX_ENV_PYTHON_VERSION=3.12 \ -e CODEX_ENV_NODE_VERSION=22
// .devcontainer/devcontainer.json { "features": { // サードパーティ(dirien 作)の feature。OpenAI 公式ではない。Node.js が必要 "ghcr.io/dirien/devcontainer-feature-codex/codex:0": { "version": "latest" } }, "mounts": [ "source=${localEnv:HOME}/.codex,target=/home/vscode/.codex,type=bind" ], "remoteEnv": { "OPENAI_API_KEY": "${localEnv:OPENAI_API_KEY}" } }
# 初回のみ: APIキー登録 sbx secret set -g openai # 対話型起動 sbx run codex ~/my-project # 非対話型(CI向け) sbx run codex . -- exec \ --sandbox workspace-write \ "テストを全部通してください"
● Kiro CLI
# 起動(認証は初回のみ) sbx run kiro ~/my-project # 初回ログイン(device flow) sbx run kiro --name my-kiro \ -- login --use-device-flow # → URL と確認コードが表示される # → ブラウザで認証 → 自動セッション開始 # 注意: ホストのユーザー設定は引き継がれない (プロジェクト設定のみ有効)
docker run -it --rm \ -v "$HOME/.local/share/kiro-cli":/root/.local/share/kiro-cli \ -v "$(pwd)":/workspace \ -w /workspace \ <自作イメージ> kiro-cli # 認証状態は # ~/.local/share/kiro-cli/data.sqlite3 に保存 # → ボリュームマウントで永続化
// .devcontainer/devcontainer.json { "mounts": [ "source=${localEnv:HOME}/.local/share/kiro-cli,target=/home/vscode/.local/share/kiro-cli,type=bind" ] } # 注意: 公式 devcontainer feature は未提供 # Kiro CLI は npm では配布されていない。Dockerfile で公式インストーラー # (https://cli.kiro.dev/install)か .deb / zip / AppImage を使って入れる # コマンド名は kiro-cli(公式の Docker イメージはない)
| ツール | 認証方式 | 永続化パス | コンテナでの注意 |
|---|---|---|---|
| Claude Code | API Key (環境変数) | ~/.claude/ | Named Volume か bind mount で永続化 |
| Codex CLI | API Key (環境変数) | ~/.codex/ | bind mount 推奨。OAuth token もここに保存 |
| Kiro CLI | Device Flow(ブラウザ) | ~/.local/share/kiro-cli/ | sqlite3 DB をボリュームマウントで永続化必須 |
# Claude Code を起動して実行するだけ /sandbox # OS 組み込みの Seatbelt が使われる # 何もインストール不要
macOS では Seatbelt(sandbox-exec)が自動的に使われる。
# Ubuntu/Debian sudo apt-get install bubblewrap socat # Fedora sudo dnf install bubblewrap socat # seccomp フィルタ(任意・推奨) npm install -g @anthropic-ai/sandbox-runtime # その後 Claude Code 再起動 → /sandbox
Ubuntu 24.04 は AppArmor 追加設定が必要な場合あり(後述)。
sysctl kernel.apparmor_restrict_unprivileged_userns が 1 の場合、bubblewrap が user namespace を作れない。以下のプロファイルを追加する:
sudo tee /etc/apparmor.d/bwrap <<'EOF' abi <abi/4.0>, include <tunables/global> profile bwrap /usr/bin/bwrap flags=(unconfined) { userns, } EOF sudo systemctl reload apparmor
- sandbox 内コマンドを自動承認
- deny ルールは常に適用
- 新ドメインアクセス時はプロンプト
rm /等の危険操作は例外でプロンプト- 承認回数が大幅に減る
- sandbox 内でも通常の承認フロー
- より細かくコントロールしたい場合
- 承認数は減らない
- sandbox の制限は同様に適用
/sandbox パネルの Mode タブで切り替え。設定は .claude/settings.local.json(git非管理)に保存される。全PJに適用したい場合は ~/.claude/settings.json に "sandbox": {"enabled": true} を追加。
ファイルシステム制限
- 書き込み: workdir + セッション temp のみ
- 読み込み: ほぼ全域(
~/.aws~/.sshも読める!) ~/.bashrc等のシェル設定は書き込み不可settings.json自体への書き込みは自動ブロックallowWrite/denyReadで拡張可能
ネットワーク制限
- デフォルト:許可ドメインなし
- 新ドメインアクセス時にプロンプト(承認で追加)
allowedDomainsで事前許可deniedDomainsで明示的ブロック- プロキシ経由・TLS は検査しない
~/.aws/credentials、~/.ssh/id_rsa などは デフォルトで読み込み可能。
ブロックするには sandbox.filesystem.denyRead: ["~/.aws", "~/.ssh"] を明示的に設定すること。
// .claude/settings.json(プロジェクトスコープ) { "sandbox": { "enabled": true, "failIfUnavailable": false, // true: 依存不足で起動失敗 "allowUnsandboxedCommands": true, // false: エスケープハッチ無効化 "enableWeakerNestedSandbox": false, // 非特権コンテナで bwrap が起動しない場合だけ true "filesystem": { "allowWrite": ["~/.kube", "/tmp/build"], // 書き込み許可追加 "denyRead": ["~/.aws", "~/.ssh"], // 読み込みブロック "allowRead": ["."] // denyRead 内の例外 }, "network": { "allowedDomains": ["registry.npmjs.org", "api.github.com"], "deniedDomains": ["example.com"], "httpProxyPort": 8080, // カスタムプロキシ "socksProxyPort": 8081 }, "excludedCommands": ["docker compose *"] // sandbox 外で実行(狭いパターンで) } }
コード中の // は説明用です。settings.json は厳密な JSON なので、実際のファイルではコメントを削除してください(残すと Settings Error になる)。sandbox.bwrapPath・sandbox.socatPath(bubblewrap・socat の場所の指定)は管理設定(managed settings)でだけ使えるキーで、プロジェクトの settings.json に書いても効きません。
パス prefix: / = 絶対パス、~/ = ホーム相対、./ or 無し = 設定ファイルの場所が基準(プロジェクトの settings ではプロジェクトルート、~/.claude/settings.json では ~/.claude)。
docker は sandbox と互換性なし。excludedCommands に追加して sandbox 外で実行させる:
"sandbox": { "excludedCommands": ["docker compose *"] }
docker * のような広いパターンにすると、そのツールでできることがすべて制限なしで実行できてしまうので、必要なサブコマンドに絞る。
非特権コンテナ内では bubblewrap が /proc をマウントできない。弱化モードを有効にする:
"enableWeakerNestedSandbox": true
注意:コンテナ自体の分離で補う前提。セキュリティが弱まる。
watchman が sandbox と非互換。jest --no-watchman で実行するか、excludedCommands に追加。
Seatbelt 下で TLS 検証が失敗することがある。対処:
"sandbox": { "excludedCommands": ["gh *", "gcloud *", "terraform *"] }
@anthropic-ai/sandbox-runtime
/sandbox が隔離するのは Bash・PowerShell・Monitor ツールのコマンドだけ。Read/Edit/WebFetch などの組み込みツールや MCP サーバー・hook はホスト上で動く。
Claude Codeプロセス全体を同じSeatbelt/bubblewrap隔離でラップしたい場合、Docker を使わずに sandbox-runtime を使う。
# 起動 npx @anthropic-ai/sandbox-runtime claude
デフォルトは書き込み・ネットワークとも全拒否。~/.srt-settings.json(または--settingsで指定するファイル)で
プロジェクトディレクトリと ~/.claude / ~/.claude.json への書き込み、api.anthropic.com 等の必要なドメインを事前に許可しておく必要がある。
/sandbox(Bashのみ)を使い、
file tools/MCP/hookも含めて丸ごと隔離したい場合にのみ検討する。
用途:コードレビュー・調査専用
用途:日常のローカル開発
用途:Docker コンテナ内推奨。コンテナが境界になる
--full-auto(workspace-write と確認の自動化のショートカット)は 0.128.0 で非推奨になり、0.147.0(2026-08-06)で codex exec から削除されました。代わりに --sandbox workspace-write を明示するか、権限プロファイル(default_permissions)を使います。ネットワークは別途 [sandbox_workspace_write] network_access = true。
# ~/.codex/config.toml(グローバル) # 承認ポリシー: "on-request"(既定・モデルが必要なときに確認) | "never" | { granular = { ... } } approval_policy = "on-request" # sandbox モード: "read-only" | "workspace-write" | "danger-full-access" sandbox_mode = "workspace-write" # workspace-write でのネットワーク許可 [sandbox_workspace_write] network_access = false # true にするとネット接続可 ───────────────────────────────────────── # Docker コンテナ内での推奨設定 approval_policy = "never" sandbox_mode = "danger-full-access" # コンテナ境界がセキュリティ層になる
| approval_policy | 意味 | 使い場面 |
|---|---|---|
| on-request | モデルが必要と判断したときに確認 | 既定。通常の対話作業 |
| never | 確認なし(失敗はモデルに返す) | コンテナ内・CI環境 |
| { granular = {...} } | 種類ごとに許可・自動拒否を細かく指定 | 確認の範囲を自分で決めたい場合 |
Codex クラウド環境のベースイメージの参照実装。Python・Node などの言語環境は入っているが、Codex CLI 自体は入っていないので、コンテナ内で npm i -g @openai/codex を実行するか、それを加えたイメージを自分でビルドする。root で動く(HOME=/root)。
# 基本的な使い方 docker run --rm -it \ -e OPENAI_API_KEY="$OPENAI_API_KEY" \ -v "$HOME/.codex":/root/.codex \ # OAuth token を永続化 -v "$PWD":/workspace \ -w /workspace \ ghcr.io/openai/codex-universal:latest # コンテナ内で: npm i -g @openai/codex && codex # 言語バージョンを固定する docker run --rm -it \ -e OPENAI_API_KEY="$OPENAI_API_KEY" \ -e CODEX_ENV_PYTHON_VERSION=3.12 \ -e CODEX_ENV_NODE_VERSION=22 \ -v "$PWD":/workspace \ <codex-universal に Codex CLI を加えた自作イメージ> \ codex --dangerously-bypass-approvals-and-sandbox \ exec "テストを全部通してください"
| 収録ランタイム | バージョン | 環境変数 |
|---|---|---|
| Python | 3.10 / 3.11 / 3.12 / 3.13 / 3.14 | CODEX_ENV_PYTHON_VERSION |
| Node.js | 18 / 20 / 22 / 24 | CODEX_ENV_NODE_VERSION |
| Rust / Go / Java / Ruby / PHP | 複数バージョン | CODEX_ENV_* |
| ビルドツール | uv / pnpm / poetry / cmake / ninja / Bazelisk | — |
- 単体の
sbxCLI(Docker Desktop は不要。Docker Desktop に統合されていたdocker sandboxは非推奨) - インストール: macOS は
brew install docker/tap/sbx(Apple Silicon・macOS 14 以降)、Windows はwinget install Docker.sbx(Windows Hypervisor Platform を有効化)、Linux は apt のdocker-sbx(KVM が必要) - Docker Hub のアカウント(
sbx login)
# ── 初回セットアップ(一度だけ)────────────────── sbx secret set -g anthropic # Claude Code 用 sbx secret set -g openai # Codex CLI 用 # Kiro は初回起動時に device flow で認証(API key 不要) # ── Claude Code ─────────────────────────────────── sbx run claude ~/my-project # 対話型 sbx run claude . -- \ --dangerously-skip-permissions \ -p "ユニットテストを追加して" # 非対話型 # ── Codex CLI ───────────────────────────────────── sbx run codex ~/my-project # 対話型 sbx run codex . -- exec \ --sandbox workspace-write \ "テストを全部通してください" # 非対話型 CI 向け(ファイルを直すので workspace-write) # ── Kiro CLI ────────────────────────────────────── sbx run kiro ~/my-project # 対話型 sbx run kiro --name my-kiro \ -- login --use-device-flow # 初回ログイン # → URL と確認コードが表示される → ブラウザで認証 # ※ ホストのユーザー設定は引き継がれない(プロジェクト設定のみ) # ── 名前付きサンドボックスの管理 ───────────────── # 一覧・停止・削除のサブコマンド名は sbx --help で確認する
- 独自 Linux カーネル
- 独自 Docker daemon
- ハイパーバイザ境界でホストと分離
- プロセス sandbox より格段に強い
- エージェントがホストを破壊できない
- VM 起動 → プロジェクトを VM 内にマウント
- ツール(claude/codex/kiro)を VM 内で実行
- ワークスペースをホストと同期して成果物を反映
- VM 終了でエージェント環境は消滅
devcontainerのボリューム構成・~/.claude永続化の設計は コンテナ運用ガイド で詳しく扱う。ここではsandbox設定の推奨値のみ。
// .claude/settings.json { "sandbox": { // bubblewrap はネスト不可なので弱化モード "enableWeakerNestedSandbox": true, // コンテナの iptables が代わりに制限 "enabled": true, // 資格情報へのアクセスをブロック "filesystem": { "denyRead": ["~/.aws", "~/.ssh"] }, // docker compose だけ sandbox 外で実行 "excludedCommands": ["docker compose *"] } }
ネットワーク制限はコンテナの init-firewall.sh が担う。
# ~/.codex/config.toml # コンテナ境界がセキュリティ層なので # 確認なし・制限なしで動かせる approval_policy = "never" sandbox_mode = "danger-full-access" # または CLI フラグで指定 # codex --dangerously-bypass-approvals-and-sandbox # codex --yolo (上記の別名)
コンテナの iptables でネットワーク制限を担わせる設計。
- 認証情報の読み込み: Claude Code は
~/.aws~/.sshをデフォルトで読める。denyReadかsandbox.credentials(ファイルや環境変数ごとにdeny/maskを指定)で明示的にブロックする - TLS 非検査: Claude Code のネットワークプロキシは既定では TLS を終端しない(実験的な
sandbox.network.tlsTerminateは認証情報のマスク用で、通信内容の検査は行わない)。domain fronting で allowlist をすり抜ける可能性あり - 環境変数の継承: sandboxed Bash はデフォルトで親プロセスの env を引き継ぐ。
CLAUDE_CODE_SUBPROCESS_ENV_SCRUBで資格情報を除去可能 - docker.sock: Unix ソケットへのアクセスを許可するとホストを制御できてしまう
- excludedCommands の無限定: sandbox 外で実行できるコマンドは管理者が狭く保つこと
最終更新: 2026-11-02 Claude Code 公式 Docs (code.claude.com/docs/en/sandboxing, /en/sandbox-environments)、Codex CLI Docs (developers.openai.com)、Docker Docs を参照 · WebFetch で確認済み