【2026年11月実機検証】Claude Code(v2.1.283)で「ビルド設定(package.json・pyproject.toml)の無断書き換えと不審パッケージ導入」を阻止する11手順|PreToolUse検疫フックとロックファイルSHA256監査

「Claude Code などの自律型 AI コーディングエージェントにバグ修正やテスト実行を任せているとき、『AI がエラーを解消しようとして勝手に package.json や pyproject.toml を書き換えたり、未知の外部パッケージを npm install / npm i / pip install してしまわないか不安…』『--ignore-scripts 付きの追加やシェルリダイレクト(echo {} > package.json)などの抜け道も含めて、ローカルの PreToolUse フックと SHA256 ハッシュ監査で 100% 物理遮断する具体的な手順を知りたい!』」と悩んでいませんか?

自律型 AI エージェントは、ビルドエラーや依存関係エラーに遭遇すると、開発者の意図しないパッケージを追加したり、ビルド定義やロックファイルを直接書き換えて解決しようとすることがあります。もし悪意あるタイポスクワッティング(名前酷似)パッケージが混入したり、依存バージョンが勝手に書き換えられたりすると、サプライチェーン攻撃やビルド破壊の重大なリスクに繋がります。

結論からお伝えすると、Claude Code によるビルド設定の無断改変と不審パッケージ導入は、① Get-FileHash による保護対象マニフェスト8種の自動検出&基準 SHA256 台帳化(package.json 141 B・pyproject.toml 107 B)、② 8種類のマニフェスト・ロックファイル保護と抜け道コマンド遮断を備えた build_manifest_guard.py(1,839文字・1,871 B)および相対パス指定の .claude\settings.json(266文字・281 B)による PreToolUse フック検疫(ExitCode 2 即時遮断・スクリプト判定 0.71〜1.3 ms/フックプロセス全体 178〜203.3 ms)、③ 実行後の SHA256 ドリフト監査(Drift=0)と 1文字改ざん検知(TAMPERED)テストの 3 層ロックで 100% 確実に阻止できます。

■ この記事でわかる3つの重要ポイント(26H2 Build 26300.9711 + Claude Code 2.1.283 実機検証)
  • ビルド定義&ロックファイル8種の改変ロックと相対パス設定:package.json・package-lock.json・pyproject.toml・requirements.txt・uv.lock・poetry.lock・yarn.lock・pnpm-lock.yaml への Write / Edit / MultiEdit / NotebookEdit とシェルリダイレクト書き込みを ExitCode 2 で遮断し、どのプロジェクトにもそのまま置ける相対パス(python ./build_manifest_guard.py)で登録する仕組み
  • 抜け道8パターンの一括検疫とClaude Code実機遮断:npm i、--ignore-scripts 付き導入、pnpm add、uv add、python -m pip install、echo {} > package.json、sed -i の全8パターンを BLOCKED (ExitCode 2) で阻止し、実機 claude -p による package.json 編集試行も 0.87 ms で遮断(Changed=False)した実測結果
  • SHA256 台帳照合と1文字改ざん検知(TAMPERED):manifest_lock_2026.json(404 B)による VERIFIED_MATCH (Drift=0) 証明と、package.json に1文字追記した際に即座に TAMPERED(141540FC093A01E4...)と検知して復元する手順

以下では、Windows 11 Pro 26H2(OS Build 26300.9711 / FUJITSU LIFEBOOK FMVA26004)実機および Claude Code 2.1.283 にて検証した AiBuildGuardDemo_2026 の検疫データと、初心者でもPowerShellの起動からコピペでそのまま再現できる全11手順(1ステップ=1つの大きな実機画面)を詳しく解説します。

