Сповіщення Claude Code на Mac: коли агент закінчив

Як отримувати сповіщення macOS, коли Claude Code чи Codex завершує роботу або чекає на вас: хуки Claude Code, notify у Codex або вбудовані сигнали Vibe Console.

Довгі запуски агента — у цьому весь сенс Claude Code: віддали завдання й займаєтеся іншим. Заковика в тому, щоб знати, коли повертатися. Перевіряєте занадто часто — втрачаєте зекономлений час. Занадто пізно — агент уже з другої хвилини чекає на дозвіл.

На Mac це можна розв’язати трьома способами: від саморобного хука до вбудованої функції.

Дві події, про які варто знати

Хоч би який спосіб ви обрали, вам потрібно дізнаватися про два різні моменти:

Завершено. Агент закінчив свій хід і чекає на ваше наступне повідомлення.
Потрібна ваша відповідь. Агент зупинився посеред завдання — зазвичай щоб попросити дозвіл виконати команду чи змінити файл.

Другий важливіший. Агент, що застряг на запиті дозволу, взагалі не просувається.

Спосіб 1: хуки Claude Code

Claude Code вміє виконувати shell-команду, коли стаються певні події. Дві події хуків покривають обидва моменти:

Stop спрацьовує, коли Claude закінчує відповідь.
Notification спрацьовує, коли Claude потребує вашої уваги, наприклад запитує дозвіл або довго чекає на введення.

Додайте їх у ~/.claude/settings.json (для всіх проєктів) або в .claude/settings.json окремого проєкту. У прикладі використано osascript, який є в macOS з коробки:

{
  "hooks": {
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "osascript -e 'display notification \"Task finished\" with title \"Claude Code\" sound name \"Glass\"'"
          }
        ]
      }
    ],
    "Notification": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "osascript -e 'display notification \"Waiting for your input\" with title \"Claude Code\" sound name \"Funk\"'"
          }
        ]
      }
    ]
  }
}

Перезапустіть Claude Code і дайте йому коротке завдання для перевірки. Першого разу macOS може запитати, чи дозволити «Редактору скриптів» показувати сповіщення.

Обмеження цього підходу: сповіщення не каже, з якого проєкту чи термінала воно прийшло, клік по ньому нікуди вас не переносить, а для кожного іншого агента потрібне схоже налаштування. Актуальний перелік подій дивіться в документації хуків Claude Code.

Спосіб 2: `notify` у Codex

Codex CLI може запускати програму після кожного ходу агента. У ~/.codex/config.toml задайте в notify команду; Codex передає їй JSON з описом події:

notify = ["osascript", "-e", "display notification \"Codex finished\" with title \"Codex\""]

Свіжі версії Codex підтримують і хуки, зокрема подію Stop, які налаштовуються в hooks.json або в таблиці [hooks] у config.toml. Параметри змінюються від версії до версії, тож звіряйтеся з документацією хуків Codex для своєї.

Спосіб 3: вбудовано у Vibe Console

Vibe Console стежить за кожним терміналом з агентом замість вас — для всіх восьми підтримуваних агентів і без жодного налаштування:

Крапка статусу на кожній вкладці показує, чи працює агент, чи простоює, тож сітку агентів можна прочитати з одного погляду.
Коли агент закінчує, застосунок відтворює звук (типово Glass) і на мить розгортає виріз екрана MacBook із цією сесією: видно, який агент і який термінал.
Коли агент зупиняється й чекає на вас, лунає інший звук (типово Funk), тож «готово» від «застряг» можна відрізнити, навіть не дивлячись.
Обидва звуки можна змінити або вимкнути.

Ще він надсилає сповіщення macOS, коли використання Claude Code чи Codex перетинає 80% і 100% вікна. Див. ліміти Claude Code.

Найбільше користі від цього, коли ви запускаєте кількох агентів одночасно. Див. як запускати кілька агентів Claude Code паралельно.

Що обрати?

	Хуки / notify	Vibe Console
Вартість	Безкоштовно	Входить у застосунок
Налаштування	Для кожного агента, JSON або TOML	Не потрібне
Відрізняє «завершено» від «застряг»	Так, двома хуками	Так, двома звуками
Показує, який термінал	Ні	Так, у вирізі
Працює для всіх восьми агентів	Лише для тих, що мають хуки	Так

Якщо ви запускаєте одну сесію Claude Code за раз, хуків достатньо. Якщо ж працюєте з кількома агентами в різних проєктах, найбільше часу заощадить робочий простір, який знає, що за термінал перед ним.

Часті запитання

Чому не спрацьовує хук Claude Code?

Перевірте, що JSON валідний, файл лежить у правильному місці, а Claude Code ви перезапустили. Виконайте команду osascript окремо в терміналі, щоб переконатися, що сповіщення дозволені.

Чи можна отримувати сповіщення на телефон?

Хуки можуть викликати будь-яку команду, зокрема push-сервіс. Крім того, Claude Code підтримує віддалене керування зі свого мобільного застосунку, тож сесію можна перевірити й не за робочим столом.

Спробуйте вбудовані сигнали безкоштовно 14 днів: завантажити Vibe Console.