איך לקבל התראה כשסוכן קוד מסיים או ממתין לאישור

כדי לקבל התראה כשסוכן קוד מסיים או ממתין לאישור, הפעילו את ההתראות המובנות שלו או הוסיפו hook שרץ כשהאירועים האלה קורים. אם לא תהיו ליד המחשב, שלחו את ההתראה לטלפון. בדקו אותה לפני שאתם יוצאים, כי סוכן שממתין לאישור לא עושה כלום עד שתענו.

הדוגמאות במדריך הזה מבוססות על Claude Code. לשמירה על המחשב ער יש מדריך נפרד. Mono מבית Reunified שולח את ההתראות האלה עבור סוכנים שאתם מפעילים דרכו, אבל השיטה עובדת בכל סביבת עבודה.

1. החליטו אילו אירועים של הסוכן צריכים התראה

שלושה אירועים חשובים:

אם אתם מגדירים רק התראה אחת, בחרו בהתראת ההרשאה.

2. הפעילו התראות ב־Claude Code

Claude Code שולח התראה כשהוא מסיים או עוצר כדי לבקש הרשאה, בזמן שנראה שאתם לא ליד המחשב. כברירת מחדל הוא מציג התראות שולחן עבודה רק ב־Ghostty, ב־Kitty וב־iTerm2 (הגדרת הטרמינל). בטרמינלים אחרים, הגדירו את preferredNotifChannel לערך ‎"terminal_bell"‎ בקובץ ‎~/.claude/settings.json כדי שהטרמינל ישמיע צליל פעמון. ב־tmux, הוסיפו set -g allow-passthrough on לקובץ ‎~/.tmux.conf וטענו אותו מחדש.

לצליל או לפקודה משלכם, הוסיפו hooks לאותו קובץ. האירוע Notification מקבל מסננים (matchers) כמו permission_prompt (בקשת אישור ממתינה כבר כשש שניות) ו־idle_prompt (Claude סיים לפני כדקה ומאז לא הקלדתם). ב־Mac, ההגדרה הזו משמיעה צליל שונה לכל אחד מהם:

{
  "hooks": {
    "Notification": [
      {
        "matcher": "permission_prompt",
        "hooks": [{ "type": "command", "command": "afplay /System/Library/Sounds/Glass.aiff" }]
      },
      {
        "matcher": "idle_prompt",
        "hooks": [{ "type": "command", "command": "afplay /System/Library/Sounds/Hero.aiff" }]
      }
    ]
  }
}

במדריך ה־hooks יש גם פקודות להתראות שולחן עבודה ב־macOS, ב־Linux וב־Windows. סוכנים אחרים עובדים אחרת, אז בדקו את התיעוד שלהם.

3. שלחו את ההתראה לטלפון

יש שלוש דרכים להעביר את ההתראה לטלפון:

• האפליקציה של הסוכן עצמו. כש־Remote Control של Claude Code פעיל, הריצו ‎/config והפעילו התראות דחיפה כש־Claude מחליט (Push when Claude decides), התראות דחיפה כשנדרשת פעולה (Push when actions required), או את שתי האפשרויות. לשם כך צריך תוכנית מנוי מתאימה ואפליקציית Claude מחוברת לאותו חשבון, עם הרשאה להתראות.
• hook ששולח התראת דחיפה, למשל באמצעות curl לשירות התראות שהאפליקציה שלו מותקנת בטלפון שלכם.
• אפליקציה נלווית שמעבירה אירועי סשן מהמחשב.

בכל הדרכים המחשב צריך להיות דולק, ער ומחובר לרשת, והסוכן צריך להמשיך לרוץ. שמרו כל טוקן של hook בקובץ ‎~/.claude/settings.json, ולא בקובץ ‎.claude/settings.json של הפרויקט, שעלול להיכנס ל־commit במאגר.

4. שמרו על פרטיות ההתראות במסך הנעילה

כל מי שנמצא ליד טלפון נעול יכול לקרוא את התצוגות המקדימות שלו. אל תכניסו להודעות של hook סודות, תוכן של קבצים או שורות מהלוגים. שלחו רק את האירוע ואת שם הפרויקט: בפרויקט בדוי בשם ״invoice-export״, מספיק ״invoice-export: נדרש אישור״. ב־iPhone, פתחו את ״הגדרות״ > ״עדכונים״ והגדירו את ״הצגת תצוגות מקדימות״ ל״כשמכשיר לא נעול״. גם ב־Android אפשר להסתיר תוכן רגיש במסך הנעילה, אבל שם האפשרות משתנה מטלפון לטלפון.

ב־Mono, התראת סיום מציגה את ההודעה האחרונה של הסוכן, מקוצרת אם היא ארוכה. התראת הרשאה מציגה את הבקשה כפי שהסוכן מתאר אותה, ולרוב זו הפקודה.

5. בדקו עם משימה לא מזיקה לפני שאתם יוצאים

במחשב שבבית, פתחו סשן בשם ״בדיקת invoice-export״ ובקשו מהסוכן להריץ את הבדיקות ולדווח על כל כישלון בלי לשנות קבצים. הסוכן שואל לפני שהוא מריץ פקודות, ולכן הוא מבקש להריץ npm test. במחשב, עברו למסך אחר או לאפליקציה אחרת, ואז נעלו את הטלפון ולכו לחדר אחר.

ב־Mono, זה מה שאמור לקרות:

1. מגיעה התראת ״בקשת הרשאה מהסוכן״ שמציינת את פקודת הבדיקות.
2. לחיצה על ההתראה פותחת את הסשן, ושם אתם בוחרים ״אשר״. בקשה מאוחרת יותר שולחת התראה משלה.
3. מגיעה ההתראה ״הסוכן סיים בסשן “בדיקת invoice-export”״ עם ההודעה האחרונה של הסוכן, למשל ״בדיקה אחת ב־dates.test.ts נכשלת בגלל אזורי זמן. לא שיניתי אף קובץ.״

אחר כך הריצו משימה שנייה כשהסשן פתוח בטלפון: בזמן שאתם צופים בו לא מגיעה התראה. לפני שאתם יוצאים, ודאו שהסשן לא מוצג על המסך באף מכשיר.

6. תקנו התראות שלא מגיעות

ב־Mono, פתחו את ״הגדרות״ > ״התראות״ ובדקו את ״כל ההתראות״, ״קוד״ (סשנים שהסתיימו או נעצרו), ״בקשות הרשאה״ ו״שליחה לשאר המכשירים שלך״. כולן מופעלות כברירת מחדל. ההתראות נשלחות מהמחשב שמריץ את הסוכן, ולכן Mono צריך להמשיך לפעול בו.

לפני שאתם מאשרים מהטלפון, קראו מה לבדוק בבקשת הרשאה. המדריך לעבודה עם סוכני קוד מהטלפון מכסה את שאר ההגדרה. Mono עדיין לא זמין, אבל אפשר להצטרף לרשימת ההמתנה.