[Clacky](https://clacky.app/ja/)/ガイド

# 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` の行を追加するか、内蔵のターミナル通知をオンにします。
-   何も起きない？ **セッションを再起動してください**。フックはセッション開始時に読み込まれます。

このページの内容

1.  [エージェントが「終わった」を伝えるしくみ](#エーシ-ェントか-終わった-を伝えるしくみ)
2.  [Claude Code：内蔵の通知](#claude-code-内蔵の通知)
3.  [Claude Code：音を鳴らすフック](#claude-code-音を鳴らすフック)
4.  [Codex：notify の設定](#codex-notify-の設定)
5.  [何も起きないときは](#何も起きないときは)

## エージェントが「終わった」を伝えるしくみ

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 ドキュメント：ターミナルの設定](https://code.claude.com/docs/en/terminal-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 などがあります。

出典：[hooks reference](https://code.claude.com/docs/en/hooks) · [hooks guide](https://code.claude.com/docs/en/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](https://developers.openai.com/codex/config-advanced)

## 何も起きないときは

-   **セッションを再起動する。** フックはセッション開始時に読み込まれるので、すでに動いていたセッションでは通知されません。
-   **ファイルが正しく読めるか確認する。** `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、アプリ。それぞれ実際に何をするのか。](https://clacky.app/ja/keep-mac-awake-lid-closed/)
-   [Mac のキーボード音とクリック音しくみ、必要な許可、アプリ、対処法。](https://clacky.app/ja/mac-keyboard-sounds/)
-   [Mac でクリックを表示標準のオプション、編集アプリ、音つきのライブ波紋。](https://clacky.app/ja/show-mouse-clicks-mac/)
-   [Mac のクリック音標準の設定はなし：音を足す方法と、必要な許可。](https://clacky.app/ja/mac-click-sound/)
-   [キーボード音アプリおすすめ無料と有料の 17 本を並べて、自分に合うものを選べます。](https://clacky.app/ja/best-keyboard-sound-apps-mac/)
-   [集中のためのキーボード音勉強、執筆、コーディングに合う、ヘッドフォンで聴くやわらかいタイピング音。](https://clacky.app/ja/keyboard-sounds-for-focus/)
-   [キーボード音の言葉thock、クリーミー、clacky、ポッピーの意味と、それぞれの聞こえ方。](https://clacky.app/ja/keyboard-sounds-explained/)
-   [ほっこり Mac アプリ作業中に動く、放置ゲーム、環境音、ペット、やわらかいクリック音。](https://clacky.app/ja/cozy-mac-apps/)
-   [カーソルハイライトアプリ比較デモ、通話、画面収録に使えるスポットライト、クリックの波紋、クリック音。](https://clacky.app/ja/best-cursor-highlighter-apps-mac/)
-   [キーボード音が鳴らない入力監視、Secure Input、出力デバイス、静音設定。](https://clacky.app/ja/keyboard-sounds-not-working-mac/)
-   [Mac でプロンプターカメラの真下で原稿を読んで、録画には映さない。](https://clacky.app/ja/teleprompter-mac/)
-   [クリックを見せて、クリック音を録音するMac の画面収録に、クリックの波紋とクリック音を入れる方法。](https://clacky.app/record-click-sound/)
-   [キーボード音つきタイピングテスト音が聞こえる 30 秒のタイピングテスト。ブラウザでそのまま試せます。](https://clacky.app/ja/typing-test/)

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

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