Claude Codeが言うことを聞かない時の直し方|CLAUDE.md・hooks・スキル
この記事は約38分で読めますこの記事の目次
- Claude Codeが言うことを聞かない時に最初に見る症状別の対応表
- Claude CodeがCLAUDE.mdを無視するのはなぜ?
- CLAUDE.mdは何行まで?長いと指示を守らないのは本当?
- CLAUDE.md・スキル・hooks・サブエージェントはどう使い分ける?
- 2回間違えたらCLAUDE.md、3回貼ったらスキルに移す
- Claude Codeが言うことを聞かない操作はhooksで止められる?
- hooksを設定したのに動かないのはなぜ?ファイル名・stdin・相対パス
- 私の設定を2026年10月17日に数え直した結果
- 指示書を読み飛ばすならスキルに切り出す
- 記事の話をしたらエージェントを起こすフックを足した理由
- サブエージェントに任せると指示に従うようになる?
- 「完了しました」なのにやっていない時は検証を挟む
- 同じ間違いが戻ってくる時は記録を次に持ち越す
- 勝手に削除・勝手にpushが怖い時は権限の設定を見る
- 言うことを聞かせようとして逆効果だったこと
- 非エンジニアが最初にやる順番
- それでもClaude Codeが言うことを聞かない時の相談先
- よくある質問
- まとめ|Claude Codeが言うことを聞かない時は仕組みに移して直す
※当サイトにはアフィリエイト広告が含まれます。本記事の本文にアフィリエイトリンクはありませんが、筆者が運営する点検室と相談サービス、有料note、公式LINEの案内を含みます。記事の前後には、サイト共通の広告(アフィリエイト広告を含む)が表示されます。
CLAUDE.mdに書いたのに、Claude Codeが言うことを聞かない。理由も自分では調べられない。そんな日が続いていませんか。
この記事の結論
Claude Codeが言うことを聞かない時は、CLAUDE.mdへの書き足しをやめ、守らせたい強さに合わせて仕組みへ移すと直ります。毎回必ず止めたい操作はhooks、長い手順はスキル、別の文脈で調べさせたい作業はサブエージェントに任せます。公式ドキュメントも、CLAUDE.mdは強制される設定ではないと明記しています。
同じ悩みを書いた人の言葉を、そのまま引きます。
同じ注意を3回書き直して、3回とも違う形で無視される。 私はここで2週間ほど止まりました。(中略)コードが読めないので、無視された理由を自分で調べる手段もありませんでした。
note(aporon_ro)
同じ注意を何度も書き足した人。書いた日は守られたのに、数日後に元へ戻った人。
CLAUDE.mdを開くこと自体が怖くなった人もいるはずです。どれか1つに覚えがあるなら、この先はあなたの話として読めます。
私も同じ所で止まりました。守らせるつもりで入れたフック(決まった操作の前後で自動に動く小さなプログラム)が、2026年9月5日から19日まで一度も動いていなかったのです。
原因は2つ。どちらもコードが読めなくても確かめられるもので、中盤の章で手順ごと書きます。
先に公式の一文を置いておきます。Anthropicが提供するClaude Codeの公式ドキュメントは、CLAUDE.mdについて次のように書いています。
Claude はこれらをコンテキストとして扱い、強制的な設定ではありません。アクションをブロックするには、Claude の判断に関わらず PreToolUse hook を使用してください。
Claude Code公式ドキュメント(メモリ)
だから、書き足すより仕組みで守らせる。Claude Codeが指示を守らない問題は、文章を磨くより置き場所を変えたほうが早く片づきます。ここから、その置き場所の選び方を症状別に見ていきます。
Claude Codeが言うことを聞かない時に最初に見る症状別の対応表
Claude Codeが言うことを聞かない時は、まず症状を1つ選び、それを直す仕組みを下の表から引いてください。症状ごとに効く場所が違います。全部をCLAUDE.mdで直そうとすると、書く量だけ増えて守られる量は増えません。
表の3列目は、私の環境で実際に壊れていた所です。2026年9月から10月にかけて、自分の設定を直しながら書き留めた事実だけを入れました。

