【Claude Code】誤削除・誤送信をHooksで物理ブロックする設定術

AIに仕事を任せるほど、事故の不安も大きくなる

Claude CodeのようなAIコーディングエージェントは、ファイル整理やデータ集計、コマンド実行まで自律的にこなしてくれます。便利な一方で「勝手に大事なファイルを消されたらどうしよう」「誤って外部にデータを送信されたら」という不安を抱く方は多いはずです。

ここで多くの人がやりがちなのが、プロンプトで「削除しないでください」とお願いする運用です。しかし会話が長くなるとAIの注意力が薄れ、指示が形骸化してしまう可能性があります。お願いベースの運用には限界があるのです。

安全に運用するための鉄則は、プロンプトでお願いするのではなく、システム側で物理的に処理を止めることです。Claude Codeには「Hooks」という仕組みがあり、これを使うと危険なコマンドの実行そのものをブロックできます。今回はこのHooksを使った安全ガードの作り方を、非エンジニアの方でも設定できるレベルまで具体的に解説します。

なお、Claude Codeを利用するにはProプラン（月額20ドル）、Maxプラン（月額100〜200ドル）、Teamプラン（1席あたり月額25ドル〜）、Enterpriseプラン、またはAPI従量課金のいずれかの契約が必要です。Freeプランではターミナル上でのClaude Code自体が利用できない点は事前に確認しておいてください。

Hooksの仕組み　AIがコマンドを実行する「直前」に割り込む

Hooksの中核となるのが「PreToolUse」というフックです。これはAIがBashコマンドなどのツールを実行しようとした瞬間に、あらかじめ登録した安全チェック処理を割り込ませる仕組みです。

チェック処理は「終了コード（Exit Code）」という数値でClaude Codeに結果を伝えます。この数値の意味を正しく理解しておくことが、事故を防ぐ最大のポイントです。

📌 終了コードと挙動の違い

・exit 0（成功）　ツールの実行がそのまま許可される
・exit 2（物理ブロック）　ツールの実行が強制的に中断される。標準エラー出力の内容はAI自身へのフィードバックとして返される
・exit 1やその他の数値　エラーメッセージは表示されるが、処理自体は止まらず進んでしまう（Non-blocking扱い）

ここでよくある誤解が「エラーを出せば止まるはず」という思い込みです。通常のプログラミングでは exit 1 がエラーの合図として使われることが多いため、つい exit 1 を書いてしまいがちですが、Claude Codeの仕様では exit 1 は警告止まりで処理が進行してしまいます。危険な操作を確実に止めたいなら、exit 2 を指定することが実務上の絶対条件です。

実装は3ステップ　設定ファイル1つで完結させる

Hooksの設定は、外部にプログラムファイルを作らなくても、設定ファイル1つの中に直接チェック処理を書き込むことで完結させられます。プログラミング初心者ほど、この「インライン方式」で始めるのがおすすめです。

1．プロジェクトのフォルダ内に「.claude」フォルダを作り、その中に「settings.json」というファイルを用意する
2．settings.jsonの中に、PreToolUseフックの設定として「Bash実行時に危険なキーワードを検知する処理」を記述する
3．危険なキーワード（削除コマンドや強制送信コマンドなど）を検知した場合は、標準エラー出力にメッセージを表示したうえで exit 2 を返すよう条件を書く

この設定は、配置したプロジェクトフォルダの中だけで有効になります。複数のプロジェクトやPC全体に同じ安全ガードをかけたい場合は、ホームディレクトリ配下の「～/.claude/settings.json」に同じ内容を配置すると、どのフォルダで作業していても適用されます。またすでに同じ場所にsettings.jsonが存在する場合、ファイルを丸ごと置き換えてしまうと既存の設定が消えてしまいます。既存のJSONを開き、「hooks」の項目だけを追記する形でマージするようにしてください。

手動でJSONファイルを編集すると、ダブルクォーテーションの閉じ忘れやカンマの付け忘れといった些細なミスでフック全体が無効になることがあります。ターミナル上で「/hooks」と入力すると、登録済みのフックの一覧確認や有効化・無効化、簡単な動作テストができます。ただしこのコマンドは複雑な条件式そのものを対話的に組み立ててくれるわけではないので、settings.jsonの記述自体はエディタで丁寧に確認しながら行い、登録後の動作確認に「/hooks」を使うという役割分担で考えるとよいでしょう。

以下は、削除コマンドや強制プッシュ、外部への送信コマンドを検知した瞬間に処理を止める、最小構成の設定例です。外部スクリプトを別途作る必要がなく、このJSONをそのまま保存するだけで動作します。

