AIへの指示が途中で無視される？Hook機能で解決する方法

AI入門

AIへの指示が途中から守られなくなる、って経験ありませんか？

「AIにちゃんとルールを伝えたのに、なんか途中から言うこと聞かなくなった…」って感じたことありませんか？これ、あなたのやり方が悪いわけじゃないんですよ。実はAIツールには「会話が長くなるとルールを忘れてしまう」という弱点があるんです。今回はその問題をサクッと解決する方法をご紹介します！

「CLAUDE.md」と「Hook」って何なの？

まずCLAUDE.md（クロード・エムディー）というのは、AIへの「指示書ファイル」のことなんです。「このプロジェクトではこのルールを守ってね」と書き込んでおく、いわばAIへの就業規則みたいなものですね。

ただこの指示書、会話が5回・10回と続くうちに、AIが少しずつ内容を忘れていっちゃうんです。エラーも出さずに静かにルールを破り始めるのが困りポイントで。

そこで登場するのがHook（フック）です。Hookは「AIが特定の作業をしようとした瞬間に自動で動くチェック機能」のことなんですよ。指示書が「お願い」なら、Hookは「強制」できる仕組みってイメージです。

💡 初心者メモ: CLAUDE.mdを「入社時に渡すマニュアル」とすると、Hookは「危ない作業の前に自動で鳴るアラーム」です。マニュアルを読み忘れても、アラームは必ず鳴りますよね。そのイメージです！

何が嬉しいの？メリット3つ

① うっかりミスを自動で防いでくれる

たとえばAIが「重要なファイルをまとめて削除するコマンド」を実行しようとしたとき、Hookが自動でストップをかけてくれるんです。会社で言えば、重要書類をシュレッダーにかける前に「本当に捨てていいですか？」と確認してくれる優秀な秘書みたいな存在ですね。

② ファイルを保存するたびに自動で整える

AIがコードを書いたあとに、自動で見やすく整形（フォーマット）してくれる設定もできるんです。毎回「きれいにして」と頼まなくてよくなるので、かなりラクになりますよ。提出書類を出したら自動でレイアウトが整う、みたいなイメージです。

③ 作業の開始・終了時に自動でチェックしてくれる

AIとの作業セッション（作業の一区切り）が始まるとき、必要な環境が整っているかを自動確認してくれます。現場に入る前に持ち物チェックを自動でやってくれる、そんなイメージですね。

どうやって始めればいいの？

実際の設定はちょっと技術的な話になるので、ここでは「何をどの順番で準備するか」をわかりやすくお伝えしますね。

ステップ1: 指示書（CLAUDE.md）を正しく書く

まずAIへの指示書を作るんですが、書き方にコツがあります。「良いコードを書いてください」みたいなふんわりした内容はNGです。AIはそんなこと最初から知っているので、書いても意味がないんですよ。

代わりに書くべきなのは、あなたのプロジェクトだけの特別なルールです。たとえば「このサービスでは記事を自動公開しない。必ず下書き保存にする」みたいな具体的なルールですね。また、ルールは多すぎるとAIが混乱するので、絶対に守らせたいルールは5個以内に絞るのがポイントです。

💡 初心者メモ: ルールは「〜しない」という否定形で書くと伝わりやすいです。「良い処理をする」より「この古い方法は使わない」の方が、誰が読んでも同じ意味になりますよね。

ステップ2: Hookの設定ファイルを用意する

Hookの設定は、プロジェクトフォルダの中に「.claude」というフォルダを作って、その中にsettings.json（セッティングス・ジェイソン）というファイルを置くことで動きます。設定ファイル（settings.json）は、AIへの「動作ルール集」を記録したメモみたいなものですね。

ステップ3: どのタイミングで何をチェックするか決める

Hookには「いつ動くか」を指定できる5種類のタイミングがあります。

  • PreToolUse（プリ・ツール・ユーズ）: AIが何か作業をする前に動く → 危険な操作をブロックするのに使う
  • PostToolUse（ポスト・ツール・ユーズ）: AIが作業した後に動く → 自動で整形・テストするのに使う
  • SessionStart（セッション・スタート）: 作業開始時に動く → 環境チェックに使う
  • SessionEnd（セッション・エンド）: 作業終了時に動く → 記録の保存に使う
  • Notification（ノーティフィケーション）: 通知が来たときに動く → SlackやDiscordと連携するのに使う
💡 初心者メモ: 最初はPreToolUse（作業前チェック）とPostToolUse（作業後の自動処理）の2つだけ覚えておけば十分ですよ！この2つを使いこなすだけで、かなり快適になります。

ステップ4: 実際に動くか確認する

設定したら、わざと危険な操作をAIにお願いして、ちゃんとブロックされるかテストしてみましょう。実際の本番データではなく、テスト用の環境で確認するのがおすすめです。

ここだけ気をつけて！

⚠ 注意: Hookの設定が間違っていると、AIが何も作業できなくなってしまうことがあります。設定は少しずつ追加して、そのたびに動作確認するのが安全です。一気に全部設定しようとしないでくださいね。
⚠ 注意: 指示書（CLAUDE.md）は長くなりすぎると逆効果です。100〜200行くらいが理想で、それ以上になると重要なルールが埋もれてしまいます。「本当に大事なことだけ」を厳選して書きましょう。
⚠ 注意: HookはAIへの「強制力」があるぶん、設定内容は慎重に決めてください。たとえば「特定の操作を全部ブロック」と設定すると、本来必要な作業まで止まってしまうこともあります。

今日のポイントまとめ

  • 📄 CLAUDE.md（指示書ファイル）は会話が長くなるとAIが忘れてしまう。これは仕様で、あなたのせいじゃない！
  • 🔒 Hook（自動チェック機能）を使えば、ルールを「お願い」から「強制」に格上げできる
  • ✏️ 指示書にはあなたのプロジェクト固有のルールだけを5個以内で書くのが効果的

もっと詳しく知りたい方はこちら

この記事の元になった詳細版をnoteで公開しています。
コード例・設定ファイル・応用テクニックなど、実践的な内容が満載です。

noteで詳細記事を読む

Powered by 侍AI道場 (CCI)

PR

Claude Codeと一緒にPythonも学ぶなら

「Python1年生 第2版」は8万部超のベストセラー。キャラクターとの会話形式でPythonの基礎をやさしく学べます。Claude Codeと組み合わせることで学習効率が大幅に上がります。

▶ Amazonで詳細を見る

Photo by Igor Omilaev on Unsplash

コメント

タイトルとURLをコピーしました