【ClaudeCode】terminal-notifierでタスクが完了したら通知がくるようにする

terminal-notifierを使うとClaude Codeの通知を良い感じにしてくれると聞いて調べた

terminal-notifierは、macOSでコマンドラインからシステム通知を送信するためのツール

github.com

以下のようなコマンドを実行すると

$ terminal-notifier -title 'Claude Code' -subtitle '処理完了' -message 'すべてのタスクが終了しました' -sound default

通知がされる

Claude Codeとの統合

Claude Codeのタスク完了時に通知を受け取ることで、作業の見落としを防止し、効率的な開発フローを実現する

基本的なセットアップ

terminal-notifierのインストール

Homebrewを使用したインストール

brew install terminal-notifier

通知の許可設定

# macOSのシステム設定で通知を許可
# システム設定 → 通知 → terminal-notifier
# 通知を許可に設定

基本的な通知コマンド

# シンプルな通知
terminal-notifier -title "完了" -message "タスクが完了しました"

# サウンド付き通知
terminal-notifier -title "完了" -message "タスクが完了しました" -sound default

# カスタムアイコン付き通知
terminal-notifier -title "完了" -message "タスクが完了しました" \
  -appIcon "/Applications/Xcode.app/Contents/Resources/Xcode.icns"

# アクション付き通知
terminal-notifier -title "ビルド完了" -message "ビルドが完了しました" \
  -execute "open -a Cursor"

Claude Codeとの統合方法

タスク完了時のHooksにこの通知コマンドを設定する

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "hooks": {
    ...
    "Stop": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "terminal-notifier -title 'Claude Code' -subtitle '処理完了' -message 'すべてのタスクが終了しました' -sound default"
          }
        ]
      }
    ]
  },
  ...
}

これでタスクが完了したら通知がくるようになった