#hooks

Claude Code を業務で常用し始めると、subagent が突然止まったり hook が誤検出したりと、ドキュメントに書いていない罠に必ずぶつかります。permissions・hooks・effortLevel の3フィールドについて、半年の実運用で辿り着いた設計を紹介します。

Claude Code の自動化スクリプトが増えてくると、意図しない起動・設定の衝突・長時間タスクの確認待ちが積み重なります。3ヶ月・30本の運用ログをもとに、4つのアンチパターンと回避策をまとめました。

「同じルールを毎回言い直している」なら settings.json と CLAUDE.md の使い分けが効きます。hooks / permissions による事故防止パターンと、dotfiles で持ち運ぶ設定テンプレをコピペ可で解説。