Cc Notify Pretty

Claude Code 通知工具

工具简介

`notify-pretty.sh` 是一个 macOS 通知脚本，用于在 Claude Code CLI 工具执行任务时向用户发送桌面通知。

背景与痛点

在使用 AI Coding 工具（尤其是 Claude Code）进行开发时，我们经常会遇到这样的场景：

• 多项目并行开发：同时在多个项目中让 Claude Code 帮忙写代码、修 bug、做重构
• 任务完成时间不确定：AI 处理任务的时间长短不一，可能几秒，也可能几分钟
• 需要频繁切换查看：不知道什么时候任务完成，只能时不时切回去看一眼，打断工作流

这种"人工轮询"的方式既低效又分散注意力。

**好消息是**，Claude Code 提供了丰富的 [Hooks 机制](https://docs.anthropic.com/en/docs/claude-code/hooks)，允许我们在特定事件（如任务完成、需要授权等）发生时执行自定义命令。

利用这个能力，我们可以：

• 🔔 任务完成时自动发送桌面通知
• 🔐 需要授权时及时提醒
• 📱 甚至可以扩展为发送微信、钉钉、Slack 等消息推送

本项目就是基于 Claude Code Hooks 实现的 **macOS 桌面通知方案**。

---

快速安装指南

按照以下步骤，从零开始安装配置 Claude Code 通知工具。

前置要求

• macOS 系统
• 已安装 Claude Code CLI
• 已安装 Homebrew（用于安装 terminal-notifier）

第 1 步：安装 terminal-notifier

brew install terminal-notifier

第 2 步：创建目录结构

mkdir -p ~/.claude/scripts
mkdir -p ~/.claude/icons

第 3 步：复制 terminal-notifier 为自定义应用

# 复制 terminal-notifier.app 作为 claude-notifier.app
cp -R /opt/homebrew/Cellar/terminal-notifier/2.0.0/terminal-notifier.app ~/.claude/claude-notifier.app

# 注意：如果你的 Homebrew 安装在其他位置（如 Intel Mac），路径可能是：
# /usr/local/Cellar/terminal-notifier/2.0.0/terminal-notifier.app

第 4 步：准备 Claude 图标

下载或创建一个 Claude 图标（PNG 格式，建议至少 256x256 像素），保存到：

~/.claude/icons/claude_icon.png

第 5 步：生成并替换图标

# 创建 iconset 目录
mkdir -p /tmp/claude.iconset

# 生成各种尺寸的图标
sips -z 16 16     ~/.claude/icons/claude_icon.png --out /tmp/claude.iconset/icon_16x16.png
sips -z 32 32     ~/.claude/icons/claude_icon.png --out /tmp/claude.iconset/icon_16x16@2x.png
sips -z 32 32     ~/.claude/icons/claude_icon.png --out /tmp/claude.iconset/icon_32x32.png
sips -z 64 64     ~/.claude/icons/claude_icon.png --out /tmp/claude.iconset/icon_32x32@2x.png
sips -z 128 128   ~/.claude/icons/claude_icon.png --out /tmp/claude.iconset/icon_128x128.png
sips -z 256 256   ~/.claude/icons/claude_icon.png --out /tmp/claude.iconset/icon_128x1