Notifications Claude Code sur votre iPhone

Ce que Claude Code fait par défaut sur Mac

Lorsque Claude Code termine une tâche ou s’arrête sur une demande d’autorisation alors que vous n’êtes plus devant le terminal, il émet un événement de notification. Ce qui s’affiche dépend du terminal utilisé. Selon la documentation de Claude Code sur les terminaux, une notification système n’est envoyée par défaut que dans Ghostty, Kitty et iTerm2. Dans les autres terminaux, y compris Terminal d’Apple, rien n’apparaît tant que vous n’activez pas la cloche du terminal ou un hook.

• Ghostty et Kitty transmettent directement l’alerte au Centre de notifications de macOS.
• iTerm2 nécessite d’activer le transfert : dans Settings → Profiles → Terminal, cochez Notification Center Alerts, puis dans Filter Alerts activez Send escape sequence-generated alerts.
• Dans tmux, les notifications sont interceptées à moins d’activer allow-passthrough.

Dans tous les cas, l’alerte reste sur le Mac. Pour la recevoir sur votre iPhone, trois pistes s’offrent à vous.

Méthode 1 : le push mobile intégré de Claude Code

Claude Code peut envoyer une notification push vers l’application mobile Claude lorsqu’une session est connectée via Remote Control. C’est la piste qui demande le moins de réglages sur le Mac :

1. Installez l’application Claude sur votre iPhone et connectez-vous avec le même compte que pour Claude Code.
2. Autorisez les notifications sur iOS.
3. Démarrez votre session avec Remote Control actif.
4. Dans le terminal, lancez /config et activez Push when Claude decides, Push when actions required, ou les deux.

D’après la documentation Remote Control, cette fonction est réservée aux offres Pro, Max, Team et Enterprise et ne fonctionne pas avec une clé API ou un fournisseur tiers. La session tourne sur votre Mac : l’ordinateur doit donc rester éveillé.

Méthode 2 : un hook qui publie directement sur ntfy

Les hooks de Claude Code exécutent la commande shell de votre choix lors d’événements précis. Un hook Notification se déclenche quand Claude attend une réponse ou une permission, ce qui permet d’envoyer un message au service gratuit ntfy. Installez l’application ntfy sur votre iPhone, abonnez-vous à un sujet long et impossible à deviner, puis ajoutez ce bloc dans ~/.claude/settings.json :

{
  "hooks": {
    "Notification": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "curl -s -d 'Claude Code attend votre attention' https://ntfy.sh/votre-sujet-prive"
          }
        ]
      }
    ]
  }
}

Un matcher vide déclenche le hook sur chaque type de notification. Remplacez-le par permission_prompt pour n’être prévenu que des demandes d’accord, ou par idle_prompt lorsque Claude a terminé. Tapez /hooks dans Claude Code pour vérifier que le hook est pris en compte.

Méthode 3 : transférer la notification macOS avec NotiFerry

La troisième méthode traite Claude Code comme n’importe quelle autre application Mac : laissez-le publier une notification macOS normale, et transférez cette notification vers votre iPhone avec NotiFerry.

Assurez-vous d’abord que la notification atteint bien le Centre de notifications du Mac. C’est déjà le cas dans Ghostty et Kitty, ainsi que dans iTerm2 une fois le transfert activé. Dans un autre terminal, utilisez le hook macOS documenté :

{
  "hooks": {
    "Notification": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "osascript -e 'display notification \"Claude Code attend votre attention\" with title \"Claude Code\"'"
          }
        ]
      }
    ]
  }
}

macOS attribue cette alerte à Éditeur de scripts (Script Editor). Exécutez une fois osascript -e 'display notification "test"' dans le terminal, puis autorisez Éditeur de scripts dans Réglages Système → Notifications.

Ensuite, configurez NotiFerry : autorisez le dossier du Centre de notifications en lecture seule, abonnez votre iPhone dans l’application ntfy et confirmez le test. Le mode par défaut (Titre uniquement) conserve le texte du message sur le Mac. Lorsqu’une session bruyante accumule cinq alertes ou plus d’une même application et que l’envoi a au moins 30 secondes de retard, NotiFerry les regroupe dans l’alerte la plus récente et ignore celles de plus de 10 minutes. NotiFerry ne lit ni vos prompts, ni les réponses de Claude, ni votre dépôt de code.

Quelle méthode choisir ?

Si vous souhaitez aussi recevoir ces alertes au poignet, consultez le guide sur les notifications du Mac sur l’Apple Watch.