Claude Codeが「勝手にやってくれる」設定術 — hooks自動化テンプレート5選

Claude Codeでコードを書いてもらった後、毎回やっていること。

lintを走らせる。フォーマッターをかける。
「.envに変な変更入ってないよね」と目視チェックする。

AIが書いてくれたコードに対して、人間が手動で品質チェックをかけている。
便利なんだけど、「この作業、自動化できないかな」と思ったことがある人は多いはずです。

できます。

Claude Codeのhooksという機能を使えば、「ファイルを保存したら自動でフォーマットする」「.envを触ろうとしたらブロックする」「作業が終わったら通知する」といった処理を、設定ファイル1つで実現できます。

プログラミングの知識は最小限で大丈夫です。
JSONの書き方がわかれば動かせます。

この記事では、実際に業務で使っているhooks設定テンプレートを5つ、そのまま渡します。
コピペして配置するだけで使えます。
加えて、「なぜこう書くのか」の設計意図も解説するので、自分で新しいhooksを作れるようにもなります。

この記事で手に入るもの

テンプレート一式（zip）

• コード品質ガード（保存時に自動lint + format）

• 機密ファイル保護（.env等への変更ブロック）

• 作業ログ（コマンド実行の記録）

• 完了通知（作業終了時にデスクトップ通知）

• コミット前チェック（コミットメッセージの品質確認）

設計解説

• 各hooksの設計意図と動作の仕組み

• カスタマイズのコツ

• 自分でhooksを作るときの考え方

hooks とは何か

知っている人は飛ばしてください。

hooksは、Claude Codeの動作の「途中」に、あなたが決めた処理を挟み込む機能です。

たとえば:

• ファイルを書き込んだ直後に → フォーマッターを自動実行

• コマンドを実行する直前に → 危険な操作をブロック

• 全ての作業が終わった時に → 通知を飛ばす

ポイントは「AIの判断に頼らない」ところです。
CLAUDE.mdに「フォーマットしてね」と書いても、忘れることがあります。
hooksなら確実に実行されます。
設定ファイルに書いたルールは、100%守られる。

skillsとの違い

前回の記事で紹介したskillsは「呼び出すと動くもの」。
自分で `/meeting-summary` と打って初めて動きます。

hooksは「勝手に動くもの」。
ファイル保存やコマンド実行といったイベントをトリガーに、自動で実行されます。

skills → 自分で呼ぶ（能動的）
hooks  → 勝手に動く（自動的）

補完関係にあります。両方使うと強い。

設定場所

`settings.json` に書きます。配置場所は2つ。

全プロジェクト共通（自分用）

~/.claude/settings.json

Windows の場合は `%USERPROFILE%.claude\settings.json` です。

特定プロジェクトだけ（チーム共有向き）

プロジェクト/.claude/settings.json

前提知識

hooksでは、データのやり取りにJSON形式を使います。
テンプレート内で登場する `jq` は、コマンドラインでJSONを処理するためのツールです。
多くの環境にプリインストールされていますが、なければ `brew install jq`（macOS）や `sudo apt install jq`（Linux）でインストールできます。Windowsの場合は `choco install jq` か、公式サイトからダウンロードしてください。

テンプレート2と5はPythonで書いているので、jqがなくても動きます。

hooksが動くタイミング（イベント一覧）

hooksは「いつ動くか」を指定できます。主なイベントはこの6つ。

PreToolUse — ツール実行の直前
ファイル書き込み、コマンド実行、Web検索など、Claude Codeがツールを使う直前に動きます。exit code 2を返すとブロックできるので、「ここには触らせない」というガードに使えます。

PostToolUse — ツール実行の直後
ファイルの保存後にフォーマッターを走らせる、コマンド実行後にログを取る、といった「後処理」に使います。一番使用頻度が高いイベントです。

Stop — 作業完了時
Claude Codeが回答を終えたタイミングで動きます。「終わったよ」の通知を飛ばすのに便利です。

Notification — 通知発生時
Claude Codeが入力を待っているとき（許可の確認など）に動きます。席を外しているときでも気づけるように通知を設定できます。

UserPromptSubmit — プロンプト送信時
あなたがメッセージを送った直後、Claudeが処理を始める前に動きます。入力の前処理に使えます。

SessionStart — セッション開始時
Claude Codeを起動したとき、または既存セッションを再開したときに動きます。環境チェックや初期化処理に使えます。

