Hooks で振る舞いを制御する

質問を解く前に、ステップバイステップで思考過程を <thinking>...</thinking> に書いてください。
最終回答だけを <answer>...</answer> に書いてください。

Extended Thinking (拡張思考) との関係

client.messages.create(
    model="claude-opus-4-7",
    max_tokens=8000,
    thinking={"type": "enabled", "budget_tokens": 4000},
    messages=[...],
)

CoT を書くべきとき / 書くべきでないとき

推論を見せる vs 見せない

import re
m = re.search(r"<answer>(.*?)</answer>", text, re.DOTALL)
final = m.group(1).strip() if m else text

CoT を試す

パターン 1: 編集後に変更ファイルだけフォーマット (高速)

「全プロジェクトを毎回フォーマット」は遅すぎる。変更ファイルだけ に絞る:

wzxhzdk:0

→ 編集された そのファイルだけ ruff format が走る。100 ms 以内で終わる。

パターン 2: シークレット流出をブロック (PreToolUse)

.env や鍵ファイルへの 書き込み・読み込み を未然にブロック:

.claude/scripts/guard-secrets.sh:

wzxhzdk:1

settings.json:

wzxhzdk:2

→ Claude が .env を編集しようとした瞬間に止まり、stderr の文言を見て自己修正を試みる。

パターン 3: 全プロンプトをログに残す (監査)

wzxhzdk:3

→ 全プロンプトが klzzwxh:0007 に記録される。コンプライアンス要件のある現場で必須。

パターン 4: セッション終了時に WIP コミット

「Claude Code を閉じる前に必ず checkpoint」を強制:

wzxhzdk:4

→ 未コミット変更があればセッション終了時に自動 commit。作業ロスト防止。

パターン 5: 危険 git コマンドの追加ガード

PreToolUse で Bash を Inspect:

wzxhzdk:5

Hooks デバッグのコツ

• /hooks で現在登録されている hook を確認
• 失敗時は ~/.claude/logs/hooks.log に stderr が記録される (環境による)
• command の中で set -x を入れると実行コマンドが見える
• 開発中は echo で $CLAUDE_TOOL_INPUT_JSON を出力し、構造を確認

Python プロジェクトで Edit / Write 直後に ruff format が走る Hook を設定してください。

1. .claude/settings.json を編集 (もしくは新規作成)
2. PostToolUse + matcher "Edit|Write"
3. command に ruff format $CLAUDE_PROJECT_DIR を設定
4. Claude Code セッションで何かファイルを編集し、自動フォーマットを確認

Bash ツール呼び出しで rm -rf が含まれていたらブロックする PreToolUse Hook を作ってください。

Hook スクリプト (bash) を .claude/scripts/guard.sh に置き、settings.json から呼び出します。