| 症状 | 直した仕組み | 私の環境で壊れていた点 |
|---|---|---|
| CLAUDE.mdが無視される | 毎回読ませる量を減らし、必要な時だけ読むルールに分ける | ルール置き場のバックアップ11本(付与前62,183バイト)が毎回読み込まれていた |
| 禁止した操作をやる(勝手に削除、勝手にpush) | permissionsの拒否ルールと、操作前に止めるフック | プロジェクト設定の拒否ルールは0行のまま(2026-10-17時点) |
| 書いた後の検査を飛ばす | 書き込みの直後に動くフック | ファイル名の指定ミスと入力の読み違いで、約2週間一度も動いていなかった |
| 指示書を読み飛ばす | 手順をスキルに切り出す | 記事の手順をCLAUDE.mdに書いていた。今はスキル2つ、配下14ファイルに分けている |
| 記事の話なのに担当エージェントを起こさない | 依頼を送った瞬間に動くフック | 2026-10-07まで仕組みが無く、毎回自分で頼み直していた |
| 「完了しました」と言ってやっていない | 結果を機械で確かめる工程を挟む | 実録はClaude Codeで保存されない時の確かめ方に書いた |
| 同じミスが戻ってくる | 学び帳で次の起動に持ち越す | 実録はClaude Codeの同じミス対策に書いた |
| 逆に、毎回許可を聞いてくる | 許可を出す範囲を設定で決める | 実録はClaude Codeが毎回聞いてくる時の設定に書いた |
表の読み方は「どこで止めたいか」で決める
表を引くときは、止めたいタイミングを先に決めます。操作の前に止めたいのか、書いた後で気づければよいのか。前なら権限かフック、後なら検査のフック、そもそも手順を守らせたいならスキルです。
症状が2つ重なる時は、強いほうから直す
削除やpushのように取り返しがつかない症状と、書式の乱れが同時に出ることもあります。その場合は取り返しがつかないほうを先に仕組みで止めてください。書式は後からでも直せますが、消えたファイルは戻りません。
表の中で、私が一番長く気づかなかったのは3行目でした。検査のつもりで入れたフックが走っていない状態は、画面に何も出ないので本当に気づけません。中身はhooksの章で開けます。
Claude CodeがCLAUDE.mdを無視するのはなぜ?
Claude CodeがCLAUDE.mdを無視する一番の理由は、CLAUDE.mdが命令として実行されるものとは扱われず、作業の前に読む参考資料として扱われるからです。参考資料なので、その場の判断で優先度が下がることがあります。公式もこの点をはっきり書いています。
CLAUDE.mdは、Claude Codeがセッションの始めに読む参考資料で、守らせる強制力はありません。冒頭で引いた公式の一文のとおり、必ず止めたい操作があるなら、Claudeの判断に関わらず動くフックを使うよう案内されています。
読者が実際に困っていた場面
CLAUDE.mdが無視されるという声は、書いた内容の良し悪しより、時間がたつと効かなくなる話が多く見つかります。記録を残す指示について、次のように書いた人がいました。
作業の終わりに記録を残してほしいとずっと指示書に書いてたんですよ。 しばらくはうまくいってたんですが、また書かれなくなって。
chi3のSubstack
書いた日は守られ、しばらくすると戻る。これは参考資料として読まれている証拠です。命令ならずっと同じように動くはずですが、参考資料は会話の流れの中で後回しにされます。
CLAUDE.mdの先頭を消したら無視が増えた例
逆に、書き方を変えたことで無視が増えた例もあります。Qiitaに、CLAUDE.mdの先頭にあった定型の部分を消したところ、無視が増えたという報告が載っています。
当初、この先頭部分を不要だと思い削除していました。しかし、CLAUDE.mdを無視することが増えました。
Qiita(godhexagon)
書いてある内容が同じでも、置き方1つで読まれ方が変わる。だからCLAUDE.mdが無視される時に最初に疑うのは、書いた文の強さより、読ませている量と置き場所です。量の話は次の章で数字を出します。
私の環境で無視されていた理由
私の場合、指示に従わない原因は書き方より量でした。毎回読み込まれるルールが膨らみ、その中に読ませるつもりのない古いファイルまで混ざっていたのです。書き足すたびに守られなくなる時は、足し算をやめて引き算から始めてください。
CLAUDE.mdは何行まで?長いと指示を守らないのは本当?
本当です。Claude Codeが言うことを聞かない時に、まず疑うのがCLAUDE.mdの長さです。
公式ドキュメントは、CLAUDE.mdを1ファイル200行以下に収めるよう目標を示し、長いファイルほど守られにくくなると書いています。行数を減らすことは、そのまま指示を守らせる対策になります。
CLAUDE.md ファイルあたり 200 行以下を目標にしてください。より長いファイルはより多くのコンテキストを消費し、遵守を減らします。
Claude Code公式ドキュメント(メモリ)
同じページには、自動で記録されるメモリの索引ファイル(MEMORY.md)は先頭200行か25KBまでが読み込まれる、とも書かれています。さらに、paths(このファイルを触った時だけ読む、という指定)を付けたルールは、該当するファイルを読む、書く、編集する時にだけ読み込まれます。
私は毎回62,183バイトのバックアップを読ませていた
2026年9月19日、私はルール置き場の11本、62,183バイトを、pathsで絞り込みました。常時読ませるのは4本、6,414バイトだけ。残りは記事を書く時など、必要な時だけ読む形にしています。
ところが6日後の9月25日、会話の文脈がすぐ埋まる症状が続き、原因を探すとルール置き場の中に作ったバックアップのフォルダが見つかりました。絞り込む前のルール11本を丸ごと複製したもので、付与前の合計は62,183バイト。フロントマター(ファイル先頭の設定欄)が無いため、毎回全部読み込まれていたのです。
つまり、削った分とほぼ同じ量を、自分で作った安全策が足し戻していました。バックアップ11本にもpathsを付けて読み込みを止め、症状は解消しています。何回減ったかの記録は残していないので、数字は書けません。
2026年10月17日時点の常時オンは5本・8,803バイト
この記事を書く日に数え直すと、常時読まれるルールは5本、8,803バイトでした。9月19日の4本に、目標を書いたmission.mdを1本足したためです。
内訳は1,835、2,519、1,205、1,920、1,324バイト。1本あたり3,000バイトを超えるものはありません。
CLAUDE.mdを短く保つコツは、毎回必要な事実だけを残し、作業ごとの手順は別のファイルへ出すことです。ルール置き場にはバックアップを置かない。複製するなら、読み込まれない場所へ移してください。
CLAUDE.md・スキル・hooks・サブエージェントはどう使い分ける?
CLAUDE.md・スキル・hooks・サブエージェントの使い分けは、守らせたい強さと、読み込まれるタイミングで決めます。毎回知っておいてほしい事実はCLAUDE.md、時々使う長い手順はスキル、必ず起きてほしい処理はhooks、本筋と切り離して調べさせたい作業はサブエージェントです。
公式の機能概要ページと各機能のページから、4つの定義を1つの表にまとめました。表の右端は、私の環境で実際に置いているものです。
| 仕組み | 読み込まれるタイミング | 守らせる強さ | 私の環境で置いているもの |
|---|---|---|---|
| CLAUDE.md | セッションの始めに毎回 | 参考資料。強制力なし | サイトの基本情報と絶対ルール |
| スキル | 説明文だけ毎回。本体は使う時に読む | 呼ばれれば手順どおり進みやすい | 記事作成の手順と、企画の壁打ち |
| hooks | 決めた操作の前後に必ず | Claudeの判断に関わらず動く | 書いた記事の検査、担当エージェントの呼び出し |
| サブエージェント | 呼ばれた時に、新しい文脈で | 本筋の会話に引きずられない | 調査、執筆、監査などの担当21体 |