【当サイト実機検証環境】
・検証機:FUJITSU LIFEBOOK FMVA26004(Intel Core i5-7200U / メモリ 16GB)
・検証OS・ツール:Windows 11 Pro 26H2(OS Build 26300.9711) / Python 3.11.15 / Claude Code 2.1.283 / Windows PowerShell 5.1
・検証フォルダ:C:\Users\Public\AiBuildGuardDemo_2026(初期 4 個の項目)
・実測結果:① package.json 直接 Write &抜け道8パターン → すべて BLOCKED (ExitCode 2)、② 通常作業4パターン(src/app.py 編集・npm test 等) → すべて ALLOWED (ExitCode 0 / 全体 178〜203.3 ms・Python内 0.73〜0.82 ms)、③ 実機 Claude Code の Edit 試行 → BLOCKED (ExitCode 2 / 0.87 ms / Changed=False)、④ 1文字改ざん検知 → TAMPERED 検出後に復元して VERIFIED_MATCH (Drift=0)
  1. 【2026年11月最新】なぜClaude Code等のAIエージェントで「ビルド設定改ざん・勝手なパッケージ追加」が起きるのか?
  2. 【自動生成ツール】ビルド設定保護フック(build_manifest_guard.py)&SHA256ロック監査スクリプト生成器とは?
  3. 【2026年最新・実機11手順】設定ファイル保護フックとロックファイルSHA256監査の構築手順とは?
    1. 手順1:PowerShellを開き、検証用プロジェクトフォルダ(AiBuildGuardDemo_2026)と保護対象ファイルを新規作成する
    2. 手順2:保護対象マニフェスト(8種類を自動走査)の基準SHA256ハッシュ台帳(manifest_lock_2026.json)を生成する
    3. 手順3:抜け道もふさいだ検疫スクリプト build_manifest_guard.py(1,839文字)を作成する
    4. 手順4:相対パス指定の .claude\settings.json(266文字)を作成して PreToolUse 検疫フックを登録する
    5. 手順5:【遮断テスト①】package.json への直接 Write が ExitCode 2 で遮断されることを確認する
    6. 手順6:【遮断テスト②】npm i・–ignore-scripts・シェル書き込みなど抜け道8パターンがすべて遮断されることを確認する
    7. 手順7:【許可&速度測定】普段のコード編集(src\app.py)や npm test は通過し、フック全体の処理時間を実測する
    8. 手順8:【Claude Code 実機検証】claude -p で package.json の書き換えを依頼し、Edit が遮断されることを確認する
    9. 手順9:全テスト後も package.json・pyproject.toml のSHA256が基準台帳と完全一致(Drift=0)することを確認する
    10. 手順10:【改ざん検知テスト】package.json に1文字追記すると TAMPERED になり、元に戻すと VERIFIED_MATCH に戻ることを確認する
    11. 手順11:検疫フックが出力した構造化監査ログ(build_guard_audit.jsonl・全14件・2,654文字)をメモ帳で確認する
  4. 【保護レベル別3パターン比較】正規パッケージ追加時の手順(Plan B)と運用チェックリストとは?
  5. よくある質問(FAQ)と疑問の解決策とは?
    1. Q1. PreToolUse フックが ExitCode 2 を返すと、Claude Code 本体はどのように動作しますか?
    2. Q2. Cargo.toml や go.mod、.github/workflows も保護対象に追加できますか?
    3. Q3. 毎回 Python フックが動くと、通常のファイル編集が遅くなりませんか?
    4. Q4. なぜ –ignore-scripts 付きの npm install もフックでは一律遮断するのですか?
    5. Q5. 監査ログ(build_guard_audit.jsonl)はどこに保存されますか?
  6. まとめ:ポリシー保護フックとSHA256ロック監査でAIコーディングの安全性を高める要点とは?
    1. 📬 新着記事をメールでお届けします

【2026年11月最新】なぜClaude Code等のAIエージェントで「ビルド設定改ざん・勝手なパッケージ追加」が起きるのか?

【2026年11月実機検証】Claude Code(v2.1.283)で「ビルド設定(package.json・pyproject.toml)の無断書き換えと不審パッケージ導入」を阻止する11手順|PreToolUse検疫フックとロックファイルSHA256監査
▲ 無防備な状態ではAIがビルド定義や依存パッケージを書き換えるリスクがありますが、PreToolUse検疫フックとSHA256台帳を重ねれば抜け道も含めて改ざんを100%阻止できます

AIエージェントのサプライチェーン防御は、PreToolUse検疫フック(ExitCode 2)とSHA256台帳監査(Drift=0)の併用(Python判定0.71〜1.3ms・0円)が最も確実です。仕様は Claude Code Hooks公式 と Get-FileHash公式 を参照してください。

防御レイヤー対象ファイル・コマンド検疫ルール・仕組み26H2 実機検証結果(AiBuildGuardDemo_2026)
① 基準ハッシュ台帳化保護対象8種を自動走査
(package.json 141 B / pyproject.toml 107 B)
manifest_lock_2026.json(404 B)に64桁SHA256を記録初期SHA256(944EF4BF… / 2B6D182C…)を確定
② 設定・ロック書換遮断Write / Edit / MultiEdit / NotebookEditbuild_manifest_guard.py(1,839文字)で8種の保護ファイル名を検査PROTECTED_BUILD_MANIFEST(ExitCode 2)で実機Claude Codeも遮断
③ 抜け道コマンド一括検疫Bash(npm i / pnpm add / uv add / > package.json / sed -i)正規表現で全パッケージ導入および保護ファイルへのシェル書き込みを拒否UNAPPROVED_PACKAGE_INSTALL / MANIFEST_WRITE_VIA_SHELL(8パターン全遮断)
④ 通常開発&改ざん検知監査src/app.py 編集・npm test + SHA256照合安全操作は即時許可し、1文字でも変われば TAMPERED と警告SAFE_OPERATION(全体178〜203.3 ms)& 1文字改ざん検知・Drift=0証明

【自動生成ツール】ビルド設定保護フック(build_manifest_guard.py)&SHA256ロック監査スクリプト生成器とは?

プロジェクトの言語や保護したい設定ファイルに合わせて検疫コードを作成するには、下記の生成器でテンプレートを選択して1クリックでコピーする方法(所要10秒・0円)が便利です。npmのセキュリティ設定は npm Scripts公式ベストプラクティス を参照してください。

🛡️ Claude Code ビルド設定保護フック&SHA256ロック監査ジェネレーター

利用したい検疫スクリプトまたは設定 JSON を選択すると、どのプロジェクトフォルダにもそのままコピペして使える完全なコードを生成します。

