エージェントフック
エージェントフック(agent hooks)とは、ツール呼び出しの直前やファイル編集の直後など、作業中の決まった時点でコーディングエージェントが自動的に実行する、ユーザー定義のコマンドやスクリプトです。エージェントの動作を確認、阻止、拡張するために使います。
別名: hooks
執筆 Divya Sharma · 2026年11月15日確認 · レビューの方法
プロンプトや指示ファイルに書いた指示は、モデルが通常は従う提案にすぎません。フックはモデルの判断にかかわらず毎回実行されるコードです。そのため、必ず守るべきルールや、モデルが覚えていることに頼りたくない作業を置く場所になります。
仕組み
エージェントの設定で、イベントに対してフックを登録します。Claude Code のイベントには、セッションの開始、ユーザーがプロンプトを送信した時点、ツールの実行直前(PreToolUse)、実行直後(PostToolUse)、エージェントが停止したときがあります。エージェントはツール名やその入力など、イベントの詳細をスクリプトに渡します。スクリプトは処理をそのまま進めるか、モデルに見える理由を添えて阻止するか、コンテキストを追加できます。
主な用途
ファイルを編集するたびにフォーマッターやリンターを実行する。ファイルを削除したり機密情報に触れたりするシェルコマンドを阻止する。保護されたパスへの編集を拒否する。エージェントが入力を必要としたらデスクトップ通知を送る。監査のためにすべてのツール呼び出しを記録する。
フックと権限の違い
エージェントの権限はツールの許可リストと拒否リストです。フックはプログラムできるので、引数を調べ、リストでは表現できないルールを適用できます。どちらもエージェントハーネスの一部です。
限界
フックはユーザーの全権限で動くため、不注意な、あるいは悪意あるフックスクリプトはそれ自体がリスクです。共有リポジトリのフックは有効にする前に確認してください。コマンドのパターンマッチングはすり抜けられることがあるので、フックは唯一の防御ではなく、エージェントサンドボックスと並ぶ 1 つの層として扱ってください。
関連用語
- コーディングエージェント
- コーディングエージェント(coding agent)とは、人が貼り付けるコードを提案するだけでなく、ソフトウェアに直接取り組む AI エージェントです。コードベースを読み、ファイルを編集し、コマンドとテストを実行し、変更が動くまで繰り返します。
- エージェントハーネス
- エージェントハーネス(agent harness)とは、モデルを実際に動くエージェントにするための周辺ソフトウェアです。ループ、ツール、システムプロンプト、権限、コンテキスト管理、セッション間で進捗を引き継ぐためのファイルなどを含みます。
- エージェントの権限
- エージェントの権限(agent permissions)とは、AI エージェントがどのツール、ファイル、コマンド、ネットワーク、アカウントを使えるか、どの操作に事前の人の承認が必要かを決めるルールです。誤ったり操作されたりしたエージェントが与える被害を限定します。
- エージェント指示ファイル(AGENTS.md)
- エージェント指示ファイル(agent instructions file)とは、AGENTS.md や CLAUDE.md など、コードリポジトリに置く Markdown ファイルです。コーディングエージェントはセッションの開始時にこれを読み、プロジェクトのコマンド、規約、ルールを把握します。
- エージェントサンドボックス
- エージェ ントサンドボックス(agent sandbox)とは、コンテナ、仮想マシン、オペレーティングシステムの制限などによる隔離された環境です。AI エージェントはその中でコードやコマンドを実行し、決められた範囲の外にあるファイル、ネットワーク、データには届きません。