Claude Code人工确认与任务结束提醒配置

adrninistrat0r

376人浏览 · 2026-07-04 23:19:08

adrninistrat0r · 2026-07-04 23:19:08 发布

1. Claude Code人工确认与任务结束提醒配置（Windows）

1.1. 概述

Claude Code 支持 hook 机制，可利用其 Stop 与 Notification 事件实现桌面提醒功能。配置后，无需持续关注 Claude Code 的执行过程：当任务结束或需要用户确认时，系统会以声音与弹窗的方式即时提醒。

1.2. 提醒的作用

任务结束提醒：任务执行完成时弹出"任务完成"窗口并通过声音提醒。
需要确认提醒：Claude Code 需要用户授权时（如执行需权限的命令），弹出"需要确认"窗口，正文显示具体待确认内容，并通过声音提醒。

弹窗以独立进程弹出，不阻塞 Claude Code 的执行。

1.3. 环境要求

仅支持 Windows。推荐 Windows 10 / 11；Windows 7 / 8 / 8.1 也可运行，但需注意：

弹窗（WScript.Shell.Popup）自 Win7 起均可用。
声音（[console]::Beep）：Win10+ 经默认音频设备播放，可靠有声；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 等字段，予以保留，仅增改 hooks）：

"hooks": {
  "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\""
        }
      ]
    }
  ]
}