Claude Code や Codex の完了を通知で知る方法
Claude Code や Codex に長いタスクを任せて別の作業をし、10 分後に戻ってみたら、2 分目で「はい」を待って止まっていた。そんな経験はありませんか。エージェントが終わったときやあなたの OK を待っているときに音や通知が届けば、それは防げます。
どちらのツールも、内蔵の機能か 1、2 行の設定だけで、無料で通知できます。このガイドでは、その方法をひとつずつ順に紹介します。
要点まとめ
- Claude Code は Ghostty、Kitty、iTerm2 ならそのまま通知できます(iTerm2 は設定がひとつ必要)。ほかのターミナルではフックを追加します。
- Claude Code の Stop フックは終わったときに、Notification フックはあなたが必要なときに動きます。どちらも、音なら
afplay、通知ならosascriptを実行させます。 - Codex は
~/.codex/config.tomlにnotifyの行を追加するか、内蔵のターミナル通知をオンにします。 - 何も起きない? セッションを再起動してください。フックはセッション開始時に読み込まれます。
エージェントが「終わった」を伝えるしくみ
どちらのツールも、決まったタイミングであなたのコマンドを実行できます。通知の正体はそれだけです。Claude Code ではこれをフック、Codex では notify と呼びます。コマンドの中身(音を鳴らす、バナーを出す、画面を光らせる)は、エージェントが止まったときや入力を求めたときに実行されます。
エージェントが働くあいだ、Mac をもっと心地よく
Clacky は、エージェントが働いているあいだの Mac そのものを心地よくします。クリック音とキーボード音、そしてエージェントが作ったものを見せたいときの画面レコーダー。Mac 1 台で $4.99 の買い切りです。
Claude Code:内蔵の通知
Claude Code は、作業が終わったときや許可の確認を待っているときに、自分でデスクトップ通知を送れます。Anthropic のドキュメントによると、Ghostty と Kitty ではそのまま動きます。iTerm2 では一度だけ設定をオンにします。
- iTerm2 → Settings → Profiles → Terminal を開きます。
- Notification Center Alerts にチェックを入れます。
- Filter Alerts をクリックし、Send escape sequence-generated alerts をオンにします。
tmux の中で Claude Code を動かしている場合は、~/.tmux.conf に set -g allow-passthrough on を追加してください。これがないと通知がターミナルまで届きません。通知の方法(たとえばターミナルのベル)は、Claude Code の /config 設定でも選べます。
Claude Code:音を鳴らすフック
Apple のターミナル、VS Code、そのほかのターミナルでは、フックを使います。フックは ~/.claude/settings.json(すべてのプロジェクト)または .claude/settings.json(ひとつのプロジェクト)に書きます。大事なイベントは 2 つです。
- Stop:Claude が回答を終えたとき。
- Notification:Claude があなたを必要としているとき(許可の確認や、入力待ちが続いているとき)。
次の設定で、どちらのときも macOS のサウンドが鳴ります。いまの設定ファイルに追記してください(すでにある内容は残します)。
{
"hooks": {
"Stop": [{ "hooks": [{ "type": "command", "command": "afplay /System/Library/Sounds/Glass.aiff" }] }],
"Notification": [{ "matcher": "", "hooks": [{ "type": "command", "command": "afplay /System/Library/Sounds/Ping.aiff" }] }]
}
}バナーのほうがいい場合は、代わりにこのコマンドを使います(Anthropic の例と同じです)。
osascript -e 'display notification "Claude Code needs your attention" with title "Claude Code"'Claude Code で /hooks と入力すると、設定されているフックを確認できます。新しいフックは、保存したあとに始めたセッションから有効になります。/System/Library/Sounds/ のサウンドは自由に使えます。Glass、Ping、Pop、Purr、Submarine などがあります。
Codex:notify の設定
Codex CLI は、ターンが終わるたびにあなたのプログラムを実行できます。設定は ~/.codex/config.toml の notify です。Codex は最後の引数としてターンの内容を JSON で渡します(type は agent-turn-complete)。音を鳴らすだけのコマンドなら無視してかまいません。
notify = ["sh", "-c", "afplay /System/Library/Sounds/Glass.aiff"]notify はトップレベルのキーなので、ファイル内のどの [section] よりも上に書きます。Codex にはターミナル UI の内蔵通知([tui] の notifications)もあり、ターミナル自身の通知やベルを使います。バナーが表示されるかどうかはターミナル次第です。
Codex の notify が動くのはターンが終わったときです。Claude Code の Notification フックのような「承認待ち」専用のイベントはありません。
何も起きないときは
- セッションを再起動する。 フックはセッション開始時に読み込まれるので、すでに動いていたセッションでは通知されません。
- ファイルが正しく読めるか確認する。
settings.jsonのカンマがひとつ抜けているだけで、すべてのフックが止まります。JSON チェッカーに貼り付けて確かめてください。 - コマンドだけを試す。 ターミナルで
afplay /System/Library/Sounds/Glass.aiffを実行します。音が出なければ、出力デバイスと音量を確認してください。 - バナーが出ない? システム設定 → 通知 で、使っているターミナル(
osascriptならスクリプトエディタ)の設定と、集中モードを確認してください。 - 音が 2 つ同時に鳴る? 設定が 2 つある状態です(たとえば
~/.claude/settings.jsonのフックと、プロジェクトの.claude/settings.jsonのフック)。どちらかひとつにしてください。
よくある質問
Claude Code に通知音の機能はありますか?
Ghostty、Kitty、iTerm2 なら、そのままデスクトップ通知を送れます(iTerm2 は Send escape sequence-generated alerts をオンにする必要があります)。どのターミナルでも音を鳴らしたいなら、afplay を実行する Stop フックか Notification フックを追加してください。
Stop フックと Notification フックの違いは?
Stop は Claude が回答を終えたときに動きます。Notification は Claude があなたを必要とするとき、つまり許可の確認や入力待ちが続いているときに動きます。たいていの人は両方を、違う音で使っています。
Codex は承認が必要なときに知らせてくれますか?
Codex の notify プログラムが動くのは、ターンが終わったとき(agent-turn-complete)です。いまのところ承認専用のイベントはないので、音が鳴るのはターンの終わりです。
この通知は Web 版の Claude Code(Chrome の claude.ai/code)でも使えますか?
今は使えません。Web 版の Claude Code は Anthropic のクラウドで動くため、フックもそこで実行され、Mac には届きません。afplay や osascript のフックが聞けるのは Mac 上で動くセッションだけです:ターミナルか Claude アプリの Code タブ。Web のセッションで通知が欲しいときは、ターミナルで claude --teleport を使って Mac で続けてください。
ほかのガイド
- ふたを閉じても Mac を起こしておくクラムシェルモード、caffeinate、pmset、アプリ。それぞれ実際に何をするのか。
- Mac のキーボード音とクリック音しくみ、必要な許可、アプリ、対処法。
- Mac でクリックを表示標準のオプション、編集アプリ、音つきのライブ波紋。
- Mac のクリック音標準の設定はなし:音を足す方法と、必要な許可。
- キーボード音アプリおすすめ無料と有料の 17 本を並べて、自分に合うものを選べます。
- 集中のためのキーボード音勉強、執筆、コーディングに合う、ヘッドフォンで聴くやわらかいタイピング音。
- キーボード音の言葉thock、クリーミー、clacky、ポッピーの意味と、それぞれの聞こえ方。
- ほっこり Mac アプリ作業中に動く、放置ゲーム、環境音、ペット、やわらかいクリック音。
- カーソルハイライトアプリ比較デモ、通話、画面収録に使えるスポットライト、クリックの波紋、クリック音。
- キーボード音が鳴らない入力監視、Secure Input、出力デバイス、静音設定。
- Mac でプロンプターカメラの真下で原稿を読んで、録画には映さない。
- クリックを見せて、クリック音を録音するMac の画面収録に、クリックの波紋とクリック音を入れる方法。
- キーボード音つきタイピングテスト音が聞こえる 30 秒のタイピングテスト。ブラウザでそのまま試せます。
Clacky ははじめてですか?クリック音とキーボード音、画面レコーダー、スクリーンショット、そして作業中に育っていく小さな港町がそろった、居心地のいい Mac のメニューバーアプリです。 すべてのツールを見る · ブラウザでサウンドを聴いてみる
2026年10月22日 に確認しました。 内容が変わっていたり、間違いがあったりしたら、hello@clacky.app までメールでお知らせください。