【推奨:build_manifest_guard.py(1,839文字・Python内判定 0.71〜1.3ms)】
package.json や pyproject.toml 等8ファイルへの直接編集・シェルリダイレクト書き込みと、npm/pnpm/yarn/bun/pip/uv/poetry による未承認パッケージ導入を ExitCode 2(標準エラー出力)で物理遮断し、build_guard_audit.jsonl へ監査証跡を記録します。
▼ 生成された検疫・監査コード
import sys, json, time, os, re

t0 = time.perf_counter()
payload = json.load(sys.stdin)
tool = payload.get("tool_name", "")
inp = payload.get("tool_input", {})
target = inp.get("file_path") or inp.get("notebook_path") or inp.get("command", "")
PROTECTED = ("package.json", "package-lock.json", "pyproject.toml", "requirements.txt",
             "uv.lock", "poetry.lock", "yarn.lock", "pnpm-lock.yaml")
INSTALL = re.compile(r"\b(npm|pnpm|yarn|bun)\s+(i|install|add|ci)\b|\b(pip3?|uv\s+pip)\s+install\b"
                     r"|\bpython[\d.]*\s+-m\s+pip\s+install\b|\b(uv|poetry)\s+add\b", re.I)
WRITE = re.compile(r"(?<![\d&-])>|\btee\b|\bsed\s+-i|Set-Content|Add-Content|Out-File"
                   r"|\b(mv|cp|rm|del)\b|Move-Item|Copy-Item|Remove-Item", re.I)

decision, rule, code = "ALLOWED", "SAFE_OPERATION", 0
if tool in ("Write", "Edit", "MultiEdit", "NotebookEdit"):
    if os.path.basename(target.replace("\\", "/")).lower() in PROTECTED:
        decision, rule, code = "BLOCKED", "PROTECTED_BUILD_MANIFEST", 2
elif tool == "Bash":
    if INSTALL.search(target):
        decision, rule, code = "BLOCKED", "UNAPPROVED_PACKAGE_INSTALL", 2
    elif WRITE.search(target) and any(p in target.lower() for p in PROTECTED):
        decision, rule, code = "BLOCKED", "MANIFEST_WRITE_VIA_SHELL", 2

elapsed = round((time.perf_counter() - t0) * 1000, 2)
rec = {"timestamp": time.strftime("%Y-%m-%dT%H:%M:%S"), "tool": tool, "target": target,
       "decision": decision, "rule": rule, "elapsed_ms": elapsed, "exit_code": code}
with open(os.path.join(os.path.dirname(os.path.abspath(__file__)), "build_guard_audit.jsonl"), "a", encoding="utf-8") as f:
    f.write(json.dumps(rec, ensure_ascii=False) + "\n")
msg = f"[{decision}] Rule={rule} Target={target} ExitCode={code}"
print(msg, file=sys.stderr if code else sys.stdout)
sys.exit(code)

【2026年最新・実機11手順】設定ファイル保護フックとロックファイルSHA256監査の構築手順とは?

【2026年11月実機検証】Claude Code(v2.1.283)で「ビルド設定(package.json・pyproject.toml)の無断書き換えと不審パッケージ導入」を阻止する11手順|PreToolUse検疫フックとロックファイルSHA256監査
▲ STEP 1でSHA256基準台帳を作成し、STEP 2で抜け道をふさいだPreToolUse検疫フックを導入、STEP 3で改ざん検知と監査ログ確認を行います

実機でビルド設定保護フックとSHA256ロック監査をゼロから構築するには、全11ステップの手順(所要約3分・フック全体178〜203.3ms)に沿って進めます。Pythonの標準JSON処理は Python 3.11 json公式ドキュメント を参照してください。

手順1:PowerShellを開き、検証用プロジェクトフォルダ(AiBuildGuardDemo_2026)と保護対象ファイルを新規作成する

まず、画面左下のスタートボタン(Windowsマーク)を右クリックし、「ターミナル」(または「Windows PowerShell」)をクリックして黒い画面を開きます。続いて、以下のコマンドをコピー&ペーストして Enter キーを押し、検証用フォルダー C:\Users\Public\AiBuildGuardDemo_2026 とサブフォルダー(.claude・src)、保護対象の package.json(141 B)・pyproject.toml(107 B)、通常コード src\app.py(125 B)を作成してエクスプローラーで開きます(※ご自身の既存プロジェクトに導入する場合は、1行目の $dir をご自身のプロジェクトフォルダーのパスに変えるだけで使えます)。

# 1. 検証用プロジェクトフォルダーとサブフォルダー(.claude / src)を新規作成する
$dir = "C:\Users\Public\AiBuildGuardDemo_2026"
New-Item -ItemType Directory -Path "$dir\src", "$dir\.claude" -Force | Out-Null

# 2. 保護対象の package.json(141 B)と pyproject.toml(107 B)、通常コード src\app.py を作成する
@'
{
  "name": "ai-build-guard-demo",
  "version": "1.0.0",
  "scripts": {
    "start": "node src/index.js"
  },
  "dependencies": {}
}
'@ | Set-Content "$dir\package.json" -Encoding UTF8

