Routines et tâches planifiées Claude Code

Les Routines Claude Code sont des configurations sauvegardées qui s'exécutent automatiquement sur l'infrastructure cloud d'Anthropic et continuent à tourner même quand votre ordinateur est éteint. Elles se déclenchent sur une planification cron, sur un appel API ou sur un événement GitHub, et se créent depuis le web, l'application Desktop ou la commande /schedule dans le CLI. Pour du polling rapide dans une session ouverte, la commande /loop répète un prompt à intervalle régulier.

Là où le mode headless vous demande de fournir vous-même l'ordonnanceur (un cron système, un runner CI), les Routines déplacent la planification chez Anthropic. Vous décrivez une fois le travail à faire, vous attachez un ou plusieurs déclencheurs, et la tâche tourne sans que vous ayez à garder une machine allumée. Ce guide couvre les Routines cloud, les tâches planifiées Desktop locales, et la commande /loop pour le polling en session.

Qu'est-ce qu'une Routine Claude Code et où s'exécute-t-elle ?

Une Routine est une configuration Claude Code sauvegardée : un prompt, un ou plusieurs dépôts, et un ensemble de connecteurs, packagés une fois et exécutés automatiquement. Les Routines s'exécutent sur l'infrastructure cloud gérée par Anthropic, ce qui leur permet de continuer à fonctionner quand votre laptop est fermé.

Chaque exécution démarre une nouvelle session cloud Claude Code complète. La Routine clone le dépôt depuis sa branche par défaut, et Claude crée des branches préfixées claude/ pour ses modifications. Les Routines tournent de manière autonome : il n'y a pas de sélecteur de mode de permission et aucune demande d'approbation pendant un run.

Les Routines sont disponibles sur les plans Pro, Max, Team et Enterprise avec Claude Code sur le web activé. Vous les créez et les gérez sur claude.ai/code/routines, ou depuis le CLI avec /schedule.

⚠️ Les Routines sont en research preview. Le comportement, les limites et la surface d'API peuvent évoluer.

À retenir : une Routine est une tâche Claude Code persistante exécutée dans le cloud Anthropic, indépendante de l'état de votre machine.

Comment créer une Routine depuis le web, le Desktop ou le CLI ?

Vous pouvez créer une Routine depuis trois surfaces. Toutes écrivent dans le même compte cloud, donc une Routine créée sur une surface apparaît immédiatement sur les autres.

Depuis le web, rendez-vous sur claude.ai/code/routines et cliquez sur New routine. Le formulaire configure le prompt, les dépôts, l'environnement, les connecteurs et les déclencheurs.

Depuis l'application Desktop, cliquez sur Routines dans la barre latérale, puis New routine, et choisissez Remote. Choisir Local à la place crée une tâche planifiée Desktop, qui s'exécute sur votre machine plutôt que dans le cloud.

Depuis le CLI, exécutez /schedule dans n'importe quelle session pour créer une Routine planifiée de manière conversationnelle. Vous pouvez aussi passer une description directement :

/schedule daily PR review at 9am

/schedule clean up feature flag in one week

Claude reprend les mêmes informations que le formulaire web, puis sauvegarde la Routine sur votre compte. Le CLI gère également les Routines existantes :

/schedule list
/schedule update
/schedule run

/schedule dans le CLI ne crée que des Routines planifiées. Pour ajouter un déclencheur API ou GitHub, éditez la Routine sur le web. Notez aussi que le prompt doit être autonome et explicite : la Routine s'exécute sans surveillance, donc le prompt doit décrire précisément quoi faire et à quoi ressemble le succès.

À retenir : /schedule est le point d'entrée CLI pour créer et piloter des Routines planifiées sans quitter votre terminal.

Comment fonctionne un déclencheur de planification (cron) ?

Un déclencheur de planification exécute la Routine sur une cadence récurrente, ou une seule fois à un instant futur précis. Dans la section Select a trigger, vous choisissez une fréquence prédéfinie : hourly, daily, weekdays ou weekly. Les heures sont saisies dans votre fuseau local et converties automatiquement, donc la Routine tourne à l'heure murale voulue quelle que soit la localisation de l'infrastructure cloud.

