settings.json
preferredNotifChannel
型
string既定値auto記述場所どの設定ファイルでも可タスク完了時と権限プロンプト表示時の通知方法を指定します。"auto"(デフォルト)は iTerm2、Ghostty、Kitty でデスクトップ通知を送り、他のターミナルでは何もしません。"terminal_bell" は任意のターミナルでベルを鳴らし、"notifications_disabled" は通知を無効にします。
取りうる値
auto既定 | Claude Code は iTerm2、Ghostty、Kitty でデスクトップ通知を送り、Terminal.app ではオーディブルベルがオフの場合にのみベルを鳴らし、それ以外では何もしません。 |
|---|---|
terminal_bell | Claude Code は任意のターミナルでベル文字を鳴らします。 |
iterm2 | Claude Code は iTerm2 のデスクトップ通知を送ります。 |
iterm2_with_bell | Claude Code は iTerm2 のデスクトップ通知を送り、ベルも鳴らします。 |
kitty | Claude Code は Kitty のデスクトップ通知を送ります。 |
ghostty | Claude Code は Ghostty のデスクトップ通知を送ります。 |
notifications_disabled | Claude Code は通知を送りません。 |
記述例
{
"preferredNotifChannel": "terminal_bell"
}使い方・用途
- タスク完了時や権限プロンプト待ちの際に、長時間タスクの実行中に他の作業へ切り替えられるよう通知を受け取れます。デフォルトの "auto" では Ghostty・Kitty・iTerm2 のみデスクトップ通知が届くため、Warp や VS Code 統合ターミナルなど他のターミナルでは "terminal_bell" に変更してベル通知に切り替えます。
- デフォルト値は "auto"。選択肢は auto / terminal_bell / iterm2 / iterm2_with_bell / kitty / ghostty / notifications_disabled の7種類です。
/configでは「Local notifications」として表示され、ベルの代わりにカスタムサウンドやコマンドを使いたい場合は Notification フックとの併用も可能です。
英語原文(公式ドキュメントより)
Method for task-complete and permission-prompt notifications. "auto" (default) sends a desktop notification in iTerm2, Ghostty, and Kitty and does nothing in other terminals; "terminal_bell" rings the bell in any terminal; "notifications_disabled" turns them off. See https://code.claude.com/docs/en/terminal-config#get-a-terminal-bell-or-notification