本文へ移動
  1. トップ
  2. 用語集
  3. フック(Claude Code の hooks)
用語集

フック(Claude Code の hooks)とは

要点よみ: ふっく

Claude Code が、道具を使う前や後、返事を終えたときなど、決まった時点で毎回自動で動かす処理。

フックは、Claude Code が作業の決まった時点で自動で動かす処理です。動かす時点は、ファイルの編集やコマンドの実行など道具を使う前と後、返事を終えたとき、会話を始めたときなどから選びます。選んだ時点と動かす処理を、設定のファイルに書きます。AI の判断に任せず、決まった時点で毎回必ず動くのが特長です。

CLAUDE.md に書いた決まりは AI が読む前提で、必ず守られるとは限りません。公式の説明も、操作を確実に止めたいときはフックを使うよう案内しています。たとえば、道具を使う前に動くフックで、鍵やパスワードを書いたファイルの書き換えや、危ないコマンドの実行を止めます。公式の説明では、このフックで止めた操作は、許可の確認を省くモードでも止まります。ファイルを直した後に書式を整える、設定のファイルの変更を記録に残す、といった使い方もあります。

入れる前に確かめること

  • フックは、使う人のアカウントの権限のまま動きます。そのアカウントが触れるファイルなら、消すこともできます。入れる前に中身を読み、試してから使います
  • 止めるには、公式で決められた返し方をさせる必要があります。フック自体がエラーで終わったときは、操作はそのまま進みます。止めたい操作で本当に止まるかを、一度わざと試して確かめます
  • フックの設定はリポジトリに入れて共有できます。人が作ったリポジトリで Claude Code を動かす前に、中の設定にどんなフックがあるかを確かめます

どの操作を止めるかは、間違えたときの影響で決めます。考え方は人の確認を挟む仕組みと同じです。