hooksだけは文脈を食わない
公式の機能概要ページでは、フックが会話の文脈に与える負担は「フックが出力を返さない限りゼロ」と説明されています。CLAUDE.mdやスキルの説明文は毎回読まれて文脈を使いますが、フックは何も言わない限り場所を取りません。守らせたいことを増やしても、CLAUDE.mdのように長くならないのが利点です。
hooksの性格を表す一文を、公式のガイドから引いておきます。
決定論的な制御を提供します。LLM が実行を選択するのに依存するのではなく、特定のアクションが常に発生します
Claude Code公式ドキュメント(フックガイド)
迷った時は「Claudeの判断に任せてよいか」で決める
4つで迷ったら、その指示をClaudeの判断に任せてよいかを自分に聞いてください。任せてよいならCLAUDE.mdかスキル。
任せたくないならhooksか権限の設定です。この1問で、4つの候補が2つに絞れます。残りは手順の長さで、スキルにするかどうかを決めます。
2回間違えたらCLAUDE.md、3回貼ったらスキルに移す
CLAUDE.mdに書くか、スキルに移すかの境目は、公式の機能概要ページに目安があります。同じ間違いを2回されたらCLAUDE.mdに書く。
同じ説明を3回目に貼りそうになったら、それはスキルにする合図です。回数で決めると、書くかどうかで迷う時間がなくなります。
スキルのページには、もう1つの判断基準が書かれています。
CLAUDE.md のセクションが事実ではなく手順に成長している場合は、スキルを作成してください
Claude Code公式ドキュメント(スキル)
同じ指示を11回出した人の記録
回数で区切らないと、指示は際限なく繰り返されます。noteに、同じ指示の回数を数えた人がいました。
私はこの指示を、過去に11回出しました。
note(kawaidesign)
11回は、公式の目安の3回を大きく超えています。3回目の時点でスキルに移していれば、残りの8回は打たずに済んだ計算です。打ち込みが3回を超えた指示は、文章の問題ではなく置き場所の問題だと考えてください。
CLAUDE.mdに残すのは「事実」だけ
私のCLAUDE.mdに残しているのは、サイト名、テーマ、文体、対象クラスター、絶対ルールなどの事実です。記事の書き方のように何段にもなる手順は、すべて外へ出しました。
事実は短く、手順は長くなるもの。短いものだけ残せば、200行の目安は自然に守れます。
同じ間違いを次の起動に持ち越させる学び帳と、CLAUDE.mdとの違いはClaude Codeの同じミスを止めた学び帳の型にまとめています。ここでは、2回でCLAUDE.md、3回でスキルという回数の基準だけ持ち帰ってください。
Claude Codeが言うことを聞かない操作はhooksで止められる?
止められます。Claude Codeが言うことを聞かない操作のうち、実行される前に止めたいものは、PreToolUse(ツールを使う直前)のフックで止めるのが公式の案内です。フックが終了コード2で終わると、その操作は実行されず、エラー出力の文がClaudeへの理由として返ります。
公式の機能概要ページは、CLAUDE.mdに「.env を編集しないでください」と書くことを、要求であって保証ではない例として挙げています。.env(パスワードや鍵を書いておくファイル)を本当に守りたいなら、文章で頼むのをやめて仕組みで止める。これがフックの使いどころです。
止めるフックと、後から知らせるフック
フックには動くタイミングが何種類もあります。よく使うのは次の4つです。
- SessionStart。セッションを始めた時に動く
- UserPromptSubmit。依頼を送った瞬間に動く
- PreToolUse。ツールを使う直前に動き、止めることもできる
- PostToolUse。ツールを使った直後に動く。操作の取り消しはできない
大事なのは最後の1つです。PostToolUseは、書き込みが終わった後に動くので、書いた内容を元に戻すことはできません。
できるのは、問題を見つけてClaudeに知らせることまで。消されて困る操作は、必ずPreToolUseか権限の設定で前に止めてください。
私のフックは「書いた直後に検査する」型
私が使っているのは、記事のファイルを書いたり編集したりした直後に、文章の癖を機械で検査するフックです。違反があった時だけ結果を表示し、何も無ければ黙ります。設定の該当部分は次のとおりです。
"PostToolUse": [
{
"matcher": "Write|Edit",
"hooks": [
{
"type": "command",
"command": "python \"$CLAUDE_PROJECT_DIR/.claude/scripts/scan_hook.py\"",
"timeout": 30
}
]
}
]matcherの「Write|Edit」は、書き込みと編集の2つのツールに反応するという指定です。公式ガイドによると、この指定は大文字と小文字を区別します。writeと小文字で書くと、一度も反応しません。
hooksを設定したのに動かないのはなぜ?ファイル名・stdin・相対パス
hooksを設定したのに動かない原因は、私の環境では3つでした。ファイル名の指定の食い違い、入力を読む場所の間違い、作業場所によってスクリプトが見つからないことです。どれも画面には何も出ないので、確かめに行かない限り気づけません。
原因1 ファイル名の指定が1件も一致していなかった
2026年9月19日に直すまで、検査のフックは「記事_」で始まるHTMLファイルだけを対象にしていました。ところが実際の記事ファイルは「スラッグ_wp.html」という名前です。対象の条件に一致するファイルが0件なので、フックは呼ばれても毎回何もせずに終わっていました。
原因2 入力は環境変数でなくstdinのJSONで届く
もう1つは、書き込んだファイルの場所を環境変数から読もうとしていたことです。公式ガイドのとおり、フックへの入力は標準入力(stdin)にJSONで届きます。
中にはセッションのID、作業場所、イベント名、ツール名、ツールに渡した中身が入っています。環境変数を見ても何も入っていないので、ここでも空振りしていました。
この2つが重なり、9月5日から19日まで、検査のフックは一度も動いていませんでした。直した後は、stdinのJSONを最初に読み、念のため環境変数と引数も順に見る形にしています。スクリプトは73行です。
原因3 相対パスだと作業場所で失敗する
9月28日には、作業する場所が.claudeフォルダの中だった時に、フックがスクリプトを見つけられない失敗が出ました。設定に相対パスを書いていたためです。
今は$CLAUDE_PROJECT_DIR(プロジェクトの場所が入る変数)から書く形に直しています。公式ガイドも、コマンドが見つからない時は絶対パスかこの変数を使うよう案内しています。

