Claude Code でファイルが消えた、トークン消費が想定の20倍に膨張した、副の作業者が「完了」 と返したのに道具の呼び出しの記録が0件だった——もしこれらの困りごとに心当たりがあれば、100時間以上 Claude Code を実機で動かしている方の集まりの中の典型的な経験です。
私もこれら全部を経験しました。800時間以上の自律運用の中で、ファイルが2回消えて、トークン消費が想定の20倍になった事故を確認して、副の作業者が空の「完了」 を返した事例を整理しました。
その経験を hook の形に整理して GitHub で無料で配り続けた3ヶ月の整理の合図がこの記事の主題です。3ヶ月の合図は2つ。GitHub の安全装置の集まり (cc-safe-setup) は星の数36件で examples/ の中に 800近い hook と試験のファイル、直近14日の独立な利用者は約 1,582名。同じ期間の Zenn の本6冊の累計の販売は12件、累計の残高は¥10,071。
「無料で配り続けると有料の本の売上は下がるのではないか」 と最初は思っていました。実機の3ヶ月の合図は逆でした。無料の hook の利用者の中から、有料の本の購入者が出る経路が動きました。本記事は、その経路の3つの整理と、読者の方が同じ経路を再現する手順の整理です。
数字の整理
| 軸 | 数字 | 合図 |
|---|---|---|
| 無料の hook の場所 | github.com/yurukusa/cc-safe-setup |
星の数36件、examples/ に 800近いファイル |
| 直近14日の独立な利用者 | 約 1,582名 | 複製の合図 |
| 有料の本の累計の残高 | ¥10,071 | 3ヶ月、6冊、累計12件の販売 |
| 有料の本の場所 | Zenn の6冊 | ¥500から¥2,500の幅、第3章まで無料の試し読み |
直近14日で約 1,582名の独立な利用者が無料の hook を取り入れた。同じ期間の有料の本の販売は累計12件。比率で見ると約0.数%の販売の率の合図。低く見えるかもしれない。ただし、無料の hook を1件も配っていなかった2025年の私の Zenn の本の売上は¥0だった。無料の配布の有無で売上の構造が変わった経路。
なぜ無料を配り続けるのか
最も大きい理由は、Claude Code を実機で動かしている方の困りごとの形が、私自身が困った形と整合しているから。私は800時間以上 Claude Code を自律で動かして、ファイルが2回消えた事故、トークン消費が20倍に膨張した事故、副の作業者が「完了」と返したのに道具の呼び出しは0件だった事例を経験した。
これらの事故は、私が「公式ガイドにない」と感じた領域の集まり。同じ困りごとを持つ方は、私と同じように検索の経路で公式ガイドを読み、解決の手順が見つからずに困っている。私はその困りごとへの直接の対応を hook として整備して、無料で公開する。
「無料で配布する」は宣伝の手段ではなく、困っている方への直接の応答の経路。困っている方が hook を取り入れて事故が予防できたら、その方の生活と仕事が改善する。これが先で、本の売上は結果の経路。
3ヶ月で動いた合図は、この「困りごとへの直接の応答」の繰り返しの中で、利用者の方の中から「同じ著者の別の整備の経路はないか」と探してくださる方が一定の率で出てくる経路。その方々が Zenn の本の購入者の経路に自然に到達する。
無料から有料への3つの経路の具体例
経路1——hook の README の中の自然な動線
cc-safe-setup の README は約 120キロバイトの規模で、各 hook の症状と原因と対策の整理を含む。各 hook の整理の末尾で、関連の深い主題が私の Zenn の本にあれば1行で動線を入れる。
例えば、キャッシュの読取率の暴落の hook の整理の末尾で、「キャッシュの最適化の経路の整理は、トークン消費を半分にする本の第5章にあります」と1行入れる。読者の方は hook を試した直後に「もう少し深い経路はないか」と探す段で、自然な動線で本に到達する。
宣伝の調子ではなく、「困りごとへの深い対応の経路が、別の場所にもある」の伝え方。動線は本の購入を強制せず、第3章まで無料の試し読みの経路で読者の方が確認できる。
経路2——hook の試験のファイルの中の実機の合図
各 hook には対応の試験のファイルがあり、tests/ の中で実機の様式と整合の確認が記録されている。試験のファイルは10件から30件の規模で、各試験の冒頭の説明に「この症状は私が800時間の中で実際に経験した」「この hook の整備は本書の第X章にあります」の整理を入れる。
試験のファイルを読む方は、 hook の整理の深さを評価する方で、本の購入者の中の最も深い層と整合する。試験のファイルから本への動線は、購入の率が他の経路より高い合図。
経路3——取り込みの依頼の中の整理
cc-safe-setup の取り込みの依頼は、5月の段で 467件以上の累計で、各々が「この事故を予防する」 の整理を含む。取り込みの依頼の本文の整理の末尾で、関連の深い主題が私の Zenn の本にあれば1行で動線を入れる。
例えば、副の作業者が空の「完了」 を返す事例の予防の hook の取り込みの依頼の本文で、「同じ事例の継続的な観察の経路は、私の Zenn の本にあります」 と1行入れる。取り込みの依頼を読む方は、技術の深さを評価する方の集まりで、本の購入者の経路に自然に到達する。
読者の方が同じ経路を再現する手順
100時間以上 Claude Code を実機で動かしている方が、同じ経路を再現する場合の整理。
手順1——自分の事故と対策の整理を hook の形で整備
毎週の整理として、今週起きた事故・失敗・学びを作業の記録の場所に蓄積する。各事故に対して「症状」「原因」「数字 (時間、トークン、費用)」「予防の hook」の4つの軸で整理する。1ヶ月で5件から10件の hook の整備が可能。
hook はシェルスクリプトの形で、Claude Code の ~/.claude/settings.json の PreToolUse や PostToolUse の経路で連携。詳しい整理の手順は、cc-safe-setup の examples/ の中の各 hook の README で確認可能。
手順2——GitHub に無料で公開
hook の整理を GitHub に自由な利用の条件で公開する。README には各 hook の症状と原因と対策の整理を含める。検索の経路で発見されやすいように、claude-code-hooks や claude-code-safety の主題の符号を設定する。
公開した後の利用者の数は、最初は0名の合図が続く。私の cc-safe-setup も2026年3月の段では星の数0件、独立な利用者の数は数名の合図だった。3ヶ月の継続で星の数36件、独立な利用者の数は14日で約 1,580名に育った。
手順3——hook の README から有料の本への自然な動線を1行で入れる
hook の整理の末尾で、関連の深い主題が自分の本にあれば1行で動線を入れる。宣伝の調子ではなく、「困りごとへの深い対応の経路が、別の場所にもある」の伝え方。
第3章まで無料の試し読みの経路を本の側で整備すると、読者の方が動線を選んだ後の経路で本の中身を確認できる。購入の強制を避ける整備の経路が、信頼の整備の経路。
章の追加の継続が、購入の経路を維持する
3ヶ月¥10,071の合図の中で、5月27日まで売れ筋の本の章の追加を1ヶ月止めていた期間、新規の購入の経路が動かない時期が続いた。同じ期間に cc-safe-setup の取り込みの依頼は 100件以上、新しい hook の追加も継続していた。
5月27日に売れ筋の本 (¥800、件数1位) に追補の章を3章追加した。読者の困りごとから整理した3つの新しい事故の領域 (権限の確認の境界、Skills の組み立ての規律、Pro Max の利用枠の異常)。同じ日に2冊の本にも章を追加した (¥2,500のトークン本の章11、 ¥500のSkillsレシピ集の章9)。 累計4章の追加で、 既存の購入者の方への無償の更新の通知の経路を整備した。
無料の hook の配布と有料の本の章の追加の継続は、両方の継続が必要。片方だけの継続では、購入の経路が動きにくい。「無料を配り続ければ売れる」 ではなく、「無料の配布と有料の中身の継続の整備の両方が、購入の経路を動かす」 の経路。
まとめ
3ヶ月で cc-safe-setup の星の数36件、examples/ に 800近いファイル、Zenn の本6冊で累計12件の販売、累計の残高¥10,071の合図の中で動いた、無料の hook の配布と有料の本の販売の組み合わせの整理。
- なぜ無料を配り続けるのか——困っている方への直接の応答の経路、本の売上は結果
- 無料から有料への3つの経路——README の動線、試験のファイルの動線、取り込みの依頼の動線
- 読者の方が同じ経路を再現する手順——hook の整備、GitHub の公開、本への動線の整備
- 章の追加の継続の重要性——無料の配布と有料の中身の継続の整備の両方が、購入の経路を動かす
100時間以上 Claude Code を実機で動かしている方の参考に。無料の hook の配布は宣伝の手段ではなく、困りごとへの直接の応答の経路で、有料の本の購入はその結果の経路。両方の継続が必要。
参考の場所
-
cc-safe-setup ——本記事の hook の場所、 自由な利用、 星の数36件、
examples/に 800近いファイル、 直近14日の独立な利用者は約 1,582名