
Claude Codeのhooksとは。お願いではなく仕組みで止める安全設定の作り方
2026/11/15
執筆:寺田昇平
AI Portalize株式会社 代表取締役/AI Digital Community 代表理事
仕組みとコンサルティング伴走支援の両面で、組織のAI活用の加速を支援。
Claude Codeのhooksは、ファイルの編集やコマンドの実行の前後に、Claude Codeが必ず動かす、利用者が決めたコマンドです。
危ない操作を止めるなら、操作の直前に呼ばれる「PreToolUse」のhookに、止めたい中身のときだけ終了コード2を返すスクリプトをつなぎます。
AIが指示を守るかどうかに頼らないので、hookが止めた操作は、権限のモードを切り替えても止まったままです。

大きな作業では、ここにPlan Mode(計画モード)を組み合わせます。
計画を人が読んで承認するまで編集を始めさせず、承認のあとの操作はhookで見張る形が、当社のおすすめです。
製品の事実は、2026年11月11日にClaude Codeの公式ドキュメントで確かめた内容です。
設定の例は公式ドキュメントの例をそのまま示したもので、手元で動かした結果ではありません。
Claude Codeのhooksで止められる操作の例
公式のガイドには、設定ファイルにそのまま足せる例がいくつか載っています。
社内に配る前に情シスが検討しやすいのは、次の3つです。
守りたいファイルの編集を止める(「.env」「package-lock.json」「.git/」など)
危ないコマンドを止め、実行しようとしたコマンドを記録する(「rm -rf」を含むコマンドなど)
設定ファイルが書き換えられたら記録する(変更そのものを止めることもできる)
止めたときは、スクリプトが書いた理由がClaudeに返ります。
公式の説明では、Claudeはその理由を受け取り、やり方を変えられるとされています。
一方で、操作のあとに動く「PostToolUse」のhookは、すでに動いた操作を取り消せません。
止めたい操作は、必ず動く前の「PreToolUse」で受け止めます。

hooksはタイミング・対象・コマンドの3つで書く
hooksは、設定ファイル(settings.json)の「hooks」の中に書きます。
書く中身は、いつ動くか(イベント)、どの操作で動くか(matcher)、何を動かすか(command)の3つです。
イベントは「PreToolUse」(ツールが動く前)のような名前で選び、公式の一覧には30を超える種類があります。
matcherには「Edit|Write」(ファイルの編集)や「Bash」(コマンドの実行)のように、ツールの名前を書きます。
hookが動くと、Claude Codeは、使うツールとその中身をJSONの形でスクリプトに渡します。
スクリプトは中身を調べ、終了コードで答えを返します。
終了コード0:異議なし。許可にはならず、ふだんの確認の流れに進む
終了コード2:止める。標準エラーに書いた理由がClaudeに返る
それ以外:多くのイベントでは、エラーが表示されたうえで操作は進む
設定したhookは、Claude Codeで「/hooks」と打つと一覧で確かめられます。
止める設定と記録する設定の例
守りたいファイルを止める公式の例は、編集の前に「protect-files.sh」というスクリプトを呼ぶ形です。
プロジェクトの「.claude/settings.json」に、次のように書きます。
{
"hooks": {
"PreToolUse": [
{
"matcher": "Edit|Write",
"hooks": [
{
"type": "command",
"command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/protect-files.sh"
}
]
}
]
}
}
スクリプトは、編集先のパスに「.env」などが含まれていたら、理由を標準エラーに書いて終了コード2で終えます。
どれにも当たらなければ、終了コード0で終えます。
コマンドの記録と止める仕組みは、1つのイベントに並べて書けます。
公式の例では、コマンドの実行の前に2つのhookを置いています。
{
"hooks": {
"PreToolUse": [
{
"matcher": "Bash",
"hooks": [
{
"type": "command",
"command": "jq -r .tool_input.command >> ~/.claude/bash.log"
},
{
"type": "command",
"command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/block-rm-rf.sh"
}
]
}
]
}
}
1つ目は、実行しようとしたコマンドを「bash.log」に1行ずつ足します。
2つ目は、「rm -rf」を含むコマンドなら終了コード2を返すスクリプトで、中身は自分で用意します。
2つは同時に動き、止める答えが優先されるので、「rm -rf」は止まり、記録にも残ります。
公式の例は、JSONを読むのに「jq」という道具を使っています。
また、Windowsでは、Git Bashを入れておくか、hookごとにPowerShellで動かす設定をします。
権限の設定とhooksの分け方
「hooksを入れれば、権限の設定はいらない?」と聞かれることがあります。
答えは、両方を役割で分けて使います。
公式のガイドは、決まった許可や禁止には、hookではなく権限の設定を使うよう書いています。
一方で、hookが止めた操作は、確認を飛ばすモード(bypassPermissions)でも止まります。
逆に、hookが「許可」を返しても、権限の設定にある禁止は外れません。
当社では、名前で決まる禁止は権限の設定に書き、中身を見て決める止め方と記録はhooksに書く、と分けています。
例えば、削除のコマンドを使わせないなら権限の設定、「.envに触れる編集だけ止める」ならhooksです。

