说实话，作为开发者，我们Zui怕的往往不是代码写不出来而是那种“等待的焦虑”。你把任务丢给 Claude Code，自己切去刷网页或者回邮件，心里却总挂着个念想：它跑完了吗？是不是卡住了？还是早就报错停在那儿了？这种时不时切回终端kan一眼的日子，真的太折磨人了。

既然我们用的是 Windows 系统，为什么不把系统自带的强大通知功Neng利用起来呢？想象一下当 AI 完成任务、遇到错误或者需要你审批权限时右下角直接弹出一个优雅的 Toast 提示，那该多省心。今天我就手把手教大家如何通过配置 Hooks，给 Claude Code 装上“嘴巴”，让它主动向你汇报工作。

准备工作：工欲善其事，必先利其器

在开始折腾配置文件之前，我们得先确保手头的工具是齐全的。既然是 Windows 原生通知，我们肯定离不开 Python 的一个神器库——win11toast。别担心，安装过程简单得令人发指。

打开你的终端，敲下这行命令：

pip install win11toast

安装完了别急着高兴，咱们先Zuo个小测试，确保这玩意儿Neng在你的电脑上正常工作。毕竟环境配置这种事，总是充满了各种玄学问题。输入下面这行 Python 代码试试：

python -c "from win11toast import toast; toast"

Ru果屏幕右下角乖乖弹出了通知框，恭喜你，第一步通关！要是没动静……嗯，别慌，试着强制重装一下：

pip install --force-reinstall win11toast

当然前提是你Yi经全局安装了 Claude Code。Ru果你还没装，可Neng需要用 npm 或者 nvm 搞定它，比如 npm install -g @anthropic-ai/claude-code。不过这部分咱们今天就不细展开了毕竟今天的重点是“提醒”。

核心原理：Hooks 是什么鬼？

hen多朋友kan到 JSON 配置文件就头大，其实大可不必。Claude Code 提供了一套非常灵活的机制，叫Zuo Hooks。你Ke以把它想象成一个不知疲倦的“监听器”或者“哨兵”。

它的逻辑非常简单：当特定事件发生时 → 触发预设脚本 → 执行你想要的操作。在这个场景里我们要执行的操作就是调用 Python 的 win11toast 库来弹窗。所以整个流程就是：AI 停下来了 → 触发 Stop 事件 → 运行 Python 脚本 → 你的屏幕亮起通知。

所有的配置dou藏在一个叫 settings.json 的文件里。通常它的位置在 C:\Users\你的用户名\.claude\settings.json。找到它，用你喜欢的编辑器打开，咱们准备大干一场。

场景一：AI 停止时立刻通知我

这是Zui常用的场景。你让 AI 去跑一个复杂的重构任务，然后自己去摸鱼了。Ru果它突然停了——无论是任务完成，还是遇到报错卡死——你dou得第一时间知道。

我们需要监听 Stop 事件。在 settings.json 中找到hooks 字段，然后像下面这样配置：

{
  "hooks": {
    "Stop": 
      }
    ]
  }
}

这段代码kan起来有点绕，其实逻辑hen清晰。我们通过 bash -c 调用了一行 Python 代码，这行代码的作用就是弹出一个标题为“Claude Code”，内容为“AI Yi停止，请检查状态”的 Windows 通知。

场景二：会话结束，防止遗漏

有时候对话结束了可Neng是因为超时也可Neng是你主动关闭了窗口。这时候，弹个窗Neng让你确认一下是不是还有什么待办事项没处理。这就是 SessionEnd 事件的用武之地。

配置方法大同小异，我们把事件名换成 SessionEnd

"SessionEnd": 
  }
]

这样一来每次会话终结，你dou会收到一个温柔的提醒：“嘿，咱们刚才聊完啦。”

场景三：权限请求，安全第一

Claude Code 在执行某些敏感操作时是需要你批准的。Ru果你没盯着终端，可Neng根本没注意到它在等你点头。这要是错过了AI 就傻傻地在那儿干等着，效率大打折扣。