どんな人に向いているか

すでにClaude Codeを使っている人

• 毎回手動でlint/formatを走らせている

• 「.envを変更されて困った」経験がある

• チームで開発品質を標準化したい

Claude Codeをもっと活用したい人

• skillsは設定した、次のステップを探している

• CLAUDE.mdの「お願い」ではなく「強制」したいルールがある

• 作業ログを残してコンプライアンス対応したい

ここからは実際のテンプレートと、設計意図、カスタマイズのポイントを解説します。

テンプレートのダウンロード

以下からzipファイルをダウンロードしてください。

中身の構成

hooks-automation-pack/
├── README.md                   ← 使い方マニュアル
├── settings-all.json           ← 全テンプレート統合版
├── settings-quality.json       ← テンプレート1のみ
├── settings-protection.json    ← テンプレート2のみ
├── settings-logging.json       ← テンプレート3のみ
├── settings-notification.json  ← テンプレート4のみ
├── settings-commit.json        ← テンプレート5のみ
└── hooks/
    ├── file_protector.py       ← 機密ファイル保護スクリプト
    ├── commit_checker.py       ← コミットメッセージチェックスクリプト
    └── format_runner.sh        ← フォーマッター実行スクリプト

設置方法

1. zipを解凍

2. 使いたいテンプレートのJSONの中身を、自分の `settings.json` にコピー

3. スクリプトが必要なテンプレートは `hooks/` フォルダをプロジェクトの `.claude/hooks/` にコピー

# 全プロジェクト共通で使う場合
# ~/.claude/settings.json に統合版の内容をコピー

