Claude Codeの通知機能を完全解説【2026年最新】：音・設定・Hooks活用まで

Claude Codeの通知機能を完全解説【2026年最新】：音・設定・Hooks活用まで

Claude Codeの通知はどういうときに発火するか

Mac・Windowsで通知を有効化する方法

Claude Codeの通知設定：settings.jsonの使い方

Claude Code通知の本命：Hooksで完全カスタマイズ

{
  "hooks": {
    "Notification": [
      {
        "matcher": "permission_prompt",
        "hooks": [
          {
            "type": "command",
            "command": "/path/to/permission-alert.sh"
          }
        ]
      },
      {
        "matcher": "idle_prompt",
        "hooks": [
          {
            "type": "command",
            "command": "/path/to/idle-notification.sh"
          }
        ]
      }
    ]
  }
}

{
  "session_id": "abc123",
  "transcript_path": "/Users/.../.claude/projects/.../00893aaf-19fa-41d2-8238-13269b9b3ca0.jsonl",
  "cwd": "/Users/...",
  "hook_event_name": "Notification",
  "message": "Claude needs your permission to use Bash",
  "title": "Permission needed",
  "notification_type": "permission_prompt"
}

通知音の設定（Mac・Windows別）

Mac向け：処理完了通知スクリプト

#!/bin/bash
# ~/.claude/hooks/notify-idle.sh

# JSONを読み込む
INPUT=$(cat)
MESSAGE=$(echo "$INPUT" | jq -r '.message // "Claude Codeが入力を待っています"')
TITLE=$(echo "$INPUT" | jq -r '.title // "Claude Code"')

# 通知音を鳴らす
afplay /System/Library/Sounds/Glass.aiff

# OSの通知を表示
osascript -e "display notification \"$MESSAGE\" with title \"$TITLE\""

Claude Code通知をスマホに飛ばす方法

#!/bin/bash
# スマホにプッシュ通知を送る
INPUT=$(cat)
MESSAGE=$(echo "$INPUT" | jq -r '.message // "Claude Codeが入力を待っています"')

curl -d "$MESSAGE" ntfy.sh/your-topic-name

#!/bin/bash
INPUT=$(cat)
MESSAGE=$(echo "$INPUT" | jq -r '.message // "Claude Codeが止まっています"')
WEBHOOK_URL="https://discord.com/api/webhooks/your-webhook-url"

curl -H "Content-Type: application/json" \
  -d "{\"content\": \"$MESSAGE\"}" \
  "$WEBHOOK_URL"

完了通知とStopフックの使い分け

tmux・Linux環境での通知設定

#!/bin/bash
INPUT=$(cat)
MESSAGE=$(echo "$INPUT" | jq -r '.message // "Claude Code: 入力待ち"')

# tmuxのステータスバーに通知
tmux display-message -d 5000 "$MESSAGE"

# ターミナルベル
printf '\a'

設定ファイルの全体像

{
  "hooks": {
    "Notification": [
      {
        "matcher": "idle_prompt",
        "hooks": [
          {
            "type": "command",
            "command": "~/.claude/hooks/notify-idle.sh"
          }
        ]
      },
      {
        "matcher": "permission_prompt",
        "hooks": [
          {
            "type": "command",
            "command": "~/.claude/hooks/notify-permission.sh"
          }
        ]
      }
    ],
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "~/.claude/hooks/notify-stop.sh"
          }
        ]
      }
    ]
  }
}

chmod +x ~/.claude/hooks/notify-idle.sh
chmod +x ~/.claude/hooks/notify-permission.sh
chmod +x ~/.claude/hooks/notify-stop.sh

まとめ

• OSの通知許可: まずMac/Windowsのシステム設定でClaude Codeの通知をオンにする
• Notificationフックの4タイプ: idle_prompt（待ち状態）、permission_prompt（許可要求）、auth_success、elicitation_dialog
• settings.jsonでHooksを設定: ~/.claude/settings.json にNotificationフックを書いてスクリプトを紐付ける
• スマホ通知: ntfy・Discord Webhook・Slack Webhookで実現できる
• Stopフックとの使い分け: タスク完了通知には Stop フック、許可要求には Notification の permission_prompt が適切

---

出典

• Claude Code Hooksリファレンス（公式）
• Claude Code 設定ドキュメント（公式）