ההתראות המובנות של Claude Code: ה-terminal bell ו-preferredNotifChannel

01הפתרון המהיר

אם לא שומעים כלום כש-Claude מסיים, הוסיפו את זה ל-~/.claude/settings.json:

{
  "preferredNotifChannel": "terminal_bell"
}

אחר כך ודאו שהטרמינל מגיב ל-bell: משמיע צליל, מקפיץ את האייקון ב-Dock, מהבהב בלשונית או מציג התראה. ההגדרה הזו נמצאת בטרמינל, לא ב-Claude Code. ב-Mac, ב-Windows וב-Linux, ברוב הטרמינלים יש בהעדפות אזור של "bell" או "alert".

02כל הערכים של preferredNotifChannel

אפשר לשים את ההגדרה בכל קובץ הגדרות: משתמש (~/.claude/settings.json), פרויקט (.claude/settings.json) או מקומי (.claude/settings.local.json). בגרסאות ישנות היא נשמרה ב-~/.claude.json, ו-Claude Code עדיין קורא ערך שנשאר שם.

03מתי ההתראה המובנית מופעלת

לפי התיעוד של Anthropic, להתראה המובנית יש אותו תזמון כמו ל-hook של Notification. בסשן טרמינל:

• בקשת הרשאה: אחרי שהבקשה ממתינה כשש שניות בלי הקשה. כל הקשה מאפסת את ההמתנה.
• סיום: כ-60 שניות אחרי ש-Claude עוצר, ורק אם לא הקלדתם מאז ואין agent ברקע שעדיין רץ.

כלומר ההתראה המובנית על סיום לא מיידית בכוונה. היא נועדה להגיע אליכם כשהתרחקתם, לא להציק בזמן שאתם צופים. אם רוצים התראה ברגע שהתור מסתיים, השתמשו במקום זאת ב-hook של Stop (ראו המדריך ל-Stop hook).

04טרמינל אחרי טרמינל

iTerm2 (macOS)

iTerm2 מקבל התראת דסקטופ כברירת מחדל, אבל iTerm2 מציג אותה רק אחרי שמאשרים זאת:

1. פתחו את Settings > Profiles > Terminal.
2. סמנו את Notification Center Alerts.
3. לחצו על Filter Alerts והפעילו את Send escape sequence-generated alerts.

ודאו גם של-iTerm2 מותר להציג התראות ב-System Settings > Notifications.

Apple Terminal (macOS)

Apple Terminal לא מקבל התראת דסקטופ. עם "auto", Claude Code שולח bell שקט רק כשהוא מזהה ש-Audible bell כבוי בפרופיל של החלון הקדמי. ה-bell מופיע אז כהבהוב של החלון, או כקפיצה ב-Dock כש-Terminal ברקע, אם האפשרות Visual bell או הקפיצה ב-Dock מופעלת בפרופיל.

שימו לב לפרט אחד. אם אישרתם את בקשת הגדרת הטרמינל בהפעלה הראשונה של Claude Code, היא הריצה את /terminal-setup, שמכבה את ה-audible bell בפרופיל של Apple Terminal. כדי לשמוע צליל, הגדירו "terminal_bell" והפעילו מחדש את Audible bell תחת Settings > Profiles > Advanced.

Ghostty ו-Kitty (macOS ו-Linux)

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

כל השאר

Windows Terminal, GNOME Terminal, Konsole, Alacritty, WezTerm, Warp וה-terminals של סביבות הפיתוח לא מקבלים כלום כברירת מחדל. הגדירו "terminal_bell" והפעילו את הטיפול בצליל ההתראה (bell) של ה-terminal עצמו, או השתמשו ב-hook. ל-terminals של סביבות פיתוח יש מוזרויות משלהם, שמפורטות במדריך ל-VS Code, Cursor ו-JetBrains.

05דרך SSH ובתוך tmux

התראת שולחן העבודה היא escape sequence שה-terminal במחשב שלכם מפרש, ולכן היא מגיעה אליכם גם כש-Claude Code רץ על שרת מרוחק דרך SSH. Ghostty ו-Kitty מעבירים אותה בלי הגדרות נוספות. iTerm2 צריך את הגדרות ההתראות שלמעלה.

בתוך tmux הרצף נבלע, אלא אם מאפשרים passthrough. הוסיפו את זה ל-~/.tmux.conf והריצו tmux source-file ~/.tmux.conf:

set -g allow-passthrough on

סשנים מנותקים (detached) הם בעיה אחרת: אם אין terminal מחובר, אין מה שיציג את ההתראה. ראו את המדריך ל-tmux ואת התראות דרך SSH.

06ההתראה המובנית ו-hooks ביחד

hooks מסוג Notification רצים לצד ההתראה המובנית ולא מחליפים אותה. התיעוד של Anthropic מציין במפורש ש-hooks מופעלים גם עם "notifications_disabled": ההגדרה משנה רק את האופן שבו Claude Code מתריע, לא את זה שה-hook רץ. כך מקבלים חלוקה נקייה:

• השאירו "auto" או "terminal_bell" להתראה ליד המחשב.
• הוסיפו hook לכל השאר, למשל צליל מערכת, התראת שולחן עבודה ב-terminal שלא מקבל אותה, או push לטלפון עם ntfy.
• אם hook כבר מציג התראת שולחן עבודה, הגדירו "notifications_disabled" כדי לא לקבל שתיים.

לדוגמה, זה משמיע צליל ב-macOS בכל פעם ש-Claude צריך תשומת לב, בכל terminal:

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

המקבילות ל-Linux ול-Windows נמצאות במדריך ל-Linux ובמדריך ל-Windows.

07המגבלות של האפשרויות המובנות

• היא נשארת במחשב. הצליל או ההתראה מגיעים מה-terminal שעל המסך. הלכתם למטבח? פספסתם.
• היא תלויה ב-terminal. הרבה terminals פופולריים לא מקבלים כלום עד שמשנים הגדרה.
• אי אפשר להגיב אליה. היא מודיעה ש-Claude מחכה, אבל עדיין צריך לחזור למקלדת.

Remote Control של Anthropic, יחד עם אפליקציית Claude לנייד, היא הדרך הרשמית לקבל push לטלפון. מדריך ההשוואה סוקר אותה לצד האפשרויות האחרות.

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

אם אתם עובדים ליד המחשב, ייתכן שההתראה המובנית יחד עם "terminal_bell" מספיקות. Claude Code Notifier נועד למצבים שבהם אתם לא ליד המחשב. כלי שורת הפקודה שלו, ccn, רץ כ-hook של Claude Code, כך שהוא עובד בכל terminal ב-Mac, ב-Windows וב-Linux, עם או בלי הגדרות bell. לבדו הוא מציג התראת שולחן עבודה כש-Claude מסיים, צריך הרשאה או שואל שאלה. עם טלפון מצומד אפשר לאשר או לדחות הרשאות, לענות על השאלות של Claude ולשלוח את ההוראה הבאה מהטלפון, ואם הקלדתם ב-30 השניות האחרונות, שום דבר לא ממתין בטלפון. ראו את העמוד של ccn.

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