Windowsで発火を確かめる5つの順番
フックが動いているかは、コードが読めなくても次の順で確かめられます。公式ガイドの手順に、私がWindowsで踏んだ所を足しました。
- Claude Codeの中で /hooks と打ち、設定したフックが一覧に出るかを見る
- matcherの綴りと大文字小文字が、ツール名と完全に一致しているかを見る
- JSONを手で流し込んでスクリプトを動かし、終わった後に終了コードを表示させる
- コマンドのパスを、絶対パスか$CLAUDE_PROJECT_DIRから書いた形に直す
- 日本語が文字化けしていないかを見る
3つ目の手で動かす確認は、公式ガイドの例をそのまま使えます。Git Bashなら次の2行です。
echo '{"tool_name":"Bash","tool_input":{"command":"ls"}}' | ./my-hook.sh
echo $?5つ目はWindowsならではの落とし穴です。Windowsの標準の文字コードはcp932なので、Pythonで書いたフックが日本語を受け取ると、文字化けして判定が外れることがあります。
私のスクリプトは、入力をUTF-8で読み、検査を呼ぶ時もUTF-8で出すよう指定して直しました。それでも分からない時は、claude –debug で起動すると、フックが呼ばれたかどうかが記録に出ます。
検査のつもりのフックが走っていなかった話は、Claude CodeでAI社員を作った記録にも別の角度から書いています。担当を何体も動かしている人は、あわせて確かめてみてください。
フックを入れたのに動いているか分からない方へ
動いていない仕組みは、作った本人ほど気づきにくいものです。進め方は2通りあります。
作ってほしい方
30分の無料相談
今の業務やシステムのどこから作り直すかを、一緒に整理します。見積もりは内容を伺ってからお出しし、頼むかどうかはそのあとで決めていただけます。無理な営業はしません。
無料相談の内容を見る自分でAIに作らせたい方
AIつまずき相談 90分(16,500円・税込)
画面を共有して、あなたのフックや設定が本当に動いているかを一緒に確かめます。どこで止まっているかを洗い出し、録画と手順メモをお渡しします。
90分相談の内容を見る私の設定を2026年10月17日に数え直した結果
この記事を書いた2026年10月17日に、自分のClaude Codeの設定を数え直しました。ファイルの数と大きさは、コマンドで1本ずつ測った値です。Claude Codeが言うことを聞かない時のために、何をどれだけ置いているかをそのまま並べます。
| 置いているもの | 2026-10-17の実測 | 役割 |
|---|---|---|
| ルール置き場 | 14本、合計72,332バイト | 文体、検索対策、収益設計などの決まりごと |
| うち常時読まれるもの | 5本、8,803バイト | 毎回必要な最低限のルール |
| うちpaths付き | 9本 | 該当する作業の時だけ読む |
| フック | 4つ | 起動時の案内2つ、書いた後の検査1つ、依頼時の呼び出し1つ |
| フック用のスクリプト | 検査73行、呼び出し47行 | Pythonで書いた小さなプログラム |
| サブエージェント | 21体、すべてmodel: opus | 調査、執筆、監査、Threads反映など |
| スキル | 2つ、配下14ファイル | 記事作成の手順、企画の壁打ち |
| コマンド | 21本 | よく使う流れを1語で呼ぶ |
| 学び帳 | 17ファイル(書式の説明1つを含む) | エージェントごとの失敗を次へ持ち越す |

