MacPip次のMacアプリは、ここに。macpip.com →

Claude Code や Codex の完了を通知で知る方法

2026年10月22日 更新

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コマンドを実行
あなたに届く音 · バナー · ベル
このページの方法はどれも同じしくみです。エージェントが決まったタイミングでコマンドを実行します。

どちらのツールも、決まったタイミングであなたのコマンドを実行できます。通知の正体はそれだけです。Claude Code ではこれをフック、Codex では notify と呼びます。コマンドの中身(音を鳴らす、バナーを出す、画面を光らせる)は、エージェントが止まったときや入力を求めたときに実行されます。

エージェントが働くあいだ、Mac をもっと心地よく

Clacky は、エージェントが働いているあいだの Mac そのものを心地よくします。クリック音とキーボード音、そしてエージェントが作ったものを見せたいときの画面レコーダー。Mac 1 台で $4.99 の買い切りです。

Claude Code:内蔵の通知

Claude Code は、作業が終わったときや許可の確認を待っているときに、自分でデスクトップ通知を送れます。Anthropic のドキュメントによると、Ghostty と Kitty ではそのまま動きます。iTerm2 では一度だけ設定をオンにします。

  1. iTerm2 → Settings → Profiles → Terminal を開きます。
  2. Notification Center Alerts にチェックを入れます。
  3. Filter Alerts をクリックし、Send escape sequence-generated alerts をオンにします。

tmux の中で Claude Code を動かしている場合は、~/.tmux.conf に set -g allow-passthrough on を追加してください。これがないと通知がターミナルまで届きません。通知の方法(たとえばターミナルのベル)は、Claude Code の /config 設定でも選べます。

出典:Claude Code ドキュメント:ターミナルの設定

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 などがあります。

出典:hooks reference · hooks guide

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 フックのような「承認待ち」専用のイベントはありません。

出典:Codex docs: advanced configuration

何も起きないときは

  • セッションを再起動する。 フックはセッション開始時に読み込まれるので、すでに動いていたセッションでは通知されません。
  • ファイルが正しく読めるか確認する。 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 で続けてください。

Clacky ははじめてですか?クリック音とキーボード音、画面レコーダー、スクリーンショット、そして作業中に育っていく小さな港町がそろった、居心地のいい Mac のメニューバーアプリです。 すべてのツールを見る · ブラウザでサウンドを聴いてみる

2026年10月22日 に確認しました。 内容が変わっていたり、間違いがあったりしたら、hello@clacky.app までメールでお知らせください。