התראות של Claude Code ב-Linux

01מה Claude Code עושה בעצמו

כש-Claude מסיים משימה או מחכה לאישור ונראה שאתם לא ליד המחשב, Claude Code יורה אירוע התראה. לפי מדריך הטרמינל של Anthropic, Ghostty ו-Kitty הופכים אותו להתראת שולחן עבודה; טרמינלים אחרים, כמו GNOME Terminal, Konsole או הטרמינל של VS Code, לא מציגים כלום.

במקום זה אפשר לבקש bell בכל טרמינל:

{
  "preferredNotifChannel": "terminal_bell"
}

מה ה-bell עושה תלוי בטרמינל ובסביבת שולחן העבודה. הוא יכול לצפצף, להבהב או לסמן את החלון כדחוף. המדריך ל-terminal bell מסביר את זה. להתראה אמיתית, השתמשו ב-hook.

02התקנת notify-send

בדקו אם הוא מותקן:

notify-send 'Claude Code' 'test'

אם הפקודה לא נמצאה, התקינו אותה:

sudo apt install libnotify-bin   # Debian, Ubuntu, Mint
sudo dnf install libnotify       # Fedora, RHEL
sudo pacman -S libnotify         # Arch

אם הפקודה רצה אבל לא מופיע כלום, אין לכם notification daemon. GNOME, KDE Plasma, Cinnamon ו-Xfce כוללים אחד. ב-tiling window manager כמו Sway, i3 או Hyprland צריך להתקין ולהפעיל אחד בעצמכם, למשל mako או dunst. זה עובד גם ב-Wayland וגם ב-X11, כי notify-send מדבר עם ה-daemon דרך D-Bus ולא עם התצוגה.

03Notification hook

זו הדוגמה ל-Linux מתוך מדריך ה-hooks של Anthropic. הוסיפו אותה ל-~/.claude/settings.json, לצד המפתחות שכבר קיימים שם:

{
  "hooks": {
    "Notification": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "notify-send 'Claude Code' 'Claude Code needs your attention'"
          }
        ]
      }
    ]
  }
}

הקלידו /hooks ב-Claude Code כדי לראות אותו תחת Notification. matcher ריק יורה על כל סוגי ההתראות. העיקריים הם permission_prompt, אחרי שבקשת אישור חיכתה כשש שניות בלי שהקלדתם, ו-idle_prompt, כ-60 שניות אחרי ש-Claude מסיים. הרשימה המלאה נמצאת במדריך ל-Notification hook.

04לדעת ברגע ש-Claude מסיים

idle_prompt מגיע באיחור של דקה. hook מסוג Stop רץ ברגע ש-Claude מסיים את התור שלו, והוא לא מקבל matcher:

{
  "hooks": {
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "notify-send -a 'Claude Code' 'Claude Code' 'Claude has finished'"
          }
        ]
      }
    ]
  }
}

-a קובע את שם האפליקציה שה-daemon מציג. עוד אפשרויות שימושיות: -u critical משאיר את ההתראה על המסך עד שסוגרים אותה (ברוב ה-daemons), ו--i dialog-information מוסיף אייקון. עוד על האירוע הזה במדריך ל-Stop hook.

05הצגת ההודעה האמיתית, עם צליל

hooks מקבלים JSON ב-standard input, והקלט של Notification כולל שדה message. סקריפט יכול להציג את הטקסט הזה ולהשמיע צליל. שמרו את זה בתור ~/.claude/hooks/notify-linux.sh:

#!/bin/bash
msg=$(jq -r '.message // "Claude Code needs your attention"')
notify-send -a 'Claude Code' 'Claude Code' "$msg"
paplay /usr/share/sounds/freedesktop/stereo/complete.oga 2>/dev/null || true