権限の設定の書き方は、Claude Codeを社内で使い始める。初期設定と安全設計にまとめています。
指示ファイル(CLAUDE.md)との分担は、Claude Codeを非エンジニアに配る。CLAUDE.mdと禁止設定の分担にあります。
Claude CodeのPlan Modeで計画を読んでから編集させる流れ
Plan Modeは、Claudeに調べさせて変更の計画を出させ、ファイルにはまだ手を付けさせない権限モードです。
Claudeはファイルを読み、調べるためのコマンドを動かし、計画を書きますが、ソースは編集しません。
調べる作業を別の担当に分けて任せるサブエージェントの使い方は、Claude Codeのサブエージェントの使い方。使う場面と使わない場面の分け方に載せています。
入るには、Shift+Tabでモードを切り替えるか、頼む文の頭に「/plan」を付けます。
計画ができると、Claudeは進め方を聞いてくるので、次の3つから選びます。
「Yes, and use auto mode」:承認して、自動モードで編集を始める(自動モードが使えない場合は「Yes, auto-accept edits」と出る)
「Yes, manually approve edits」:承認して、編集を1つずつ確かめながら進める
「No, keep planning」:Plan Modeのまま、直してほしい点を伝える
計画の文を直したいときは、Ctrl+Gでテキストエディタに開けます。
当社では、慣れるまでは「Yes, manually approve edits」を選び、編集の中身まで確かめる進め方をすすめています。

Plan Modeの間も、PreToolUseのhookは動きます。
ただ、公式のガイドには、計画の承認をhookで自動にする例も載っています。
人が計画を読むためのPlan Modeなので、当社ではこの自動の承認は入れません。
会社で配るときの置き場所と管理設定
hooksは、どの設定ファイルに書くかで、届く範囲が変わります。
自分の設定は自分のすべてのプロジェクト、プロジェクトの設定はリポジトリに入れればチームに届きます。
管理者が配る管理設定は、組織全体に届きます。
当社では、会社として止めたい操作は、管理設定のhooksとして配る形をすすめています。
管理設定は、claude.aiの管理コンソールやMDMなどで配り、利用者の設定では上書きできません。

管理者が「allowManagedHooksOnly」を使うと、管理設定のhooksだけが動き、利用者やプロジェクトのhooksは動きません。
確認を飛ばすモードは、管理設定の「disableBypassPermissionsMode」で使えなくできます。
もう1つ気をつけたいのが、hooksそのものの安全です。
公式は、コマンドのhookは利用者の権限のすべてで動き、その人が触れるファイルは変更も削除もできると注意しています。
配る前に、hookのコマンドを読み、試してから入れます。
会社で止めたい操作は、管理設定と会社の契約のアカウントをそろえたうえで配ります。
hooksとPlan Modeを組み合わせた進め方の例
社内に配るときの進め方を、当社の例として挙げます。
順番や期間は、会社の状況に合わせて変えて構いません。

配る前:止める操作を決め、管理設定のhooksと、確認を飛ばすモードを使えなくする設定を配る
使い始め:ファイルをいくつも直す作業は、Plan Modeで計画を出させてから始める
2〜3週間後:コマンドの記録を見て、止める対象と、確認なしで任せる操作を見直す
「計画を毎回読むのは手間では?」という声には、小さな直しはPlan Modeを使わなくてよい、と線を引いておきます。
つまり、Plan Modeは作業の大きさで使い分け、hooksはどの作業でも同じように動かします。
AIに任せる操作を3つの層に分ける考え方は、AIエージェントの権限管理。禁止・要承認・信頼範囲の3層で決めるにまとめています。
社内ルールの整え方はAIの社内ルールが整っていないのページにあります。
Claudeを組織に入れるときの考え方は、Claudeを業務で使う。Geminiとの使い分けと、組織に入れるときの考え方が土台になります。
hooksで止める操作を一緒に決めるAI活用の伴走支援
どの操作をhooksで止め、どの作業でPlan Modeを使うかを決めるところから、私たちのAI活用の伴走支援で一緒に進められます。
月2回の定例とチャットで相談しながら社内で進めるAIコンサルティングと、社内の会議にも入るAI伴走支援の2つの形があります。
AI伴走支援では、研修やツールづくりまで一緒に手を動かします。
研修だけ、ガイドラインだけといった一部からのご依頼も受けています。
料金は月額プランと成果報酬プランがあり、Gemini・Claude・Copilotのどれを使っている会社でも進められます。
Claude Codeのhooksは止める操作を仕組みで決める設定
Claude Codeのhooksを使うと、守りたいファイルの編集や危ないコマンドを、AIの判断に任せずに止め、記録に残せます。
名前で決まる禁止は権限の設定、中身を見て止める操作と記録はhooks、大きな作業の前の確認はPlan Mode、と役割を分けて配ります。
参照した情報(2026年11月11日に確認)
すぐ使える業務アプリが300以上
開いてそのまま使えて、AIで自社用にも直せます。15の分野から、やりたい作業で探せます。業務アプリを見る
執筆:寺田昇平
AI Portalize株式会社 代表取締役/AI Digital Community 代表理事
仕組みとコンサルティング伴走支援の両面で、組織のAI活用の加速を支援。
お知らせ・組織AI推進ノウハウ一覧












