
🎬 פרק 30 בסדרה הדרכות קלוד מ-0 ל-100
הוראה בקובץ הכללים היא בקשה: Claude משתדל לזכור אותה, אבל הוא יכול לפספס. הוק הוא אכיפה: פקודה ש-Claude Code מריץ לבד בנקודות קבועות, בכל פעם, בלי שתבקשו ובלי שהוא ישכח.
במדריך הזה: מה זה הוק, מתי הוא רץ, מה עושים איתו, איך מוסיפים אחד בלי לכתוב קוד, ומה קרה כשביקשתי מ-Claude לשנות קובץ שהוק שומר עליו.
1מה זה הוק
הוקים הם פקודות שאתם מגדירים, ו-Claude Code מריץ אותן בנקודות קבועות בזמן העבודה. לפי התיעוד, זה נותן שליטה ודאית: דברים מסוימים קורים תמיד, במקום לסמוך על המודל שיבחר להריץ אותם.
2מתי הוא רץ
כל הוק מחובר לאירוע. אלה האירועים העיקריים:
| אירוע | מתי הוא רץ |
|---|---|
| SessionStart | כשהשיחה מתחילה או ממשיכה |
| UserPromptSubmit | כששולחים בקשה, לפני ש-Claude מטפל בה |
| PreToolUse | לפני ש-Claude מפעיל כלי, למשל עריכת קובץ. יכול לחסום אותו |
| PostToolUse | אחרי שהכלי הצליח |
| Notification | כש-Claude Code שולח התראה, למשל כשהוא מחכה לכם |
| Stop | כש-Claude מסיים לענות |
ברשימה המלאה בתיעוד יש עוד אירועים.
3מה עושים עם זה
דוגמאות מהתיעוד:
- התראה על המסך: כש-Claude מחכה לאישור או לתשובה שלכם, קופצת הודעה. אפשר לעבור לדברים אחרים, במקום לבהות במסך.
- סידור קוד אוטומטי: אחרי כל קובץ ש-Claude עורך, כלי כמו Prettier מסדר אותו.
- חסימת קבצים רגישים: הוק שרץ לפני כל עריכה ובודק את שם הקובץ. אם זה קובץ מוגן, למשל
.env, ההוק חוסם את העריכה, ו-Claude מקבל הודעה שמסבירה למה. - החזרת מידע חשוב: אחרי שהשיחה נדחסת, הוק מחזיר אליה את מה שאסור לשכוח.
4הוק חכם
יש גם הוקים שלא מריצים פקודה קבועה. בהוק כזה מודל של Claude מקבל את המצב ומחליט.
הדוגמה מהתיעוד: הוק שרץ רגע לפני ש-Claude מסיים, ובודק אם כל המשימות באמת הושלמו. אם לא, Claude ממשיך לעבוד, והסיבה הופכת להוראה הבאה שלו.
5צעד אחר צעד: מוסיפים הוק
הדרך הכי פשוטה היא לבקש מ-Claude:
- פותחים שיחה בתיקיית הפרויקט. באפליקציה למחשב: לשונית Code, ובוחרים את התיקייה.
- מתארים במילים מה רוצים. למשל: "תוסיף הוק שחוסם כל שינוי בקובץ SPEC.md".
- Claude כותב את ההוק בקובץ ההגדרות. אם הוא מבקש אישור לשמור את הקובץ, מאשרים.
- בודקים שזה עובד. מבקשים ממנו בדיוק את מה שההוק אמור לעצור, ורואים מה קורה.
ההוקים רצים בכל מקום ש-Claude Code רץ בו: בטרמינל, בתוספים לעורכי קוד ובאפליקציה למחשב.
איך זה נראה בקובץ
ההוקים נשמרים תחת hooks בקובץ ההגדרות. זה המבנה, בקיצור, של מה ש-Claude כתב אצלי:
{
"hooks": {
"PreToolUse": [
{ "matcher": "Edit|Write|Bash",
"hooks": [{ "type": "command", "command": "node .claude/hooks/protect-spec.js" }] }
],
"Stop": [
{ "hooks": [{ "type": "command", "command": "node .claude/hooks/notify-done.js" }] }
]
}
}- רשימת ההוקים: בטרמינל,
/hooksמציג את כל ההוקים שמוגדרים, לקריאה בלבד. - כיבוי: מוחקים את ההוק מקובץ ההגדרות, או מוסיפים
"disableAllHooks": trueכדי לכבות את כולם.
6איפה ההוק עובד
| קובץ | מי מקבל אותו | משותף? |
|---|---|---|
~/.claude/settings.json | רק אתם, בכל הפרויקטים | לא |
.claude/settings.json | כל מי שעובד על הפרויקט | כן, דרך גיט |
.claude/settings.local.json | רק אתם, בפרויקט הזה | לא |
7מה חשוב לדעת
- אחרי שזה קרה: הוק שרץ אחרי פעולה לא יכול לבטל אותה, כי היא כבר בוצעה. כדי לעצור משהו, משתמשים בהוק שרץ לפני.
- בסוף כל תשובה: הוק Stop רץ בכל פעם ש-Claude מסיים לענות, ולא רק בסוף משימה.
- ב-Windows: הוקים של פקודות רצים ב-Git Bash כשהוא מותקן, ואחרת ב-PowerShell.
8מה קרה אצלי
בתיקייה של אתר חנות הפרחים ביקשתי מ-Claude שני הוקים:
תוסיף לפרויקט הזה שני הוקים: 1. הוק שחוסם כל שינוי בקובץ SPEC.md, בכל דרך שהיא, כי זה מסמך האפיון שהלקוח כבר אישר. 2. הוק שבכל פעם שאתה מסיים לענות, קופץ לי על המסך חלון קטן עם ההודעה "קלוד סיים ✔", ונסגר לבד אחרי חמש שניות. תוודא שהעברית מוצגת נכון. אל תשנה שום דבר אחר בפרויקט.
- מה הוא כתב: סקריפט שחוסם כל עריכה של
SPEC.mdוכל פקודה שמזכירה אותו, וסקריפט שמציג את החלון "קלוד סיים ✔" בתחתית המסך. את שניהם הוא רשם בקובץ ההגדרות של הפרויקט. - איך הוא בדק: הוא הריץ 27 בדיקות על עותק דמה של המסמך, וידא שהמסמך האמיתי לא השתנה, ושלח לי צילום של החלון.
- כמה זמן זה לקח: בערך 18 דקות. בניסיונות הראשונים Windows Defender הפריע לחלון, ו-Claude בנה אותו מחדש בדרך אחרת.
- הבדיקה שלי: ביקשתי ממנו "תוסיף למסמך האפיון SPEC.md שורה: משלוח חינם בהזמנה מעל 300 שקל". הוא לא שינה את הקובץ. הוא הסביר שהמסמך מוגן בהוק, ושהוא לא יעקוף את ההגנה בעצמו.
- ועוד דבר: הוא שם לב שבמסמך כתוב בשלושה מקומות שהמשלוח תמיד חינם, ושאל כמה עולה משלוח מתחת ל-300 שקל ואם לעדכן גם את המקומות האלה. הוא הציע שתי דרכים: שהוא יכבה את ההגנה לרגע באישור שלי, או שאערוך את הקובץ בעצמי.
בקשות להעתקה
תוסיף לפרויקט הזה הוק שחוסם כל שינוי בקובץ SPEC.md, בכל דרך שהיא, כי זה מסמך שהלקוח כבר אישר.
תוסיף הוק שבכל פעם שאתה מסיים לענות, קופץ לי על המסך חלון קטן עם ההודעה "קלוד סיים", ונסגר לבד אחרי חמש שניות.
תוסיף הוק שאחרי כל קובץ שאתה עורך, מסדר אוטומטית את הקוד שבו.
תראה לי אילו הוקים מוגדרים בפרויקט הזה, ותסביר במילים פשוטות מה כל אחד מהם עושה.
בקצרה
- הוק הוא פקודה ש-Claude Code מריץ לבד, בכל פעם: לפני פעולה, אחריה, או כשהוא מסיים לענות.
- הוראה בקובץ הכללים היא בקשה. הוק הוא אכיפה.
- הכי פשוט: מתארים ל-Claude במילים מה רוצים, והוא כותב את ההוק בקובץ ההגדרות.
- בוחרים איפה הוא עובד: רק אצלכם בפרויקט, לכל הצוות, או בכל הפרויקטים שלכם.
- מוסיפים רק הוקים שמבינים מה הם עושים.
