この教材の結論を、先に書きます

Claude Code のフックは、エラーを出さずに動かなくなります。 死に方は4つあり、そのうち1つは終了コード 0で返ります。つまりフックとしては「成功」しています
「違反 0件」には2つの意味があります。 本当に0件なのか、数え方が壊れていて何も見つけられなかったのか。出力上は見分けがつきません
だから、数える道具が要ります。 この教材は監査スクリプト hook-doctor.py（6項目・カナリア内蔵）と雛形6本、本文7章（14,481字）を渡します
対象は、フックをすでに何本か書いて動かしている方です。 入門の説明はしていません
価格 ¥4,980。 ご自身の環境で違反が1件も出なかった場合は、30日間・全額返金します

自分の117本を数えたら、12本はどこからも呼ばれていなかった

先に、私の数字を出します。

hook-doctor v1.0   対象: /Users/xxx/.claude
実行体 117本 ／ 設定ファイル 19本

🟥 ① 起動経路のない実行体: 12本 / 117本
🟥 ② 自己テストのない検出器: 28本 / 117本
🟥 ③ タイムアウトに間に合わない配線: 1本 / 117本
🟩 ④ exit 0 の後ろで死んでいる行: 0本 / 117本
🟩 ⑤ 通知だけで残高を持たない検出器: 0本 / 117本
🟥 ⑥ 自分自身を数えている検出器: 25本 / 117本

違反の残高: 66件 / 実行体 117本

これは、この教材を書いている会社の環境です。

同じスクリプトを Anthropic の公式プラグイン群にかけると 51本中16件でした。密度は当社 0.56件/本、公式 0.31件/本。

道具を作った本人の環境が、いちばん汚れていました。

フックが死ぬとき、なぜエラーが出ないのか？

Claude Code のフックを何本か書いて動かしている方なら、一度は思ったことがあるはずです。

「これ、本当に動いてるんだろうか」

動いているかどうかは、見ただけでは分かりません。なぜなら、フックが死ぬとき、たいてい何も出ないからです。

私たちが実際に踏んだ死に方は4つでした。

4つとも静かです。

そして、いちばん怖いのはここです。

3つ目の「exit 0 の後ろ」は、終了コード0で返ります。 つまり、フックとしては「成功」しています。

私は、あるフックの途中に「該当しなければ静かに終わる」つもりで exit 0 を1行足しました。その後ろに49行の検査がありました。全部死にました。

そして気づいたのは、それから数か月あとです。

この教材で、何が手に入るのか？

1. `hook-doctor.py` — あなたの環境を数えるスクリプト

Python 3 だけで動きます。追加のライブラリは要りません。

python3 hook-doctor.py --root ~/.claude

6項目を数えて、残高で返します。「◯本中◯本が違反」の数字と、ファイル名の名指しです。

カナリア（意図的に仕込んだ、引っかかるはずの1件）を内蔵しています。それを検出できなければ、結果を出さずに終了します。理由は本文の第2章に書きました——「0件」には2つの意味があるからです。

本当に0件だった
数え方が壊れていて、何も見つけられなかった

この2つは、出力上まったく同じに見えます。

2. 本文全7章（14,481字）

フックは、エラーを出さずに死ぬ — 7本が一度も鳴っていなかった話
「0件」は「正常」ではない — カナリアを内蔵しない検出器は、自分の盲点を再生産する
止める型と、見せる型 — 実測: 止める型は1日で私を5回止め、見せる型は行動を0件しか変えなかった
配線したことは、走ることではない — 1,312行を15秒で登録していた話
通知は消える。残高だけが残る — 11件を13日間放置した設計上の理由
hook-doctor の使い方 — 設置と読み方、そしてこの道具が見落とすもの4つ
壊したときの戻し方 — Bashが一切使えなくなった日にやったこと

3. 雛形6本（そのまま動きます）

止める型／残高型／自己テスト／到達マーカー／自己参照の除外／復旧用。

6本とも bash -n と ast.parse を通してあり、4本は実際に走らせて出力を確認しています。

なぜ、この会社がこれを書けるのか？

株式会社SAC Technologies といいます。AI社員76名と人間1名で会社を動かしています。

2026年4月から、会社の運営そのものを Claude Code の上に載せています。意思決定、成果物の作成、外部への連絡、その検査——全部です。

そのために書いたフックとスクリプトが117本あります。

この教材の中身は、その117本を運用してきた記録です。うまくいった話ではありません。壊した話です。

検出器を46本作って、7本が一度も鳴っていなかった
40本（87%）が、自分が壊れているかを確かめる仕組みを持っていなかった
フックを1本編集して構文を壊し、Bashが一切使えなくなった
検出器が重すぎてタイムアウトし、無出力になった。それを「問題なし」と読み違えた

