paleech0

Claude Code Popup Notify — Development skill for Claude Code

Development community

Claude Code 权限申请桌面弹窗 + 空闲通知（tkinter，零依赖，高 DPI 自适应）.

How to install Claude Code Popup Notify

This entry records only its repository, not the path inside it, so there is no exact command to give. Open paleech0/claude-code-popup-notify and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Claude Code Popup Notify does

Claude Code 权限申请桌面弹窗 + 空闲通知（tkinter，零依赖，高 DPI 自适应）.

Alternatives in Development

Serenity Stock Choke — A股/港股/美股卡脖子选股 Skill，基于 Serenity 供应链瓶颈理论 Claude Code / Codex 通用智能体可用，零依赖 487 ★
Tmux Claude Session Manager — Run many Claude Code sessions across your projects, each in its own tmux session — then list them, see which a 380 ★
HeiGe GEO SEO — 中国市场优先的 GEO(生成式引擎优化)+ SEO 内容优化系统:让内容被豆包/千问/DeepSeek/文心/元宝/ChatGPT/Perplexity 引用 52 ★

README

Claude Code Popup Notify

把 Claude Code 的权限申请变成 Windows 桌面弹窗——后台运行时不错过权限确认，前台时自动静默不打扰。

灵感来自 [KYinCode/claude-code-popup-hooks](https://github.com/KYinCode/claude-code-popup-hooks)，在其基础上重构并大幅增强。

功能特性

权限弹窗：CC 申请权限时弹出交互式窗口，显示中文概述 + 工具名 + 命令详情
问询预览：CC 向用户提问（AskUserQuestion）时，弹窗展示问题内容和选项列表，确认后由 CC 原生界面收答案
空闲通知：CC 完成任务等待输入时弹窗提醒，6 秒自动消失
前台检测：终端在前台时自动跳过弹窗，不打扰当前工作（Windows 完整支持）
超时机制：60 秒未操作自动拒绝，带实时倒计时
静默模式：一键将弹窗最小化到任务栏，不抢焦点，点任务栏图标可恢复
空闲屏蔽：空闲通知可临时关闭，重启 CC 后自动恢复（同一会话内有效）
记住规则：「同意并记住」将权限规则持久化到本地设置，下次自动通过
键盘快捷键：Enter 同意 · Esc 拒绝 · Ctrl+Enter 同意并记住
窗口自适应：弹窗按内容实际渲染尺寸自动调整大小（长文本自动撑高），选项超长时自动出现滚动条，底部按钮永不被顶出窗口
高 DPI 适配：150% 等屏幕缩放下窗口按逻辑像素统一换算，不会超出屏幕或被截走按钮

安装前提

Python 3（任一版本均可）
无需 pip install——仅依赖标准库（tkinter、ctypes、json 等）
Windows / macOS / Linux 均可运行（前台检测全平台支持，VS Code / Cursor 内置终端除外,二者必定弹窗）

安装

方式一：一行命令（推荐）

**Windows（PowerShell）：**

md "$env:USERPROFILE\.claude\hooks" -Force; Invoke-WebRequest -Uri "https://raw.githubusercontent.com/paleech0/claude-code-popup-notify/main/cc-notify.py" -OutFile "$env:USERPROFILE\.claude\hooks\cc-notify.py"

**macOS / Linux：**

mkdir -p ~/.claude/hooks && curl -o ~/.claude/hooks/cc-notify.py https://raw.githubusercontent.com/paleech0/claude-code-popup-notify/main/cc-notify.py

然后用下面的配置完成安装。

方式二：安装脚本（Windows）

下载仓库中的 `install.ps1`，右键 → 使用 PowerShell 运行。脚本会自动完成下载和配置。

配置 hooks

在 `~/.claude/settings.json` 中添加以下配置。如果文件已有其他内容，将 `"hooks"` 块合并进去：

{
  "hooks": {
    "PermissionRequest": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "python ~/.claude/hooks/cc-notify.py"
          }
        ]
      }
    ],
    "Notification": [
      {
        "matcher": "idle_prompt",
        "hooks": [
          {
            "type": "command",
            "command": "python ~/.claude/hooks/cc-notify.py"
          }
        ]
      }
    ]
  }