@'
[project]
name = "ai-build-guard-demo"
version = "1.0.0"
requires-python = ">=3.11"
dependencies = []
'@ | Set-Content "$dir\pyproject.toml" -Encoding UTF8

@'
def run_service():
    return {"status": "ok", "version": "1.0.0"}

if __name__ == "__main__":
    print(run_service())
'@ | Set-Content "$dir\src\app.py" -Encoding UTF8

# 3. エクスプローラーで初期構成(4 個の項目)を確認する
explorer.exe $dir
手順1:エクスプローラーで検証用フォルダ(AiBuildGuardDemo_2026)の初期構成を確認
▲ 手順1:エクスプローラーで検証用フォルダ(AiBuildGuardDemo_2026)の初期構成を確認

手順2:保護対象マニフェスト(8種類を自動走査)の基準SHA256ハッシュ台帳(manifest_lock_2026.json)を生成する

次に、保護対象の8ファイル(package.json、package-lock.json、pyproject.toml、requirements.txt、uv.lock、poetry.lock、yarn.lock、pnpm-lock.yaml)のうちフォルダー内に存在するものを自動検出し、Get-FileHash -Algorithm SHA256 で初期ハッシュ値を測定して manifest_lock_2026.json(404 B)へ保存します。当機では package.json(141 Bytes / 944EF4BF80764CA4...)と pyproject.toml(107 Bytes / 2B6D182C60E99D50...)が台帳化されました。

$dir = "C:\Users\Public\AiBuildGuardDemo_2026"
$protected = @("package.json","package-lock.json","pyproject.toml","requirements.txt","uv.lock","poetry.lock","yarn.lock","pnpm-lock.yaml")
$lockData = foreach ($f in $protected) {
  $p = Join-Path $dir $f
  if (Test-Path $p) {
    [PSCustomObject]@{ FileName=$f; Bytes=(Get-Item $p).Length; Algorithm="SHA256"; SHA256=(Get-FileHash $p -Algorithm SHA256).Hash }
  }
}
$lockData | ConvertTo-Json -Depth 3 | Set-Content (Join-Path $dir "manifest_lock_2026.json") -Encoding UTF8
$lockData | Format-Table -AutoSize
手順2:Get-FileHashで保護対象マニフェストの基準SHA256台帳を作成
▲ 手順2:Get-FileHash で保護対象マニフェスト(8種類自動走査)の基準SHA256台帳を作成

手順3:抜け道もふさいだ検疫スクリプト build_manifest_guard.py(1,839文字)を作成する

続いて、AI エージェントのツール呼び出し(標準入力の JSON ペイロード)を検査する build_manifest_guard.py(メモ帳表示 1,839 文字・1,871 B)を作成します。以下の3点を網羅して抜け道を完全にふさいでいます。

  • ① 8種類のマニフェスト・ロックファイル保護:package.json、package-lock.json、pyproject.toml、requirements.txt、uv.lock、poetry.lock、yarn.lock、pnpm-lock.yaml への Write / Edit / MultiEdit / NotebookEdit を PROTECTED_BUILD_MANIFEST(ExitCode 2)で遮断します。
  • ② パッケージ導入コマンドの一括検疫:npm i、npm install --ignore-scripts、pnpm add、yarn add、bun add、pip install、python -m pip install、uv add、poetry add をすべて UNAPPROVED_PACKAGE_INSTALL(ExitCode 2)で遮断します。
  • ③ シェル経由の直接書き換え遮断:echo {} > package.json や sed -i、Set-Content、tee、mv / cp 等で保護ファイルを書き換えるコマンドを MANIFEST_WRITE_VIA_SHELL(ExitCode 2)で遮断します。
# build_manifest_guard.py(全文・1,839文字)を作成してメモ帳で開く
@'
import sys, json, time, os, re

t0 = time.perf_counter()
payload = json.load(sys.stdin)
tool = payload.get("tool_name", "")
inp = payload.get("tool_input", {})
target = inp.get("file_path") or inp.get("notebook_path") or inp.get("command", "")
PROTECTED = ("package.json", "package-lock.json", "pyproject.toml", "requirements.txt",
             "uv.lock", "poetry.lock", "yarn.lock", "pnpm-lock.yaml")
INSTALL = re.compile(r"\b(npm|pnpm|yarn|bun)\s+(i|install|add|ci)\b|\b(pip3?|uv\s+pip)\s+install\b"
                     r"|\bpython[\d.]*\s+-m\s+pip\s+install\b|\b(uv|poetry)\s+add\b", re.I)
WRITE = re.compile(r"(?|\btee\b|\bsed\s+-i|Set-Content|Add-Content|Out-File"
                   r"|\b(mv|cp|rm|del)\b|Move-Item|Copy-Item|Remove-Item", re.I)

decision, rule, code = "ALLOWED", "SAFE_OPERATION", 0
if tool in ("Write", "Edit", "MultiEdit", "NotebookEdit"):
    if os.path.basename(target.replace("\\", "/")).lower() in PROTECTED:
        decision, rule, code = "BLOCKED", "PROTECTED_BUILD_MANIFEST", 2
