【効率化】Claude Code の通知音設定 - タスク完了を見逃さない

はじめに

Claude Code でビルドやテストを実行している間、ずっと画面を見つめていませんか？通知音を設定すれば、タスク完了時に音で知らせてくれるので、他の作業をしながら待つことができます。

この記事でわかること

• Terminal Bell を使ったシンプルな通知設定

• Hooks を使ったカスタム通知設定

• 各プラットフォーム（Mac/Windows/Linux）での設定方法

対象読者

• Claude Code を日常的に使用しているエンジニア

• 長時間の処理を効率よく待ちたい方

方法1: Terminal Bell（シンプル）

最もシンプルな方法です。1行のコマンドで設定できます。

claude config set --global preferredNotifChannel terminal_bell

これで、タスク完了時にターミナルのベル音が鳴るようになります。動作確認は echo -e “\a” で行えます。

方法2: Hooks（カスタマイズ可能）

より柔軟な設定が可能な方法です。好きなサウンドファイルを指定したり、通知タイプごとに異なる音を設定できます。設定ファイルは ~/.claude/settings.json です。

基本設定（macOS）

{
  "hooks": {
    "Notification": [
      {
        "matcher": "idle_prompt",
        "hooks": [
          {
            "type": "command",
            "command": "afplay /System/Library/Sounds/Glass.aiff"
          }
        ]
      }
    ]
  }
}

通知タイプ（matcher）の種類

• idle_prompt: 60秒以上の処理後、入力待ちになった時

• permission_prompt: ツール実行の許可を求める時

• auth_success: 認証成功時

• elicitation_dialog: MCP ツールで入力が必要な時

複数の通知タイプに対応する設定

{
  "hooks": {
    "Notification": [
      {
        "matcher": "permission_prompt",
        "hooks": [
          {"type": "command", "command": "afplay /System/Library/Sounds/Ping.aiff"}
        ]
      },
      {
        "matcher": "idle_prompt",
        "hooks": [
          {"type": "command", "command": "afplay /System/Library/Sounds/Glass.aiff"}
        ]
      }
    ]
  }
}

macOS で使えるシステムサウンド

/System/Library/Sounds/ にある標準サウンドファイルを使用できます。

• Glass.aiff - クリアなガラス音（おすすめ）

• Ping.aiff - 短いピン音

• Submarine.aiff - 潜水艦のソナー音

• Blow.aiff - ポップな音

# 利用可能なサウンド一覧を確認
ls /System/Library/Sounds/

# サウンドを試聴
afplay /System/Library/Sounds/Glass.aiff

プラットフォーム別の設定

Windows（WSL）

"command": "powershell.exe -c [System.Media.SystemSounds]::Beep.Play()"

Linux

"command": "paplay /usr/share/sounds/freedesktop/stereo/complete.oga"

VS Code での設定

VS Code のターミナルで Terminal Bell を使う場合は、設定画面で「terminal bell」と検索し、「Terminal > Integrated: Enable Bell」を有効化してください。

Tips

トラブルシューティング

音が鳴らない場合の確認ポイント：

1. echo -e “\a” で確認（ターミナル側の問題か切り分け）

2. iTerm2: Preferences → Profiles → Terminal → 「Silence bell」のチェックを外す

3. システムの音量がミュートになっていないか確認

まとめ

• シンプルに使うなら terminal_bell 設定がおすすめ

• カスタマイズしたいなら Hooks で好きなサウンドを設定

• 通知タイプごとに音を分けられる

• プラットフォームに応じてコマンドを調整する

参考リンク

• Claude Code Docs - Terminal Config

• Claude Code Docs - Hooks