Routines Claude et notifications push : soyez prévenu quand une exécution cloud a besoin de vous

Les routines Claude sont la partie de Claude Code qui fonctionne sans vous. Vous enregistrez une fois un prompt et un dépôt, et l'infrastructure cloud d'Anthropic lance une nouvelle session Claude Code chaque nuit, à chaque nouvelle pull request, ou quand votre supervision appelle un point de terminaison. Votre ordinateur peut rester fermé.
Le piège, c'est qu'une routine ne prévient personne. Le résultat reste dans une session sur claude.ai tant que vous n'allez pas le consulter, et la liste des exécutions aide peu : un statut vert signifie seulement que la session a démarré et s'est terminée sans erreur d'infrastructure, pas que le travail a réussi. Une vérification nocturne des dépendances qui a détecté un build cassé ressemble exactement à une vérification qui n'a rien trouvé.
Ce guide fait en sorte que la routine envoie une notification push sur votre téléphone via Pocket Alert : une notification discrète quand tout va bien, une notification bien visible quand quelque chose requiert votre attention.
Ce que sont les routines Claude, en bref
Anthropic les appelle désormais tâches planifiées. « Routines » est le nom précédent, encore visible dans l'adresse web (claude.ai/code/routines), dans l'alias de CLI /routines et dans l'API. Il s'agit de la même fonctionnalité, actuellement en préversion de recherche.
Une routine est une configuration Claude Code enregistrée : un prompt, un ou plusieurs dépôts GitHub, un environnement cloud et un ensemble de connecteurs. Chaque exécution est une session cloud complète, capable de lancer des commandes shell, modifier du code, pousser sur une branche claude/ et appeler des connecteurs. Les exécutions démarrent à partir de déclencheurs, et une même routine peut en avoir plusieurs :
- Planification : préréglages horaire, quotidien, hebdomadaire, une expression cron personnalisée (au maximum une fois par heure), ou une exécution ponctuelle à une heure donnée.
- API : une requête POST vers le point de terminaison
/firepropre à la routine, avec un jeton au porteur. Vous pouvez transmettre un champtext, comme le corps d'une alerte, que l'exécution reçoit comme contexte. - GitHub : des événements de pull request, de release ou d'issue sur un dépôt où l'application GitHub de Claude est installée, avec des filtres de pull request sur l'auteur, la branche, les labels, l'état brouillon et plus encore.
Vous créez des routines sur claude.ai/code/routines avec New task, dans l'application Desktop, ou avec /schedule dans la CLI de Claude Code, par exemple /schedule daily PR review at 9am. Elles nécessitent une offre Pro, Max, Team ou Enterprise, et les exécutions consomment votre utilisation d'abonnement comme les sessions interactives.
De quoi avez-vous besoin
- Un compte Pocket Alert, une clé API depuis Clés API, et l'application sur votre téléphone iPhone ou Android. L'offre gratuite suffit.
- Une routine, ou un projet de routine.
Il existe deux façons pour une exécution d'atteindre votre téléphone : curl depuis la session vers l'API Pocket Alert, ou le serveur MCP Pocket Alert ajouté comme connecteur. Commencez par curl. Il fonctionne sur toutes les offres qui incluent les routines, et la clé n'entre jamais dans la session.
Configuration : curl avec un secret réseau
L'environnement cloud d'une routine a par défaut un accès réseau Trusted : registres de paquets, GitHub et API des fournisseurs cloud, rien d'autre. api.pocketalert.app ne figure pas dans cette liste, donc un curl simple échouerait avec 403 et x-deny-reason: host_not_allowed.
Un secret réseau résout à la fois le problème du réseau et celui de la clé. Vous stockez la clé sur l'environnement, et le proxy d'Anthropic l'ajoute aux requêtes destinées aux hôtes que vous listez, une fois qu'elles ont quitté la VM de la session. Les hôtes couverts par un secret réseau sont accessibles quel que soit le niveau d'accès, et Claude ne voit jamais la clé.
- Ouvrez la routine sur claude.ai/code/routines, choisissez Edit, puis Advanced settings > General > Cloud environment. Survolez l'environnement et cliquez sur son icône de paramètres.
- Dans Network secrets, cliquez sur Add secret et gardez le type Bearer.
- Name :
Pocket Alert. Allowed websites :api.pocketalert.app. - Sous Custom headers, remplacez le nom d'en-tête
AuthorizationparToken, supprimez le préfixeBearer, et collez votre clé API comme valeur. - Cliquez sur Add. Le secret est enregistré immédiatement et ne peut plus être consulté.
Désormais, la requête n'a plus besoin d'aucune clé. Ajoutez ceci à la fin du prompt de la routine :
When you are done, send exactly one push notification with curl:
curl -sS https://api.pocketalert.app/v1/messages \
-H 'Content-Type: application/json' \
--data-binary @- <<'EOF'
{"title": "<routine name>: <one-line result>", "message": "<2-3 sentence summary>", "level": "<level>"}
EOF
Do not add any auth header; the environment adds it. Build valid JSON.
Pick the level:
- "low" if the run finished and nothing needs my attention.
- "default" if you opened a pull request or found something worth reading today.
- "high" only if the work failed, tests are broken, or you found a real problem.
Include the session link from:
echo "https://claude.ai/code/${CLAUDE_CODE_REMOTE_SESSION_ID/#cse_/session_}"
La dernière ligne provient de la documentation d'Anthropic : chaque session cloud peut lire son propre identifiant dans CLAUDE_CODE_REMOTE_SESSION_ID, et cette commande le transforme en URL de la transcription. Avec ce lien dans le message, vous passez de la notification à l'exécution en un seul geste.
Cliquez sur Run now sur la page de la routine pour la tester avant la première exécution planifiée.
Si la boîte de dialogue de votre environnement n'a pas de ligne Custom headers (sur une offre Team sans rôle administrateur, le formulaire ne demande qu'un hôte et une valeur), réglez Network access sur Custom, ajoutez api.pocketalert.app dans Allowed domains en conservant la liste par défaut, et placez la clé dans une variable d'environnement comme POCKETALERT_KEY, envoyée par -H "Token: $POCKETALERT_KEY". Sachez que les variables d'environnement sont lisibles par toute personne utilisant l'environnement, ce qui fait du secret la meilleure option.
Ou ajoutez le serveur MCP comme connecteur
Les routines peuvent utiliser vos connecteurs claude.ai, et le trafic des connecteurs passe par les serveurs d'Anthropic, donc aucune modification de liste d'autorisation n'est nécessaire. Le prompt indique alors simplement « appelle l'outil create_message de pocketalert » avec un titre, un message et un niveau.
La limite concerne l'authentification. Le serveur MCP de Pocket Alert accepte la clé API sous la forme Authorization: Bearer KEY, et sur claude.ai un connecteur personnalisé ne peut envoyer une clé fixe que via la section Request headers de la boîte de dialogue Add custom connector. Anthropic présente cette section comme une bêta disponible pour un nombre limité d'organisations. Si vous la voyez (sur les offres Team et Enterprise, un propriétaire ajoute le connecteur dans Organization settings > Connectors à la place) :
- Rendez-vous sur claude.ai/customize/connectors et cliquez sur Add custom connector.
- URL :
https://mcp.pocketalert.app/mcp. Authentication : No sign-in. - Dans Request headers, choisissez
authorizationet saisissezBearer YOUR_API_KEY.
Les nouvelles routines incluent par défaut tous vos connecteurs, donc vérifiez l'onglet Connectors de la routine et ne gardez que ceux dont elle a besoin. La commande claude mcp add de la CLI Claude Code ne sert à rien ici : les serveurs ajoutés ainsi vivent sur votre machine et n'apparaissent pas dans les routines. Si vous utilisez aussi Claude Code en local, cette configuration est décrite dans Notifications push pour Claude Code ; pour d'autres options MCP, consultez Meilleurs serveurs MCP de notifications.
Deuxième niveau : une notification push qui ne dépend pas du modèle
Les deux méthodes ci-dessus reposent sur le fait que Claude suive le dernier paragraphe de votre prompt. En général, c'est le cas. Mais une exécution qui atteint une limite de débit ou une erreur d'API n'arrive jamais à ce paragraphe, et c'est justement l'exécution dont vous voulez être informé.
Les hooks fonctionnent aussi dans les routines : une session cloud avec un dépôt lit le fichier .claude/settings.json de ce dépôt. Un hook Stop se déclenche quand Claude termine, et StopFailure se déclenche à la place quand le tour se termine sur une erreur d'API, comme rate_limit ou server_error. Commitez ceci comme .claude/settings.json :
{
"hooks": {
"Stop": [
{ "hooks": [{ "type": "command", "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/notify.sh done" }] }
],
"StopFailure": [
{ "hooks": [{ "type": "command", "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/notify.sh failed" }] }
]
}
}
Et le script, .claude/hooks/notify.sh, rendu exécutable :
#!/usr/bin/env bash
[ "$CLAUDE_CODE_REMOTE" = "true" ] || exit 0
payload=$(cat)
last=$(jq -r '.last_assistant_message // ""' <<<"$payload")
link="https://claude.ai/code/${CLAUDE_CODE_REMOTE_SESSION_ID/#cse_/session_}"
if [ "$1" = "failed" ]; then
title="Claude run failed: $(jq -r '.error // "unknown"' <<<"$payload")"
level=high
else
title="Claude run finished · $(basename "$CLAUDE_PROJECT_DIR")"
level=low
fi
jq -n --arg t "$title" --arg m "${last:0:300}
$link" --arg l "$level" '{title: $t, message: $m, level: $l}' |
curl -sS --max-time 10 https://api.pocketalert.app/v1/messages \
-H 'Content-Type: application/json' --data-binary @- >/dev/null 2>&1 || true
La vérification CLAUDE_CODE_REMOTE garde le hook silencieux sur votre ordinateur, où cette variable n'est jamais true. jq est préinstallé dans les sessions cloud, et le secret réseau de la première section fournit la clé. Gardez la notification via le prompt pour le contenu (« 3 paquets obsolètes, PR ouverte ») et le hook comme signal garanti de « c'est terminé », ou utilisez seulement l'un des deux.
Le hook se déclenche pour chaque session cloud sur ce dépôt, pas seulement pour les exécutions de routines, donc attendez-vous à une notification quand vous utilisez aussi Claude Code sur le web avec ce dépôt.
Niveaux et boutons
Le prompt ci-dessus utilise déjà l'élément le plus important : les niveaux. low arrive discrètement et reste dans l'historique, high s'affiche comme sensible au facteur temps sur iPhone et passe outre Concentration. La règle « high uniquement pour les problèmes » vous évite de tout désactiver au bout d'une semaine. critical existe aussi et passe outre Ne pas déranger sur les offres payantes, mais une routine nocturne mérite rarement ce niveau. Consultez les niveaux de priorité pour le comportement de chaque niveau sur iOS et Android.
Sur les offres payantes, un message peut porter jusqu'à trois boutons d'action. Le plus utile ici est un bouton view avec l'URL de la session, ajouté au JSON ainsi :
"actions": [{"type": "view", "label": "Open run", "value": "https://claude.ai/code/session_..."}]
Chaque notification arrive aussi dans l'historique de l'application et dans le tableau de bord web, à côté des alertes de vos serveurs et de votre CI, donc une semaine d'exécutions nocturnes tient en un seul défilement.
Limites honnêtes
- Le prompt est une demande, pas une garantie. Claude envoie généralement la notification, mais il peut l'oublier, en envoyer deux, ou écrire un JSON incorrect. Utilisez le hook si vous avez besoin de certitude.
- Une exécution peut s'arrêter et attendre. Les routines démarrent en mode automatique, mais une action qui correspond à une règle « ask », ou des blocages répétés, obligent l'exécution à attendre une réponse dans sa session. Ni le prompt ni
Stopne vous signaleront cette attente. Si une routine vous prévient d'habitude à 7 h 10 et qu'elle ne le fait pas, allez voir. - Les limites d'utilisation s'appliquent. Les exécutions sont décomptées de votre abonnement. Sans crédits d'utilisation, les exécutions supplémentaires sont refusées une fois la limite atteinte, et une exécution qui ne démarre jamais n'envoie rien. Il existe aussi des plafonds horaires : 100 exécutions planifiées par compte, 30 exécutions « Run now » ou appels d'API par routine.
- Préversion de recherche. Anthropic indique que le comportement, les limites et l'API peuvent encore changer.
- Offre gratuite. 50 messages par jour sur un appareil. Une routine horaire qui envoie une notification par exécution rentre dans ce quota ; une notification par fichier modifié n'y rentre pas.
Si rien n'arrive
- Ouvrez l'exécution. Chaque exécution dans l'Historique de la routine s'ouvre comme une session complète. Recherchez
api.pocketalert.appdans la transcription et lisez la sortie de curl. 403avechost_not_allowed. Le secret n'est pas présent sur l'environnement utilisé par cette routine, ou l'hôte est mal orthographié. Vérifiez Allowed websites.401. « No token provided » signifie qu'aucune clé n'a atteint l'API : le secret n'est pas rattaché ou le nom de l'en-tête est mal orthographié. « token contains an invalid number of segments » signifie que l'en-tête est toujoursAuthorization; remplacez-le parToken. « Invalid token » signifie que le préfixeBearerest encore présent ou que la clé a été révoquée.400. Le corps n'est pas un JSON valide, généralement à cause d'un guillemet non échappé dans le résumé. La version du hook construit le JSON avecjq, ce qui évite le problème.- Le hook ne s'est jamais exécuté. Vérifiez que
.claude/settings.jsonest commité sur la branche par défaut, que le script est exécutable, et que la routine ne comporte qu'un seul dépôt.
FAQ
Les routines Claude et les tâches planifiées sont-elles la même chose ?
Oui. Anthropic a renommé les routines en tâches planifiées ; l'adresse web, l'alias /routines et l'API conservent l'ancien nom.
La routine voit-elle ma clé API Pocket Alert ?
Pas avec un secret réseau. Le proxy ajoute l'en-tête après que la requête a quitté la session, donc la clé ne figure dans aucune variable d'environnement ni dans aucun fichier que Claude peut lire. Avec une variable d'environnement, elle est lisible à l'intérieur de la session.
Une routine peut-elle me réveiller la nuit ?
Avec "level": "critical" sur une offre payante, oui. Réservez-le aux routines qui surveillent la production, comme une routine déclenchée par API que votre supervision active lors d'un pic d'erreurs.
Qu'en est-il de la planification locale avec /loop ou des tâches planifiées de Desktop ?
Elles s'exécutent sur votre machine, donc les hooks locaux de Claude Code et les serveurs MCP fonctionnent comme d'habitude. La configuration est décrite dans Notifications push pour Claude Code. Pour d'autres schémas d'agents, consultez alertes pour agents IA.
Créez un compte gratuit, ajoutez le secret, et laissez la routine de demain matin vous dire comment elle s'est passée.