Hooks 設定

Hooksとは

Claude Codeの特定のイベント（ファイル保存、コマンド実行前後など）に反応して、自動でシェルコマンドを実行する機能です。

「Claudeがファイルを変更したら、自動でテストを走らせる」といった自動化が簡単に作れます。

※Hooks: Claude Codeの特定の操作（ツール実行前後など）に独自のシェルコマンドを自動実行できる設定機能。

設定場所

~/.claude/settings.json の hooks セクションに記述します。

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "npm run lint"
          }
        ]
      }
    ]
  }
}

※npm: Node.jsのパッケージ管理ツール。`npm install` でライブラリをインストールする。

イベントの種類

イベント	タイミング
PreToolUse	ツール実行前
PostToolUse	ツール実行後
Notification	Claude Code停止時

実用的なHooks例

ファイル変更後に自動でLint

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [{ "type": "command", "command": "npm run lint --fix" }]
      }
    ]
  }
}

セッション終了時に通知

{
  "hooks": {
    "Notification": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "osascript -e 'display notification \"Claude Codeが停止しました\" with title \"ClaudeCode\"'"
          }
        ]
      }
    ]
  }
}

注意点

HooksはClaude Codeが実行するシェルコマンドです。危険なコマンドを設定しないよう注意してください。また、LintやTestが失敗すると作業が止まる場合があるため、|| true でエラーを無視する設定も有効です。