Claude Code桌面消息通知配置全攻略
适用场景:Claude Code 在后台跑任务时,你不想盯着终端;当它需要授权、需要你回答问题、或任务结束时,让系统直接弹出桌面通知提醒你回来处理即可。
本文仅包含桌面通知,不含钉钉/企业微信等第三方通知。

1. 前言:为什么要给 Claude Code 加“消息提醒”?
Claude Code 在实际使用中经常出现这些“你离开就错过”的节点:
- 需要你确认权限(读写文件、执行命令、联网检索等)
- 需要你回答一个关键问题才能继续(AskUserQuestion / elicitation)
- 任务已经完成,但你不知道它何时跑完
解决思路很简单:利用 Claude Code 的 hooks 机制,在特定事件发生时自动执行一条命令,去调用一个 Python 脚本发送桌面通知。
2. 效果展示
配置完成后,你会在以下时机收到系统通知(Windows 通知中心):
- 需要授权时:弹出“需要授权...”
- 任务结束时:弹出“任务完成...”
- 认证成功/空闲等待时:弹出相应提示
3. 环境准备:Python + plyer
3.1 准备 Python(建议虚拟环境)
确保你能在本机正常运行 Python。建议为脚本建一个独立目录并创建 venv:
python -m venv .venv
3.2 安装桌面通知库 plyer
pip install plyer
4. 通知脚本详解:send_notification.py(完整代码 + 说明)
下面是一个“够用且干净”的桌面通知脚本:从命令行接收消息内容,可选 --title 自定义标题。
import sys
import argparse
from plyer import notification
def send_notify(title: str, message: str) -> None:
notification.notify(
title=title,
message=message,
timeout=3, # 通知停留时间(秒),可按需调整
)
def main() -> None:
parser = argparse.ArgumentParser(description="Send desktop notification.")
parser.add_argument("message", nargs="+", help="Notification message")
parser.add_argument("--title", default="Claude Code 通知", help="Notification title")
args = parser.parse_args()
message = " ".join(args.message)
send_notify(args.title, message)
if __name__ == "__main__":
main()4.1 先手动验证脚本是否能弹通知
在命令行执行:
python send_notification.py 任务完成啦 --title Claude
能正常弹出桌面通知后,再进入下一步(hooks 配置)。
5. Claude Code 配置详解:settings.json(结构 + 关键点)
Claude Code 的 settings.json 里,我们主要用两部分:
env:环境变量(我用的是GML4.7)hooks:事件触发器(本文核心)
6. hooks 触发点怎么选?(三类足够覆盖大多数场景)
你现有配置的思路非常实用,基本分三类:
- PermissionRequest:需要授权时提醒(最重要)
- Notification:状态类提醒(认证成功、空闲等待、需要你补充信息)
- Stop:任务结束提醒
hooks 的执行方式是 type: "command",本质就是“跑一条命令”,我们把命令写成调用 Python 脚本即可。
7. 可直接复用的配置模板
把下面模板按需替换路径即可(重点替换两处:你的 python.exe 路径与 send_notification.py 路径)。
注意:JSON 字符串中 Windows 路径需要写双反斜杠
\\。
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "***",
"ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic",
"API_TIMEOUT_MS": "3000000",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
},
"hooks": {
"PermissionRequest": {
"0": {
"matcher": "Task|TaskOutput|Bash|Glob|Grep|ExitPlanMode|Read|Edit|Write|NotebookEdit|WebFetch|TodoWrite|WebSearch|KillShell|AskUserQuestion|Skill|EnterPlanMode",
"hooks": {
"0": {
"type": "command",
"command": "D:\\\\MyCodes\\\\ClaudeScript\\\\.venv\\\\Scripts\\\\python.exe D:\\\\MyCodes\\\\ClaudeScript\\\\send_notification.py 需要授权..."
}
}
}
},
"Notification": {
"0": {
"matcher": "permission_prompt|idle_prompt|auth_success|elicitation_dialog",
"hooks": {
"0": {
"type": "command",
"command": "D:\\\\MyCodes\\\\ClaudeScript\\\\.venv\\\\Scripts\\\\python.exe D:\\\\MyCodes\\\\ClaudeScript\\\\send_notification.py Claude Code 有新状态..."
}
}
}
},
"Stop": {
"0": {
"matcher": "",
"hooks": {
"0": {
"type": "command",
"command": "D:\\\\MyCodes\\\\ClaudeScript\\\\.venv\\\\Scripts\\\\python.exe D:\\\\MyCodes\\\\ClaudeScript\\\\send_notification.py 任务完成..."
}
}
}
}
}
}7.1 我建议你这样改得更“可读”
你可以把三条命令的文案改得更直观,例如:
- PermissionRequest:
需要授权:请回到 Claude Code 确认 - Notification:
Claude Code 等待你的输入/选择 - Stop:
Claude Code 已完成本次任务
8. 常见问题 FAQ(踩坑集中区)
Q1:不弹通知,但脚本手动运行是好的?
- 检查
settings.json中命令路径是否正确(尤其是python.exe与脚本路径) - 确保 JSON 中反斜杠写成
\\ - 先把 command 简化成最短可运行版本排查路径问题
Q2:弹了通知,但内容不对/中文乱码?
- Windows 通知一般不会乱码;如果异常,检查终端编码与脚本文件编码(建议 UTF-8)
- 尽量避免把特殊符号塞进命令行参数(必要时用简短文本)
Q3:PermissionRequest 为什么匹配这么多?
matcher是你希望提醒的“高频需要确认”的操作集合(读写文件、执行命令、联网检索等)- 不想太吵:从
matcher里删掉不关心的项即可(例如删掉Glob|Grep等)
Q4:通知太快消失?
- 把
timeout从3改成5或更长
9. 结语:这套配置带来的真实价值
配置好桌面通知后,你就不需要一直盯着 Claude Code 的输出:
- 该你授权时叫你回来
- 该你回答时提醒你
- 跑完了告诉你结果已就绪
对日常写代码、跑脚本、生成文档、长任务迭代非常省心。
以上就是Claude Code桌面消息通知配置全攻略的详细内容,更多关于Claude Code桌面消息通知配置的资料请关注脚本之家其它相关文章!
相关文章

