TAG

Hooks

21 記事

hook に足した検査スクリプトは正しく動いていたのに、会話のほうが先に容量を使い果たしていました。833ファイルを走査して58バイトしか返さない検査と、同じ対象で42KBを返す検査を実測で並べ、hook に出力予算を設ける設計をまとめます。

Claude Code v2.1.233 以降、新しいモデルでは TodoWrite と Task 系ツールが既定で読み込まれません。環境変数で戻す前に確かめるべき3つの分岐と、チェックリストの代わりに置いた作業台帳の実装、並列実行で台帳が壊れた境界の実測結果をまとめます。

セッション途中で作業ルートを追加すると、無視規則も deny パターンもそのままでは新しいルートに届きません。git check-ignore と照合器の比較で境界を実測し、DirectoryAdded から呼ぶ差分監査スクリプトの実行結果まで記録しました。

自動コンパクションで消えるのは会話ではなく「なぜそう決めたか」です。PreCompact / SessionEnd / SessionStart の3フックで決定ログを外部ファイルへ退避し、次のセッションへ確実に手渡す実装を、動くコードと実測値つきで解説します。

Claude Code v2.1.195 でハイフンを含む hook matcher が部分一致から厳密一致に変わり、既存の PreToolUse フックが静かに発火しなくなりました。原因の切り分けと、壊れない matcher の書き方をまとめます。

自動投稿の後片付けだけが月に数回抜け落ちる——原因は片付けを処理の続きとして書いていたことでした。Claude CodeのSessionEndフックへ一時ファイル削除とログ記録を寄せる方法を、4サイト運用で実際に移した内容、つまずいた点と回避策、発火確認の手順とともにまとめました。

Claude Code Hooks を自動化の安全弁として運用するための実装メモ。exit code 0/2/その他の使い分け、JSON 出力による決定制御、ブロックが暴発したときの切り分け、観測ログの設計までを実例で整理します。

長時間の自動実行中に rm -rf や force push が紛れ込む不安を、PreToolUse フックの事前検査で解消した記録です。settings.json の設定、検査スクリプト、exit code 2 でブロックされた後の Claude の挙動、誤検知の調整までを実例で示します。

壁紙アプリと癒し系アプリの保守で、Claude Code の PostToolUse Hook と SwiftLint を組み合わせ、個人開発の品質ゲートを6週間運用した記録です。導入の動機から実装、運用してわかった調整ポイントまでを率直に書き残します。

Claude Code の Hook が `command timed out` で発火しても完了しない問題を、timeout 設定の見直し・分割実行・バックグラウンド化の3アプローチで実用的に解決する手順をまとめます。

Claude Code は単なる補助ツールではなく、開発プロセスそのものを駆動する基盤になり得ます。CLAUDE.md・MCP・skills・hooks・サブエージェントの5つを運用設計の柱として整理します。

Claude Code のフックは強力ですが、どのイベントで何ができるかが曖昧で、結局使いこなせないまま終わる人が多いです。私が半年運用して辿り着いた、フック種別ごとの設計判断と典型的な落とし穴を整理します。