Pour un intervalle personnalisé, choisissez le préréglage le plus proche dans le formulaire, puis exécutez /schedule update dans le CLI pour définir une expression cron précise. L'intervalle minimum est d'une heure ; les expressions plus fréquentes sont rejetées.

Une planification one-off déclenche la Routine une seule fois à un timestamp précis. Décrivez l'heure en langage naturel depuis le CLI :

/schedule tomorrow at 9am, summarize yesterday's merged PRs

/schedule in 2 weeks, open a cleanup PR that removes the feature flag

Après le tir, la Routine se désactive automatiquement et l'interface web la marque Ran. Les runs one-off ne comptent pas dans le plafond quotidien de Routines : ils consomment l'usage standard de votre abonnement comme n'importe quelle session.

À retenir : les planifications cron récurrentes ont un intervalle minimum d'une heure, tandis que les runs one-off ciblent un instant unique décrit en langage naturel.

Comment déclencher une Routine via API ou sur un événement GitHub ?

Au-delà du cron, une Routine peut combiner plusieurs déclencheurs. Vous attachez n'importe quelle combinaison de déclencheurs schedule, API et GitHub à la même Routine.

Déclencheur API

Un déclencheur API donne à la Routine un endpoint HTTP dédié. Un POST sur l'endpoint avec le token bearer de la Routine démarre une nouvelle session et renvoie une URL de session. Les déclencheurs API s'ajoutent depuis le web : ouvrez la Routine en édition, ajoutez un déclencheur API, copiez l'URL puis générez un token. Le token n'est affiché qu'une fois et ne peut pas être récupéré ensuite.

Envoyez ensuite une requête POST sur l'endpoint /fire. Le corps accepte un champ optionnel text pour passer du contexte spécifique au run, comme le corps d'une alerte :

curl -X POST https://api.anthropic.com/v1/claude_code/routines/trig_01ABCDEFGHJKLMNOPQRSTUVW/fire \
  -H "Authorization: Bearer sk-ant-oat01-xxxxx" \
  -H "anthropic-beta: experimental-cc-routine-2026-04-01" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"text": "Sentry alert SEN-4521 fired in prod. Stack trace attached."}'

Une requête réussie renvoie un JSON avec l'identifiant et l'URL de la nouvelle session :

{
  "type": "routine_fire",
  "claude_code_session_id": "session_01HJKLMNOPQRSTUVWXYZ",
  "claude_code_session_url": "https://claude.ai/code/session_01HJKLMNOPQRSTUVWXYZ"
}

Déclencheur GitHub

Un déclencheur GitHub démarre une nouvelle session automatiquement quand un événement correspondant survient sur un dépôt connecté. Les déclencheurs GitHub se configurent uniquement depuis l'interface web, et nécessitent l'installation de l'application GitHub Claude sur le dépôt. Deux catégories d'événements sont supportées : Pull request (PR ouverte, fermée, assignée, labellisée, synchronisée) et Release (créée, publiée, éditée, supprimée). Vous pouvez choisir une action précise comme pull_request.opened, ou réagir à toutes les actions de la catégorie.

Des filtres permettent de restreindre quelles PR démarrent une session : auteur, titre, corps, branche cible, branche source, labels, état draft ou merged. Chaque événement correspondant démarre sa propre session indépendante.

Pour gérer finement ce que la Routine peut atteindre, le guide MCP (Model Context Protocol) détaille la connexion sécurisée aux services externes via connecteurs, et le guide permissions et sécurité couvre la limitation des pushes aux branches claude/.

À retenir : une seule Routine peut réagir à un cron, à un appel API et à un événement GitHub à la fois, chaque déclencheur ouvrant sa propre session cloud.

Qu'est-ce qu'une tâche planifiée Desktop et quand l'utiliser ?

