Claude Code hooks:カスタムワークフローの自動化設定

Claude Code hooks:カスタムワークフローの自動化設定

AIを知りたい

Claude Codeの「hooks」って何ですか?

AIエンジニア

hooksはClaude Codeの特定のアクションの前後にシェルコマンドを自動実行する機能です。「ファイル保存後にeslint実行」「コミット前にテスト実行」「セッション開始時に環境変数読み込み」といった処理を自動化できます。

AIを知りたい

Git hooksとは違うのですか?

AIエンジニア

概念は似ていますが、Claude Codeの操作に対するフックです。Claude Codeがファイルを編集した時やBashコマンドを実行する時などAIの操作をトリガーにできる点が異なります。

Claude Code hooksとは、Claude Codeの各種アクションの前後にカスタムシェルコマンドを自動実行する仕組みです。

.claude/settings.jsonのhooksセクションで設定し、PreToolUse(ツール実行前)、PostToolUse(ツール実行後)、Notification(通知時)などのイベントにスクリプトをバインドできます。

設定方法と活用例

AIを知りたい

どうやって設定しますか?

AIエンジニア

.claude/settings.jsonにhooksセクションを追加します。PostToolUseイベントで、toolNameが”Edit”の時にeslintを自動実行する設定などが可能です。matcherでどのツール・ファイルパターンで発火するかフィルタリングできます。

AIを知りたい

具体的にどんなhooksが便利ですか?

AIエンジニア

ファイル保存後のリンター実行(コード品質の自動チェック)、コミット前のテスト実行(壊れたコードのコミット防止)、セッション開始時の環境セットアップが特に便利です。CI/CDのローカル版として活用できます。

イベント タイミング 活用例
PreToolUse ツール実行前 危険なコマンドのブロック
PostToolUse ツール実行後 リンター自動実行
Notification 通知発生時 Slack通知の送信
Stop 応答完了時 成果物の自動検証

まとめ

Claude Code hooksはAIの操作をトリガーにしたカスタムワークフロー自動化を実現する機能です。settings.jsonで簡単に設定でき、開発品質を自動的に担保する仕組みを構築できます。

関連記事