Claude Codeのフック(hooks)とは?設定方法・書く場所・使えるタイミングと、通知・自動整形・編集を止める使い方と注意点を解説【2026年11月】
Claude Codeのフック(hooks)とは、Claude Codeが作業する途中の決まったタイミングで、自分で決めたコマンドを自動的に動かす仕組みのことです。
AIに「毎回これをして」と頼んでも、たまに忘れることがあります。フックを使うと、AIの判断に任せず、決まった処理を毎回動かせます。
本記事では、Claude Codeのフックについて、仕組み、設定方法、書く場所、使い方の例、注意点の順に整理します。
公式ドキュメント(2026年11月15日時点)をもとに、株式会社Pdien(プディン)が日々の業務で使っている立場からお伝えします。
公開日:2026年11月15日/最終更新日:2026年11月15日
- フックは、決まったタイミングで自動的に動くコマンドです
- 設定ファイルに書き、書く場所で使える範囲が決まります
- コマンドは自分の権限で動くため、中身を確かめてから入れます
この記事の結論
- Claude Codeのフックは、作業の途中で自動的に動くコマンドです。
- 設定は settings.json の hooks に書き、/hooks で確かめます。
- 通知、ファイルの自動整形、大事なファイルの編集を止める使い方があります。
- コマンドは自分のアカウントの権限で動くため、中身の確認が欠かせません。
▲ Claude Codeのフックは、動くタイミングと書く場所を押さえると使えます
「どの作業を自動で確かめる仕組みにすればよいか」といったご相談を承っています。AI社員(AIエージェント)導入のご相談はこちらからどうぞ。
Claude Codeのフック(hooks)とは?
フックとは、自分で決めたシェルのコマンドを、Claude Codeが決まったタイミングで自動的に動かす仕組みです。
公式ドキュメントでは、AIが実行するかどうかを選ぶのではなく、決まった処理が毎回動くことが利点だと説明されています。
▲ 「頼んで忘れられる」作業を、毎回動く処理に置き換えられます
公式ドキュメントでは、次のような使い道が挙げられています。
- プロジェクトの決まりを守らせる
- 毎回くり返す作業を自動にする
- 今使っている道具とClaude Codeをつなぐ
出典: Automate actions with hooks(Claude Code Docs)(2026年11月15日時点)
判断が要る確認には、Claudeのモデルに判定させる「プロンプト型」のフックも用意されています。
フックはどのタイミングで動く?
フックは、「イベント」と呼ばれるタイミングごとに設定します。公式ドキュメントには30を超えるイベントが載っていて、よく使うのは次のものです。
| イベント | 動くタイミング |
|---|---|
| SessionStart | セッションを始めたとき・再開したとき |
| UserPromptSubmit | 指示を送った直後、Claudeが処理する前 |
| PreToolUse | ツールを使う直前(止めることもできる) |
| PostToolUse | ツールを使い終えた直後 |
| Notification | Claude Codeが通知を出すとき |
| Stop | Claudeが返答を終えたとき |
▲ 「使う前」か「使った後」かで、できることが変わります
公式ドキュメントによると、Stopはタスクが終わったときだけでなく、返答を終えるたびに動きます。自分で中断したときは動かないと書かれています。
出典: Hooks reference(Claude Code Docs)(2026年11月15日時点)
フックの設定方法は?
フックの設定は、設定ファイル(settings.json)に hooks の項目を書くことです。Claudeに、やりたいことを伝えて書いてもらうこともできます。
settings.json の hooks に、イベントと動かすコマンドを書く
Claude Codeで /hooks を入力し、一覧に出ているかを見る
そのイベントが起きる作業をして、コマンドが動くかを見る
▲ 公式ドキュメントでも、この3つの手順で最初のフックを作る流れが紹介されています
書く中身は、大きく3つの部分に分かれます。
| 部分 | 書くこと | |
|---|---|---|
| イベント名 | PreToolUse・Notification など、動くタイミング | |
| matcher | どのツールのときに動くか(例:Edit\ | Write) |
| hooks | 種類(type)と、動かすコマンド(command) |
/hooks の画面は見るためのもので、ここから書き換えることはできません。直すときは、設定ファイルを開いて書き換えます。
すでに hooks の項目がある設定ファイルに足すときは、全体を置き換えず、同じ hooks の中にイベントを足すよう案内されています。
フックはどこに書く?
書く場所によって、どこで動くかが決まります。チームで同じ決まりを使うなら、プロジェクトの .claude/settings.json に書きます。
| 書く場所 | 動く範囲 | 共有できるか |
|---|---|---|
| ~/.claude/settings.json | 自分のすべてのプロジェクト | できない(自分のPCだけ) |
| .claude/settings.json | 今のプロジェクト | できる(リポジトリに入れられる) |
| .claude/settings.local.json | 今のプロジェクト | できない |
| 組織の管理設定 | 組織全体 | できる(管理者が決める) |
| プラグインの hooks/hooks.json | プラグインを有効にした場所 | できる |
▲ 自分用なら ~/.claude、チームで使うならプロジェクトの .claude に書きます
このほか、スキルやサブエージェントのファイルの頭にも書けます。その場合は、そのスキルやサブエージェントが動いている間だけ使われます。
フックで何ができる?使い方の例は?
公式ドキュメントには、そのまま使える設定の例が載っています。当社でも使いやすいと感じたのは、次の3つです。
▲ どれも「毎回やってほしいこと」を自動にする使い方です
| 使い方 | イベント | 内容 |
|---|---|---|
| 通知を受け取る | Notification | 入力や許可を待っているとき、デスクトップに知らせる |
| 自動で整える | PostToolUse | ファイルを編集した後、整形の道具を動かす |
| 編集を止める | PreToolUse | .env など大事なファイルへの書き込みを止める |
このほか、会話の圧縮(コンパクト)の後に、大事な決まりを読み込ませ直す例もあります。
当社でも、セッションを始めるたびに会社の決まりごとを読み込ませるフックを使っています。人が毎回伝えなくても、最初に同じ前提で作業を始められます。
決まった確認を自動で動かす仕組みづくりから、会社での使い方のルールまで、自社に合わせてご相談いただけます。
フックで作業を止めるには?
作業を止めたいときは、PreToolUse のフックで、コマンドを「終了コード2」で終わらせます。理由はエラー出力に書くと、Claudeに伝わります。
▲ 止められた理由が伝わるので、Claudeは別のやり方を考えられます
| 終わり方 | どうなるか |
|---|---|
| 終了コード0 | 止めない(ふだんの許可の確認に進む) |
| 終了コード2 | 止める(理由がClaudeに伝わる) |
| それ以外 | 多くのイベントでは、そのまま進む |
公式ドキュメントでは、終了コード0は「許可する」という意味ではないと注意されています。許可の確認は、ふだんどおりに行われます。
PreToolUse のフックが止めた場合は、確認を省くモードでも止まると書かれています。会社で守りたい決まりを設定で効かせられるため、事故防止に役立ちます。
PostToolUse は、ツールを使った後に動きます。すでに終わった操作を取り消すことはできません。
フックとCLAUDE.md・スキルはどう使い分ける?
毎回かならず動かしたい処理はフック、Claudeに知っておいてほしい決まりはCLAUDE.md、手順のまとまりはスキルに向いています。
▲ 「毎回動かす」ならフック、「知っておいてもらう」ならCLAUDE.mdです
| こんなとき | 向いているもの |
|---|---|
| 毎回かならず動かしたい | フック |
| 決まった操作を止めたい | フック |
| 守ってほしい決まりを伝えたい | CLAUDE.md |
| 決まった手順を使い回したい | スキル |
| 作業を別の文脈で任せたい | サブエージェント |
公式ドキュメントでも、毎回のセッションの最初に情報を伝えるだけなら、CLAUDE.mdを検討するよう案内されています。
決まりの書き方はCLAUDE.mdの書き方とは?、手順のまとめ方はClaude Codeのスキル(Skills)とは?で解説しています。
フックを使うときの注意点は?
一番の注意点は、フックのコマンドが、自分のアカウントと同じ権限で動くことです。公式ドキュメントでも、入れる前に中身を確かめて試すよう警告されています。
▲ 自分のPCのファイルを消したり読んだりできるコマンドだと考えて扱います
- コマンドは、自分のアカウントが触れるファイルをすべて扱える
- 対話で使う場合、フォルダを信頼する確認を通すまでフックは動かない
- -p で動かす場合は確認が出ず、リポジトリのフックがそのまま動く
- コマンド型のフックは、既定で10分が時間の上限
公式ドキュメントでは、変数を引用符で囲む、スクリプトの場所を省略せずに書く、.env や鍵のファイルを避けるといった書き方が勧められています。
自分で書いていないリポジトリを -p で動かす前は、.claude の設定ファイルを読んで、どんなフックが入っているかを確かめます。
外部サービスとつなぐ方法はClaude CodeのMCPの使い方、作業を任せる方法はClaude Codeのサブエージェントとは?にまとめています。
フックが動かないときは?
まず /hooks を開き、そのフックが正しいイベントの下に出ているかを確かめます。公式ドキュメントでは、次の点を見るよう案内されています。
▲ 多くは、名前の打ち間違いかイベントの選び間違いです
- /hooks の一覧に、そのフックが出ているか
- matcher がツール名と大文字・小文字まで一致しているか
- 使う前(PreToolUse)と使った後(PostToolUse)を取り違えていないか
すべてのフックを一時的に止めたいときは、設定ファイルに “disableAllHooks”: true と書きます。1つのフックだけを残したまま止める方法はないと書かれています。
よくある質問(FAQ)
Q. Claude Codeのフック(hooks)とは何ですか?
Claude Codeが作業する途中の決まったタイミングで、自分で決めたコマンドを自動的に動かす仕組みです。AIの判断に任せず、決まった処理を毎回動かせます。
Q. フックはどこに設定しますか?
設定ファイル(settings.json)の hooks に書きます。自分用なら ~/.claude/settings.json、プロジェクト用なら .claude/settings.json です。
Q. 設定したフックを確かめる方法は?
Claude Codeで /hooks を入力すると、設定されているフックをイベントごとに一覧で見られます。
Q. フックで作業を止められますか?
止められます。PreToolUse のフックのコマンドを終了コード2で終わらせると、そのツールの操作が止まり、理由がClaudeに伝わります。
Q. CLAUDE.mdとの違いは何ですか?
CLAUDE.mdは、Claudeに知っておいてほしい決まりを伝えるものです。フックは、決まったタイミングでコマンドを毎回動かす仕組みです。
Q. フックは安全ですか?
フックのコマンドは、自分のアカウントと同じ権限で動きます。入れる前に中身を読み、試してから使うよう公式ドキュメントで警告されています。
Q. フックを一時的に止めるには?
設定ファイルに “disableAllHooks”: true と書くと、すべてのフックを一時的に止められます。
まとめ
Claude Codeのフックは、決まったタイミングで自動的に動くコマンドです。設定ファイルに書き、書く場所で動く範囲が決まります。
▲ タイミング・書き方・使い方・注意点の4つを押さえます
- 知る:SessionStart・PreToolUse・PostToolUse・Stop などで動く
- 書く:settings.json の hooks に書き、/hooks で確かめる
- 使う:通知、自動整形、大事なファイルの編集を止める
- 気をつける:自分の権限で動くので、中身を確かめる
▲ 入れる前に、この3つを確かめると安全に使えます
株式会社Pdienは、愛知県岡崎市の会社です。AIエージェントを使ったAI内製化の支援や、SNS運用の自動化を行っています。会社でのAIの使い方を整える支援は、AI内製化の顧問のページでご紹介しています。
ご相談はお問い合わせフォームから受け付けています。
どの作業をフックで自動にするかの整理から、会社での安全な使い方のルールづくりまで、自社に合わせた進め方をご相談いただけます。