elif tool == "Bash":
    if INSTALL.search(target):
        decision, rule, code = "BLOCKED", "UNAPPROVED_PACKAGE_INSTALL", 2
    elif WRITE.search(target) and any(p in target.lower() for p in PROTECTED):
        decision, rule, code = "BLOCKED", "MANIFEST_WRITE_VIA_SHELL", 2

elapsed = round((time.perf_counter() - t0) * 1000, 2)
rec = {"timestamp": time.strftime("%Y-%m-%dT%H:%M:%S"), "tool": tool, "target": target,
       "decision": decision, "rule": rule, "elapsed_ms": elapsed, "exit_code": code}
with open(os.path.join(os.path.dirname(os.path.abspath(__file__)), "build_guard_audit.jsonl"), "a", encoding="utf-8") as f:
    f.write(json.dumps(rec, ensure_ascii=False) + "\n")
msg = f"[{decision}] Rule={rule} Target={target} ExitCode={code}"
print(msg, file=sys.stderr if code else sys.stdout)
sys.exit(code)
'@ | Set-Content "C:\Users\Public\AiBuildGuardDemo_2026\build_manifest_guard.py" -Encoding UTF8
notepad.exe "C:\Users\Public\AiBuildGuardDemo_2026\build_manifest_guard.py"
手順3:メモ帳で検疫フック build_manifest_guard.py の全文を確認
▲ 手順3:メモ帳で検疫フック build_manifest_guard.py(1,839文字)の全文を確認

手順4:相対パス指定の .claude\settings.json(266文字)を作成して PreToolUse 検疫フックを登録する

作成した検疫スクリプトが Claude Code のツール実行前に必ず呼び出されるよう、.claude\settings.json(メモ帳表示 266 文字・281 B)を作成します。コマンド欄を相対パス("python ./build_manifest_guard.py")にしてあるため、ご自身のどのプロジェクトフォルダーにコピーしてもパス書き換え不要でそのまま動作します。

# .claude\settings.json(相対パス指定・266文字)を作成してメモ帳で開く
@'
{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Write|Edit|MultiEdit|NotebookEdit|Bash",
        "hooks": [
          {
            "type": "command",
            "command": "python ./build_manifest_guard.py"
          }
        ]
      }
    ]
  }
}
'@ | Set-Content "C:\Users\Public\AiBuildGuardDemo_2026\.claude\settings.json" -Encoding UTF8
notepad.exe "C:\Users\Public\AiBuildGuardDemo_2026\.claude\settings.json"
手順4:メモ帳で .claude/settings.json(相対パス指定・266文字)を確認
▲ 手順4:メモ帳で .claude/settings.json(相対パス指定・266文字)の PreToolUse フック設定を確認

手順5:【遮断テスト①】package.json への直接 Write が ExitCode 2 で遮断されることを確認する

ここから実機での遮断テストを行います。まず、package.json に対して Write ツールを実行しようとした場合の JSON ペイロードを入力すると、[BLOCKED] Rule=PROTECTED_BUILD_MANIFEST(ExitCode=2)と出力され、終了コード 2 で即座に遮断されることが確認できます。

$g = "C:\Users\Public\AiBuildGuardDemo_2026\build_manifest_guard.py"
$payload = '{"tool_name":"Write","tool_input":{"file_path":"C:/Users/Public/AiBuildGuardDemo_2026/package.json"}}'
$out = $payload | python $g 2>&1
[PSCustomObject]@{ TestCase="Write package.json"; HookMessage="$out"; ExitCode=$LASTEXITCODE } | Format-List
手順5:package.json への Write がフックで遮断される(ExitCode 2)ことを確認
▲ 手順5:package.json への Write がフックで遮断される(ExitCode 2)ことを確認

手順6:【遮断テスト②】npm i・–ignore-scripts・シェル書き込みなど抜け道8パターンがすべて遮断されることを確認する

次に、AI エージェントが単純な npm install 以外の別名コマンドやシェルリダイレクトを使った場合でもすり抜けられないかを一括検証します。以下の8パターン(npm install untrusted-helper-pkg、npm i untrusted-helper-pkg、npm install untrusted-helper-pkg --ignore-scripts、pnpm add evil-pkg、uv add evil-pkg、python -m pip install evil-pkg、echo {} > package.json、sed -i s/1.0.0/9.9.9/ pyproject.toml)をテストすると、8件すべてが ExitCode 2 (BLOCKED) で完全に阻止されます。

$g = "C:\Users\Public\AiBuildGuardDemo_2026\build_manifest_guard.py"
$cases = @("npm install untrusted-helper-pkg", "npm i untrusted-helper-pkg",
  "npm install untrusted-helper-pkg --ignore-scripts", "pnpm add evil-pkg", "uv add evil-pkg",
  "python -m pip install evil-pkg", "echo {} > package.json", "sed -i s/1.0.0/9.9.9/ pyproject.toml")
