2026 Claude Codeの設定はAgentに書き換えられる?SBPLで改ざん防止

Claude Code公式ドキュメントは、設定項目として filesystem.denyWrite、failIfUnavailable、allowUnsandboxedCommands の3つを案内しています。公式のSandbox設定に照らすと、勝者は、個人の監督下ではdenyWriteと失敗時停止を使い、チームや無人実行ではmanaged settingsへ安全規則を移す構成です。さらに境界を強める必要がある場合だけ、SBPLでClaude Code全体を包みます。高リスク処理は独立したMac環境へ分離してください。
この判断が必要なのは、プロジェクト内に.claude/settings.jsonを置き、Claude Codeにファイル編集を許可している開発者です。チーム規則をプロジェクト設定やAgentの判断で弱めたくないDevSecOps担当者、長時間または無人で端末Agentを動かす開発基盤担当者にも向いています。
最終更新:2026年9月15日。Claude Codeの設定、権限、Sandbox、managed settingsは公式ドキュメント、macOSのsandbox-execの状態は現行man pageを基に確認しています。
同じ書き込み境界にあるAgentと設定
典型的な失敗モデルは、Agentが権限を定義するファイルと同じディレクトリへ書き込める状態です。.claude/settings.jsonのdeny規則を弱めたり、HooksやSkillsを変更したりすると、次のセッションの挙動まで変わります。
Claude CodeのEditやWriteは対象ファイルを直接変更します。Bashは子プロセスを起動するため、Gitやシェルスクリプト経由の変更も別に評価しなければなりません。公式Bash Sandboxは主にBashとその子プロセスを制限する仕組みであり、Claude Code全体の設定ファイル保護を自動的に保証するものではありません。権限モデルの説明でも、許可・拒否の判定とSandboxの境界は分けて扱われています。
ここでのClaude Code 設定の改ざん防止は、単に「優先順位の高い設定を置く」ことではありません。Agentが変更できる場所と、変更を拒否する規則の保存場所を分離することが本質です。
プロジェクト設定とmanaged settingsの保護範囲
プロジェクト設定は、リポジトリごとの許可や開発者間の共有に向いています。ローカル設定は個人実験に便利です。しかし、どちらもワークスペースから書き換えられるなら、無人処理の最終防衛線にはなりません。
特に確認すべき対象は次の範囲です。
.claude配下の設定ファイル- HooksとSkills
- Agentの起動スクリプト
- 後続セッションの権限に影響する補助設定
- APIキーや認証情報が置かれる作業ディレクトリ外のパス
業務固有の設定はリポジトリに残して構いません。一方、Sandboxを回避しない規則、失敗時に停止する規則、保護対象ディレクトリの拒否は、Agentが書けないmanaged settings側へ移すべきです。公式の設定階層では、managed settingsが高い優先順位を持つことが確認されています。
ただし、設定ファイルを1つ開いて「これが最終値」と判断するのは危険です。managed、ユーザー、プロジェクト、ローカルの値がどのように組み合わさるかを、実行時の診断で確かめる必要があります。
設定の合成と実効値の確認
設定の優先順位が高くても、配列型の項目が単純な上書きになるとは限りません。allowWriteのような許可範囲は、複数の設定源が合成され、想定より広い書き込み先になる可能性があります。ここは単一JSONの目視ではなく、実行時の結果を確認する箇所です。
確認手順は次の順番です。
- プロジェクト設定から
.claude、Hooks、Skillsの書き込み可否を洗い出します。 - denyWriteとallowWriteの対象パスを、相対パスと絶対パスの両方で整理します。
/status、/permissions、/doctorを実行し、実効値と設定元を確認します。- 設定変更後に新しいセッションを起動し、前のセッションの状態をそのまま信頼しないようにします。
- managed settings側の拒否規則が、プロジェクト設定で弱められていないことを運用記録に残します。
コマンド名や表示内容はClaude Codeの更新で変わる可能性があります。設定のデバッグ手順は、作成時点の公式デバッグガイドで再確認してください。
失敗時の継続実行と防御の空白
Sandboxの失敗には、少なくとも異なる3つの状態があります。初期化そのものに失敗する状態、通常権限の処理へフォールバックする状態、明示的に非Sandbox実行を許可する状態です。
このため、設定ファイルが書き換えられなかった事実だけでは不十分です。あるセッションで隔離されていても、次の実行が通常権限へ戻れば、同じ防御前提は成立しません。
失敗時停止を組む際の判断は明確です。
- Sandboxを利用できない場合はタスクを停止させる。
allowUnsandboxedCommandsを安易に有効化しない。- 例外コマンドを増やす前に、そのコマンドが起動する子プロセスまで確認する。
- 設定変更後は、隔離された状態と停止する状態の両方を検証する。
これらのフィールド名や既定動作は固定的に推測せず、公式Sandbox文書の現行記載で照合してください。開発者Issueで報告された設定自動変更や隔離失敗は、特定バージョン・特定環境の個別事例として扱い、現行版の必然的な脆弱性とは断定しません。
SBPLとClaude Code全体の書き込み境界
Claude Code公式のBash Sandboxと、手書きのSBPLは同じものではありません。前者はClaude Codeが管理するBash実行の保護機構です。後者はmacOSのSeatbeltポリシーを使い、起動したClaude Codeプロセスと子プロセスに、OS側から追加の制約をかける考え方です。
macOSのSandbox Profile Languageは、許可する操作を細かく記述できます。検証用には、実在の秘密情報や本番リポジトリを使わず、仮想の保護ファイルと一時ディレクトリだけを対象にします。
(version 1)
(deny default)
(allow process*)
(allow file-read*
(subpath "/tmp/claude-sbpl-demo"))
(allow file-write*
(subpath "/tmp/claude-sbpl-demo/work"))
(deny file-write*
(subpath "/tmp/claude-sbpl-demo/policy.json"))
この例は概念検証用です。実際のパスやmacOSの挙動は環境ごとに確認し、秘密鍵、システム設定、本番コードをテスト対象にしないでください。起動時には、プロファイルを明示してClaude Codeを呼び出す、取り消し可能なAliasを用意します。
alias claude-locked='sandbox-exec -f "$HOME/.config/claude/demo.sb" claude'
sandbox-execは現行macOSで呼び出せる場合がありますが、Xcodeのman pageではDeprecatedです。Sandboxの概要と合わせると、現在動くことを長期的なサポート契約と解釈してはいけません。AnthropicのSandbox Runtime公開リポジトリも確認し、実装変更やVirtualizationへの移行可能性を定期的に評価します。
リスク別の分流
| 運用条件 | 設定ファイルの置き場所 | 追加する防御 | 判断 |
|---|---|---|---|
| 受け入れ確認をしながら個人で実行 | プロジェクト設定を利用 | denyWrite、実効値の確認、失敗時停止 | 既存環境を継続 |
| チームで共有するタスク | 業務設定はプロジェクト、核心規則はmanaged settings | 設定元の監査、例外の抑制 | managed settingsへ移行 |
| 無人または長時間のAgent実行 | Agentが直接変更できない管理領域 | 全プロセスのSBPL、失敗時停止 | 独立Mac環境を優先 |
| 隔離失敗時の復旧が重要 | 再作成できる専用環境 | 実行環境の分離、ログと復元手順 | 本番環境から切り離す |
独立Mac環境を選ぶ場合は、単に別の端末を借りるだけでは不十分です。策略ファイルの配置、配布経路、環境を再作成できるか、物理的または論理的に他の開発作業と分離されているかを確認します。長期運用の候補を比較する際は、ProxyMacのヘルプで運用方法を確認し、実行環境をコンソールから管理できるかを先に整理してください。
FAQ
設定の保護は、単一のJSONファイルにdeny規則を書く作業では終わりません。Agentが変更できる範囲、実際に合成された権限、Sandbox失敗時の挙動、実行環境の独占性を順番に確認します。
Claude Codeは自分のsettings.jsonを変更できますか?
プロジェクトディレクトリのsettings.jsonがClaude Codeの書き込み対象に含まれていれば、EditやWrite、Bash経由の処理で変更される可能性があります。設定の優先順位が高いことは、ファイル自体が保護されることを意味しません。重要な拒否規則はmanaged settingsや外部のSBPLでAgentの書き込み範囲から分離してください。
.claudeディレクトリへの書き込みを禁止するにはどうしますか?
まずClaude CodeのdenyWriteで.claudeを対象にし、実際の適用元を/status、/permissions、/doctorで確認します。ただしプロジェクト設定だけでは、設定を変更できる主体と守る設定が同じ境界に残ります。無人実行では、保護対象をmanaged settingsへ移し、必要に応じてSBPLでディレクトリへの書き込みをプロセス全体から拒否します。
managed settingsとプロジェクト設定はどちらが安全ですか?
チーム全体の拒否規則や失敗時停止を守る目的では、managed settingsの方が適しています。公式設定ではmanaged settingsが高い優先順位を持ち、プロジェクト側から簡単に置き換えられない運用を作れます。一方、業務固有の許可や実験的な設定はプロジェクト側に残し、両者の実効値を診断コマンドで確認する必要があります。
SBPLでClaude Code全体の書き込みを制限できますか?
手書きのSBPLをsandbox-execで適用すれば、Claude Code本体と子プロセスを含むプロセス境界に書き込み規則を追加できます。ただしsandbox-execはAppleのman pageでDeprecatedとされており、現在呼び出せることと長期サポートが保証されることは別です。検証用の一時ディレクトリで確認し、継続運用ではVirtualizationなどの代替も比較してください。
プロジェクト設定だけに依存すると、設定を変更できるAgentと、変更を拒否するルールが同じ場所に残ります。managed settingsは配布と監査に強い一方、実行プロセスそのものの書き込みを止める仕組みではありません。SBPLは全プロセスの境界を補えますが、sandbox-execのDeprecatedという制約があります。
この3点を同時に満たせない環境でClaude Codeを長期または無人運用するなら、共有ワークステーションより、復旧手順を組み込んだ独立Mac環境の方が安全性を説明しやすくなります。現在の環境をそのまま使う場合でも、設定ファイルの所在、無人実行の有無、許可する書き込み先を先に棚卸ししてから、ProxyMacのMacレンタル環境で隔離構成を検証するのが現実的です。