Claude Codeのフック(hooks)とは?「毎回必ずやってほしいこと」を仕組みで決める機能
著者:高橋 輝(AITODAY プロダクトオーナー)
公開日:最終更新日:

この記事でわかること
- フックは、Claude Code が特定のタイミングで「必ず」実行する処理を決めておく機能
- CLAUDE.md は AI へのお願いなので必ず守られるとは限らないが、フックは仕組みとして毎回動く
- 設定は settings.json に書き、/hooks で確認できる。書き方は Claude に頼んでもいい
Claude Code のフック(hooks)でできることを、専門用語なしで解説。CLAUDE.md との違い、よく使われる例、設定の確認方法、使うときの注意。
一言でいうと、フックは「Claude Code に、決まったタイミングで毎回必ずやってほしいこと」を設定しておく機能です。たとえば「返事待ちになったら通知を出す」「大事なファイルは書き換えさせない」といったことを、AIの気分に任せずに仕組みで決められます。
フックとは
Claude Code は、作業の途中でいろいろな「タイミング」を通ります。ファイルを書き換える前、書き換えた後、作業が終わったとき、あなたの返事を待っているとき、などです。
フックは、そのタイミングに合わせて、決めておいた処理を自動で動かす仕組みです。英語の hook には「引っかける」という意味があり、Claude Code の動きに処理を引っかけておくイメージです。
CLAUDE.md との違い
「毎回これをやって」と伝える方法は、CLAUDE.md にもあります。違いは、守られるかどうかです。
| 方法 | 中身 | 守られ方 |
|---|---|---|
| CLAUDE.md | AIへのお願いを文章で書く | AIが読んで従う。必ず守られるとは限らない |
| フック | タイミングと処理を設定で決める | Claude Code が毎回必ず実行する |
「なるべく守ってほしいこと」は CLAUDE.md、「絶対に毎回やってほしいこと」はフックと使い分けるのが基本です。
よく使われる例
公式ドキュメントで紹介されている例を、仕事の場面に置き換えると次のようになります。
- 返事待ちになったら通知を出す:Claude Code が「許可していいですか?」と止まったときに、パソコンに通知が届く。画面を見張っていなくてよくなる
- 大事なファイルを守る:パスワードなどを書いた設定ファイルを、AIが書き換えようとしたら止める
- 書き換えたファイルの見た目を整える:AIがファイルを編集するたびに、決まった書式に自動で直す
- 会話を要約した後に、大事な決まりを思い出させる:長い作業で会話が要約されても、毎回必ず伝えたいルールを入れ直す
主なタイミング
フックを動かせるタイミングはたくさんありますが、よく使うのは次の5つです。
| タイミング(英語名) | いつ動くか |
|---|---|
| SessionStart | 作業を始めたとき、再開したとき |
| PreToolUse | ファイルの書き換えやコマンドの実行の直前。ここで止めることもできる |
| PostToolUse | ファイルの書き換えやコマンドの実行が終わった直後 |
| Notification | あなたの返事や許可を待っているとき |
| Stop | Claude が返答を書き終えたとき |
設定のしかた
設定は、settings.json というファイルに書きます。置き場所で、効く範囲が変わります。
| 置き場所 | 効く範囲 |
|---|---|
~/.claude/settings.json | 自分のパソコンでの、すべての作業 |
.claude/settings.json(プロジェクトのフォルダ内) | そのプロジェクトだけ。チームで共有できる |
たとえば、Mac で「返事待ちになったら通知を出す」フックは、公式ドキュメントでは次のように書かれています。
{
"hooks": {
"Notification": [
{
"matcher": "",
"hooks": [
{
"type": "command",
"command": "osascript -e 'display notification \"Claude Code needs your attention\" with title \"Claude Code\"'"
}
]
}
]
}
}
自分で書かなくても、Claude Code に「返事待ちになったら通知が出るようにフックを設定して」と頼めば、書いてくれます。設定できたかどうかは、Claude Code で /hooks と入力すると一覧で確認できます。
ポイントMac で通知が出ないときは、ターミナルで一度
osascript -e 'display notification "test"'を実行してから、「システム設定 → 通知」で「スクリプトエディタ」の通知をオンにしてください。公式ドキュメントでも、ここが原因になりやすいと案内されています。
使うときの注意
- フックはパソコンの上でコマンドを動かします。ネットで見つけた設定をそのまま貼る前に、何をするものか確認してください
- プロジェクトの .claude/settings.json は、チームで共有されることがあります。自分だけの設定は ~/.claude/settings.json に書きます
- 止めたいときは消せば戻ります。すべてのフックを止めたいときは、settings.json に
"disableAllHooks": trueと書きます
よくある勘違い
- 「フックはAIへの指示」:違います。AIが読むお願いではなく、Claude Code 本体が決まったタイミングで動かす処理です。
- 「エンジニアしか使えない」:半分違います。中身はコマンドですが、Claude に頼めば書いてもらえます。何をするフックなのかを理解しておけば十分です。
まとめ
フックは、Claude Code に「毎回必ずやってほしいこと」を仕組みで決めておく機能です。CLAUDE.md が「お願い」なら、フックは「決まり」です。まずは「返事待ちになったら通知を出す」のような、害のない便利なものから試すのがおすすめです。
次に読む
よくある質問
Q. フックを使うのにプログラミングは必要ですか?
Q. CLAUDE.md に書くのと何が違いますか?
Q. どこに設定しますか?
Q. 設定したフックを止めたいときは?
あなたの仕事に関係するAIニュースを、毎朝お届けします。
業界と使っているAIツールを選ぶと、仕事に関係するニュースが毎朝届きます。
登録無料・Googleアカウントなら30秒・いつでも解除できますAITodayについて →
関連記事
- 用語解説
Copilot Chat(Basic)とは?ExcelやWordからCopilotが消えた理由
ExcelやWordからCopilotが消えたときに出る「Copilot Chat(Basic)」の意味を、専門用語なしで解説。ライセンスなしで使える範囲、使い続ける方法と料金。
- 用語解説
AIエージェントとは?「答える」AIから「やっておいてくれる」AIへ
ニュースで毎日のように見る「AIエージェント」の意味を、専門用語なしで解説。チャットAIとの違い、何ができるか、仕事で使うときの注意。
- 用語解説
コンテキストエンジニアリングとは?プロンプトの「書き方」より「何を渡すか」
プロンプトエンジニアリングの次に注目されているコンテキストエンジニアリングの意味を、専門用語なしで解説。何が違うのか、CLAUDE.md・RAG・MCPとの関係、今日からできること。