针对 PermissionRequest 事件，我们Ke以加一个稍微紧迫一点的提醒：

"PermissionRequest": 
  }
]

kan到这个弹窗，你就知道 AI 正在眼巴巴地kan着你，等着你拿主意呢。

进阶玩法：错误处理与组合拳

除了上面这些常规操作，我们还Neng玩点花的。比如当工具执行失败时我想知道具体的错误类型，这时候就Ke以利用 PostToolUseFailure 事件。

你Ke以配置成这样：

"PostToolUseFailure": 
  }
]

甚至，同一个事件是Ke以触发多条通知的。比如在 SessionEnd 的时候，你既想弹个窗，又想顺便记录个日志，完全Ke以把多个命令放在数组里。或者，你Ke以写一个独立的 Python 脚本来读取你的待办事项列表，然后在会话结束时提醒你还有多少活没干完。

举个例子，你Ke以写个简单的脚本放在 ~/.claude/hooks/check-reminders.py

import os
from win11toast import toast
reminder_file = os.path.expanduser
if os.path.exists:
    with open as f:
        lines = f.readlines
    if lines:
        count = len
        toast

然后在 Hook 里调用它，是不是感觉瞬间高大上了？

如何优雅地合并配置

hen多朋友kan到这儿可Neng会问：“我的 settings.json 里Yi经有一堆配置了直接复制粘贴会不会把原来的搞乱？”

这是个好问题。千万别直接覆盖！你要Zuo的是“合并”。把你现有的 hooks 字段里的内容保留下来然后把上面提到的 StopSessionEndPermissionRequest 这几个块，像搭积木一样加进去。Ru果某个事件Yi经存在那就把新的配置追加到数组里而不是替换掉整个数组。

Ru果你实在不想手动改 JSON，其实还有一个偷懒的办法：直接把你的需求发给 Claude Code 自己！你Ke以这样对它说：

帮我把 win11toast 提醒加到 Claude Code 的 hooks 配置里。需要监听三个事件：Stop 时弹出“AI Yi停止，请检查状态”；SessionEnd 时弹出“会话Yi结束”；PermissionRequest 时弹出“需要你批准某个操作”。配置文件在 C:\Users\singsky\.claude\settings.json，保留现有所有 hooks 不变，只新增这三个事件。

相信我，它改配置文件的速度比你快多了而且还不容易出错。你只需要Zui后确认一下结果就行。

排查：为什么弹窗没出来？

配置dou改好了重启了 Claude Code，结果死活没弹窗？别急，咱们按步骤排查一下。

确认 win11toast 本身是不是好的。手动跑一下测试命令：

python -c "from win11toast import toast; toast"

Ru果这一步dou没弹窗，那说明 Python 环境或者库安装有问题，得重装或者检查路径。Windows 上有时候 Python 不在全局 PATH 里你可Neng需要用完整路径调用。

Ru果这一步弹窗正常，那问题多半出在配置文件上。检查一下 JSON 格式对不对，有没有少逗号，或者转义字符有没有搞错。特别是那些反斜杠 \，在 JSON 里可是需要写成 \\ 的。

Zui后别忘了重启 Claude Code！修改配置后不重启是不会生效的。关掉当前的会话，重新开一个对话，再试试kan。

写在Zui后

加上 Windows Toast 提醒后你会发现整个人dou轻松了。人和 AI 并行工作，Zui怕的就是信息不同步。现在AI 什么时候停了、什么时候需要你、什么时候出错了你douNeng第一时间掌握。这种掌控感，真的Neng极大提升开发效率。

当然本文的方案主要针对 Windows 用户。Ru果你是 Mac 党，可Neng得去研究研究 osascript 或者 terminal-notifier 之类的工具了。不过原理dou是通用的，触类旁通嘛。

赶紧去试试吧，配置好之后把任务丢给 AI，然后安心地去泡杯咖啡。等到右下角弹窗亮起的那一刻，你会感谢现在动手的自己。省心十成，绝对不是说说而Yi！

---