התראות של Claude Code ב-Windows (PowerShell ו-WSL)

01Windows נייטיב או WSL: איפה ה-hooks רצים

Claude Code רץ או ישירות על Windows או בתוך WSL, וזה מה שקובע איך hook של התראות עובד.

• Windows נייטיב. ההגדרות נמצאות ב-%USERPROFILE%\.claude\settings.json. לפי מדריך ה-hooks של Anthropic, hooks של פקודות רצים כברירת מחדל ב-Git Bash, או ב-PowerShell כש-Git Bash לא מותקן. אפשר לכפות PowerShell על hook בודד עם "shell": "powershell"; במקרה כזה Claude Code משתמש ב-pwsh.exe (PowerShell 7) אם הוא נמצא, ואחרת ב-powershell.exe (Windows PowerShell 5.1).
• WSL. מתקינים ומריצים את claude בתוך הטרמינל של WSL, כך שקובץ ההגדרות הוא של Linux, ‏~/.claude/settings.json בתוך ההפצה, וה-hooks רצים ב-shell של Linux. ‏notify-send שם בדרך כלל לא מגיע לדסקטופ של Windows. במקום זה קוראים לתוכנות של Windows.

02הבדיקה המהירה: הצלצול של הטרמינל

האות הכי פשוט הוא הצלצול (bell). מוסיפים את זה לקובץ ההגדרות:

{
  "preferredNotifChannel": "terminal_bell"
}

מעכשיו Claude Code ישלח תו bell כשהוא מסיים או מחכה לכם. ב-Windows Terminal, מה שה-bell עושה מוגדר לכל פרופיל דרך bellStyle בקובץ settings.json שלו. ‏"bellStyle": ["window", "taskbar"] מהבהב את החלון ואת הכפתור בשורת המשימות במקום להשמיע צליל. במדריך הצלצול של הטרמינל יש עוד פרטים. זה עוזר רק כשהטרמינל מול העיניים.

03Notification hook עם PowerShell

זו הדוגמה ל-Windows מתוך מדריך ה-hooks של Anthropic. היא עובדת בלי להתקין כלום:

{
  "hooks": {
    "Notification": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "powershell.exe -Command \"[System.Reflection.Assembly]::LoadWithPartialName('System.Windows.Forms'); [System.Windows.Forms.MessageBox]::Show('Claude Code needs your attention', 'Claude Code')\""
          }
        ]
      }
    ]
  }
}

היא פותחת תיבת דו-שיח, לא toast בפינת המסך, והתיבה עלולה להיפתח מאחורי הטרמינל. כדאי לבדוק את הפקודה ב-PowerShell קודם. מקלידים /hooks ב-Claude Code כדי לוודא שה-hook נטען.

matcher ריק מופעל לכל סוגי ההתראות, כולל permission_prompt (אישור שממתין כשש שניות) ו-idle_prompt (Claude סיים לפני כ-60 שניות). במדריך ה-Notification hook מוסבר התזמון.

04toast אמיתי עם BurntToast

BurntToast הוא מודול PowerShell נפוץ שמתוחזק על ידי הקהילה, להתראות toast ב-Windows. מתקינים אותו פעם אחת למשתמש שלכם:

Install-Module -Name BurntToast -Scope CurrentUser

ואז בודקים שהוא עובד:

New-BurntToastNotification -Text 'Claude Code', 'Claude needs your attention'

משתמשים בו ב-hook. הגרסה הזו מפעילה PowerShell בלי פרופיל ועוקפת את ה-execution policy לקריאה הזו בלבד, כך שהיא מתנהגת אותו דבר מ-Git Bash או מ-PowerShell:

{
  "hooks": {
    "Notification": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "powershell.exe -NoProfile -ExecutionPolicy Bypass -Command \"New-BurntToastNotification -Text 'Claude Code', 'Claude needs your attention'\""
          }
        ]
      }
    ],
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "powershell.exe -NoProfile -ExecutionPolicy Bypass -Command \"New-BurntToastNotification -Text 'Claude Code', 'Claude has finished'\"",
            "async": true
          }
        ]
      }
    ]
  }
}

ה-hook מסוג Stop רץ בסוף כל תור, כך שתדעו על משימה שהסתיימה מיד ולא דקה אחר כך; ראו את מדריך ה-Stop hook. ‏"async": true מריץ את ה-hook ברקע, כך שהפעלה איטית של PowerShell לא מעכבת את Claude Code.

אם הודעות toast לא מופיעות אף פעם, בדקו ב-Settings > System > Notifications: ההתראות צריכות להיות מופעלות, ו-Do Not Disturb כבוי. הודעות של BurntToast מופיעות שם בדרך כלל תחת Windows PowerShell, שגם לו צריך לאפשר התראות.

05מתוך WSL: קריאה ל-Windows דרך interop

בתוך WSL ה-hook רץ ב-Linux, אבל WSL יכול להפעיל תוכנות Windows לפי שם ה-.exe שלהן. המדריך של Anthropic מציין ש-powershell.exe חייב להיות ב-PATH דרך ה-interop של Windows. זו ברירת המחדל; היא נשלטת על ידי appendWindowsPath בסעיף [interop] של /etc/wsl.conf. בודקים מה-shell של WSL:

command -v powershell.exe

כש-BurntToast מותקן בצד של Windows, ה-hook בקובץ ~/.claude/settings.json של WSL הוא אותה פקודה:

{
  "hooks": {
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "powershell.exe -NoProfile -ExecutionPolicy Bypass -Command \"New-BurntToastNotification -Text 'Claude Code', 'Claude has finished'\"",
            "async": true
          }
        ]
      }
    ]
  }
}

הפעלת Windows PowerShell מתוך WSL יכולה לקחת שנייה ויותר, וזו עוד סיבה להשתמש ב-"async": true.

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

ה-hooks שלמעלה מספיקים כשיושבים ליד המחשב. ברגע שמתרחקים הם לא עוזרים, ו-toast לא יכול לאשר פקודה ל-Claude.

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

irm https://claudecodenotifier.com/install.ps1 | iex

הוא מוסיף את רשומות ה-hook שלו להגדרות של Claude Code, לא נוגע בשאר הקובץ ושומר גיבוי. מיד הוא מציג toast של Windows כש-Claude מסיים, צריך הרשאה או שואל שאלה, בלי טלפון ובלי רשת. מכיוון שהוא מתחבר ל-Claude Code ולא לטרמינל, הוא עובד אותו דבר ב-Windows Terminal, ב-PowerShell ובטרמינלים של IDE.

אם Claude Code רץ ב-WSL, מתקינים את ccn בתוך WSL עם השורה של Linux, כי שם נמצאים Claude Code וההגדרות שלו:

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

אחר כך מריצים ccn test. האם התראת דסקטופ מתוך WSL תגיע לדסקטופ של Windows תלוי בהגדרות ה-WSL שלכם, ולכן ב-WSL הטלפון הוא הדרך האמינה. עם טלפון מצומד, האירועים מגיעים כהתראות push, ואפשר לאשר פעם אחת, לאשר לכל הסשן או לדחות הרשאה, לענות על השאלות של Claude ולשלוח את ההוראה הבאה ישירות מהטלפון. ראו צימוד טלפון, עמוד ccn ותמחור לאפליקציות הטלפון.

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

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