Claude Code 2.1.325のsandbox Bash確認と無人実行の点検

13 分で読める
SaaSClaude Code

Claude Code 2.1.325では、sandbox内のBashも通常の許可判定を受けます。sandbox内のコマンドを自動許可したい場合は、sandbox.autoAllowBashIfSandboxed: trueを明示します。ただしdenyとコマンドを限定したaskは残り、裸のBashやBash(*)のaskはsandbox内では省かれます。/loop・定期タスクからallowed-toolsやhooksを持つスキルを呼ぶ場合は、そのスキルだけをpermissions.allowへ追加するのが公式の案内です。

確認日:2026-11-15 JST。対象:Claude Code 2.1.325の公式仕様と2.1.322との比較計画。CLIの版比較は未検証です。 macOS 27.0・Node.js 26.12.1で隔離の事前確認を試しましたが、必要な隔離条件を満たせず比較を中止しました。以下の製品挙動は公式資料、点検例の挙動は偽設定を使った合成テストに基づきます。

要点:sandboxによる制限と、コマンドを許可する判断は別です。自動許可を選ぶときもdeny・限定したaskを残し、スキルは名前で許可します。読むだけの点検例で設定候補を確認できますが、無人実行の成功を保証するものではありません。

2.1.325でsandboxのBashはどう変わりましたか?

2.1.325の変更履歴はsandbox内のBashを既定で通常の許可判定へ変更したと説明しています。通常の許可判定でも、allowルールやpermission mode、読み取り専用コマンドなどによって実行される場合があります。「すべてのBashに必ず確認が出る」という意味ではありません。

設定・条件 2.1.322についての公式記述からの見込み 2.1.325の公式仕様
sandbox有効、autoAllow未指定 旧既定値はtrue 通常の許可判定
autoAllowをtrueに指定 sandbox内で自動許可 sandbox内で自動許可。例外は下記
denyで対象コマンドを禁止 禁止が優先 禁止が優先
Bash(git push *)のask コマンドを限定した確認 確認が残る
裸のBashのaskとautoAllow true 版比較は未検証 sandbox内の全体確認は省かれる
excludedCommandsに一致 通常の許可判定 通常の許可判定

この表はCLIの実測結果ではありません。設定リファレンスは既定値をfalseとし、「2.1.324より前はtrue」と記しています。変更履歴の掲載は2.1.325ですが、切替が初めて起きたバージョンを今回確定したわけではなく、2.1.324は未実測です。

設定を書き換えずに何を点検できますか?

点検スクリプトを保存し、読む設定ファイルを引数で指定します。Node.jsで動作し、設定の書き込み・通信・コマンド実行はしません。引数なしでホームの設定を読むこともありません。

node sandbox-unattended-audit.mjs \
  --user /absolute/path/to/user-settings.json \
  --project /absolute/path/to/repo/.claude/settings.json \
  --local /absolute/path/to/repo/.claude/settings.local.json \
  --skill /absolute/path/to/repo/.claude/skills/demo/SKILL.md

存在するファイルだけを指定します。managedの単一ファイルを調べる場合だけ--managed /absolute/path/to/managed-settings.jsonを追加します。symlinkを含む経路は拒否するため、実体のパスを指定してください。設定原文・ファイルパス・スキル本文は出力せず、スキルは入力順の配列番号で示します。

点検結果はどう読みますか?

注意コード・状態 読み取れること 次の確認
regular-permissions 指定ファイルではsandbox有効、autoAllowはfalseまたは未指定 allowとpermission modeを確認
bare-bash-ask-skipped autoAllow trueと裸のBash askが併存 必要なコマンドを限定したaskへ
needs-allow allowed-toolsかhooksを宣言し、名前のallowがない 内容を確認してからそのスキルだけ許可
allow-listed 指定ファイルに名前のallowがある 実行成功や安全性の判定ではない
review-deny Skillのdenyが指定されている 名前・alias等をCLIで確認。点検例はdenyの詳細を解釈しない
managed-auto-allow-review managedのsandbox有効化に同じ入力のautoAllow trueがない 組織の最上位managed sourceを確認
unsandboxed-retry-review 指定ファイルで非sandbox再試行を禁止していない allowUnsandboxedCommandsを確認

この例は指定したファイルの限られた構文を読む静的点検です。コマンドライン、環境変数、permission mode、複数のmanaged source、plugin・alias、実際のコマンドの許可可否を評価しません。allowed-toolsは1行・空白区切り・YAMLリストを検出しますが、YAML全般は解釈せず、対応外の宣言はエラーにします。

