組織のAI活用をAIポータルと伴走支援で加速

Claude Codeのhooksとは。お願いではなく仕組みで止める安全設定の作り方

Claude Codeのhooksとは。お願いではなく仕組みで止める安全設定の作り方

執筆:寺田昇平

AI Portalize株式会社 代表取締役/AI Digital Community 代表理事

仕組みとコンサルティング伴走支援の両面で、組織のAI活用の加速を支援。

Claude Codeのhooksは、ファイルの編集やコマンドの実行の前後に、Claude Codeが必ず動かす、利用者が決めたコマンドです。
危ない操作を止めるなら、操作の直前に呼ばれる「PreToolUse」のhookに、止めたい中身のときだけ終了コード2を返すスクリプトをつなぎます。
AIが指示を守るかどうかに頼らないので、hookが止めた操作は、権限のモードを切り替えても止まったままです。

Claude Codeのhooksで危ない操作を止める流れとして、Claudeがファイルの編集やコマンドの実行を決める、操作が動く前にPreToolUseのhookが必ず呼ばれる、スクリプトがファイル名やコマンドの中身を調べる、終了コード2なら操作が止まり理由がClaudeに返る、の4つを順に示した図

大きな作業では、ここにPlan Mode(計画モード)を組み合わせます。
計画を人が読んで承認するまで編集を始めさせず、承認のあとの操作はhookで見張る形が、当社のおすすめです。

製品の事実は、2026年11月11日にClaude Codeの公式ドキュメントで確かめた内容です。
設定の例は公式ドキュメントの例をそのまま示したもので、手元で動かした結果ではありません。

Claude Codeのhooksで止められる操作の例

公式のガイドには、設定ファイルにそのまま足せる例がいくつか載っています。
社内に配る前に情シスが検討しやすいのは、次の3つです。

  • 守りたいファイルの編集を止める(「.env」「package-lock.json」「.git/」など)

  • 危ないコマンドを止め、実行しようとしたコマンドを記録する(「rm -rf」を含むコマンドなど)

  • 設定ファイルが書き換えられたら記録する(変更そのものを止めることもできる)

止めたときは、スクリプトが書いた理由がClaudeに返ります。
公式の説明では、Claudeはその理由を受け取り、やり方を変えられるとされています。

一方で、操作のあとに動く「PostToolUse」のhookは、すでに動いた操作を取り消せません。
止めたい操作は、必ず動く前の「PreToolUse」で受け止めます。

Claude Codeのhooksの公式の例として、守りたいファイルはPreToolUse(Edit・Write)で.envなどへの編集を止め、危ないコマンドはPreToolUse(Bash)で記録しrm -rfを止め、設定ファイルの変更はConfigChangeで記録する(止めることもできる)ことを比べた図

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です。

当社の分け方として、権限の設定(allow・deny)には名前で決まる許可と禁止を書き、決まった線は公式も権限の設定で引くよう案内していること、hooksには中身を見て止める操作と記録を書き、hookが止めた操作はどの権限モードでも止まることを左右に並べた図

権限の設定の書き方は、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」を選び、編集の中身まで確かめる進め方をすすめています。

Claude CodeのPlan Modeで計画ができたときに選べる3つとして、Yes, and use auto modeは承認して自動モードで編集を始める、Yes, manually approve editsは承認して編集を1つずつ確かめる、No, keep planningは承認せずPlan Modeのまま計画を直すことを示した図

Plan Modeの間も、PreToolUseのhookは動きます。
ただ、公式のガイドには、計画の承認をhookで自動にする例も載っています。
人が計画を読むためのPlan Modeなので、当社ではこの自動の承認は入れません。

会社で配るときの置き場所と管理設定

hooksは、どの設定ファイルに書くかで、届く範囲が変わります。
自分の設定は自分のすべてのプロジェクト、プロジェクトの設定はリポジトリに入れればチームに届きます。
管理者が配る管理設定は、組織全体に届きます。

当社では、会社として止めたい操作は、管理設定のhooksとして配る形をすすめています。
管理設定は、claude.aiの管理コンソールやMDMなどで配り、利用者の設定では上書きできません。

hooksを書く設定ファイルと届く範囲の対応として、~/.claude/settings.jsonはそのパソコンの自分のすべてのプロジェクト、.claude/settings.jsonは1つのプロジェクトでリポジトリに入れればチームで共有、.claude/settings.local.jsonは1つのプロジェクトの自分だけ、管理者が配る管理設定は組織全体で利用者の設定では上書きできないことを並べた図