数えて見つかった小さなずれ
数え直すと、起動時に表示している案内文が古いままでした。案内では常時オンのルールを4本と表示しますが、実際は5本読まれています。
mission.mdを足した日に、案内文を直し忘れていたのです。動きに害は無いものの、表示を信じていたら気づけないずれでした。
表に無いもの
この表には、守られる率がどれだけ上がったかは入れていません。フックを入れる前後で数えていないからです。
数えていない数字は書きません。言えるのは、どの仕組みを何個置き、どれが壊れていたかまでです。
指示書を読み飛ばすならスキルに切り出す
Claude Codeが言うことを聞かない症状のうち、指示書を読み飛ばして作業を始めるものは、その手順をスキルに切り出してください。スキルは説明文だけが毎回読み込まれ、本体は使う時に読まれます。長い手順をCLAUDE.mdに置くより、必要な時に丸ごと読ませるほうが手順どおりに進みます。
読み飛ばしの悩みは、先ほど引いたSubstackの記事にも出てきます。
指示書を読み飛ばして書き始めることがありました。
chi3のSubstack
スキルは説明文が呼び出しの決め手になる
スキルの説明文は毎回読まれるので、ここに「いつ使うか」を書いておくと、Claudeが自分で呼び出しやすくなります。何をするスキルかより、どんな依頼が来たら使うかを書く。説明文が曖昧だと、本体がどれほど丁寧でも呼ばれません。
私が切り出した2つのスキル
私のスキルは2つです。1つは記事を作る手順で、調査から仕上げまで11の役割に分けた流れをまとめています。
もう1つは企画の壁打ちで、書く前に方針を詰めるための手順です。2つの配下にあるファイルは合わせて14個あります。
どちらも、最初はCLAUDE.mdの中に書いていた手順です。記事のたびに同じ説明を貼るのが手間になり、外へ出しました。今のCLAUDE.mdには、どのスキルを入口にするかを数行書いてあるだけです。
スキルにしても飛ばされる時
スキルも、呼ばれなければ読まれません。必ず通したい手順なら、呼び出し自体をフックで促す手があります。次の章が、私がそれをやった例です。
記事の話をしたらエージェントを起こすフックを足した理由
私は2026年10月7日に、依頼を送った瞬間に動くUserPromptSubmitのフックを1つ足しました。記事やThreadsの話をした時に、担当のエージェントを起こすよう本筋のClaudeに念を押すためです。CLAUDE.mdに書いても守られなかった指示を、送るたびに差し込む形へ移しました。
きっかけは、その日の自分の一言でした。「いつもブログ記事、Threads作成時にエージェント立ち上げされてないから困る」。
CLAUDE.mdには前から、記事の文面は本体で書かず担当に任せると書いていました。それでも本体が自分で書き始めてしまう。典型的な、指示に従わない状態です。
フックの中身は47行
このフックは、送った文に「記事」「ブログ」「リライト」「note」「Threads」「投稿文」「キャプション」などの語が入っているかを見ます。入っていれば、担当のエージェントを起動するよう促す一文を、Claudeが読む文脈に差し込みます。スクリプトは47行です。
ここでもWindowsの文字化けを踏みました。入力をそのまま読むとcp932で解釈され、日本語の語が一致しなくなります。入力をUTF-8として読む1行を足して直しました。
念押しのフックは「止める」とは違う
注意してほしいのは、このフックが操作を止めるものではない点です。差し込むのは念押しの一文なので、最後に従うかどうかはClaudeの判断に残ります。
CLAUDE.mdより毎回目に入る位置に置いただけ、と考えてください。何回発火したかは数えていないので、効き目の数字も書きません。
本当に止めたいなら、PreToolUseで操作の直前に止める。念押しで足りるなら、UserPromptSubmitで差し込む。この2つを混ぜないことが、フックで言うことを聞かせる時の分かれ目です。
サブエージェントに任せると指示に従うようになる?
サブエージェントに任せると、長い会話で薄まった指示の影響は受けにくくなります。公式によると、サブエージェントは新しい、分離された文脈で始まるからです。その代わり、本筋の会話で決めたことは何も引き継がないので、必要な指示はエージェントの定義側に書いておく必要があります。
各サブエージェントは新しい、分離されたコンテキストウィンドウで開始されます。会話履歴、既に呼び出したスキル、または Claude が既に読んだファイルは表示されません
Claude Code公式ドキュメント(サブエージェント)
白紙で始まるのは長所でも短所でもある
白紙で始まるので、本筋で何時間も話した後でも、担当は最初に渡された指示を新鮮なまま読みます。一方で、会話の途中で「この言い方はやめて」と伝えたことは、担当には届きません。伝えたいことは、担当の定義ファイルか、担当を呼ぶ時の依頼文に書き込みます。
私は21体を同じモデルで動かしている
私の環境では、調査、執筆、心理面の手直し、監査などを21体の担当に分けています。2026年10月17日時点で、21体すべての定義がmodel: opusです。担当ごとに読むルールも決めてあり、執筆担当は起動したら文体と検索対策のルールを読むよう定義に書いています。
担当の作り方そのものは、Claude CodeのAI社員の作り方に手順ごとまとめました。ここで押さえたいのは、サブエージェントは指示に従わない問題を魔法のように消すものではない、という点です。白紙の担当に何を書いて渡すかで、結果が決まります。
「完了しました」なのにやっていない時は検証を挟む
Claude Codeが「完了しました」と言ったのに実際はやっていない時は、報告を信じる前に、結果を機械で確かめる工程を挟んでください。完了の報告は、やるつもりだったことの説明で、結果の証明にはなりません。ファイルがあるか、中身が変わったか、テストが通ったかは、コマンドで見れば数秒で分かります。
Zennには、Claude Codeに出した2つの頼みごとを書いた記事があります。mainブランチ(本番用の枝)に直接コミットしないこと。
ビルドが失敗している間は、完了したと報告しないこと。どちらも、言葉で頼むだけでは守られにくい種類の指示です。
出典はZenn(yuta02)の記事です。
検証は、報告と別の道具で行う
確かめる時は、Claudeの報告を読むのではなく、ファイルやコマンドの結果を見ます。私は記事を書かせた後、検査のフックが出す点数と違反の件数を見て、100点でなければ完了と扱いません。報告に「100点でした」と書かれていても、その数字は自分でもう一度出します。
実録は保存されない記事に書いた
「やりました」と言ってファイルが保存されていなかった実録と、その確かめ方は、Claude Codeで保存されない時の確かめ方に書いています。報告の嘘には3つの型があり、それぞれ確かめる場所が違います。
守ったかどうかを機械で確かめる部分は、有料noteで深く掘りました。報告をうのみにしない考え方と、検証スクリプトのひな型、作業を途中で止める方法が入っています。
「完了しました」を確かめる仕組みを作りたい方へ
完了報告が結果の証明にならない理由と、検証スクリプトのひな型、暴走を途中で止める方法、実物のログの読み方をまとめた有料noteです(780円)。この記事の章のうち、やったと言ってやっていない症状だけを深く掘った内容です。
有料noteの内容を見る同じ間違いが戻ってくる時は記録を次に持ち越す
一度直した間違いが数日後に戻ってくる時は、その学びを次の起動に持ち越す記録の仕組みが足りていません。Claude Codeは、新しいセッションごとに前の会話を覚えていない状態から始まります。前回の失敗は、ファイルに書いて次に読ませない限り、無かったことになります。
私は担当ごとに学び帳を持たせている
私の環境には、担当ごとの学び帳が17ファイルあります(書式の説明1つを含む)。担当は起動した時に自分の学び帳を読み、終わる前に新しい学びを1行書きます。さらに、セッションを始めた時に動くフックが、学び帳の要点をまとめて表示します。
学び帳の1行の書式、上限の決め方、CLAUDE.mdへ昇格させる基準は、Claude Codeの同じミス対策の記事に写せる形で置いています。ここで繰り返すと長くなるので、使い分けの答えだけ書きます。
CLAUDE.mdに書くか、学び帳に書くか
全員が毎回守る決まりならCLAUDE.md。特定の担当が特定の作業で踏んだ失敗なら学び帳です。
担当の失敗をCLAUDE.mdに積むと、ほかの作業でも毎回読まれて行数だけが増えます。200行の目安を守るためにも、担当の失敗は担当の手元に置いてください。
勝手に削除・勝手にpushが怖い時は権限の設定を見る
Claude Codeに勝手に削除やpushをされたくない時は、settings.jsonの権限(permissions)に拒否ルールを書きます。公式の権限ページによると、ルールは拒否、確認、許可の順に評価され、最初に一致したものが結果を決めます。拒否ルールに一致した操作は、より細かい許可ルールがあっても実行されません。
公式の例では、git push で始まるコマンドを拒否する書き方が載っています。
{
"permissions": {
"deny": [
"Bash(git push *)"
]
}
}拒否ルールにも抜け道がある
同じページには、この書き方が防げない形も書かれています。git -C . push のように、同じpushを別の書き方で呼ぶと一致しません。
公式は、拒否ルールをClaudeが普段書くコマンドを防ぐものと位置づけ、プログラムの周りを固める安全の境界ではないと説明しています。確実に守りたい時は、サンドボックス(隔離した実行環境)と組み合わせるよう案内されています。
.envのように読まれたくないファイルは、Read(./.env) の形で読み込みを拒否できます。公式によると、この拒否は同じパスへの編集と書き込みも止めます。CLAUDE.mdに「触らないで」と書くより、ずっと確かな止め方です。
私のプロジェクト設定の拒否ルールは0行
正直に書くと、2026年10月17日時点で、私のプロジェクトのsettings.jsonにある権限は許可ルールの3行だけで、拒否ルールは0行です。この記事を書くために数えて、初めて気づきました。表の2行目に入れたのはこのためです。
許可を聞かれすぎて困る逆の症状は、Claude Codeが毎回聞いてくる時の設定にまとめています。拒否を足すと確認も増えるので、両方の記事を見て、止めたい操作だけを拒否に入れてください。
言うことを聞かせようとして逆効果だったこと
Claude Codeが言うことを聞かない状態を直そうとして、私が一番遠回りしたのは、設定ファイルが壊れていると思い込んだことでした。フックが動かない理由を、settings.jsonが壊れていて自分では直せないせいだと決めつけ、約2週間そのままにしていたのです。実際のファイルは911バイトで、中身は正常でした。
壊れていたのは設定ファイルではなく、フックの中身でした。ファイル名の指定と、入力を読む場所。
ファイル名の指定も入力を読む場所も、JSONを手で流し込めばその場で分かることです。「壊れている」と思った時点で、確かめる手を止めていました。
安全のために作ったバックアップが逆に効いた
2つ目の逆効果は、ルールを削る前に取ったバックアップです。消しても戻せるように同じフォルダの中へ複製したら、その複製が毎回読み込まれ、削った分を足し戻していました。安全策のつもりが、指示を守らない原因の1つになっていたわけです。
弱点を知ったうえで、この順番を選んだ
仕組みに移すやり方には弱点があります。フックもスキルも、動いていないと画面に何も出ません。CLAUDE.mdに書くだけなら少なくとも目で読めますが、仕組みは確かめに行かない限り、効いているかどうかが見えないのです。
それでも私は仕組みに移すほうを選びました。理由は、確かめ方さえ決めておけば、動いているかをその場で確かめられるからです。
CLAUDE.mdは何回読み直しても、守られるかどうかは次の会話まで分かりません。見えない弱点は、確かめる手順で埋められます。
非エンジニアが最初にやる順番
コードが読めない人が、Claude Codeが言うことを聞かない状態から抜ける仕組みを入れるなら、CLAUDE.mdを削る、フックを1つ足す、手順をスキルに移す、の順で進めてください。サブエージェントは最後です。前の段が動いていないうちに次を足すと、どこが壊れているか分からなくなります。