自動許可と制限はどこで設定しますか?

設定の優先順位を確認し、対象の作業に必要な範囲で次の設定を検討します。これは設定例であり、点検スクリプトが保存する内容ではありません。

{
  "sandbox": {
    "enabled": true,
    "failIfUnavailable": true,
    "autoAllowBashIfSandboxed": true,
    "allowUnsandboxedCommands": false
  },
  "permissions": {
    "ask": ["Bash(git push *)"],
    "allow": ["Skill(demo)"]
  }
}

この設定例はローカルCLI向けです。demoは説明用の名前なので、実際に内容を確認したスキル名へ置き換えてください。ローカルCLIでのfailIfUnavailableはsandboxが使えない条件での実行を防ぐための設定、allowUnsandboxedCommands: falseはsandbox外への再試行を禁止するための設定です。後者は既存の作業を止める場合があります。作業フォルダ外への書き込みを制限する記事も参照してください。

Anthropic-hosted環境では、failIfUnavailableがtrueでも警告付きでセッションを開始でき、sandbox.filesystem・sandbox.networkを強制しない例外がリファレンスにあります。この設定例からcloud scheduled tasks等での停止や隔離を保証できません。hosted環境は今回未実測です。

保存先 対象 同じscalarキーの優先度
userの~/.claude/settings.json 自分の各プロジェクト 低
projectの.claude/settings.json 共有するプロジェクト userより上
localの.claude/settings.local.json 自分の当該プロジェクト projectより上
起動時の--settings 当該セッション localより上。点検例の対象外
managed settings 組織の方針 最上位。複数sourceの規則あり

優先順位にはadmin-required sandboxの例外があります。managedのallowUnsandboxedCommands: falseまたはnetwork.allowManagedDomainsOnly: trueでsandboxが管理上必須の場合、userのenabled: trueをproject/localのfalseで解除できません。点検例は指定managed入力からこの条件を判定し、裸のBash askの注意を残します。

permissionの配列は上位ファイルで丸ごと置き換わるのでなく結合されます。点検例もこの結合を反映します。managedでsandboxを有効にする組織については、変更履歴とリファレンスが最上位のmanaged sourceにautoAllow trueを書くよう案内しています。ユーザー側の設定だけで組織の方針を変更できるとは考えないでください。managed環境は今回未実測です。

denyやコマンドを限定したaskは残りますか?

PermissionsとSandbox modesでは、autoAllow trueでもdenyとBash(git push *)などのaskは適用されます。裸のBash・Bash(*)のaskを省く扱いにはplan modeでの例外があり、CLAUDE_CODE_SUBPROCESS_ENV_SCRUBは自動許可を無効にします。sandboxで実行できないコマンドやexcludedCommandsも通常の許可判定へ進みます。

広いBash allowを追加して確認をまとめて消す前に、ワイルドカードの許可範囲を確認してください。

/loopと定期タスクではスキルの何を確認しますか?

2.1.325の変更履歴は、allowed-toolsまたはhooksを宣言するスキルを/loop・定期タスクから実行する前に確認し、無人で使うにはpermissions.allowへSkill(name)を追加するよう案内しています。Skillsの許可構文にも名前を指定するSkill(demo)と、引数を含めるSkill(demo *)の書式があります。permissionsにあるSkill(skill:<name>)はdenyのparameter形式の説明であり、ここでは混用しません。

スキルのhooksも確認対象です。hookの終了コードと、subagentのMCPと信頼は別の確認面として役立ちます。Skillを許可しただけで、MCPの信頼やすべてのツール操作まで許可したとは扱いません。

定期タスクの比較表では/loopはセッションの許可を引き継ぎます。今回、対話セッションの/loop・定期タスクは実行していません。Desktop・IDE・SDKの「常に許可」の変更も変更履歴に基づく説明だけで、実測していません。無人実行時の利用量はClaude Codeのusage、Codexでの別経路はcodex execを参照できます。

今回の検証で何が分かり、何が残りましたか?