# 特定プロジェクトだけで使う場合
mkdir -p .claude/hooks
cp hooks-automation-pack/hooks/* .claude/hooks/
# .claude/settings.json にテンプレートの内容をコピー

全部使う必要はありません。必要なものだけ選んでください。

テンプレート1: コード品質ガード

ファイルを保存するたびに、自動でフォーマッターとlinterを実行します。

何が起きるか

Claude Codeがファイルを書き込む → 直後にフォーマッターが走る → インデントや余分な空白が自動修正される

手動で `prettier` や `ruff` を走らせる必要がなくなります。

設定

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": ".claude/hooks/format_runner.sh"
          }
        ]
      }
    ]
  }
}

フォーマッタースクリプト（format_runner.sh）

#!/bin/bash
# 保存されたファイルの拡張子に応じてフォーマッターを実行
# stdin から JSON を受け取る（Claude Code hooks の標準仕様）

FILE_PATH=$(jq -r '.tool_input.file_path // empty')

if [ -z "$FILE_PATH" ] || [ ! -f "$FILE_PATH" ]; then
  exit 0
fi

EXT="${FILE_PATH##*.}"

case "$EXT" in
  ts|tsx|js|jsx)
    if command -v npx &> /dev/null; then
      npx prettier --write "$FILE_PATH" 2>/dev/null
    fi
    ;;
  py)
    if command -v ruff &> /dev/null; then
      ruff format "$FILE_PATH" 2>/dev/null
      ruff check --fix "$FILE_PATH" 2>/dev/null
    fi
    ;;
  go)
    if command -v gofmt &> /dev/null; then
      gofmt -w "$FILE_PATH" 2>/dev/null
    fi
    ;;
  css|scss|json|md)
    if command -v npx &> /dev/null; then
      npx prettier --write "$FILE_PATH" 2>/dev/null
    fi
    ;;
esac

設計意図

なぜ PostToolUse + Edit|Write か

ファイルが変更された「直後」に走らせたいので PostToolUse。
matcher に `Edit|Write` を指定することで、ファイル操作のときだけ発火します。
Web検索やBashコマンドのときには動かない。

なぜスクリプトに切り出すか

settings.json に直接コマンドを書くこともできますが、ロジックが複雑になるとJSONエスケープが地獄になります。スクリプトに切り出せば、テストもしやすい。

なぜ `command -v` でチェックするか

フォーマッターがインストールされていない環境でエラーにしない。
チームメンバーの環境差を吸収できます。

カスタマイズ

• Rust を追加したい → `rs` のケースで `rustfmt` を呼ぶ

• 特定ディレクトリだけ対象にしたい → `FILE_PATH` のプレフィックスで条件分岐

• フォーマットだけでなくテストも走らせたい → スクリプトに `pytest` 等を追加（ただし遅くなるので注意）

テンプレート2: 機密ファイル保護

`.env`、`credentials.json`、`package-lock.json` など、触られたくないファイルへの変更をブロックします。

何が起きるか

Claude Codeが保護対象ファイルを編集しようとする → ブロックされる → Claude Codeに「このファイルは編集できません」とフィードバックされる

設定

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "python3 .claude/hooks/file_protector.py"
          }
        ]
      }
    ]
  }
}

保護スクリプト（file_protector.py）

#!/usr/bin/env python3
"""機密ファイルへの編集をブロックするhooksスクリプト"""
import json
import sys

# 保護対象のパターン（必要に応じて編集）
PROTECTED_PATTERNS = [
    '.env',
    '.env.local',
    '.env.production',
    'credentials.json',
    'secrets.yaml',
    'package-lock.json',
    'pnpm-lock.yaml',
    'yarn.lock',
    '.git/',
]

try:
    data = json.load(sys.stdin)
    file_path = data.get('tool_input', {}).get('file_path', '')

    for pattern in PROTECTED_PATTERNS:
        if pattern in file_path:
            # exit code 2 = ブロック（Claude Codeに理由を伝える）
            print(f"BLOCKED: '{file_path}' is a protected file. "
                  f"Matched pattern: '{pattern}'. "
                  f"Edit this file manually if needed.")
            sys.exit(2)

    # exit code 0 = 許可
    sys.exit(0)

except Exception as e:
    # エラー時は安全側に倒す（許可）
    print(f"Warning: file_protector error: {e}", file=sys.stderr)
    sys.exit(0)

設計意図

なぜ PreToolUse か

「編集される前」にブロックしたいから。PostToolUse だと既に書き換えた後になってしまいます。ツールの実行を止められるのは PreToolUse だけ。

なぜ exit code 2 か

exit code（終了コード）はプログラムが「どう終わったか」を数字で返す仕組みです。Claude Code hooks では以下の意味になります。

• exit code 0 → 許可（正常に終了、問題なし）

• exit code 2 → ブロック（画面に出力した内容がClaude Codeにフィードバックされ、「なぜブロックしたか」が伝わる）

• それ以外 → エラー（フック自体の問題として扱われる）

なぜ「エラー時は許可」か

hooks のバグで仕事が止まるのが一番困ります。保護スクリプトが壊れたときは、フォールバックとして許可側に倒す。ログで警告を出して、後から気づけるようにしておきます。

カスタマイズ

• Dockerfile も保護したい → `PROTECTED_PATTERNS` に `'Dockerfile'` を追加

• `src/config/` 以下を丸ごと保護 → `'src/config/'` を追加

• ロックファイルの保護は不要 → `package-lock.json` 等を削除

テンプレート3: 作業ログ

Claude Codeが実行したコマンド、編集したファイルをすべてログに記録します。

何が起きるか

Bashコマンドの実行、ファイルの編集 → ログファイルに自動記録 → 後から「何をやったか」を確認できる

設定

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "jq -r '\"[\" + (now | strftime(\"%Y-%m-%d %H:%M:%S\")) + \"] CMD: \" + .tool_input.command + \" -- \" + (.tool_input.description // \"no description\")' >> .claude/activity.log"
          }
        ]
      },
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "jq -r '\"[\" + (now | strftime(\"%Y-%m-%d %H:%M:%S\")) + \"] EDIT: \" + .tool_input.file_path' >> .claude/activity.log"
          }
        ]
      }
    ]
  }
}

ログの出力例

[2026-02-16 14:32:15] CMD: npm run build -- Build the project
[2026-02-16 14:32:18] EDIT: src/components/Button.tsx
[2026-02-16 14:33:01] CMD: npm run test -- Run tests
[2026-02-16 14:33:45] EDIT: src/utils/helpers.ts

設計意図

なぜ jq を直接書くか

ログ記録は処理がシンプルなので、スクリプトに切り出すほどではありません。jq のワンライナーで十分。ただし、jq がインストールされている前提です。

なぜ PreToolUse か

「何を実行したか」を事前に記録しておくことで、コマンドが失敗した場合でも記録が残ります。PostToolUse だとコマンドが途中でクラッシュしたときにログが取れない。

なぜ description も記録するか

`npm run build` だけだと後から見たときに文脈がわからないことがあります。Claude Codeが付けるdescriptionも一緒に残しておくと、「なぜこのコマンドを実行したか」がわかる。

カスタマイズ

• ログの保存先を変えたい → `>> .claude/activity.log` の部分を変更

• 日次でログを分けたい → ファイル名に日付を入れる（`activity-$(date +%Y-%m-%d).log`）

• Web検索もログに取りたい → matcher に `WebSearch` を追加

テンプレート4: 完了通知

Claude Codeが作業を終えたとき、デスクトップ通知を飛ばします。

何が起きるか

Claude Codeの処理が完了 → デスクトップ通知が表示される → 別の作業をしていても気づける

設定（OS別）

macOS:

{
  "hooks": {
    "Stop": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "osascript -e 'display notification \"Claude Codeの作業が完了しました\" with title \"Claude Code\"'"
          }
        ]
      }
    ],
    "Notification": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "osascript -e 'display notification \"入力を待っています\" with title \"Claude Code\"'"
          }
        ]
      }
    ]
  }
}

Windows（PowerShell）:

{
  "hooks": {
    "Stop": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "powershell -Command \"[System.Reflection.Assembly]::LoadWithPartialName('System.Windows.Forms'); [System.Windows.Forms.MessageBox]::Show('Claude Codeの作業が完了しました', 'Claude Code')\""
          }
        ]
      }
    ]
  }
}

Linux:

{
  "hooks": {
    "Stop": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "notify-send 'Claude Code' '作業が完了しました'"
          }
        ]
      }
    ]
  }
}

設計意図

なぜ Stop と Notification の両方か

Stop は「作業が完了したとき」。Notification は「入力を待っているとき」（許可の確認など）。両方設定しておくと、席を外していても重要なタイミングを逃しません。

なぜ matcher が空か

通知系のフックは、すべてのケースで発火させたいことが多い。特定のツールに絞る必要がないので、空文字にしてフィルタなしにしています。

カスタマイズ

• Slack に通知したい → `command` を `curl` での Webhook 呼び出しに変更

• 音を鳴らしたい → macOS なら `afplay /System/Library/Sounds/Glass.aiff` を追加

• 長時間タスクのときだけ通知 → スクリプトに切り出して経過時間をチェック

テンプレート5: コミット前チェック

Bashでgit commitが実行されるとき、コミットメッセージの品質を自動チェックします。

何が起きるか

Claude Codeが `git commit` を実行しようとする → コミットメッセージをチェック → 問題があればブロックしてフィードバック

設定

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "python3 .claude/hooks/commit_checker.py"
          }
        ]
      }
    ]
  }
}

チェックスクリプト（commit_checker.py）

#!/usr/bin/env python3
"""git commitのコミットメッセージ品質をチェックするhooksスクリプト"""
import json
import sys
import re

# チェックルール（必要に応じて編集）
MAX_SUBJECT_LENGTH = 72
REQUIRED_PREFIX = False  # True にすると prefix 必須
VALID_PREFIXES = ['feat', 'fix', 'docs', 'style', 'refactor', 'test', 'chore']

try:
    data = json.load(sys.stdin)
    command = data.get('tool_input', {}).get('command', '')

    # git commit 以外は無視
    if 'git commit' not in command:
        sys.exit(0)

    # コミットメッセージを抽出
    msg_match = re.search(r'-m\s+["\'](.+?)["\']', command)
    if not msg_match:
        # -m なしの commit（エディタが開くパターン）は通す
        sys.exit(0)

    message = msg_match.group(1)
    subject = message.split('\n')[0]
    issues = []

    # チェック1: 件名の長さ
    if len(subject) > MAX_SUBJECT_LENGTH:
        issues.append(
            f"Subject is {len(subject)} chars "
            f"(max {MAX_SUBJECT_LENGTH})")

    # チェック2: 件名が空でないか
    if not subject.strip():
        issues.append("Subject is empty")

    # チェック3: prefix チェック（有効時のみ）
    if REQUIRED_PREFIX:
        has_prefix = any(
            subject.lower().startswith(f"{p}:")
            or subject.lower().startswith(f"{p}(")
            for p in VALID_PREFIXES)
        if not has_prefix:
            issues.append(
                f"Missing prefix. Use one of: "
                f"{', '.join(VALID_PREFIXES)}")

    if issues:
        feedback = "Commit message issues:\n"
        for issue in issues:
            feedback += f"  - {issue}\n"
        feedback += f"\nCurrent message: \"{subject}\""
        print(feedback)
        sys.exit(2)

    sys.exit(0)

except Exception as e:
    # エラー時は許可側に倒す
    sys.exit(0)

設計意図

なぜ Bash の PreToolUse か

git commit は Bash ツール経由で実行されます。`Edit` や `Write` のmatcher ではキャッチできません。Bash の PreToolUse で、コマンド文字列に `git commit` が含まれるかチェックしています。

なぜ prefix チェックをオプションにしているか

Conventional Commits（`feat:`, `fix:` 等）を強制したい人もいれば、不要な人もいます。`REQUIRED_PREFIX = False` をデフォルトにして、必要な人だけ `True` に変えられるようにしています。

なぜ正規表現で `-m` を探すか

`git commit -m "message"` の形式を解析しています。エディタが開くパターン（`-m` なし）はメッセージを解析できないので通しています。

カスタマイズ

• Conventional Commits を強制したい → `REQUIRED_PREFIX = True` に変更

• prefix の種類を変えたい → `VALID_PREFIXES` を編集

• 日本語コミットメッセージをブロックしたい → ASCII チェックを追加

• Co-Authored-By の強制 → message に `Co-Authored-By` が含まれるかチェック

テンプレートを組み合わせる

5つのテンプレートは独立して動きます。同時に使うこともできます。

`settings-all.json` には全テンプレートを統合した設定を入れてあります。そのままコピーすれば全部有効になりますが、全部載せると重くなるケースもあります。まずは1つ試して、必要に応じて追加していくのがおすすめです。

組み合わせの優先度

1. コード品質ガード（テンプレート1）→ 最初に入れるべき。毎回のフォーマットが不要になるだけで体感が変わる

2. 機密ファイル保護（テンプレート2）→ チーム開発では必須。事故防止

3. 完了通知（テンプレート4）→ 長い処理を待つことが多い人に

4. 作業ログ（テンプレート3）→ コンプライアンスや振り返りが必要な場合

5. コミット前チェック（テンプレート5）→ コミット規約がある場合

自分でhooksを作るときのコツ

1. matcher は具体的に書く

"matcher": "Edit|Write"
"matcher": "Bash"
"matcher": "*"

`*` は全ツールにマッチしますが、不要なタイミングでも発火するので遅くなります。必要なツールだけ指定してください。

2. exit code を正しく使う

• `0` → 正常終了（許可）

• `2` → ブロック（stdoutがClaude Codeにフィードバックされる）

• その他 → エラー扱い

PreToolUse で exit code 2 を返すと、そのツール呼び出しがキャンセルされます。stdout に理由を書くと、Claude Codeが「なぜブロックされたか」を理解して、別の方法を試してくれます。

3. エラー時は安全側に倒す

hooks のバグで仕事が止まるのが最悪のパターンです。例外処理では `sys.exit(0)`（許可）にしておき、ログで警告を出す。

4. 重い処理は避ける

hooks はツール実行のたびに動きます。1回のhookに5秒かかると、10回のファイル編集で50秒の待ち時間が発生します。フォーマッターの実行くらいなら問題ありませんが、テストスイート全体を走らせるのは避けたほうがいい。

トラブルシューティング

Q. hookが動かない

settings.json の構文を確認してください。JSON のカンマ忘れ、括弧の閉じ忘れが多い原因です。

# JSON の構文チェック
cat ~/.claude/settings.json | jq .

エラーが出たら、JSONフォーマッターで整形し直してください。

Q. hookがブロックしすぎる

matcher が広すぎる可能性があります。`*` を使っていたら、具体的なツール名に絞ってみてください。

Q. スクリプトが見つからない

パスを確認してください。settings.json に書くパスは、Claude Codeの作業ディレクトリからの相対パスです。

× hooks/file_protector.py
○ .claude/hooks/file_protector.py

Q. Windows で動かない

シェルスクリプト（.sh）はWindowsでそのままでは動きません。PowerShell版を使うか、Python スクリプトを使ってください。今回のテンプレートでは、ロジックが必要なものはPythonで書いているので、Pythonがインストールされていれば動きます。

まとめ

• hooksはClaude Codeの動作に「確実に実行される」処理を挟み込む機能

• settings.json に設定を書くだけで動く

• 5つのテンプレートで、フォーマット自動化・ファイル保護・ログ・通知・コミットチェックをカバー

• まずはコード品質ガード（テンプレート1）から試してみてください