הפכו אותו לבר-הרצה עם chmod +x ~/.claude/hooks/notify-linux.sh והשתמשו ב-~/.claude/hooks/notify-linux.sh כפקודת ה-hook. jq זמין בחבילות של כל הפצה. paplay עובד עם PulseAudio ועם שכבת ה-PulseAudio של PipeWire, וקובץ הצליל מגיע מערכת הצלילים של freedesktop (sound-theme-freedesktop ב-Debian וב-Ubuntu). אפשר להשתמש בכל קובץ .oga או .wav.

06אין notify-send? השתמשו ב-escape sequence

אם הטרמינל שלכם מבין escape sequences של התראות, hook יכול לבקש מ-Claude Code לשלוח אחת. ל-hooks אין טרמינל משלהם, אז מחזירים את ה-sequence בשדה terminalSequence ו-Claude Code כותב אותו. התיעוד של Anthropic מציין OSC 777 עבור Ghostty, urxvt ו-Warp, ו-OSC 99 עבור Kitty. לדוגמה:

#!/bin/bash
body=$(jq -r '.message // "Needs your attention"')
seq=$(printf '\033]777;notify;%s;%s\007' "Claude Code" "$body")
jq -nc --arg seq "$seq" '{terminalSequence: $seq}'

זה לא דורש daemon במכונה שעליה רץ Claude Code, ולכן זה גם הטריק לשרתים מרוחקים דרך SSH.

07כש-notify-send עובד ב-shell אבל לא מתוך Claude Code

notify-send צריך את כתובת ה-D-Bus session של ההתחברות לשולחן העבודה. hooks יורשים את הסביבה של Claude Code, כך שאם הפעלתם את Claude Code מטרמינל בשולחן העבודה, הכול בסדר. אבל אם Claude Code הופעל דרך SSH, משירות systemd, בתוך container, או בתוך שרת tmux שהופעל לראשונה מ-SSH, ייתכן שהכתובת חסרה וההתראה לא מגיעה לשום מקום. הריצו echo $DBUS_SESSION_BUS_ADDRESS באותו shell שממנו מפעילים את claude; אם הפלט ריק, התראות שולחן עבודה מהסשן הזה לא יוצגו. המדריך ל-tmux והמדריך ל-SSH מכסים את המצבים האלה.

08איפה Claude Code Notifier נכנס לתמונה

ה-hooks שלמעלה הם בחירה טובה כשעובדים ליד המחשב. אבל הם לא יגיעו אליכם ברגע שתקומו מהשולחן, והתראת שולחן עבודה לא מאפשרת לענות ל-Claude.

Claude Code Notifier הוא כלי עצמאי (של TouchTap, לא של Anthropic) שמבוסס על ה-hooks של Claude Code. כלי שורת הפקודה החינמי שלו, ccn, רץ על Mac, Windows ו-Linux. ב-Linux:

curl -fsSL https://claudecodenotifier.com/install.sh | sh

או npx @touchtap/ccn אם מותקן אצלכם Node.js. הוא מוסיף את רשומות ה-hook שלו ל-~/.claude/settings.json, לא נוגע בשאר ושומר גיבוי. מאותו רגע הוא מציג התראת שולחן עבודה ב-Linux כש-Claude מסיים, צריך אישור או שואל שאלה. החלק הזה לא דורש רשת ולא טלפון. הוא רץ כמה אלפיות שנייה לכל אירוע, ושום דבר לא נשאר לרוץ ברקע.

צמדו טלפון iPhone או Android, ואותם אירועים יגיעו כהתראות push, גם במכונה בלי שולחן עבודה בכלל. מהטלפון אפשר לאשר או לדחות בקשת הרשאה, לבחור תשובה לשאלה של Claude ולשלוח את ההוראה הבאה אחרי ש-Claude מסיים. ראו צימוד טלפון, הדף של ccn ומחירים לאפליקציות הטלפון. ב-Linux, ccn שומר את ה-token שלו בקובץ שרק אתם יכולים לקרוא.

אם מתקינים את ccn, כדאי להסיר את ה-hooks של notify-send שהגדרתם בעצמכם כדי למנוע כפילויות.

09שאלות נפוצות