Une tâche planifiée Desktop s'exécute localement sur votre machine, contrairement à une Routine cloud. Vous la créez depuis l'application Desktop en choisissant Local au lieu de Remote lors de la création d'une nouvelle Routine.

La différence clé tient à l'accès aux fichiers et à l'état machine. Une tâche Desktop accède aux fichiers locaux et tourne sur votre machine, ce qui exige que celle-ci soit allumée. Une Routine cloud travaille sur un clone frais, sans accès à vos fichiers locaux, mais ne dépend pas de l'état de votre machine. L'intervalle minimum d'une tâche Desktop est d'une minute, contre une heure pour une Routine cloud.

Choisissez les tâches cloud pour du travail qui doit tourner de manière fiable sans votre machine. Choisissez les tâches Desktop quand vous avez besoin d'accéder aux fichiers et outils locaux. Choisissez /loop pour du polling rapide pendant une session.

À retenir : une tâche Desktop est le bon choix quand le travail dépend de fichiers locaux ; une Routine cloud l'est quand la persistance prime sur l'accès local.

Comment utiliser /loop pour du polling dans une session ?

La commande /loop est le moyen le plus rapide de répéter un prompt tant que la session reste ouverte. C'est une compétence (skill) fournie de série. Les tâches /loop sont liées à la session : elles vivent dans la conversation courante et s'arrêtent quand vous en démarrez une nouvelle.

Quand vous fournissez un intervalle et un prompt, Claude le convertit en expression cron, planifie le job et confirme la cadence :

/loop 5m check if the deployment finished and tell me what happened

Les unités supportées sont s (secondes), m (minutes), h (heures) et d (jours). Si vous omettez l'intervalle, Claude en choisit un dynamiquement entre une minute et une heure selon ce qu'il observe :

/loop check whether CI passed and address any review comments

Vous pouvez aussi passer une autre commande comme prompt, par exemple /loop 20m /review-pr 1234, pour ré-exécuter une skill ou commande sauvegardée à chaque itération. Pour un rappel unique, décrivez simplement votre besoin en langage naturel :

remind me at 3pm to push the release branch

Pour arrêter un /loop pendant qu'il attend la prochaine itération, appuyez sur Esc. Les tâches récurrentes en session expirent automatiquement 7 jours après leur création.

À retenir : /loop excelle pour surveiller un déploiement ou une PR pendant une session ouverte, mais s'arrête dès que la session se termine.

Quelle option de planification choisir selon le besoin ?

Les trois options répondent à des besoins distincts, et le bon choix dépend de la durée de vie attendue et de l'accès aux ressources.

Utilisez une Routine cloud pour de l'automatisation non surveillée qui doit survivre indépendamment de toute session : revue de PR nocturne, triage d'alertes via endpoint API, vérification de déploiement. C'est le seul mode qui tourne machine éteinte.

Utilisez une tâche Desktop quand le travail a besoin de fichiers locaux ou d'outils installés sur votre poste, tout en gardant une planification durable qui survit aux redémarrages.

Utilisez /loop pour du polling court et ponctuel pendant une session active, là où l'overhead de création d'une Routine n'est pas justifié. Pour orchestrer ces automatisations avec des sessions multi-turn et le mode headless, reportez-vous au tutoriel mode headless et CI/CD, et consultez le guide intégration Git pour comprendre comment Claude gère les branches lors des runs automatisés.

Si vous souhaitez un accompagnement structuré sur l'automatisation de vos workflows avec Claude Code, la formation Claude Code de SFEIR Institute couvre en 1 journée le mode headless et les patterns d'automatisation, et la formation Développeur Augmenté par l'IA approfondit l'intégration de l'IA dans l'ensemble du cycle de développement.

Pour les questions fréquentes sur les déclencheurs, les limites d'usage et le dépannage, la FAQ du mode headless regroupe les réponses essentielles.

À retenir : cloud pour la fiabilité sans machine, Desktop pour l'accès local durable, /loop pour le polling rapide en session.

---