[Claude Code] Sound Notification on Completion

#claude #ai #code #terminal

Tested on MacOS.

Add notification when Claude Code is done. Enabled through global settings. You can configure more hooks to run commands.

Add settings.json if it doesn't exist

On Linux/MacOS: ~/.claude/settings.json
On Windows: %USERPROFILE%\.claude\settings.json

settings.json file content

Add the "hooks" section to your settings.json file if you already have other stuff in there like Status Line, etc.

For MacOs, below "command" runs a sound using the inbuilt sound player afplay.

For Windows use powershell -c (New-Object Media.SoundPlayer 'C:\\Windows\\Media\\chimes.wav').PlaySync().

{
  "hooks": {
    "Stop": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "afplay ~/.claude/sounds/success.mp3 &"
          }
        ]
      }
    ]
  },
}

Default system sounds on MacOS

Here are the built-in macOS system sounds, all located in /System/Library/Sounds/

/System/Library/Sounds/Glass.aiff
/System/Library/Sounds/Ping.aiff
/System/Library/Sounds/Submarine.aiff
/System/Library/Sounds/Funk.aiff
/System/Library/Sounds/Hero.aiff
/System/Library/Sounds/Basso.aiff
/System/Library/Sounds/Blow.aiff
/System/Library/Sounds/Bottle.aiff
/System/Library/Sounds/Frog.aiff
/System/Library/Sounds/Morse.aiff
/System/Library/Sounds/Pop.aiff
/System/Library/Sounds/Purr.aiff
/System/Library/Sounds/Sosumi.aiff
/System/Library/Sounds/Tink.aiff

You can preview any of them in your terminal with:
afplay /System/Library/Sounds/Glass.aiff