Claude Code人工确认与任务结束提醒配置
1. Claude Code人工确认与任务结束提醒配置Windows1.1. 概述Claude Code 支持 hook 机制可利用其Stop与Notification事件实现桌面提醒功能。配置后无需持续关注 Claude Code 的执行过程当任务结束或需要用户确认时系统会以声音与弹窗的方式即时提醒。1.2. 提醒的作用任务结束提醒任务执行完成时弹出任务完成窗口并通过声音提醒。需要确认提醒Claude Code 需要用户授权时如执行需权限的命令弹出需要确认窗口正文显示具体待确认内容并通过声音提醒。弹窗以独立进程弹出不阻塞 Claude Code 的执行。1.3. 环境要求仅支持 Windows。推荐 Windows 10 / 11Windows 7 / 8 / 8.1 也可运行但需注意弹窗WScript.Shell.Popup自 Win7 起均可用。声音[console]::BeepWin10 经默认音频设备播放可靠有声Win7/8/8.1 经 PC 喇叭播放无喇叭的机器可能无声。需要确认弹窗的具体内容依赖ConvertFrom-Json需 PowerShell 3.0。Win8 自带Win7 默认为 PowerShell 2.0需安装 Windows Management Framework 5.1。未安装时弹窗仍可弹出但不显示具体内容不会报错。依赖系统自带powershell.exe、已安装 Claude Code。1.4. 配置方式编辑 Claude Code 用户配置文件~/.claude/settings.json路径为C:\Users\用户名\.claude\settings.json将以下hooks字段合并至其中若已存在env、mcpServers等字段予以保留仅增改hookshooks:{Notification:[{matcher:,hooks:[{type:command,command:powershell.exe -NoProfile -ExecutionPolicy Bypass -Command \[console]::Beep(800,250);Start-Sleep -Milliseconds 80;[console]::Beep(1000,250);Start-Sleep -Milliseconds 80;[console]::Beep(1200,400);[Environment]::SetEnvironmentVariable(CCT,Claude Code - 需要确认,Process);[Environment]::SetEnvironmentVariable(CCX,(Claude 需要你的确认[char]13[char]10[char]13[char]10( { if ([Console]::IsInputRedirected){try{[string]((ConvertFrom-Json([Console]::In.ReadToEnd())).message)}catch{}}else{}})),Process);Start-Process powershell -ArgumentList -NoProfile,-Command,(New-Object -ComObject WScript.Shell).Popup([Environment]::GetEnvironmentVariable(CCX),0,[Environment]::GetEnvironmentVariable(CCT),48)|Out-Null -WindowStyle Hidden\}]}],Stop:[{matcher:,hooks:[{type:command,command:powershell.exe -NoProfile -ExecutionPolicy Bypass -Command \[console]::Beep(523,280);Start-Sleep -Milliseconds 180;[console]::Beep(784,280);Start-Sleep -Milliseconds 180;[console]::Beep(1047,280);Start-Sleep -Milliseconds 180;[console]::Beep(1568,420);[Environment]::SetEnvironmentVariable(CCT,Claude Code - 任务完成,Process);[Environment]::SetEnvironmentVariable(CCX,Claude 已完成任务请查看结果。,Process);Start-Process powershell -ArgumentList -NoProfile,-Command,(New-Object -ComObject WScript.Shell).Popup([Environment]::GetEnvironmentVariable(CCX),15,[Environment]::GetEnvironmentVariable(CCT),64)|Out-Null -WindowStyle Hidden\}]}]}command为单行 JSON 字符串复制时请保持原样勿折行其中\为 JSON 转义引号为 PowerShell 内嵌单引号均为必要字符。保存后重启 Claude Codehook 于启动时加载。重启后令 Claude Code 完成一个任务或执行一个需授权的命令即可触发对应提醒。1.5. 提醒效果任务结束Stop 事件于 Claude Code 回复结束时触发声音C5 → G5 → C6 → G6523 / 784 / 1047 / 1568 Hz四声升调每声 280ms、间隔 180ms、末声 420ms。弹窗标题Claude Code - 任务完成正文Claude 已完成任务请查看结果。15 秒后自动关闭。需要确认Notification 事件于 Claude Code 需要授权时触发声音800 → 1000 → 1200 Hz三声升调。弹窗标题Claude Code - 需要确认正文动态拼接实际待确认内容取自 hook 传入 JSON 的message字段常驻直至用户点击 OK。1.6. 自定义提醒方式声音、弹窗文案、停留时长、图标等均可调整。可直接以自然语言向 Claude Code 提出修改要求例如“把任务完成的声音改成 3 声下行音调”“需要确认的弹窗 10 秒后自动关闭”“弹窗正文改成英文”“只保留声音去掉弹窗的系统提示音”“任务完成改用《欢乐颂》开头几个音”Claude Code 将直接修改settings.json中对应脚本并当场播放或触发以确认效果。
)
)
