COMPANY企業情報 SERVICEサービス WORKS制作実績 BLOGブログ RECRUIT採用情報 CONTACTお問い合わせ

BLOG

ブ ロ グ

TOP > BLOG > claude-code-hooks
AI

Claude Codeのフック(hooks)とは?設定方法・書く場所・使えるタイミングと、通知・自動整形・編集を止める使い方と注意点を解説【2026年11月】

Claude Codeのフック(hooks)とは?設定方法・書く場所・使えるタイミングと、通知・自動整形・編集を止める使

Claude Codeのフック(hooks)とは、Claude Codeが作業する途中の決まったタイミングで、自分で決めたコマンドを自動的に動かす仕組みのことです。

AIに「毎回これをして」と頼んでも、たまに忘れることがあります。フックを使うと、AIの判断に任せず、決まった処理を毎回動かせます。

本記事では、Claude Codeのフックについて、仕組み、設定方法、書く場所、使い方の例、注意点の順に整理します。

公式ドキュメント(2026年11月15日時点)をもとに、株式会社Pdien(プディン)が日々の業務で使っている立場からお伝えします。

公開日:2026年11月15日/最終更新日:2026年11月15日

この記事の要点
  • フックは、決まったタイミングで自動的に動くコマンドです
  • 設定ファイルに書き、書く場所で使える範囲が決まります
  • コマンドは自分の権限で動くため、中身を確かめてから入れます
目次

この記事の結論

Claude Codeのフックの要点(自動で動く・設定ファイルに書く・止められる・安全に使う)

▲ Claude Codeのフックは、動くタイミングと書く場所を押さえると使えます

「どの作業を自動で確かめる仕組みにすればよいか」といったご相談を承っています。AI社員(AIエージェント)導入のご相談はこちらからどうぞ。

Claude Codeのフック(hooks)とは?

フックとは、自分で決めたシェルのコマンドを、Claude Codeが決まったタイミングで自動的に動かす仕組みです。

公式ドキュメントでは、AIが実行するかどうかを選ぶのではなく、決まった処理が毎回動くことが利点だと説明されています。

Claude Codeのフックとは:AIの判断に任せず、決まった処理を毎回動かす仕組み

▲ 「頼んで忘れられる」作業を、毎回動く処理に置き換えられます

公式ドキュメントでは、次のような使い道が挙げられています。

出典: Automate actions with hooks(Claude Code Docs)(2026年11月15日時点)

判断が要る確認には、Claudeのモデルに判定させる「プロンプト型」のフックも用意されています。

フックはどのタイミングで動く?

フックは、「イベント」と呼ばれるタイミングごとに設定します。公式ドキュメントには30を超えるイベントが載っていて、よく使うのは次のものです。

イベント動くタイミング
SessionStartセッションを始めたとき・再開したとき
UserPromptSubmit指示を送った直後、Claudeが処理する前
PreToolUseツールを使う直前(止めることもできる)
PostToolUseツールを使い終えた直後
NotificationClaude Codeが通知を出すとき
StopClaudeが返答を終えたとき
Claude Codeのフックが動く主なタイミング(SessionStart・PreToolUse・PostToolUse・Stop ほか)

▲ 「使う前」か「使った後」かで、できることが変わります

公式ドキュメントによると、Stopはタスクが終わったときだけでなく、返答を終えるたびに動きます。自分で中断したときは動かないと書かれています。

出典: Hooks reference(Claude Code Docs)(2026年11月15日時点)

フックの設定方法は?

フックの設定は、設定ファイル(settings.json)に hooks の項目を書くことです。Claudeに、やりたいことを伝えて書いてもらうこともできます。

STEP
書く

settings.json の hooks に、イベントと動かすコマンドを書く

STEP
確かめる

Claude Codeで /hooks を入力し、一覧に出ているかを見る

STEP
試す

そのイベントが起きる作業をして、コマンドが動くかを見る

