Claude Code Notify

让你的 Claude Code 在任务完成时弹出 macOS 右上角横幅通知 🔔

• ✅ 任务完成 自动弹通知，带回复摘要
• ✅ 需要确认 不同声音提醒（Ping）
• ✅ 纯原生 macOS 通知，无需安装第三方工具
• ✅ 一条命令安装，小白友好

效果预览

┌─────────────────────────────────────┐
│  Claude Code · 任务完成              │
│  点击回到 VS Code                    │
│  已帮你完成代码重构，提取了 3 个…🔔  │
└─────────────────────────────────────┘

一键安装

在终端里粘贴运行：

curl -fsSL https://raw.githubusercontent.com/Ethan-Tang/claude-code-notify/main/install.sh | bash

把 Ethan-Tang 换成你的 GitHub 用户名。

手动安装

# 1. 下载脚本
mkdir -p ~/.claude/scripts
curl -o ~/.claude/scripts/notify.sh https://raw.githubusercontent.com/Ethan-Tang/claude-code-notify/main/notify.sh
chmod +x ~/.claude/scripts/notify.sh

# 2. 配置 hooks（加到 ~/.claude/settings.json 的 "hooks" 字段）

在 ~/.claude/settings.json 中添加：

"hooks": {
  "Stop": [{
    "hooks": [{
      "type": "command",
      "command": "bash ~/.claude/scripts/notify.sh"
    }]
  }],
  "Notification": [{
    "hooks": [{
      "type": "command",
      "command": "bash ~/.claude/scripts/notify.sh"
    }]
  }],
  "SubagentStop": [{
    "hooks": [{
      "type": "command",
      "command": "bash ~/.claude/scripts/notify.sh"
    }]
  }]
}

通知类型

事件	标题	声音	说明
Stop	Claude Code · 任务完成	Glass	每次回答完触发
Notification	Claude Code · 需要确认	Ping	需要你确认时触发
SubagentStop	Claude Code · 任务完成	Glass	后台子任务完成

常见问题

Q: 收不到通知？ A: 脚本用的是 macOS 原生 osascript，不需要额外权限。如果收不到，检查 系统设置 > 通知 > 脚本编辑器（或终端），确认允许通知。

Q: 通知内容太长？ A: 超过 60 字自动截断，只显示一行。

许可

MIT