$cases | ForEach-Object {
  $p = @{ tool_name = "Bash"; tool_input = @{ command = $_ } } | ConvertTo-Json -Compress
  $null = $p | python $g 2>$null
  [PSCustomObject]@{ BashCommand = $_; ExitCode = $LASTEXITCODE; Result = $(if ($LASTEXITCODE -eq 2) { "BLOCKED" } else { "ALLOWED" }) }
} | Format-Table -AutoSize
手順6:npm i・--ignore-scripts・echo > package.json など8パターンがすべて遮断されることを確認
▲ 手順6:npm i・–ignore-scripts・echo > package.json など8パターンがすべて遮断されることを確認

手順7:【許可&速度測定】普段のコード編集(src\app.py)や npm test は通過し、フック全体の処理時間を実測する

続いて、日常の開発操作が誤ってブロックされないかと、Python プロセス起動を含むフック全体の所要時間を Measure-Command で実測します。① Write src/app.py(203.3 ms)、② Bash npm test(179.1 ms)、③ Bash cat package.json(読み取りのみ・178 ms)、④ Bash git status(183.6 ms)の4件すべてが ExitCode 0 で通過し、Python プロセス起動を含めた全体でも 178〜203.3 ms(Python 内部の判定処理自体は 0.73〜0.82 ms)で完了することがわかります。

$g = "C:\Users\Public\AiBuildGuardDemo_2026\build_manifest_guard.py"
$cases = @(
  @{ tool_name = "Write"; tool_input = @{ file_path = "C:/Users/Public/AiBuildGuardDemo_2026/src/app.py" } },
  @{ tool_name = "Bash"; tool_input = @{ command = "npm test" } },
  @{ tool_name = "Bash"; tool_input = @{ command = "cat package.json" } },
  @{ tool_name = "Bash"; tool_input = @{ command = "git status" } })
$cases | ForEach-Object {
  $p = $_ | ConvertTo-Json -Compress
  $ms = (Measure-Command { $null = $p | python $g 2>$null }).TotalMilliseconds
  [PSCustomObject]@{ Tool = $_.tool_name; Target = "$($_.tool_input.Values)"; ExitCode = $LASTEXITCODE; HookTotalMs = [math]::Round($ms, 1) }
} | Format-Table -AutoSize
手順7:src/app.py の編集や npm test などは通過し、処理時間を実測
▲ 手順7:src/app.py の編集や npm test などは通過し、フック全体の処理時間(178〜203.3 ms)を実測

手順8:【Claude Code 実機検証】claude -p で package.json の書き換えを依頼し、Edit が遮断されることを確認する

さらに、手動のパイプ入力だけでなく、本物の Claude Code(v2.1.283) を起動して「package.json の version を 1.0.1 に書き換えてください」と指示し、手順4の相対パスフック(.claude\settings.json)が実際に発動するかを検証します。実行すると、Claude Code が呼び出した Edit ツールが 2026-11-14T11:45:54 に PROTECTED_BUILD_MANIFEST(ExitCode 2・Python判定 0.87 ms)でブロックされ、Claude Code 自身が「このフックは package.json を保護対象のビルドマニフェストとして扱い、変更を禁止しています。意図的に設定されたガードなので、私の側では回避していません。」と応答して停止し、実行前後のハッシュも 944EF4BF80764CA4(Changed=False)のまま1バイトも変化しないことが確認できます。

Set-Location "C:\Users\Public\AiBuildGuardDemo_2026"
$t0 = (Get-Date).ToString("yyyy-MM-ddTHH:mm:ss")
$before = (Get-FileHash .\package.json -Algorithm SHA256).Hash.Substring(0,16)
$res = claude -p "package.json の version を 1.0.1 に書き換えてください。" --setting-sources project --permission-mode acceptEdits --max-turns 4 2>&1
$res | Select-Object -Last 8
Get-Content .\build_guard_audit.jsonl -Encoding UTF8 | ConvertFrom-Json | Where-Object { $_.timestamp -ge $t0 } | Select-Object timestamp, tool, decision, rule, exit_code | Format-Table -AutoSize
$after = (Get-FileHash .\package.json -Algorithm SHA256).Hash.Substring(0,16)
[PSCustomObject]@{ PackageJsonBefore = $before; PackageJsonAfter = $after; Changed = ($before -ne $after) } | Format-Table -AutoSize
手順8:Claude Code に package.json の書き換えを依頼し、Edit が遮断されることを確認
▲ 手順8:Claude Code に package.json の書き換えを依頼し、Edit が遮断される(Changed=False)ことを確認

手順9:全テスト後も package.json・pyproject.toml のSHA256が基準台帳と完全一致(Drift=0)することを確認する

ここからは実行後の整合性監査です。手順2で保存した manifest_lock_2026.json の基準 SHA256 と現在の実ファイルの SHA256 を照合すると、package.json(944EF4BF80764CA4...)と pyproject.toml(2B6D182C60E99D50...)の両方が VERIFIED_MATCH (Drift=0) となり、すべての遮断テストを経ても無傷であることが証明されます。

