Claude Notify – Desktop Notifications for Claude Code on Windows
Claude Notify is a Windows taskbar program that posts a summary of up to 30 words when Claude Code finishes a reply, then opens the matching VS Code chat.
By Dillip Chowdary • Oct 15, 2026 • Source: github.com
At a glance
- Product
- Claude Notify
- Platform
- Windows 10 or 11
- License
- MIT
- Display time
- 2 to 60 seconds, default 8
- Summary wait
- About 15 seconds, Haiku via claude -p
In this post
The source is a Windows taskbar utility, so I’ll stick to its real commands and numbers and check each section’s length before the article is final.Claude Notify is a small Windows taskbar program that posts a notification when Claude Code finishes a reply. github.com's report says that text is a summary of up to 30 words, or the start of the message if the summary is off or fails. A click raises the project's VS Code window and opens the matching conversation.
This piece is for people who run Claude Code on Windows 10 or 11, as the VS Code extension or from the command line, including Cursor and Code - Insiders. It covers the Haiku summary, the companion window, the Stop hook, startup with Windows, and removal.
01What shipped
Claude Notify ships as ClaudeNotify.exe. Running it does not require an installer or administrator permissions.
Claude Code has to be present as the VS Code extension or the command-line tool. Default editor processes are Code, Code - Insiders, and Cursor. The license is MIT, in the LICENSE file.
Claude Code has to be present as the VS Code extension or the command-line tool. Default editor processes are Code, Code - Insiders, and Cursor. The license is MIT, in the LICENSE file.
The program stays quiet when the editor window is visible on screen, fully or partly. If that window is minimized, or if another window covers it completely, the notification is shown. The toast carries the summary, or the opening of the message when the summary is off or fails.
The program stays quiet when the editor window is visible on screen, fully or partly. If that window is minimized, or if another window covers it completely, the notification is shown. The toast carries the summary, or the opening of the message when the summary is off or fails.
02What improved
The summary changes both the text and the wait. With it on, Claude Notify runs claude -p with Haiku.
With it off, the start of the message appears immediately, and the same fallback is used if the summary fails. A word-count setting accepts any value from 5 to 60. The summary in the notification is up to 30 words.
With it off, the start of the message appears immediately, and the same fallback is used if the summary fails. A word-count setting accepts any value from 5 to 60. The summary in the notification is up to 30 words.
Display time can be set from 2 to 60 seconds, default 8, and that control works only while the companion window is enabled. The ordinary Windows notification is controlled by Windows and ignores this value. Position is bottom right by default, or bottom left.
Display time can be set from 2 to 60 seconds, default 8, and that control works only while the companion window is enabled. The ordinary Windows notification is controlled by Windows and ignores this value. Position is bottom right by default, or bottom left.
| Item | Off or Windows toast | Claude Notify |
|---|---|---|
| Preview | Message start, immediately | Up to 30 words; word count 5 to 60 |
| Wait | Immediate if the summary is off or fails | About 15 seconds via claude -p with Haiku, counted on the subscription |
| On-screen time | Windows ignores 2 to 60 | 2 to 60 seconds, default 8; pauses on hover |
| Corner | Companion window only | Bottom right by default, or bottom left |
03What you gain
It still does that when several VS Code windows are open at the same time. A reply you can already see does not get a toast, because a fully or partly visible editor suppresses the notification. A minimized window, or a window covered completely by something else, is the case that shows it.
It still does that when several VS Code windows are open at the same time. A reply you can already see does not get a toast, because a fully or partly visible editor suppresses the notification. A minimized window, or a window covered completely by something else, is the case that shows it.
Advertisement
Tech Pulse Daily
Get tomorrow's pulse first
Join engineers who read Tech Pulse before stand-up. Free, weekday mornings.
The Stop hook applies to every project, while the rest of the Claude Code settings stay put. The connection writes that hook into %USERPROFILE%\.claude\settings.json only after saving settings.json.bak, and other settings in the file are not changed.
The program copy used for the connection is stored at %LOCALAPPDATA%\ClaudeNotify. The log at %APPDATA%\ClaudeNotify\log.txt stores counts only, not message content.
Right-click does not remove the hook. The notification window follows the light or dark theme selected in VS Code or Cursor, not Windows.
04How to get it
Run ClaudeNotify.exe from the latest Release. No administrator permissions are required.
It creates settings.json.bak, leaves other settings alone, and applies the hook to all projects. Check "הפעל עם Windows" (Run with Windows) and save to start with Windows. Display time defaults to 8 seconds, from 2 to 60, and the corner defaults to bottom right.
It creates settings.json.bak, leaves other settings alone, and applies the hook to all projects. Check "הפעל עם Windows" (Run with Windows) and save to start with Windows. Display time defaults to 8 seconds, from 2 to 60, and the corner defaults to bottom right.
If no notification appears after a reply, type /hooks once inside Claude Code, or restart Claude Code. With the message summary enabled, Claude Notify runs claude -p with Haiku.
That call takes about 15 seconds and is counted on the subscription. Compile from the src folder by running build.cmd instead of using the Release exe.
The Stop hook covers all projects. To remove Claude Notify, click "הסר חיבור" (Remove connection), exit from the taskbar icon, and delete the folder %LOCALAPPDATA%\ClaudeNotify.
ClaudeNotify.exe/hooksclaude -pbuild.cmd05What to watch next
Duration and position do not apply to every toast. The range of 2 to 60 seconds, default 8, applies only when the companion window is enabled, and the countdown pauses while the pointer rests on that window.
A standard Windows notification ignores the number because Windows controls it. Position is companion-only as well: bottom right by default, or bottom left.
A Haiku summary takes about 15 seconds and is counted on the subscription. The summary text stays up to 30 words, with a word-count setting from 5 to 60.
If a toast still does not pop, turn off Do not disturb and Focus assist. %APPDATA%\ClaudeNotify\log.txt records counts only, never the reply. The source code is in the src folder. Every code change publishes a new Release automatically. .NET Framework 4.8 is already built into Windows 10 and 11, and the license is MIT, in LICENSE.
If a toast still does not pop, turn off Do not disturb and Focus assist. %APPDATA%\ClaudeNotify\log.txt records counts only, never the reply. The source code is in the src folder. Every code change publishes a new Release automatically. .NET Framework 4.8 is already built into Windows 10 and 11, and the license is MIT, in LICENSE.
Frequently asked questions
How do I install Claude Notify on Windows?
Run ClaudeNotify.exe, which needs no installer and no administrator permissions, then click "התקן חיבור ל-Claude Code" (Install connection to Claude Code). The button copies the program to %LOCALAPPDATA%\ClaudeNotify, adds a Stop hook to %USERPROFILE%\.claude\settings.json for every project, and writes settings.json.bak without changing other settings. Check "הפעל עם Windows" (Run with Windows) and save if it should start with Windows.
Why does the Claude Notify summary take about 15 seconds?
With the message summary on, Claude Notify runs claude -p using Haiku, which takes about 15 seconds and is counted on the subscription. The summary is up to 30 words, and the word-count setting accepts 5 to 60. When the summary is off, or if it fails, the start of the message shows immediately.
Does Claude Notify alert when the editor is already visible?
No. If the editor window is visible, fully or partly, Claude Notify shows nothing. It shows a notification when that window is minimized or completely covered, and a click raises the project's VS Code window and opens the matching conversation even if several VS Code windows are open.
What should I check if a Claude Notify toast never appears?
Type /hooks once in Claude Code, or restart Claude Code, and turn off Do not disturb and Focus assist. The 2-to-60-second duration, default 8, applies only while the companion window is enabled, because a normal Windows toast ignores it. The unsigned exe can also trip SmartScreen on first run ("מידע נוסף", then "הפעל בכל זאת"), and %APPDATA%\ClaudeNotify\log.txt stores counts only, not the reply.
How do I remove Claude Notify?
Click "הסר חיבור" (Remove connection) in the settings window, exit from the taskbar icon, and delete %LOCALAPPDATA%\ClaudeNotify. Open settings by double-clicking the icon or by running ClaudeNotify.exe again. A right-click on the icon turns notifications off and leaves the Stop hook in place.
Sources
Author
Dillip Chowdary
Writes Tech Bytes coverage of AI, engineering, and the tools that actually ship. Editor of Tech Pulse Daily.
Related on Tech Bytes
Advertisement