Notifications Claude Code sur Mac : savoir quand c’est fini

Les longues exécutions sont tout l’intérêt de Claude Code : vous confiez une tâche et vous passez à autre chose. Le hic, c’est de savoir quand revenir. Vérifiez trop souvent et vous perdez le temps gagné ; vérifiez trop tard et l’agent attend une autorisation depuis la deuxième minute.

Il y a trois façons de régler ça sur Mac, du hook fait maison à la fonction intégrée.

Deux événements à surveiller

Quelle que soit la méthode, vous voulez être prévenu à deux moments différents :

1. Terminé. L’agent a fini son tour et attend votre prochain message.
2. Besoin de vous. L’agent s’est arrêté au milieu d’une tâche, en général pour demander l’autorisation de lancer une commande ou de modifier un fichier.

Le second compte le plus. Un agent bloqué sur une demande d’autorisation n’avance plus du tout.

Option 1 : les hooks Claude Code

Claude Code peut exécuter une commande shell quand certains événements se produisent. Deux événements de hook couvrent les moments ci-dessus :

• Stop se déclenche quand Claude a fini de répondre.
• Notification se déclenche quand Claude a besoin de votre attention, par exemple pour une demande d’autorisation ou après une longue attente de réponse.

Ajoutez-les dans ~/.claude/settings.json (pour tous les projets) ou dans .claude/settings.json d’un projet. Cet exemple utilise osascript, fourni avec 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\"'"
          }
        ]
      }
    ]
  }
}

Redémarrez Claude Code et lancez une tâche courte pour tester. La première fois, macOS peut vous demander si Éditeur de script a le droit d’afficher des notifications.

Les limites de cette approche : la notification ne dit pas de quel projet ou de quel terminal elle vient, un clic dessus ne vous y emmène pas, et il faut une configuration similaire pour chaque autre agent. Consultez la documentation des hooks Claude Code pour la liste à jour des événements.

Option 2 : notify dans Codex

Codex CLI peut exécuter un programme après chaque tour d’agent. Dans ~/.codex/config.toml, donnez une commande à notify ; Codex lui transmet une description JSON de l’événement :

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

Les versions récentes de Codex prennent aussi en charge des hooks, dont un événement Stop, configurés dans hooks.json ou dans une table [hooks] de config.toml. Les options changent d’une version à l’autre : consultez la documentation des hooks Codex pour la vôtre.

Option 3 : intégré à Vibe Console

Vibe Console surveille chaque terminal d’agent à votre place, pour les huit agents pris en charge, sans aucune configuration :

• Une pastille de statut sur chaque onglet indique si son agent travaille ou attend : une grille d’agents se lit d’un coup d’œil.
• Quand un agent termine, l’app joue un son (Glass par défaut) et ouvre brièvement l’encoche du MacBook sur la session, en indiquant l’agent et le terminal concernés.
• Quand un agent s’arrête pour vous attendre, elle joue un autre son (Funk par défaut) : vous distinguez « fini » de « bloqué » sans regarder.
• Les deux sons sont personnalisables, et vous pouvez aussi les couper.

L’app envoie aussi une notification macOS quand votre utilisation de Claude Code ou de Codex franchit 80 % puis 100 % d’une fenêtre. Voir Limites d’utilisation de Claude Code.

C’est surtout utile quand plusieurs agents tournent en même temps. Voir comment lancer plusieurs agents Claude Code en parallèle.

Quelle solution choisir ?

Si vous faites tourner une seule session Claude Code à la fois, les hooks suffisent. Si vous lancez plusieurs agents sur plusieurs projets, un espace de travail qui sait quel terminal est lequel vous fera gagner le plus de temps.

FAQ

Pourquoi mon hook Claude Code ne se déclenche-t-il pas ?

Vérifiez que le JSON est valide, que le fichier est au bon endroit et que vous avez redémarré Claude Code. Lancez la commande osascript seule dans un terminal pour confirmer que les notifications sont autorisées.

Puis-je recevoir une notification sur mon téléphone ?

Les hooks peuvent appeler n’importe quelle commande, y compris un service de notifications push. Claude Code permet aussi le contrôle à distance depuis son app mobile, pour suivre une session loin de votre bureau.

Essayez les sons intégrés gratuitement pendant 14 jours : téléchargez Vibe Console.