Claude Code で「このフォルダだけは絶対に書き換えさせたくない」とき、CLAUDE.md に書くだけでは「お願い」にしかなりません。公式ドキュメント(memory のページ)も、確実に止めたいことは PreToolUse フックで止めるように書いています。
Windows(PowerShell 5.1)で data フォルダを守るフックを書いたところ、英字だけのパスでは止まるのに、日本語を含むパスでは素通りしていました。原因と、直した版を置いておきます。
結論(直した版)
.claude/hooks/mamoru.ps1(UTF-8 BOM 付きで保存)
[Console]::InputEncoding = [System.Text.Encoding]::UTF8
[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
try {
$in = [Console]::In.ReadToEnd() | ConvertFrom-Json
$path = [System.IO.Path]::GetFullPath([string]$in.tool_input.file_path)
$root = [string]$env:CLAUDE_PROJECT_DIR
if (-not $root) { throw "no project dir" }
if ($root -notmatch '^[A-Za-z]:[\\/]') { throw "unexpected project dir" }
$data = [System.IO.Path]::GetFullPath([System.IO.Path]::Combine($root, "data")).TrimEnd("\") + "\"
} catch {
[Console]::Error.WriteLine("フックが判断できませんでした。安全のため止めます。")
exit 2
}
if ($path.StartsWith($data, [System.StringComparison]::OrdinalIgnoreCase)) {
[Console]::Error.WriteLine("data フォルダは読むだけです: $path")
exit 2
}
exit 0
.claude/settings.json
{
"hooks": {
"PreToolUse": [
{
"matcher": "Edit|Write",
"hooks": [
{
"type": "command",
"command": "powershell.exe",
"args": ["-NoProfile", "-ExecutionPolicy", "Bypass", "-File",
"${CLAUDE_PROJECT_DIR}/.claude/hooks/mamoru.ps1"],
"onFailure": "block"
}
]
}
]
}
}
PreToolUse のフックが終了コード 2 で終わると、その道具の実行は止まり、標準エラーに書いた文が Claude に渡ります(公式 hooks-guide / hooks)。command と args を分ける書き方は、公式の Windows(PowerShell)の例と同じ形です。
落とし穴1:日本語のパスで JSON が読めず、exit 0 で素通り
最初の版には InputEncoding の行も try〜catch もありませんでした。
| 渡した file_path | 最初の版 | 直した版 |
|---|---|---|
C:\work\data\uriage.csv |
2(止める) | 2 |
C:\work\claude_練習\data\uriage.csv |
0(素通り) | 2 |
標準入力の JSON が化けて ConvertFrom-Json が失敗し、そのまま最後の exit 0 に落ちていました。「読めなかったら止める」側に倒すのが要点です(catch で exit 2)。
落とし穴2:BOM なしで保存するとスクリプト自体が動かない
PowerShell 5.1 は、BOM なしの UTF-8 を既定で UTF-8 として読みません。BOM なしで保存した同じスクリプトは、中の日本語が化けて動きませんでした。BOM 付きで保存し直すと、止めた理由の文も正しい日本語で出ました。Claude に作らせるときは「UTF-8 の BOM 付きで保存して、先頭に BOM があるか確かめて」まで頼むと確実です。
落とし穴3:onFailure を書かないと、スクリプトの失敗で素通り
公式 hooks のページによると、たいていのイベントでは、フックのスクリプトが見つからない・途中で落ちた・時間切れ、といった失敗のときは止めずに続行します。スクリプトのパスを1文字間違えただけで、守っているつもりのフォルダが全部素通りになります。"onFailure": "block"(2.1.295 以降)を付けると、失敗のときも止まります。守るためのフックには必ず付けておくのが安全です。
落とし穴4:「パスに data があれば止める」と書くと、別の場所で全部止まる
$path -match '\\data\\' のような書き方だと、作業フォルダ自体が D:\Data\... の下にあるとき、すべての書き換えが止まります。上の版は CLAUDE_PROJECT_DIR を基準に <作業フォルダ>\data\ と比べ、末尾に \ を付けているので、datasheet のような別フォルダも止めません。GetFullPath で out\..\data\x.csv のような回り道も正規化しています。
CLAUDE_PROJECT_DIR が /c/work のような Git Bash 形式で渡ってきた場合、最初は data の書き換えを止めませんでした。そのため、ドライブ文字で始まらない形のときは止める(-notmatch の行)ようにしています。
確かめ方(実際のファイルは触らない)
CLAUDE_PROJECT_DIR を入れてから、書き換えのときと同じ形の JSON を渡して、終了コードと出た文を見ます。JSON はパイプで渡さず、BOM 付き UTF-8 のファイルにしてから渡します。
# 作業フォルダ(日本語を含む)で実行
$env:CLAUDE_PROJECT_DIR = (Get-Location).Path
$j = '{"tool_input":{"file_path":"' + ((Join-Path $env:CLAUDE_PROJECT_DIR 'data\uriage.csv') -replace '\\','\\') + '"}}'
[System.IO.File]::WriteAllText("$PWD\in.json", $j, (New-Object System.Text.UTF8Encoding $true))
cmd /c "powershell -NoProfile -ExecutionPolicy Bypass -File .\.claude\hooks\mamoru.ps1 < in.json"
$LASTEXITCODE # 「data フォルダは読むだけです」と出て 2 なら正しく止まっている
data\uriage.csv を out\a.csv に変えて、何も出ずに 0 になることも必ず確かめます。
落とし穴5:確かめ方そのものが化ける
最初は '{...}' | powershell -File mamoru.ps1 とパイプで渡していました。ところが、何も設定していない PowerShell 5.1 では、外部プログラムへのパイプの文字コード($OutputEncoding)が us-ascii です。日本語のパスが途中で化けて、フックは「判断できませんでした」で 2 を返しました。終了コードは 2 なので止まっているように見えますが、理由が違います(data の外を渡しても 2 になる)。終了コードだけでなく、出た文まで見てください。
筆者の環境(Windows 11・PowerShell 5.1・Claude Code 2.1.317)で確かめた結果:
- data の中(日本語フォルダ名・
DATAと大文字でも)→ 2 -
outの中 → 0 - 作業フォルダより上に
Dataフォルダがあってもout→ 0 -
datasheetの中 → 0 - 読めない入力・CLAUDE_PROJECT_DIR なし・
/c/work形式 → 2 - この settings.json を置いて
claude doctor→ 設定の誤りなし
※ターミナル版はログインしていないため、Claude が実際に書き換えようとして止まるところまでは試していません。置いたら「data\uriage.csv の1行目を書き換えて」と頼んで止まるか、スクリプト名を一時的に変えて onFailure で止まるかを、自分で確かめてください。
限界:見張っているのは Edit と Write だけ
このフックは、Bash や PowerShell の道具でのファイル書き換えは止めません。また、worktree で作業させると CLAUDE_PROJECT_DIR は元のフォルダを指したままなので、コピー側の data は守られません。本当に守りたい原本は、作業フォルダに置かずコピーで作業させるのがいちばん確実です。
Claude Code を、エンジニアでない人が仕事で安全に使うための設定(権限モード、CLAUDE.md、スキル、フック、記憶)を、公式ドキュメントと照らし合わせて1冊にまとめました。
『Claude Code 使い方と安全な任せ方』(Kindle):https://www.amazon.co.jp/dp/B0HQXHHT1D
エンジニアでない人が Claude Code に Excel・CSV・PDF・フォルダ整理などの事務作業を頼むときの「頼む文」28本と、全部を実際に動かした記録は、Tips にまとめました。
『Claude Code 事務作業の任せ方レシピ28』(Tips):https://tips.jp/u/hina-mina/a/claude-code-jimu-recipe28