1段目 CLAUDE.mdを200行以内に削る(今日5分)
今日やるのはこれだけで足ります。CLAUDE.mdを開いて行数を見て、200行を超えていたら、手順になっている段落に印を付けてください。
消すのは次の段で移した後で構いません。ルール置き場にバックアップの複製が無いかも、ついでに確かめます。
2段目 書いた後に検査するフックを1つだけ足す
最初のフックは、止めるものより知らせるものが安全です。書き込みの後に動くPostToolUseなら、失敗しても作業そのものは止まりません。足したら、JSONを手で流し込んで動くことを確かめ、/hooks で一覧に出ることも見ておきます。
3段目 3回貼った手順をスキルに移す
1段目で印を付けた手順のうち、3回以上貼ったものからスキルに移します。説明文には、どんな依頼が来たら使うかを書きます。移し終えたら、CLAUDE.mdから元の段落を消してください。
そもそもの指示の出し方から固めたい人もいると思います。環境構築の詰まりどころと指示の出し方の型、コピペで使えるプロンプト33本は、Claude Code入門の有料note(980円)にまとめています。
それでもClaude Codeが言うことを聞かない時の相談先
ここまでの順で直しても、Claude Codeが言うことを聞かない時は、設定ファイルとフックの中身を人に見てもらうのが近道です。自分で作った仕組みは、作った本人が一番見落とします。私自身、壊れていない設定ファイルを約2週間疑い続けました。
相談する前にそろえておくもの
- 困っている症状を1つ。対応表のどの行に近いか
- CLAUDE.mdの行数と、ルール置き場のファイル数
- settings.jsonのhooksと権限の部分
- 守られなかった時の、Claudeの返事の文面
.envの中身、パスワード、APIの鍵は、相談の場にも出さないでください。見せるのは設定の形だけで足ります。値が必要な場面は、まずありません。
業務の仕組みごと見直したい時
Claude Codeの設定だけでなく、業務のどこにAIを入れるか自体から迷っている人は、AIでの業務効率化を誰に相談するかも参考にしてください。相談先の種類と、頼む前に決めておくことを並べています。
CLAUDE.mdもフックも試したのに直らない方へ
設定のどこで止まっているかは、外から見ると早く分かります。進め方は2通りです。
作ってほしい方
30分の無料相談
作りたい仕組みと今の状態を伺い、どこから手を付けるかを一緒に決めます。費用は内容を伺ってからお伝えし、頼むかどうかはその後で選べます。押し売りはしません。
無料相談を申し込む自分でAIに作らせたい方
AIつまずき相談 90分(16,500円・税込)
画面共有で、CLAUDE.md、フック、権限の設定を一緒に開き、守られない原因を探します。直した手順は録画とメモで残るので、次からは自分で確かめられます。
90分相談の詳細を見るよくある質問
Claude Codeが言うことを聞かない時に、よく聞かれることをまとめました。
Q1. claude.mdが無視されるのは、書き方が悪いからですか?
書き方より、読ませている量と置き場所を先に疑ってください。公式はCLAUDE.mdを強制される設定ではないと説明し、200行以下を目標に挙げています。
Q2. CLAUDE.mdは何行までにすればいいですか?
公式の目標は1ファイル200行以下です。長いファイルほど文脈を使い、守られにくくなると書かれています。
Q3. 絶対に守らせたいルールはどこに書けばいいですか?
Claudeの判断に任せたくないなら、フックか権限の拒否ルールに移します。操作の前に止めたいならPreToolUseのフックです。
Q4. hooksを設定したのに動きません。最初に何を見ればいいですか?
Claude Codeで /hooks と打ち、一覧に出るかを見てください。次にmatcherの大文字小文字、手で流し込んだ時の動き、パスの書き方、文字化けの順で確かめます。
Q5. フックへの入力は、どこから読めばいいですか?
標準入力(stdin)に届くJSONから読みます。私は環境変数から読もうとして、約2週間フックが空振りしていました。
Q6. Claude Codeが勝手にpushするのを止められますか?
settings.jsonの権限に、git push で始まるコマンドの拒否ルールを書けます。別の書き方のpushには一致しないので、確実に止めたい時はサンドボックスと組み合わせます。
Q7. スキルとCLAUDE.mdの違いは何ですか?
CLAUDE.mdは毎回全部読まれ、スキルは説明文だけ毎回読まれて本体は使う時に読まれます。手順に育った内容はスキルに移すよう、公式も案内しています。
Q8. Claude Codeが勝手に止まるのも、指示に従わない症状ですか?
途中で止まる症状は、指示を守らない問題とは別に、文脈が埋まっていないかを先に見てください。私の環境では、毎回読ませていたバックアップを止めたところで、文脈がすぐ埋まる症状が解消しました。
Q9. グローバルなルールとプロジェクトのルールは、どちらに書けばいいですか?
どのプロジェクトでも守らせたいことはユーザー全体の設定、そのプロジェクトだけの決まりはプロジェクトの設定に書きます。両方に同じことを書くと、読む量が増えるだけです。
Q10. サブエージェントにすれば指示を守るようになりますか?
新しい文脈で始まるので、長い会話で薄まった指示の影響は受けにくくなります。ただし本筋の会話で決めたことは引き継がないので、指示は定義側に書いてください。
まとめ|Claude Codeが言うことを聞かない時は仕組みに移して直す
Claude Codeが言うことを聞かない時は、CLAUDE.mdに書き足すのをやめて、守らせたい強さに合わせて仕組みへ移してください。CLAUDE.mdは参考資料で、強制力はありません。私の環境で壊れていたのは、毎回読ませていたバックアップ62,183バイトと、約2週間動いていなかったフックでした。
- 毎回知っておいてほしい事実だけをCLAUDE.mdに残し、200行以内に収める
- 2回間違えたらCLAUDE.md、3回貼ったらスキルに移す
- 必ず止めたい操作は、PreToolUseのフックか権限の拒否ルールで止める
- フックを足したら、/hooks と手で流し込む確認で、動いていることを確かめる
- 「完了しました」は、ファイルやコマンドの結果で確かめてから受け取る
ここまで読んだあなたは、無視された理由を自分で確かめられる側の人です。今夜CLAUDE.mdを開いたら、まず行数を見る。
200行を超えていたら、手順の段落に印を付けて閉じる。それだけで、次の一歩が決まります。1か月後、同じ注意を4回目に打とうとして手を止め、スキルを1つ作っている自分を思い浮かべてみてください。
設定を直して分かったことや、新しい実録を出した時は、公式LINEでもお知らせしています。
レコプラ公式LINEを見るClaude Codeを使った仕事を収入につなげたい人は、Claude Code副業の始め方と単価相場も参考にしてください。
参考資料
この記事を書いた人|ゆうき
中小企業DX化コンサルタント × システム開発者
1987年生まれ。高卒スタートから中小物流会社の業務改善責任者へ。
大手コンサルに頼らず、現場の業務をAIとシステムで組み替えてきました。物流会社に勤めて19年(うちバックオフィス・業務改善15年)。Claude Codeで組んだブログ運営用の担当21体とフック4つを、自分で数え直しながら使っています。
ゆうきのプロフィールを見る お問い合わせ:info @desire-planet.com
公開日 2026年10月17日 最終更新日 2026年10月17日




