AIToday
用語解説

Claude Codeのフック(hooks)とは?「毎回必ずやってほしいこと」を仕組みで決める機能

著者:(AITODAY プロダクトオーナー)

公開日:最終更新日:

Claude Codeのフック(hooks)とは?「毎回必ずやってほしいこと」を仕組みで決める機能

この記事でわかること

  • フックは、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.mdAIへのお願いを文章で書くAIが読んで従う。必ず守られるとは限らない
フックタイミングと処理を設定で決めるClaude Code が毎回必ず実行する

「なるべく守ってほしいこと」は CLAUDE.md、「絶対に毎回やってほしいこと」はフックと使い分けるのが基本です。

よく使われる例

公式ドキュメントで紹介されている例を、仕事の場面に置き換えると次のようになります。

  • 返事待ちになったら通知を出す:Claude Code が「許可していいですか?」と止まったときに、パソコンに通知が届く。画面を見張っていなくてよくなる
  • 大事なファイルを守る:パスワードなどを書いた設定ファイルを、AIが書き換えようとしたら止める
  • 書き換えたファイルの見た目を整える:AIがファイルを編集するたびに、決まった書式に自動で直す
  • 会話を要約した後に、大事な決まりを思い出させる:長い作業で会話が要約されても、毎回必ず伝えたいルールを入れ直す

主なタイミング

フックを動かせるタイミングはたくさんありますが、よく使うのは次の5つです。

タイミング(英語名)いつ動くか
SessionStart作業を始めたとき、再開したとき
PreToolUseファイルの書き換えやコマンドの実行の直前。ここで止めることもできる
PostToolUseファイルの書き換えやコマンドの実行が終わった直後
Notificationあなたの返事や許可を待っているとき
StopClaude が返答を書き終えたとき

設定のしかた

設定は、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. フックを使うのにプログラミングは必要ですか?
A. 簡単なものなら、Claude Code に「返事待ちになったら通知が出るようにフックを設定して」と頼めば書いてくれます。ただし、中身はパソコンで動くコマンドなので、何をするフックなのかは自分でも確認してください。
Q. CLAUDE.md に書くのと何が違いますか?
A. CLAUDE.md は AI が読んで従う「お願い」なので、必ず守られるとは限りません。フックは Claude Code が決まったタイミングで必ず実行するので、AIの判断に左右されません。
Q. どこに設定しますか?
A. 全部の作業に効かせたいなら ~/.claude/settings.json、1つのプロジェクトだけなら、そのフォルダの .claude/settings.json に書きます。
Q. 設定したフックを止めたいときは?
A. 設定ファイルから該当する部分を消すか、すべて止めたいときは settings.json に "disableAllHooks": true と書きます。

出典:Claude Code 公式ドキュメント

あなたの仕事に関係するAIニュースを、毎朝お届けします。

業界と使っているAIツールを選ぶと、仕事に関係するニュースが毎朝届きます。

登録無料・Googleアカウントなら30秒・いつでも解除できますAITodayについて →

関連記事