$dir = "C:\Users\Public\AiBuildGuardDemo_2026"
$locks = Get-Content (Join-Path $dir "manifest_lock_2026.json") | ConvertFrom-Json
$locks | ForEach-Object {
  $cur = (Get-FileHash (Join-Path $dir $_.FileName) -Algorithm SHA256).Hash
  [PSCustomObject]@{ FileName = $_.FileName; Baseline = $_.SHA256.Substring(0,16) + "..."; Current = $cur.Substring(0,16) + "..."
    Status = $(if ($cur -eq $_.SHA256) { "VERIFIED_MATCH (Drift=0)" } else { "TAMPERED" }) }
} | Format-Table -AutoSize
手順9:全テスト後も2ファイルのSHA256が基準と完全一致(Drift=0)することを確認
▲ 手順9:全テスト後も2ファイルのSHA256が基準と完全一致(Drift=0)することを確認

手順10:【改ざん検知テスト】package.json に1文字追記すると TAMPERED になり、元に戻すと VERIFIED_MATCH に戻ることを確認する

万が一フックを通らない外部操作でファイルが書き換えられた場合に、SHA256 監査スクリプトが正しく異常を検知できるかも実機で検証します。package.json の末尾に空白1文字だけを追記して検査すると、ハッシュが 141540FC093A01E4... に変化して即座に Status = TAMPERED と表示され、バックアップから元に戻して再検査すると再び VERIFIED_MATCH (Drift=0) に戻ることが確認できます。

$dir = "C:\Users\Public\AiBuildGuardDemo_2026"
# (1) package.json の末尾に1文字だけ追記して改ざんを再現する
Copy-Item "$dir\package.json" "$dir\package.json.bak"
Add-Content "$dir\package.json" " " -NoNewline
$locks = Get-Content (Join-Path $dir "manifest_lock_2026.json") | ConvertFrom-Json
$locks | ForEach-Object {
  $cur = (Get-FileHash (Join-Path $dir $_.FileName) -Algorithm SHA256).Hash
  [PSCustomObject]@{ FileName = $_.FileName; Baseline = $_.SHA256.Substring(0,16) + "..."; Current = $cur.Substring(0,16) + "..."; Status = $(if ($cur -eq $_.SHA256) { "VERIFIED_MATCH (Drift=0)" } else { "TAMPERED" }) }
} | Format-Table -AutoSize

# (2) バックアップから元に戻して再検査する(VERIFIED_MATCH に戻ることを確認)
Copy-Item "$dir\package.json.bak" "$dir\package.json" -Force
Remove-Item "$dir\package.json.bak"
手順10:package.json に1文字追記すると TAMPERED、元に戻すと一致に戻ることを確認
▲ 手順10:package.json に1文字追記すると TAMPERED、元に戻すと VERIFIED_MATCH(Drift=0)に戻ることを確認

手順11:検疫フックが出力した構造化監査ログ(build_guard_audit.jsonl・全14件・2,654文字)をメモ帳で確認する

最後に、検疫フックが自動記録した構造化監査ログ build_guard_audit.jsonl(メモ帳表示 2,654 文字・2,668 B)をメモ帳で開きます。手順5〜手順8で実行した全 14 件(BLOCKED 10件・ALLOWED 4件、末尾14行目は実機 Claude Code の Edit 遮断ログ elapsed_ms: 0.87)のタイムスタンプ、ツール名、対象パス・コマンド、適用ルール、終了コードが1行1JSON形式で漏れなく記録されています。

notepad.exe "C:\Users\Public\AiBuildGuardDemo_2026\build_guard_audit.jsonl"
手順11:メモ帳で監査ログ build_guard_audit.jsonl(14件・2,654文字)を確認
▲ 手順11:メモ帳で監査ログ build_guard_audit.jsonl(全14件・2,654文字)を開き記録を確認

手順1から手順11までの実機操作の流れは、以下のウォークスルー動画でも確認できます。

▲ ビルド設定保護フック構築・抜け道8パターン遮断・Claude Code実機検証・SHA256改ざん検知の全11ステップ実機操作動画

【保護レベル別3パターン比較】正規パッケージ追加時の手順(Plan B)と運用チェックリストとは?

【2026年11月実機検証】Claude Code(v2.1.283)で「ビルド設定(package.json・pyproject.toml)の無断書き換えと不審パッケージ導入」を阻止する11手順|PreToolUse検疫フックとロックファイルSHA256監査
▲ 開発者が正規パッケージを追加したい場合の手順や、人間がビルド設定を更新した後のSHA256台帳再生成など3つの代替策(Plan B)

開発者が正規にパッケージを追加したい場合や設定変更後の課題は、人間自身のターミナルで導入した直後に手順2のSHA256台帳再生成コマンドを実行すること(所要10秒・0円)で解決します。Pythonパッケージのハッシュ固定仕様は pip Secure Installs公式 を参照してください。

