2
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

Claude Code の PreToolUse フックを Windows で書いたら、日本語のフォルダ名で素通りになっていた(BOM・onFailure・CLAUDE_PROJECT_DIR)

2
Last updated at Posted at 2026-11-08

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

2
0
1

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
2
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?