Hooks, Claude Code'da bir aracın çalışmasından önce ve sonra kendi kodunu araya sokmanı sağlayan kancalardır. Onay kapıları kurmak, her değişikliği loglamak, ya da belirli komutları tamamen engellemek için kullanılır. Bu rehberde güvenli otomasyonun bel kemiğini işliyoruz.
İki temel kanca
- PreToolUse: Araç çalışmadan önce tetiklenir. Burada çağrıyı inceleyip izin verebilir, değiştirebilir veya reddedebilirsin.
- PostToolUse: Araç çalıştıktan sonra tetiklenir. Sonucu loglamak, bildirim göndermek ya da ek bir adım tetiklemek için uygundur.
Onay kapısı kurmak
En yaygın kullanım, riskli komutları insana sormaktır. PreToolUse içinde komutu kontrol eder, tehlikeliyse durdurursun:
# kavramsal: PreToolUse mantığı if komut "rm -rf" ya da "DROP TABLE" içeriyorsa: reddet ve nedeni yaz else: izin ver
Loglama ve denetim
PostToolUse ile her araç çağrısını bir dosyaya yazabilirsin: ne zaman, hangi araç, hangi parametre. Bu, hem hata ayıklama hem de "AI tam olarak ne yaptı?" sorusunun cevabı için paha biçilmezdir.
Sık hatalar
- Sessiz reddetme: Bir çağrıyı engellerken nedeni yazmazsan, Claude neden takıldığını anlamaz. Her zaman gerekçe döndür.
- Çok geniş engel: "Tüm bash komutlarını engelle" otomasyonu işe yaramaz hale getirir; yalnızca gerçekten riskli olanı yakala.
Özet
Hooks, kontrolü sana verir: hangi işlemin serbest, hangisinin onayla, hangisinin yasak olduğunu sen belirlersin. İyi bir hook seti, hızlı otomasyonla güvenliği aynı anda mümkün kılar.