自動のガードと記録

しくみ

フックは、Claude Code の作業の決まったタイミングで、自動的に動くプログラムです。公式ドキュメントでは「特定のことが必ず起きるようにする仕組み」と説明されています。

プロンプトや CLAUDE.md に「元データは書き換えないで」と書いても、それはお願いです。Claude が守らないこともあります。フックは、Claude の判断とは関係なく必ず動くので、守ってほしいルールを確実にできます。

指紋とは、ファイルの中身から計算される固有の値（ハッシュ値）です。中身が1文字でも変わると、まったく違う値になります。作業の前後で指紋を比べれば、元データが変わっていないことを確かめられます。

実際に試して分かったこと

このページを作るとき、ひな形を実際の Claude Code で試しました。

1. 最初は「ファイルの書き込み（Edit・Write）」だけを止めるフックにしていました。すると Claude は、コマンドを使った別の方法で元データに追記してしまいました。作業記録のフックは、その操作をきちんと記録していました。
2. そこで、コマンドの中身も確かめるようにし、さらに元データの指紋の確認を加えました。直したひな形では、Claude は書き込みを止められ、「フックが input フォルダの書き換えを禁止しているため、変更していません」と報告しました。

この経験から言えるのは、1つの仕組みだけに頼らず、「止める」と「確かめる」を組み合わせることの大切さです。経理の内部統制で、予防的な統制と発見的な統制を組み合わせるのと同じ考え方です。

設定のしかた

1. ひな形を置く

ひな形（keiri-hooks-sample.zip）を展開し、中の .claude フォルダを、作業用のフォルダの直下にコピーします。

勘定照合/
├── .claude/
│   ├── settings.json        … フックの設定（Windows は settings.windows.json の名前を変えて使う）
│   └── hooks/               … フックのプログラム
├── input/                   … 元データ（フックで保護される）
├── output/                  … 結果の保存先
└── logs/                    … 作業記録（自動で作られ、フックで保護される）

Windows の場合は、settings.windows.json の名前を settings.json に変えます（もとの settings.json は削除します）。Mac では、「.」で始まるフォルダは Finder で隠れています。Command＋Shift＋.（ピリオド）で表示できます。

2. 設定ファイルの中身

Mac・Linux 用の設定（一部）は次のとおりです。matcher は「どの道具のときに動くか」、${CLAUDE_PROJECT_DIR} は「作業用のフォルダの場所」を表します。

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Edit|Write|Bash",
        "hooks": [
          {
            "type": "command",
            "command": "python3",
            "args": ["${CLAUDE_PROJECT_DIR}/.claude/hooks/guard_input.py"]
          }
        ]
      }
    ]
  }
}

フックのプログラムが「終了コード2」で終わると、その操作は止められ、プログラムが出したメッセージが Claude に伝わります（公式ドキュメントより）。ひな形では「input フォルダのファイルは書き換えられません。結果は output フォルダに保存してください」と伝えるようにしています。

3. 動きを確かめる

1. Claude Code でフォルダを開きます。フォルダを信頼するか聞かれたら、.claude の中身を確認してから信頼します。信頼するまで、フックは動きません（公式ドキュメントより）。
2. 入力欄に /hooks と入力し、4つのフックが表示されることを確かめます。
3. 「input/ のCSVに1行追加して」と頼み、止められることを確かめます。
4. logs/claude_sagyou_kiroku.csv を Excel で開き、記録が残っていることを確かめます。

作業記録の例

logs/claude_sagyou_kiroku.csv には、次のような記録が残ります。

この記録と、テーマD（中級者の次の一歩）で作る照合の記録を合わせて保管すると、「どのデータを使い、どう処理し、元データは変わっていない」ことを説明できます。