対象 実施内容 言える範囲
公開資料 公式文書とGitHub CHANGELOGの該当箇所を取得 取得時点の仕様説明
CLI隔離の事前確認 偽API・偽設定、外側sandboxとenvの代替構成 入れ子sandbox失敗。代替でも全設定パスの隔離を示せず比較中止
設定の優先順位 3 scope×enabled/autoAllowの未設定・false・trueを全列挙 点検例の729組。CLI本体の検証ではない
管理上必須の例外 managedの2キーとuser/project/localのenabledを全列挙 追加243組。独立レビューの反例を回帰検査
不正入力・境界 JSON・型・frontmatter・サイズ・symlinkを検査 点検例が不正入力を拒否すること
壊した点検例 優先順位逆転・裸のask注意削除・hooks見落とし 検査が各不具合を検出すること
未実測 S1〜S8・K1〜K2の版比較、managed、/loop、Desktop等 公式説明の範囲に限定

合成入力と点検結果も配布します。実験は通常の設定や秘密値を変更するためのものではなく、固定の偽キーとローカル偽APIだけを使いました。実モデルは呼んでいません。実設定の値やハッシュも取得していません。CLI本体の比較を完了したという主張や、流入・順位が改善したという実績はありません。SaaS Workflows一覧から関連する点検例を探せます。

よくある質問は?

2.1.325でsandboxのBashに確認が出るのはなぜですか?

通常の許可判定へ変わったためです。すべてのコマンドが必ず確認待ちになるわけではなく、allowルールやpermission modeなどで変わります。CLIの版比較は今回未検証です。

sandboxのBashを自動許可するにはどうしますか?

sandbox.enabledとsandbox.autoAllowBashIfSandboxedをtrueにします。denyやコマンドを限定したaskは引き続き適用されます。組織のmanaged設定がある場合は最上位のmanaged sourceを確認します。

autoAllowを有効にするとdenyも無視されますか?

公式仕様ではdenyは残ります。裸のBash・Bash(*)のaskを省く扱いと、コマンドを限定したaskやdenyを区別してください。plan modeなどには例外があります。

/loopや定期タスクでスキルが止まるのはなぜですか?

変更履歴ではallowed-toolsかhooksを宣言したスキルの前に確認を挟みます。内容を確認したスキルだけをSkill(demo)などの名前でallowへ加えます。対話の定期実行は今回未実測です。

managed settingsではどこへ設定しますか?

公式の案内はsandbox.autoAllowBashIfSandboxedを最上位のmanaged sourceでtrueにすることです。配布例は単一のmanaged入力だけを扱い、MDMや複数sourceの実効設定を判定しません。

Desktopなどの「常に許可」でも定期タスクが止まりますか?

2.1.325の変更履歴にはDesktop・IDE・SDKの「常に許可」の変更により、保存済みルールに頼る定期タスクが待つ場合があるとあります。今回これらのhostは未実測です。

このトピックを深掘りする

SaaSの導入・連携

AIに仕事の続きを渡すために、会議の原文、未完了の宿題、確認できない項目をどう残すか。導入判断と連携実装を掘り下げる。

全22本中 1 本目。

このトピックの記事一覧

シリーズ全体の流れを見ながら、次に読む記事へ進めます。 初めての方はホームへ →

よくある質問

2.1.325でsandboxのBashに確認が出るのはなぜですか?

通常の許可判定へ変わったためです。すべてのコマンドが必ず確認待ちになるわけではなく、allowルールやpermission modeなどで変わります。CLIの版比較は今回未検証です。

sandboxのBashを自動許可するにはどうしますか?

sandbox.enabledとsandbox.autoAllowBashIfSandboxedをtrueにします。denyやコマンドを限定したaskは引き続き適用されます。組織のmanaged設定がある場合は最上位のmanaged sourceを確認します。

autoAllowを有効にするとdenyも無視されますか?

公式仕様ではdenyは残ります。裸のBash・Bash(*)のaskを省く扱いと、コマンドを限定したaskやdenyを区別してください。plan modeなどには例外があります。

/loopや定期タスクでスキルが止まるのはなぜですか?

変更履歴ではallowed-toolsかhooksを宣言したスキルの前に確認を挟みます。内容を確認したスキルだけをSkill(demo)などの名前でallowへ加えます。対話の定期実行は今回未実測です。

managed settingsではどこへ設定しますか?

公式の案内はsandbox.autoAllowBashIfSandboxedを最上位のmanaged sourceでtrueにすることです。配布例は単一のmanaged入力だけを扱い、MDMや複数sourceの実効設定を判定しません。

Desktopなどの「常に許可」でも定期タスクが止まりますか?

2.1.325の変更履歴にはDesktop・IDE・SDKの「常に許可」の変更により、保存済みルールに頼る定期タスクが待つ場合があるとあります。今回これらのhostは未実測です。