📋 ここからコピペ

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "input=$(cat); if echo \"$input\" | grep -iE \"rm -rf|git push --force|curl\"; then echo \"[安全ガード] 破壊的コマンドまたは外部送信は禁止されています\" >&2; exit 2; fi"
          }
        ]
      }
    ]
  }
}

この設定を入れておくと、AIが「rm -rf」のような破壊的削除コマンドや「git push --force」といった強制上書き、外部通信を伴う「curl」コマンドを実行しようとした瞬間に処理が中断され、「[安全ガード] 破壊的コマンドまたは外部送信は禁止されています」というメッセージが表示されます。書類作成やデータ集計といった安全な作業はAIに任せたまま、最後の確定作業だけ人間が承認するという運用が実現できます。

なお、この設定例はBash（シェル）の書き方を前提にしているため、Windows環境で試す場合はGit Bashなど、Bashコマンドが実行できる環境を用意しておく必要があります。また文字列の単純一致でキーワードを検知しているため、「rm -r -f」のような表記ゆれや、正常なAPI連携で使う「curl」コマンドまで意図せず検知してしまうことがあります。実際の業務で使うコマンドに合わせて、検知するキーワードは少しずつ調整していくのが安全です。

設定を保存したら、必ず本番運用の前に動作テストをしておきましょう。テスト用の空フォルダを用意し、Claude Codeに「このフォルダの中身をrm -rfで削除して」のように指示してみてください。「[安全ガード]」のメッセージが表示されて処理が止まれば、正しく機能している証拠です。

つまずきやすい3つのポイントと対策

📌 失敗しやすい点と対策

・JSONの構文ミスでフックが起動しない　対策としてエディタで記述を確認したうえで「/hooks」コマンドを使って登録状態を確認する、またはVS Codeなど構文チェック機能付きエディタを利用するのがおすすめ
・外部スクリプトを別ファイルで用意しようとして環境エラーになる　対策として今回紹介したようにsettings.json内で完結するインライン記法を使う
・つい exit 1 を書いてしまい止まらない　対策として「止めるなら exit 2」という数値だけを固定ルールとして覚えておく

特に3つ目は見落としやすい部分です。「設定したはずなのにAIの削除が止まらなかった」という事故の多くは、この終了コードの取り違えが原因です。exit 2 以外は処理を止められないと覚えておくだけで、事故のリスクを大きく減らせます。

ブロックした後、AIは「反省」してやり直す

Hooksでできることは、単に処理を止めるだけではありません。exit 2 で処理を中断させたとき、標準エラー出力に書いたメッセージは、画面に表示される警告文であると同時に、Claude自身への文脈情報としてリアルタイムに渡されます。

そのため、いきなり止められたAIは「なぜ止められたのか」を理解したうえで、削除ではなく安全なバックアップフォルダへの移動を提案するなど、代替手段を自ら考え直して対話を続けることがあります。単なる遮断機能ではなく、AIを安全な方向へ再教育する仕組みとしても活用できるわけです。

なお、誤検知でブロックされてしまった場合や、どうしても人間の判断でその操作を実行したい場合は、AIに再提案させるのではなく、人間が直接ターミナルで該当コマンドを実行する、もしくは一時的にsettings.json内の該当条件をコメントアウトして解除するといった運用にしておくと安全です。解除したままにしないよう、作業後は必ず元の設定に戻すことを忘れないでください。

💡 【何それ!?のAI豆知識】

Hooksで exit 2 によってツールの実行がブロックされたとき、その理由を記した標準エラー出力の内容は、単なる画面表示用のログではありません。Claude Code自身へのフィードバックプロンプトとして文脈に注入される仕様になっています。つまりAIは「怒られた」ことを理解できる形で情報を受け取り、安全な代替案を自分で考え直すのです。止めて終わりではなく、止めた理由まで正確に書いておくことが、AIとの安全な協働を続けるコツになります。

まとめ

AIに仕事を任せて時短効果を得るためには、まず「勝手に危険な操作をされない」という土台が必要です。プロンプトでのお願いではなく、Hooksによるシステム側の物理遮断を組み込むことで、初めて安心してAIに作業を委ねられるようになります。設定はsettings.jsonひとつで完結できるので、今日から試してみてください。

さらに深い実践テンプレートは、有料マガジン『週刊 AI仕事術ラボ』で公開しています。
👉 https://note.com/wise_wolf4411/m/m43c7c6cdad4f 

📚 参考（公式情報）

・Automate actions with hooks：https://docs.anthropic.com/en/docs/claude-code/hooks 
・Hooks reference：https://docs.anthropic.com/en/docs/claude-code/hooks-reference 

#業務効率化 #仕事術 #ClaudeCode #AIガバナンス #セキュリティ #自動化 #DX #時短術 #生成AI