適用場景：Claude Code 在后臺跑任務(wù)時，你不想盯著終端；當(dāng)它需要授權(quán)、需要你回答問題、或任務(wù)結(jié)束時，讓系統(tǒng)直接彈出桌面通知提醒你回來處理即可。
本文僅包含桌面通知，不含釘釘/企業(yè)微信等第三方通知。

1. 前言：為什么要給 Claude Code 加“消息提醒”？

Claude Code 在實際使用中經(jīng)常出現(xiàn)這些“你離開就錯過”的節(jié)點：

• 需要你確認(rèn)權(quán)限（讀寫文件、執(zhí)行命令、聯(lián)網(wǎng)檢索等）
• 需要你回答一個關(guān)鍵問題才能繼續(xù)（AskUserQuestion / elicitation）
• 任務(wù)已經(jīng)完成，但你不知道它何時跑完

解決思路很簡單：利用 Claude Code 的 hooks 機(jī)制，在特定事件發(fā)生時自動執(zhí)行一條命令，去調(diào)用一個 Python 腳本發(fā)送桌面通知。

2. 效果展示

配置完成后，你會在以下時機(jī)收到系統(tǒng)通知（Windows 通知中心）：

• 需要授權(quán)時：彈出“需要授權(quán)...”
• 任務(wù)結(jié)束時：彈出“任務(wù)完成...”
• 認(rèn)證成功/空閑等待時：彈出相應(yīng)提示

3. 環(huán)境準(zhǔn)備：Python + plyer

3.1 準(zhǔn)備 Python（建議虛擬環(huán)境）

確保你能在本機(jī)正常運(yùn)行 Python。建議為腳本建一個獨立目錄并創(chuàng)建 venv：

python -m venv .venv 

3.2 安裝桌面通知庫 plyer

pip install plyer 

4. 通知腳本詳解：send_notification.py（完整代碼 + 說明）

下面是一個“夠用且干凈”的桌面通知腳本：從命令行接收消息內(nèi)容，可選 --title 自定義標(biāo)題。

import sys
import argparse
from plyer import notification
def send_notify(title: str, message: str) -> None:
    notification.notify(
        title=title,
        message=message,
        timeout=3,  # 通知停留時間（秒），可按需調(diào)整
    )
def main() -> None:
    parser = argparse.ArgumentParser(description="Send desktop notification.")
    parser.add_argument("message", nargs="+", help="Notification message")
    parser.add_argument("--title", default="Claude Code 通知", help="Notification title")
    args = parser.parse_args()
    message = " ".join(args.message)
    send_notify(args.title, message)
if __name__ == "__main__":
    main()

4.1 先手動驗證腳本是否能彈通知

在命令行執(zhí)行：

python send_notification.py 任務(wù)完成啦 --title Claude 

能正常彈出桌面通知后，再進(jìn)入下一步（hooks 配置）。

5. Claude Code 配置詳解：settings.json（結(jié)構(gòu) + 關(guān)鍵點）

Claude Code 的 settings.json 里，我們主要用兩部分：

• env：環(huán)境變量（我用的是GML4.7）
• hooks：事件觸發(fā)器（本文核心）

6. hooks 觸發(fā)點怎么選？（三類足夠覆蓋大多數(shù)場景）

你現(xiàn)有配置的思路非常實用，基本分三類：

1. PermissionRequest：需要授權(quán)時提醒（最重要）
2. Notification：狀態(tài)類提醒（認(rèn)證成功、空閑等待、需要你補(bǔ)充信息）
3. Stop：任務(wù)結(jié)束提醒

hooks 的執(zhí)行方式是 type: "command"，本質(zhì)就是“跑一條命令”，我們把命令寫成調(diào)用 Python 腳本即可。

7. 可直接復(fù)用的配置模板

把下面模板按需替換路徑即可（重點替換兩處：你的 python.exe 路徑與 send_notification.py 路徑）。

注意：JSON 字符串中 Windows 路徑需要寫雙反斜杠 \\。

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "***",
    "ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic",
    "API_TIMEOUT_MS": "3000000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  },
  "hooks": {
    "PermissionRequest": {
      "0": {
        "matcher": "Task|TaskOutput|Bash|Glob|Grep|ExitPlanMode|Read|Edit|Write|NotebookEdit|WebFetch|TodoWrite|WebSearch|KillShell|AskUserQuestion|Skill|EnterPlanMode",
        "hooks": {
          "0": {
            "type": "command",
            "command": "D:\\\\MyCodes\\\\ClaudeScript\\\\.venv\\\\Scripts\\\\python.exe D:\\\\MyCodes\\\\ClaudeScript\\\\send_notification.py 需要授權(quán)..."
          }
        }
      }
    },
    "Notification": {
      "0": {
        "matcher": "permission_prompt|idle_prompt|auth_success|elicitation_dialog",
        "hooks": {
          "0": {
            "type": "command",
            "command": "D:\\\\MyCodes\\\\ClaudeScript\\\\.venv\\\\Scripts\\\\python.exe D:\\\\MyCodes\\\\ClaudeScript\\\\send_notification.py Claude Code 有新狀態(tài)..."
          }
        }
      }
    },
    "Stop": {
      "0": {
        "matcher": "",
        "hooks": {
          "0": {
            "type": "command",
            "command": "D:\\\\MyCodes\\\\ClaudeScript\\\\.venv\\\\Scripts\\\\python.exe D:\\\\MyCodes\\\\ClaudeScript\\\\send_notification.py 任務(wù)完成..."
          }
        }
      }
    }
  }
}

7.1 我建議你這樣改得更“可讀”

你可以把三條命令的文案改得更直觀，例如：

• PermissionRequest：需要授權(quán)：請回到 Claude Code 確認(rèn)
• Notification：Claude Code 等待你的輸入/選擇
• Stop：Claude Code 已完成本次任務(wù)

8. 常見問題 FAQ（踩坑集中區(qū)）

Q1：不彈通知，但腳本手動運(yùn)行是好的？

• 檢查 settings.json 中命令路徑是否正確（尤其是 python.exe 與腳本路徑）
• 確保 JSON 中反斜杠寫成 \\
• 先把 command 簡化成最短可運(yùn)行版本排查路徑問題

Q2：彈了通知，但內(nèi)容不對/中文亂碼？

• Windows 通知一般不會亂碼；如果異常，檢查終端編碼與腳本文件編碼（建議 UTF-8）
• 盡量避免把特殊符號塞進(jìn)命令行參數(shù)（必要時用簡短文本）

Q3：PermissionRequest 為什么匹配這么多？

• matcher 是你希望提醒的“高頻需要確認(rèn)”的操作集合（讀寫文件、執(zhí)行命令、聯(lián)網(wǎng)檢索等）
• 不想太吵：從 matcher 里刪掉不關(guān)心的項即可（例如刪掉 Glob|Grep 等）

Q4：通知太快消失？

• 把 timeout 從 3 改成 5 或更長

9. 結(jié)語：這套配置帶來的真實價值

配置好桌面通知后，你就不需要一直盯著 Claude Code 的輸出：

• 該你授權(quán)時叫你回來
• 該你回答時提醒你
• 跑完了告訴你結(jié)果已就緒

對日常寫代碼、跑腳本、生成文檔、長任務(wù)迭代非常省心。

以上就是Claude Code桌面消息通知配置全攻略的詳細(xì)內(nèi)容，更多關(guān)于Claude Code桌面消息通知配置的資料請關(guān)注腳本之家其它相關(guān)文章！

最新評論