Claude Code Sound Notifications

Add sound notifications to Claude Code that play when responses complete.

Quick Setup

1. Create the settings directory:

mkdir -p ~/.claude

2. Copy the settings file:

cp settings.json ~/.claude/settings.json

3. Restart Claude Code or your IDE

Manual Setup

Create ~/.claude/settings.json with:

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

Customization

Different Sounds

Available macOS system sounds:

• Glass.aiff (default)
• Ping.aiff
• Pop.aiff
• Hero.aiff
• Funk.aiff

Replace Glass.aiff with any sound name from /System/Library/Sounds/

Custom Sound Files

Use your own sound file:

"command": "afplay /path/to/your/sound.mp3"

Windows/Linux

For Windows (replace afplay with powershell):

"command": "powershell -c (New-Object Media.SoundPlayer 'C:\\Windows\\Media\\notify.wav').PlaySync()"

For Linux (replace afplay with aplay):

"command": "aplay /usr/share/sounds/alsa/Front_Left.wav"

How It Works

Uses Claude Code's hooks system to execute shell commands when responses complete. The Stop hook triggers whenever Claude finishes responding.

Troubleshooting

• No sound: Restart Claude Code/IDE after adding settings
• Permission denied: Ensure sound file path is accessible
• Wrong sound: Check available sounds with ls /System/Library/Sounds/