Claude Code + Windows 桌面消息通知配置指南

Claude Code Windows 桌面通知配置指南

让 Claude Code 在完成任务后自动弹出 Windows 桌面通知，不用一直盯着屏幕等。

前置条件

• Windows 10 或 Windows 11
• Claude Code CLI 已安装并能正常使用

安装步骤

第一步：创建通知脚本

创建目录%USERPROFILE%\.claude\scripts\，然后在其中新建文件notify.ps1，内容如下：

param([string]$Title="Claude Code",[string]$Message="Task completed!")try{[void][Windows.UI.Notifications.ToastNotificationManager, Windows.UI.Notifications, ContentType = WindowsRuntime][void][Windows.Data.Xml.Dom.XmlDocument, Windows.Data.Xml.Dom, ContentType = WindowsRuntime]$AppId='{1AC14E77-02E7-4E5D-B744-2EB1AE5198B7}\WindowsPowerShell\v1.0\powershell.exe'$escapedTitle=[System.Security.SecurityElement]::Escape($Title)$escapedMessage=[System.Security.SecurityElement]::Escape($Message)$Template= @" <toast duration="short"> <visual> <binding template="ToastGeneric"> <text>$escapedTitle</text> <text>$escapedMessage</text> </binding> </visual> <audio src="ms-winsoundevent:Notification.Default"/> </toast> "@$Xml=New-ObjectWindows.Data.Xml.Dom.XmlDocument$Xml.LoadXml($Template)$Toast=[Windows.UI.Notifications.ToastNotification]::new($Xml)[Windows.UI.Notifications.ToastNotificationManager]::CreateToastNotifier($AppId).Show($Toast)}catch{Add-Type-AssemblyName System.Windows.Forms$NotifyIcon=New-ObjectSystem.Windows.Forms.NotifyIcon$NotifyIcon.Icon =[System.Drawing.SystemIcons]::Information$NotifyIcon.BalloonTipTitle =$Title$NotifyIcon.BalloonTipText =$Message$NotifyIcon.Visible =$true$NotifyIcon.ShowBalloonTip(10000)Start-Sleep-Seconds 5$NotifyIcon.Dispose()}

第二步：创建自定义命令（可选，支持手动发通知）

创建目录%USERPROFILE%\.claude\commands\，然后在其中新建文件notify.md，内容如下：

Send a Windows desktop toast notification to inform the user. The user typed: $ARGUMENTS If $ARGUMENTS is empty, use the default message: "Claude Code 任务完成！" Run this bash command to send the notification (replace <MESSAGE> with the notification text): ```bash powershell.exe -NoProfile -ExecutionPolicy Bypass -File "$(cygpath -w "$HOME/.claude/scripts/notify.ps1")" -Message "<MESSAGE>"

If cygpath is not available, use the Windows path directly:

powershell.exe-NoProfile-ExecutionPolicyBypass-Command"&\"$env:USERPROFILE\\.claude\\scripts\\notify.ps1\"-Message '<MESSAGE>'"

After sending the notification, briefly tell the user “已发送桌面通知”.

### 第三步：配置 Stop Hook（自动通知） 打开 `%USERPROFILE%\.claude\settings.json`，在 JSON 根对象中添加 `hooks` 字段。 **完整的 settings.json 示例：** ```json { "hooks": { "Stop": [ { "matcher": "", "hooks": [ { "type": "command", "command": "powershell.exe -NoProfile -ExecutionPolicy Bypass -File C:/Users/你的用户名/.claude/scripts/notify.ps1", "async": true } ] } ] } }

注意：把C:/Users/你的用户名/替换为同事的实际用户目录路径。可以用echo %USERPROFILE%在 cmd 中查看。

如果settings.json中已有其他配置（如env、enabledPlugins等），只需把hooks字段追加进去即可，不要覆盖原有内容。

第四步：验证

在 Claude Code 中直接输入以下内容让 Claude 发一条测试通知：

请运行 powershell.exe -NoProfile -ExecutionPolicy Bypass -File C:/Users/你的用户名/.claude/scripts/notify.ps1 -Title "测试" -Message "通知功能正常！"

如果右下角弹出 Windows Toast 通知，说明配置成功。

文件结构总览

%USERPROFILE%\.claude\ ├── scripts\ │ └── notify.ps1 ← 通知脚本（必需） ├── commands\ │ └── notify.md ← 手动命令（可选） └── settings.json ← Hook 配置（必需）

使用方式

常见问题

Q: 没有弹出通知？

• 确认 Windows 通知设置中没有禁用 PowerShell 的通知权限（设置 → 系统 → 通知）
• 确认文件路径正确，没有中文或特殊字符

Q: 每次回复都弹通知太频繁？

• 从settings.json中删除整个hooks字段即可关闭自动通知
• 只保留/notify手动命令，需要时再用

Q: 通知内容能自定义吗？

• 可以。手动通知通过/notify 消息内容自定义
• 自动通知的默认消息定义在notify.ps1的$Message参数默认值中，直接修改即可

实际效果演示：
在任务完成之后，自动弹窗通知，从此无需盯着命令行窗口，看任务有没有完成