そして、この教材のための道具そのものが、他人の環境で「実行体0本」と答えました。105本あるところでです。しかも画面は緑でした。

その顛末は、本文の第2章にそのまま書いてあります。教材の主題を、自分の失敗で証明する形になりました。

この教材は、誰に向いているのか？

向いている方

フックをすでに何本か書いて動かしている
settings.json に3本以上登録している
「動いているはず」と思っているが、確かめたことがない
自分でスクリプトを書いて、Claude Code に検査させている

向いていない方

これからフックを書き始める方——入門の説明はしていません
フックを1本も書いていない方——数えるものがありません
きれいな設計論を求める方——ここにあるのは壊れた記録です

⇒ 迷われたら、先に hook-doctor の無料版で自分の数字を見てください。
0件だったら、この教材は要りません。

なぜ ¥4,980 なのか？

¥4,980

この価格にした理由を書きます。

同じ棚（Brain のAI・Claude Code領域）で、動くもの（スクリプト）が付いている商品を実測しました。LP自動生成が650部、スライド自動生成が300部、Obsidian構築が150部完売——上位はすべて ¥4,980 でした。

一方、¥980 帯は読み物寄りの商品が中心です。

監査ツールを ¥980 で出すと、無料記事と同じ棚に見えます。価格は、中身についての最初の情報だからです。

🟨 正直に書きます。当社の Brain 実績は 累計2部・売上5,960円です。この教材が何部売れるかは分かりません。

返金は、どういう条件ですか？

hook-doctor をご自身の環境で走らせて、1件も違反が出なかった方は、ご連絡いただければ全額をお返しします。

判定は主観ではありません。スクリプトの出力です
手続きは銀行振込で、直接のやりとりになります（プラットフォームを介しません）
返金してもプラットフォームの手数料は当社に戻りません。それでもこの条件にしています

「効果がなければ」ではなく「あなたの環境で0件だったら」にしたのは、判定を機械に置くためです。

よくあるご質問

Q. 私の環境でも動きますか？
A. Python 3 があれば動きます。当社以外の環境4つ（Anthropic公式プラグイン群・社内アプリ2つ・当社）で実走して確認しました。ただし、この確認をする前は動きませんでした。その話は第2章にあります。

Q. macOS 以外でも使えますか？
A. スクリプト自体は OS に依存しませんが、当社が実走したのは macOS のみです。Linux・Windows(WSL) での動作は確認していません。

Q. 6項目の判定は、決まった基準ですか？
A. いいえ。当社が自分のために作った基準です。②（自己テスト）と⑤（残高）は設計上の考え方で、あなたの方針と違うかもしれません。①③④⑥は、動いていないという事実です。

Q. この道具の盲点は何ですか？
A. 4つあります。参照を「ファイル名の出現」で数えている／②を語で判定している／③は推定であり実行時間を測っていない／.git や大きなファイルを走査しない。すべて本文の第6章に書いてあります。

Q. 更新はありますか？
A. Claude Code の仕様変更に追随して更新します。購入された方は追加費用なしで受け取れます。

Q. 買ったあと、何から始めればいいですか？
A. 走らせて、数字を見るところまでで5分です。直す順番は第6章に書きました。全部を一度に直そうとしないでください。③（タイムアウト）から直します。ここが死んでいると、他の検査が全部効いていないからです。

免責事項（ご購入前にお読みください）

本教材に記載の数値は、すべて当社環境および公開されているプラグインでの実測値です。ご利用の環境によって結果は異なります。
hook-doctor の6項目は、当社が自社の運用のために定めた基準であり、公式の仕様や標準ではありません。②（自己テスト）・⑤（残高）は設計上の考え方であり、方針が異なれば違反として数えない選択もあり得ます。
本教材および hook-doctor の利用によって生じたいかなる結果についても、当社は責任を負いかねます。ご自身の環境に適用される際は、必ず事前にバックアップをお取りください。第7章に復旧の手順を記載しています。
Claude Code の仕様は変更されることがあります。本教材の内容は 2026年9月8日時点のものです。
本教材は技術的な運用手法を扱うものであり、収益・成果・投資に関する情報を提供するものではありません。
教材の内容（本文・スクリプト・雛形）の再配布・転載・二次販売はご遠慮ください。ご自身の業務での利用は自由です。

最後に

この教材で書いたのは、全部私が壊した記録です。

7本が鳴っていなかった。1,312行を15秒で走らせようとしていた。exit 0 の後ろで49行が死んでいた。11件を13日間放置した。Bashを使えなくした。そして、この教材のための道具が、他人の環境で「0本」と答えた。

うまくやる方法は、まだ書けません。書けるのは、壊れ方の一覧と、数える道具だけです。

ただ、1つだけ確かなことがあります。

「動いているはず」を、数字に置き換えたときにだけ、直せます。

あなたの数字は、いくつでしょうか。