管理者が「allowManagedHooksOnly」を使うと、管理設定のhooksだけが動き、利用者やプロジェクトのhooksは動きません。
確認を飛ばすモードは、管理設定の「disableBypassPermissionsMode」で使えなくできます。

もう1つ気をつけたいのが、hooksそのものの安全です。
公式は、コマンドのhookは利用者の権限のすべてで動き、その人が触れるファイルは変更も削除もできると注意しています。
配る前に、hookのコマンドを読み、試してから入れます。

会社で止めたい操作は、管理設定と会社の契約のアカウントをそろえたうえで配ります。

hooksとPlan Modeを組み合わせた進め方の例

社内に配るときの進め方を、当社の例として挙げます。
順番や期間は、会社の状況に合わせて変えて構いません。

hooksとPlan Modeを組み合わせて社内に配る進め方の例として、配る前に止める操作を決めて管理設定でhooksを配り、使い始めは大きな作業をPlan Modeで計画を出してから始めて小さな直しはそのまま進め、2〜3週間後に情シスがコマンドの記録を見て止める対象を見直す流れを示した図

  • 配る前:止める操作を決め、管理設定の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活用の加速を支援。

keyboard_backspace

お知らせ・組織AI推進ノウハウ一覧

無料 自社に当てはめて知りたい方へ

読んだ内容を、

御社の数字

で確かめませんか。

利用データから、御社のAI活用がいまどこにいるのかを判定します。
同業他社との比較と、次にやることをお渡しします。

組織のAI活用力診断のメインビジュアル(ノートPCの利用データと結果表)

Related

関連記事

Service

サービス一覧

AI Portalizeの管理画面イメージ:AI活用数・効率化時間の見える化とチームへの広がり

AIツールが見つかる。社内に広がる。使われ方が見える。

組織のAIポータル「AI Portalize」

  • check_circle

    やりたいことで検索すると、業務アプリ300以上とナレッジ250本以上から見つかる

    check_circle

    社内で作ったツールやナレッジが共有され、よく使われるものが上に並ぶ

    check_circle

    誰が何をどれだけ使っているかが、集計の手間なしで分かる

デジタル系企業特化のAIコンサルティング&伴走支援のイメージイラスト

実務に組み込むまで伴走

組織のAI活用を加速「AIコンサル&伴走支援」

  • check_circle

    従業員が安心して使うためのガイドライン策定

    check_circle

    ドメイン知識が豊富なコンサルタント

    check_circle

    業務分解からAIワークフロー作成

    check_circle

    研修から実務への組み込みまで

法人向けAI研修のイメージ:受講者が自分の業務でAIを使いながら学ぶ研修の様子

自社の業務で、使える知識に

実務で使える知識を「法人向けAI研修」

  • check_circle

    いま使っているAIと受講者の業務を伺って、誰に・どのAIで・どの業務を題材にするかを提案

    check_circle

    Gemini・Claude・AIエージェントなど、8つの研修例と230以上のテーマ例

    check_circle

    基本はオンライン。研修の資料と録画もお渡し

デジタル系企業特化のAIコンサルティング&伴走支援のイメージイラスト

豊富な新規事業立ち上げ実績

AIを活用した
新規事業の立ち上げ支援

  • check_circle

    検討からサービス構築まで

    check_circle

    豊富な新規事業構築実績

    check_circle

    すでにあるAIボットなどを活用も可能

AI活用支援のビフォーアフター:迷っている状態からGemini等を使いこなす状態への変化

経営者・役員・AI担当向け

AIパーソナル
トレーニング

  • check_circle

    まだAI活用できていない状態でも大丈夫

    check_circle

    1回2時間のみからご利用いただけます

    check_circle

    実務で使える「今のAI活用」を学ぶ

    check_circle

    トップ層こそAIに詳しく

AIガイドライン作成+定着研修の紹介バナー:御社に合ったルールづくりから社内への定着まで

生成AIの社内ルールを一緒に作る

AIガイドライン作成+
定着研修

  • check_circle

    御社の現状をヒアリングしながら一緒に作成

    check_circle

    AIツールごとの仕組みや契約の違いを踏まえて線を引く

    check_circle

    従業員の方への定着研修までご支援

AIガイドライン作成+定着研修の紹介バナー:御社に合ったルールづくりから社内への定着まで

AIの答えに、自社の名前を

LLMO・GEO・AIO
対策

  • check_circle

    御社の現状をヒアリングしながら一緒に作成

    check_circle

    AIツールごとの仕組みや契約の違いを踏まえて線を引く

    check_circle

    従業員の方への定着研修までご支援

まずは、いまのAI活用の
状況をお聞かせください。

何から始めるか決まっていなくても、ご相談いただけます。

無料相談・お問い合わせ