OpenCode安装及配置Claude Opus 4.6模型完整指南
本文介绍了如何从零开始在不同操作系统上安装并配置OpenCode,这是一款100%开源的AI编码代理,文章详细解释了使用NodeJS安装、配置模型以及安装antigravity+geminiclioauth插2026-04-29
Qwen3.6-27B 本地私有化部署 + Claude Code 连接应用
本文主要介绍 Qwen3.6-27B 的本地私有化部署过程,部署采用vLLM 引擎,以及将 Claude Code 指向使用私有化部署的模型,并且开发一个五子棋的网页小游戏,以及针对开源项目2026-04-29
Claude Code接入SonarQube静态扫描的实战指南
SonarQube 是业界最流行的代码质量平台之一,能检测 Bug、漏洞、坏味道、安全热点,还能统计覆盖率和重复代码,而现在,它可以直接集成进 Claude Code,让 AI 在帮你写代码2026-04-28
Claude Code零改动接入DeepSeek V4的详细过程
文章介绍了cc-use工具,作为ClaudeCodeDe的启动器,解决了在不同不同Anthropop提供者之间切换时环境变量冲突的问题,文章详细描述了如何使用cc-use工具接通DeepSeekV4端点,需2026-04-28
这篇文章主要为大家详细Claude Code的核心用法,包括精简上下文、先规划后编码、强制自我验证,通过标准四步工作流与实战 Prompt助你 5 分钟上手,让 AI 成为编程神队友,有2026-04-28
Claude Code是Anthropic推出的面向开发者的AI编程协作工具, Claude Code定位不是聊天,而是在本地代码仓库中执行高权限、可上下文感知的工程任务,这篇文章主要介绍了使用cla2026-04-27
ClaudeCode是Anthropicc推出的AI编程搭档,具备上下文感知、工程化导向和可定制行为特征,本文介绍了其安装配置、与第三方平台CodingPlan的的集成,并通过IDE插件在Idea中使用2026-04-27
Claude Code GitHub Actions 使用详细步骤
ClaudeCode是Anthropic推出的GitHubActions工具,能自动分析代码、创建PR、实现功能并修复错误,本文介绍了如何通过AceDataCloud的代理服务配置和使用ClaudeCodeGitHubAction2026-04-27
本文详细介绍了如何安全干净地升级ClaudeCode和OpenCode两大工具至最新版本,内容包括检查当前版本,备份配置文件,关闭运行中的会话及解决常见问题的方法,希望对大家有所2026-04-26
这篇文章提供了详细的卸载Claude和Opencaed的方法,包括确认安装方式,卸载命令,清理残留配置文件和环境变量等几个步骤,文章还提供了针对不同安装方式的具体操作,希望对大2026-04-26











最新评论