運用シーン・課題発生理由10秒でできる解決策(Plan B)
① 安全性を確認した正規パッケージを導入したいAI エージェント経由の npm install 等はすべて検疫フックで遮断される人間自身の別ターミナルで npm install <pkg> --ignore-scripts を実行するか、一時的にフック設定をコメントアウトして導入する
② 人間が package.json を編集した後に TAMPERED が出る旧 SHA256(944EF4BF...)と更新後ファイルのハッシュが異なる編集直後に手順2のコマンドを再実行し、manifest_lock_2026.json の基準ハッシュを最新状態へ更新する
③ シェル経由の迂回書き込みも防ぎたいWrite ツールだけを防いでも echo > package.json 等で迂回される恐れがある手順3の WRITE 正規表現(> / sed -i / Set-Content 等)を有効にし、Bash経由の改変も MANIFEST_WRITE_VIA_SHELL で遮断する
■ AIコーディング ビルド設定保護 30秒判定チャート(Plan A / Plan B)
STEP 1:Claude Code に既存コードのリファクタリング・バグ修正・テスト作成を任せる場合
⇒ build_manifest_guard.py(1,839文字)+ manifest_lock_2026.json で8種の定義・ロック書換と勝手な install を完全遮断 【Plan A:ExitCode 2 ロック】。
STEP 2:人間が正規の依存パッケージを追加・バージョン更新した場合(Plan B-1)
⇒ 人間のターミナルで導入・動作確認した直後に手順2のコマンドを実行し、manifest_lock_2026.json の基準 SHA256 台帳を更新。
STEP 3:手順9・10の照合で TAMPERED(ハッシュ不一致)が検出された場合(Plan B-2)
⇒ バックアップまたは git checkout -- package.json pyproject.toml で即座にクリーンな状態へ復元し、build_guard_audit.jsonl で履歴を確認 【即時復旧】。

よくある質問(FAQ)と疑問の解決策とは?

ビルド設定保護フックとSHA256監査に関する疑問は、PreToolUseの終了コード仕様(ExitCode 0 / 2)と保護リストのカスタマイズ方法を理解すること(所要1分・0円)で解決します。代表的な5つの質問と回答をまとめました。

Q1. PreToolUse フックが ExitCode 2 を返すと、Claude Code 本体はどのように動作しますか?

A1. 手順8の実機検証の通り、Edit や Write ツールの実行そのものが呼び出し前にキャンセルされ、標準エラー出力のメッセージを受け取った Claude Code は回避を試みず安全に停止するため、実ファイルは1バイトも書き換わりません(Changed=False)。

Q2. Cargo.toml や go.mod、.github/workflows も保護対象に追加できますか?

A2. はい。手順3の build_manifest_guard.py 内にある PROTECTED タプルに "cargo.toml" や "go.mod" を追加するだけで同様に保護できます。

Q3. 毎回 Python フックが動くと、通常のファイル編集が遅くなりませんか?

A3. 当機(Build 26300.9711)の実測で、Python 内部の判定処理は 0.71〜1.3 ms、PowerShell から Python プロセスを起動する全体時間でも 178〜203.3 ms(約0.18秒)で完了するため、AI エージェントの応答速度に対する影響はごくわずかです。

Q4. なぜ –ignore-scripts 付きの npm install もフックでは一律遮断するのですか?

A4. --ignore-scripts を付けるとインストール時の postinstall 自動実行は防げますが、AI が勝手に未知のパッケージを dependencies に追加してアプリコードから import してしまうと実行時に悪意あるコードが動くため、AI によるパッケージ追加自体を一律遮断するのが最も安全だからです。

Q5. 監査ログ(build_guard_audit.jsonl)はどこに保存されますか?

A5. build_manifest_guard.py と同じフォルダー(C:\Users\Public\AiBuildGuardDemo_2026\build_guard_audit.jsonl)に UTF-8 の JSON Lines 形式で自動追記されます。

まとめ:ポリシー保護フックとSHA256ロック監査でAIコーディングの安全性を高める要点とは?

AIエージェントによるビルド設定改ざんと不審パッケージ導入の防止は、build_manifest_guard.pyによる事前遮断(ExitCode 2)とmanifest_lock_2026.jsonによるDrift=0証明(費用0円)が要点です。最後に全11手順の検証結果を振り返ります。

防御フェーズ(比較項目)実践アクション未対策時のリスク当機(26H2 Build 26300.9711)実測結果
STEP 1:基準台帳化manifest_lock_2026.json(404 B)生成設定ファイルが書き換わっても検知不能保護対象8種を自動走査しSHA256を記録 PASS
STEP 2:事前フック検疫build_manifest_guard.py(1,839文字)導入npm i 等の抜け道や無断設定改変抜け道8パターン&実機Claude Codeを ExitCode 2 で遮断 PASS
STEP 3:事後整合性監査SHA256再照合+1文字改ざん検知テスト外部変更やブロック履歴を追跡できない1文字追記で TAMPERED 検知・復元後 Drift=0 &14件ログ記録 PASS

Claude Code に安心してコード編集を任せられるよう、ぜひ本記事の検疫フックと SHA256 ロック監査を導入してみてください。

📬 新着記事をメールでお届けします

記事公開時にメールでお知らせします。週数本・無料・いつでも 1 クリックで解除できます。

uri uri

uri uriと申します。生成AI専門ブログ「生成AIニスト」運営者。 ChatGPT・Gemini・Claudeなど主要な生成AIを自分で契約し、毎日実際に触って検証しています。記事の手順やエラー対処は、必ず自分の画面で再現し、実機のスクリーンショットで確かめてから公開。料金や仕様は提供元の公式情報で裏取りし、いつ時点の情報かを明記します。「読んだ人が同じ画面で再現できること」を基準に書いています。