Claude Codeのフックの設定方法(settings.jsonに書く・/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 Codeのフックを書く場所と動く範囲(~/.claude/settings.json・.claude/settings.json ほか)

▲ 自分用なら ~/.claude、チームで使うならプロジェクトの .claude に書きます

このほか、スキルやサブエージェントのファイルの頭にも書けます。その場合は、そのスキルやサブエージェントが動いている間だけ使われます。

フックで何ができる?使い方の例は?

公式ドキュメントには、そのまま使える設定の例が載っています。当社でも使いやすいと感じたのは、次の3つです。

Claude Codeのフックの使い方の例(通知・自動整形・編集を止める)

▲ どれも「毎回やってほしいこと」を自動にする使い方です

使い方イベント内容
通知を受け取るNotification入力や許可を待っているとき、デスクトップに知らせる
自動で整えるPostToolUseファイルを編集した後、整形の道具を動かす
編集を止めるPreToolUse.env など大事なファイルへの書き込みを止める

このほか、会話の圧縮(コンパクト)の後に、大事な決まりを読み込ませ直す例もあります。

当社でも、セッションを始めるたびに会社の決まりごとを読み込ませるフックを使っています。人が毎回伝えなくても、最初に同じ前提で作業を始められます。

決まった確認を自動で動かす仕組みづくりから、会社での使い方のルールまで、自社に合わせてご相談いただけます。

フックで作業を止めるには?

作業を止めたいときは、PreToolUse のフックで、コマンドを「終了コード2」で終わらせます。理由はエラー出力に書くと、Claudeに伝わります。

Claude Codeのフックで作業を止める仕組み(終了コード0は通常どおり・2は止める)

▲ 止められた理由が伝わるので、Claudeは別のやり方を考えられます

終わり方どうなるか
終了コード0止めない(ふだんの許可の確認に進む)
終了コード2止める(理由がClaudeに伝わる)
それ以外多くのイベントでは、そのまま進む

公式ドキュメントでは、終了コード0は「許可する」という意味ではないと注意されています。許可の確認は、ふだんどおりに行われます。

PreToolUse のフックが止めた場合は、確認を省くモードでも止まると書かれています。会社で守りたい決まりを設定で効かせられるため、事故防止に役立ちます。

PostToolUse は、ツールを使った後に動きます。すでに終わった操作を取り消すことはできません。

フックとCLAUDE.md・スキルはどう使い分ける?

毎回かならず動かしたい処理はフック、Claudeに知っておいてほしい決まりはCLAUDE.md、手順のまとまりはスキルに向いています。

Claude CodeのフックとCLAUDE.md・スキルの使い分け

▲ 「毎回動かす」ならフック、「知っておいてもらう」ならCLAUDE.mdです

こんなとき向いているもの
毎回かならず動かしたいフック
決まった操作を止めたいフック
守ってほしい決まりを伝えたいCLAUDE.md
決まった手順を使い回したいスキル
作業を別の文脈で任せたいサブエージェント

公式ドキュメントでも、毎回のセッションの最初に情報を伝えるだけなら、CLAUDE.mdを検討するよう案内されています。

決まりの書き方はCLAUDE.mdの書き方とは?、手順のまとめ方はClaude Codeのスキル(Skills)とは?で解説しています。

フックを使うときの注意点は?

一番の注意点は、フックのコマンドが、自分のアカウントと同じ権限で動くことです。公式ドキュメントでも、入れる前に中身を確かめて試すよう警告されています。

Claude Codeのフックを使うときの注意点(権限・信頼していないフォルダ・時間の上限)

▲ 自分のPCのファイルを消したり読んだりできるコマンドだと考えて扱います

公式ドキュメントでは、変数を引用符で囲む、スクリプトの場所を省略せずに書く、.env や鍵のファイルを避けるといった書き方が勧められています。

自分で書いていないリポジトリを -p で動かす前は、.claude の設定ファイルを読んで、どんなフックが入っているかを確かめます。

外部サービスとつなぐ方法はClaude CodeのMCPの使い方、作業を任せる方法はClaude Codeのサブエージェントとは?にまとめています。

フックが動かないときは?

まず /hooks を開き、そのフックが正しいイベントの下に出ているかを確かめます。公式ドキュメントでは、次の点を見るよう案内されています。

Claude Codeのフックが動かないときに確かめること(/hooks・matcher・イベントの種類)

▲ 多くは、名前の打ち間違いかイベントの選び間違いです

すべてのフックを一時的に止めたいときは、設定ファイルに “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のフックは、決まったタイミングで自動的に動くコマンドです。設定ファイルに書き、書く場所で動く範囲が決まります。

Claude Codeのフックのまとめ(知る・書く・使う・気をつける)

▲ タイミング・書き方・使い方・注意点の4つを押さえます

Claude Codeのフックを入れる前に確かめること(中身を読んだか・書く場所は合っているか・試したか)

▲ 入れる前に、この3つを確かめると安全に使えます

株式会社Pdienは、愛知県岡崎市の会社です。AIエージェントを使ったAI内製化の支援や、SNS運用の自動化を行っています。会社でのAIの使い方を整える支援は、AI内製化の顧問のページでご紹介しています。

ご相談はお問い合わせフォームから受け付けています。

どの作業をフックで自動にするかの整理から、会社での安全な使い方のルールづくりまで、自社に合わせた進め方をご相談いただけます。

CONTACT

サービスや見積りのご相談を承っております。お気軽にお問い合わせください。

お問い合わせ