Claude Code Notifier Plus

Get notified when Claude Code needs your attention — works in both CLI and VS Code extension mode.

🌐 中文说明

Why This Extension?

The official Claude Code VS Code extension handles notifications internally through its webview and does not trigger the Notification hook that CLI-based notifier extensions rely on. This means existing notifier extensions silently fail when you use Claude Code inside VS Code.

Claude Code Notifier Plus solves this by registering event-specific hooks that fire in both CLI and VS Code environments:

Features

• Dual-mode support — works whether you run Claude Code in the terminal or the VS Code extension
• Pure CLI support — notifications work even without VS Code running (direct terminal-notifier / osascript fallback)
• Click-to-focus — click a notification to jump directly to the corresponding window — VS Code project window or CLI terminal (Terminal.app, iTerm2, Warp, etc.) — auto-detected via VSCODE_PID for reliable source identification; notification auto-dismissed from Notification Center after click (macOS, requires terminal-notifier)
• OS-level notifications — native system notifications on macOS, Windows, and Linux (zero dependencies for basic mode)
• Task context — notifications include project name 📂 and task title 💬 so you know which tab needs attention
• Sound alerts — audible notification when Claude needs attention
• Focus-aware — optionally suppress notifications when VS Code is already focused
• Configurable delay — set a delay before the system notification fires; dismiss the VS Code popup within that window to cancel it
• Multi-instance safe — dedup prevents duplicate notifications across multiple VS Code windows
• Auto-install — hooks are automatically registered in ~/.claude/settings.json on activation
• i18n — supports English and Chinese, auto-detected from system locale

Installation

From VS Code Marketplace

Search for "Claude Code Notifier Plus" in the Extensions panel, or:

code --install-extension tutuge.claude-code-notifier-plus

From VSIX

code --install-extension claude-code-notifier-plus-1.0.0.vsix

After installation, reload VS Code (Cmd+Shift+P → "Developer: Reload Window").

Optional: Click-to-Focus (macOS)

For the best experience on macOS, install terminal-notifier:

brew install terminal-notifier

This enables:

• Clicking a notification to jump to the exact VS Code project window, or the CLI terminal (Terminal.app / iTerm2 / Warp) where Claude Code is running
• Custom notification icon

The extension will guide you through this on first launch.

⚡ Important (macOS): To enable click-to-focus on the exact project window, you need to grant Accessibility permission:

System Settings → Privacy & Security → Accessibility → Enable terminal-notifier

This permission allows the extension to raise the correct VS Code window when you click a notification. You only need to do this once. Without it, clicking a notification will activate VS Code but won't switch to the specific project window.

Configuration

All settings are under claudeCodeNotifierPlus.* in VS Code settings:

clickToFocus Options

Bonus: Add Selection to Claude Code

Quickly send selected code to Claude Code's chat input — no copy-paste needed. 4 ways to trigger:

You can also right-click any file in the Explorer panel to add it to Claude Code.

The selected code is inserted as a @file#line reference in Claude Code's chat, so Claude knows exactly where the code is and can read the full context.

How It Works

Test

Open the Command Palette (Cmd+Shift+P) and run:

Claude Code Notifier Plus: Send Test Notification

License

MIT

中文说明

当 Claude Code 需要你的注意时发送系统通知 — 同时支持 CLI 模式和 VS Code 扩展模式。

特性

• 双模式支持 — 终端 CLI 和 VS Code 扩展内都能触发通知
• 纯 CLI 支持 — 无需打开 VS Code 也能收到系统通知
• 点击跳转 — 点击通知直接跳转到对应项目的 VS Code 窗口，或 CLI 终端窗口（Terminal.app / iTerm2 / Warp 等），通过 VSCODE_PID 精确识别来源，不会误跳终端；点击后通知自动从通知中心移除（macOS，需安装 terminal-notifier）
• 系统级通知 — macOS / Windows / Linux 原生系统通知
• 任务上下文 — 通知包含项目名 📂 和任务摘要 💬
• 提示音 — 可选声音提醒
• 焦点感知 — VS Code 为活动窗口时可跳过通知
• 多语言 — 支持中文和英文，跟随系统语言自动切换
• 零配置 — 安装即用，hook 自动注册

甜点功能：快速发送选中代码到 Claude Code

选中代码后，有 4 种方式 将代码引用插入 Claude Code 聊天输入框：

• 💬 编辑器工具栏按钮 — 选中文字后，编辑器右上角出现聊天图标，一键点击
• 💡 灯泡代码操作 — 选中文字后，点击行首灯泡图标选择操作
• 🖱️ 右键菜单 — 选中代码 → 右键 → "将选中内容添加到 Claude Code"
• ⌨️ 快捷键 Cmd+Shift+I

还可以在资源管理器中右键任意文件添加到 Claude Code。

安装

VS Code 扩展商店搜索 "Claude Code Notifier Plus" 直接安装。

推荐额外安装（macOS 点击跳转功能）：

brew install terminal-notifier

安装后重新加载 VS Code 即可使用。

⚡ 重要提示（macOS）： 要启用点击通知精确跳转到对应项目窗口，需要授予辅助功能权限：

系统设置 → 隐私与安全性 → 辅助功能 → 开启 terminal-notifier

该权限允许插件在你点击通知时定位并激活正确的 VS Code 窗口，只需授权一次。未授权时点击通知仍可激活 VS Code，但不会切换到具体项目窗口。