Claude Code Notifier — صدا و اعلانِ پایان کار

وقتی Claude Code کارش تمام می‌شود، منتظر تو می‌ماند، یا با خطا متوقف می‌شود، یک صدا پخش می‌کند و یک اعلانِ دسکتاپ نشان می‌دهد — تا لازم نباشد به صفحه زل بزنی.

Plays a sound and shows a desktop notification when Claude Code finishes, waits for you, or stops with an error. Cross-platform, and works both in VS Code and in the terminal.

ویژگی‌ها / Features

صداهای متمایز برای هر رویداد: پایانِ کار / منتظرِ تو / درخواست اجازه / خطا.
اعلانِ دسکتاپ (Windows / macOS / Linux).
هم در VS Code، هم در ترمینال: از طریق hookهای Claude Code کار می‌کند، پس جهانی است (نه فقط داخل ادیتور).
fire-and-forget: صدا/اعلان در پس‌زمینه اجرا می‌شود و Claude را کند نمی‌کند.
امن و قابل‌بازگشت: hookهای فعلی‌ات قبل از تغییر بک‌آپ می‌شوند و با Disable بازمی‌گردند. بدون شبکه، بدون eval.

چطور کار می‌کند؟ / How it works

افزونه یک نسخه از notify.js و صداها را در ~/.claude/claude-notify/ می‌گذارد و چهار hook را در ~/.claude/settings.json تنظیم می‌کند: Stop → پایان، Notification → منتظر، PermissionRequest/Elicitation → اجازه/سؤال. هر hook دستورِ node "<…>/notify.js" <event> را صدا می‌زند. نیازی به Reload نیست — hookها در رویدادِ بعدیِ Claude اعمال می‌شوند.

نصب / Install

از Marketplace: در بخش Extensions عبارت Claude Notifier را جستجو و نصب کنید (یا bakhtarimohammad.claude-code-notifications). بلافاصله فعال می‌شود.

از ترمینال (بدون VS Code):

node bin/cc-notify.js install   # تنظیم hookها (با بک‌آپ)
node bin/cc-notify.js test      # تستِ صدا + اعلان
node bin/cc-notify.js remove    # بازگرداندن hookهای اصلی

دستورها / Commands

دستور	کار
`Claude Notifier: Enable`	نصب hookها
`Claude Notifier: Disable`	بازگرداندن hookهای اصلی
`Claude Notifier: Test`	تستِ صدا + اعلان
`Claude Notifier: Show Log`	لاگ

تنظیمات / Settings

کلید	پیش‌فرض	توضیح
`claudeNotifier.enabled`	`true`	فعال‌بودن
`claudeNotifier.sound`	`true`	پخش صدا
`claudeNotifier.desktop`	`true`	اعلانِ دسکتاپ
`claudeNotifier.onFinish`	`true`	اعلان موقع اتمام (Stop)
`claudeNotifier.onWaiting`	`true`	اعلان موقع انتظار/Notification
`claudeNotifier.onPermission`	`true`	اعلان موقع درخواست اجازه/سؤال

برگرداندن کامل / Full revert

قبل از حذفِ افزونه، یک‌بار Claude Notifier: Disable را اجرا کن تا hookهای اصلیِ settings.json بازگردانده شوند.

نکته‌ها / Notes

به node روی PATH نیاز است (چون Claude Code خودش با Node اجرا می‌شود، معمولاً هست). صداها فایل‌های کوچک WAV هستند که با OS-playerِ بومی پخش می‌شوند (PowerShell SoundPlayer / afplay / paplay).
اعلانِ دسکتاپ: روی ویندوز balloon، روی مک osascript، روی لینوکس notify-send.

لایسنس / License

MIT.