SpyBara
Go Premium

routines.md 2026-10-19 23:58 UTC to 2026-10-20 23:00 UTC

This page contains 264 additions and 281 deletions.

2026
Thu 1 23:59 Fri 2 22:59 Sat 3 23:57 Wed 7 23:59 Thu 8 22:58 Sat 10 23:01 Wed 14 22:58 Tue 20 23:00 Wed 21 23:02 Thu 22 22:58 Fri 23 22:59 Sat 24 22:59 Sun 25 23:58 Tue 27 22:59 Fri 30 23:01

Automatiser le travail avec les tâches planifiées

Mettez Claude Code en pilotage automatique. Créez des tâches planifiées, anciennement appelées routines, qui s'exécutent dans le cloud selon un calendrier, sur des appels API ou sur des événements GitHub.

[!NOTE]

Les tâches planifiées sont en research preview. Le comportement, les limites et la surface de l'API peuvent changer.

Une tâche planifiée cloud, anciennement appelée routine, est une configuration Claude Code enregistrée : un prompt, un ou plusieurs dépôts, et un ensemble de connecteurs, empaquetés une fois et exécutés automatiquement. Les tâches planifiées s'exécutent sur l'infrastructure cloud gérée par Anthropic, ou sur l'environnement auto-hébergé de votre organisation lorsqu'elles y sont routées, de sorte qu'elles continuent de fonctionner lorsque votre ordinateur portable est fermé.

Chaque tâche planifiée peut avoir un ou plusieurs déclencheurs attachés :

  • Planification : s'exécute selon une cadence récurrente comme toutes les heures, chaque nuit ou chaque semaine, ou une seule fois à un moment futur spécifique
  • API : se déclenche à la demande en envoyant une requête HTTP POST à l'endpoint propre à la tâche avec un jeton porteur
  • GitHub : s'exécute automatiquement en réponse aux événements du dépôt tels que les pull requests ou les releases

Une seule tâche planifiée peut combiner des déclencheurs. Par exemple, une tâche de revue de PR peut s'exécuter chaque nuit, se déclencher à partir d'un script de déploiement, et réagir également à chaque nouvelle PR.

Une tâche planifiée n'a pas besoin de planification :

  • Une tâche avec uniquement un déclencheur API s'exécute lorsque vous appelez son endpoint.
  • Une tâche avec uniquement un déclencheur GitHub s'exécute lorsqu'un événement de dépôt correspondant se produit.

Les tâches planifiées sont disponibles sur les plans Pro, Max, Team et Enterprise. Créez-les et gérez-les sur claude.ai/code/routines, ou à partir de la CLI avec /schedule. L'ancien nom, routines, apparaît encore dans l'adresse web, la CLI et l'API.

[!NOTE]

Deux autres fonctionnalités planifient du travail sur votre machine plutôt que dans le cloud : les tâches planifiées Desktop et /loop. Pour choisir parmi les trois, consultez Comparer les options de planification.

Les propriétaires Team et Enterprise peuvent désactiver les tâches planifiées pour tous les membres avec le bouton bascule Scheduled tasks (Was Routines) dans Organization settings > Capabilities > Remote sessions. Lorsque le bouton bascule est désactivé, les tâches planifiées existantes cessent de s'exécuter et les membres ne peuvent pas en créer de nouvelles.

Exemples de cas d'usage

Chaque exemple associe un type de déclencheur au type de travail auquel les tâches planifiées sont adaptées : sans surveillance, répétable et lié à un résultat clair.

  • Maintenance du backlog : un déclencheur de planification s'exécute chaque soir de semaine dans votre dépôt, avec votre outil de suivi des tickets ajouté comme connecteur. La tâche planifiée lit les tickets ouverts depuis la dernière exécution, applique des étiquettes et assigne des responsables en fonction de la zone de code référencée. Elle publie ensuite un résumé sur Slack afin que l'équipe commence la journée avec une file d'attente triée.
  • Triage des alertes : votre outil de surveillance appelle l'endpoint API de la tâche planifiée lorsqu'un seuil d'erreur est dépassé, en transmettant le corps de l'alerte en tant que text. Le prompt de la tâche demande à Claude d'enquêter sur l'alerte contenue dans le payload de déclenchement, il extrait donc la trace de pile et la met en corrélation avec les commits récents du dépôt. Il ouvre ensuite une pull request brouillon avec un correctif proposé et un lien vers l'alerte. L'équipe d'astreinte examine la PR au lieu de partir d'un terminal vierge.
  • Revue de code sur mesure : un déclencheur GitHub s'exécute sur pull_request.opened. La tâche planifiée applique la liste de contrôle de revue propre à votre équipe et laisse des commentaires en ligne pour les problèmes de sécurité, de performance et de style. Elle ajoute également un commentaire récapitulatif afin que les relecteurs humains puissent se concentrer sur la conception plutôt que sur les vérifications mécaniques.
  • Vérification du déploiement : votre pipeline CD appelle l'endpoint API de la tâche planifiée après chaque déploiement en production. La tâche exécute des smoke tests sur le nouveau build, analyse les logs d'erreurs pour détecter les régressions, et publie un feu vert ou un feu rouge sur le canal de release avant la fermeture de la fenêtre de déploiement.
  • Dérive de la documentation : un déclencheur de planification s'exécute chaque semaine. La tâche planifiée analyse les PR fusionnées depuis la dernière exécution, signale la documentation qui référence des API modifiées, et ouvre des PR de mise à jour sur le dépôt de documentation pour qu'un éditeur les examine.
  • Portage de bibliothèque : un déclencheur GitHub s'exécute sur pull_request.closed filtré sur les PR fusionnées dans un dépôt SDK. La tâche planifiée porte la modification vers un SDK parallèle dans un autre langage et ouvre une PR correspondante, en gardant les deux bibliothèques synchronisées sans qu'un humain ne réimplémente chaque modification.

Créer une tâche planifiée

Créez une tâche planifiée à partir du web sur claude.ai/code/routines, à partir de l'application Desktop, ou à partir de la CLI. Les trois surfaces écrivent dans le même compte cloud, de sorte qu'une tâche planifiée que vous créez dans l'une apparaît immédiatement dans les autres. Dans l'onglet Code de l'application Desktop, cliquez sur Scheduled dans la barre latérale ou dans le menu More de la barre latérale, puis sur New task, et poursuivez avec Créer à partir du web.

Les tâches planifiées s'exécutent de manière autonome en tant que sessions cloud Claude Code complètes. Vous ne choisissez pas de mode de permission. La session exécute des commandes shell, utilise des skills commités dans le dépôt cloné, et appelle tous les connecteurs que vous incluez, le tout sans s'arrêter pour approbation en dehors de certaines actions sur les artefacts.

Ce qu'une tâche planifiée peut atteindre est déterminé par :

  • Les dépôts que vous sélectionnez
  • L'accès réseau et les variables de l'environnement
  • Les connecteurs que vous incluez

Limitez chacun de ces éléments à ce dont la tâche a besoin.

Les tâches planifiées appartiennent à votre compte claude.ai individuel. Elles ne sont pas partagées avec vos coéquipiers, et leurs exécutions sont décomptées de l'utilisation et des limites de votre compte. Tout ce qu'une tâche planifiée fait via votre identité GitHub connectée ou vos connecteurs apparaît comme provenant de vous. Les commits et les pull requests portent votre utilisateur GitHub, et les messages Slack, les tickets Linear ou les autres actions de connecteur utilisent vos comptes liés pour ces services.

Créer à partir du web

1. Ouvrir la boîte de dialogue de création

Rendez-vous sur claude.ai/code/routines et cliquez sur New task. Si un menu s'ouvre d'abord, sélectionnez Set up manually. La boîte de dialogue New scheduled task s'ouvre. L'autre option du menu, Create with Claude, vous permet plutôt de décrire la tâche dans un chat et de laisser Claude la créer.

Si Repositories et Environment sont déjà affichés à l'ouverture de la boîte de dialogue, consultez en quoi cette boîte de dialogue diffère. Sinon, cette boîte de dialogue crée également des tâches planifiées pour le chat claude.ai. Pour que la vôtre soit ce que la boîte de dialogue appelle une tâche Claude Code, sélectionnez un dépôt ou ajoutez un déclencheur d'événement GitHub ou API dans les étapes qui suivent. Ce type de tâche exécute Claude Code dans une session cloud.

2. Nommer la tâche et écrire le prompt

Donnez à la tâche planifiée un nom descriptif et écrivez le prompt que Claude exécute à chaque fois. Le prompt est la partie la plus importante : la tâche s'exécute de manière autonome, le prompt doit donc être autosuffisant et explicite sur ce qu'il faut faire et sur ce à quoi ressemble le succès. Sélectionnez un modèle dans le sélecteur de modèle du champ de prompt. Claude l'utilise à chaque exécution.

Lorsqu'un déclencheur se déclenche, la session reçoit le prompt enregistré comme sa mission et l'exécute, plutôt que de le traiter comme un contenu non fiable arrivé au milieu d'une conversation. Le déclencheur atteste seulement que le prompt a été stocké à l'avance par une session autorisée sur votre compte. Le prompt déclenché n'est donc pas une entrée utilisateur en direct et ne peut pas valoir approbation ou consentement pour des actions pendant l'exécution. Le contenu que la session récupère pendant l'exécution conserve son traitement habituel.

3. Sélectionner un déclencheur

Dans la ligne Trigger, choisissez comment la tâche démarre. Pour combiner plusieurs déclencheurs, cliquez sur + à la fin de la ligne.

Schedule

Choisissez une fréquence prédéfinie pour une exécution récurrente. Consultez Ajouter un déclencheur de planification pour la gestion des fuseaux horaires, les démarrages tardifs, les intervalles cron personnalisés et les exécutions ponctuelles.

GitHub event

Sélectionnez le dépôt, l'événement auquel réagir et des filtres facultatifs. Consultez Ajouter un déclencheur GitHub pour la liste complète des événements pris en charge et des champs de filtre.

API

Sélectionnez API ici. Lorsque vous cliquez sur Create, la boîte de dialogue API token affiche le jeton une seule fois, copiez-le donc avant de fermer la boîte de dialogue. Consultez Ajouter un déclencheur API pour copier l'URL ou générer un nouveau jeton.

4. Sélectionner les dépôts

Développez Advanced settings. Sous Repository dans l'onglet General, sélectionnez un ou plusieurs dépôts GitHub dans lesquels Claude travaillera.

Chaque dépôt est cloné au début d'une exécution. Claude crée des branches préfixées par claude/ pour ses modifications.

5. Sélectionner un environnement

Après avoir sélectionné un dépôt, Cloud environment apparaît en dessous. Choisissez un environnement cloud pour la tâche. Les environnements contrôlent ce à quoi la session cloud a accès :

  • Network access : définissez le niveau d'accès à Internet disponible pendant chaque exécution
  • Environment variables : fournissez des valeurs que Claude peut utiliser pendant chaque exécution. Elles sont visibles par quiconque utilise l'environnement, donc dans un environnement hébergé par Anthropic, stockez plutôt les clés des API que Claude appelle pendant une exécution en tant que secrets réseau. Cette section liste également les requêtes qui ne reçoivent jamais de secret
  • Setup script : installez les dépendances et les outils dont la tâche a besoin. Le résultat est mis en cache, de sorte que le script ne se réexécute pas à chaque session

Un environnement Default est fourni avec un accès réseau Trusted, qui n'autorise que la liste d'autorisation par défaut des registres de paquets, des API de fournisseurs cloud, des registres de conteneurs et des domaines de développement courants à travers le réseau de la session. Les connecteurs que vous ajoutez à la tâche atteignent leurs services via les serveurs d'Anthropic, ils n'ont donc pas besoin de modifications de la liste d'autorisation.

Si votre tâche doit atteindre directement vos propres services, ou un domaine en dehors de cette liste, modifiez l'accès réseau de l'environnement avant l'exécution. Pour utiliser un environnement distinct, créez-en un d'abord.

6. Examiner les connecteurs

Passez à l'onglet Connectors de Advanced settings. Tous vos connecteurs MCP connectés sont inclus par défaut. Supprimez ceux dont la tâche n'a pas besoin : Claude peut utiliser chaque outil d'un connecteur inclus, y compris les écritures, sans demander de permission pendant une exécution.

7. Créer la tâche

Cliquez sur Create. La boîte de dialogue se ferme et la page de détail de la nouvelle tâche s'ouvre. La tâche s'exécute la prochaine fois que l'un de ses déclencheurs correspond. Pour démarrer une exécution immédiatement, cliquez sur Run now sur la page de détail.

Chaque exécution crée une nouvelle session aux côtés de vos autres sessions, où vous pouvez voir ce que Claude a fait, examiner les modifications et créer une pull request.

Boîte de dialogue avec Repositories et Environment dans la vue principale

Suivez les étapes de création à partir du web, et remplissez chaque champ dans la vue principale de la boîte de dialogue plutôt que sous Advanced settings. Cette boîte de dialogue crée uniquement des tâches Claude Code.

Sélectionnez le dépôt avant d'ajouter un déclencheur d'événement GitHub, car ce déclencheur n'est pas disponible tant qu'aucun dépôt n'est sélectionné.

Créer à partir de la CLI

Exécutez /schedule dans n'importe quelle session pour créer une tâche planifiée de manière conversationnelle. Vous pouvez également transmettre directement une description, pour une tâche récurrente comme /schedule daily PR review at 9am ou ponctuelle comme /schedule clean up feature flag in one week. Claude passe en revue les mêmes informations que celles recueillies par la boîte de dialogue web, puis enregistre la tâche sur votre compte. La commande est également disponible sous l'alias /routines.

Un démarrage réussi ressemble à une conversation : Claude pose des questions de suivi sur la planification, les dépôts et le prompt avant d'enregistrer. Si Claude répond plutôt que vous devez vous authentifier ou qu'il ne peut pas se connecter à votre compte claude.ai distant, aucune tâche planifiée n'a été créée ; consultez Dépannage.

Une tâche que vous créez avec /schedule possède un déclencheur de planification. Vous pouvez également ajouter les autres types de déclencheurs :

  • Déclencheur API : modifiez la tâche sur le web sur claude.ai/code/routines
  • Déclencheur GitHub : modifiez la tâche sur le web, ou demandez à Claude dans la CLI. L'ajout à partir de la CLI nécessite Claude Code v2.1.225 ou version ultérieure

Une tâche planifiée sans déclencheur de planification, comme une tâche démarrée uniquement par des appels API ou des événements GitHub, n'a pas d'heure de prochaine exécution. La CLI n'en affiche aucune lorsque Claude l'enregistre ou la met à jour. Avant la v2.1.211, la CLI indiquait une heure de prochaine exécution en l'an 1 pour ces tâches.

Configurer les déclencheurs

Une tâche planifiée démarre lorsque l'un de ses déclencheurs correspond. Ajoutez ou supprimez les déclencheurs d'une tâche à tout moment dans la ligne Trigger de la boîte de dialogue de modification de la tâche.

Lorsqu'une tâche a deux déclencheurs ou plus, chacun possède une icône de corbeille dans cette boîte de dialogue. Pour supprimer un déclencheur de planification ou d'événement GitHub, cliquez sur son icône de corbeille, puis sur Save changes. Pour supprimer un déclencheur API, supprimez plutôt son jeton.

Ajouter un déclencheur de planification

Un déclencheur de planification exécute la tâche selon une cadence récurrente, ou une seule fois à un moment futur spécifique. Dans la boîte de dialogue de création ou de modification de la tâche sur le web, choisissez une fréquence prédéfinie telle que toutes les heures, quotidienne ou hebdomadaire :

  • Fuseau horaire : les heures sont saisies dans votre fuseau horaire local et converties automatiquement, de sorte que la tâche s'exécute à cette heure locale, quel que soit l'emplacement de l'infrastructure cloud.
  • Exécutions à l'heure pile : si vous planifiez une exécution exactement à l'heure pile, par exemple 9:00, elle peut démarrer avec plusieurs minutes de retard. Pour démarrer au plus près de l'heure planifiée, choisissez quelques minutes après l'heure, par exemple 9:07.
  • Intervalles personnalisés : pour un intervalle personnalisé tel que toutes les deux heures, choisissez le préréglage le plus proche dans la boîte de dialogue, puis exécutez /schedule update dans la CLI pour définir une expression cron spécifique. L'intervalle minimum est d'une heure ; les expressions qui s'exécutent plus fréquemment sont rejetées.

Planifier une exécution ponctuelle

Une planification ponctuelle exécute la tâche une seule fois à un horodatage spécifique. Par exemple, utilisez-la pour :

  • Vous faire un rappel plus tard dans la semaine
  • Ouvrir une PR de nettoyage après la fin d'un déploiement progressif
  • Lancer un travail de suivi après la livraison d'une modification en amont

Après l'exécution, la tâche se désactive d'elle-même et l'interface web la marque comme Completed. Pour l'exécuter à nouveau, ouvrez la boîte de dialogue de modification de la tâche sur le web, qui propose One-time pour une tâche ponctuelle, et définissez une nouvelle heure.

Créez une exécution ponctuelle à partir de la CLI en décrivant l'heure en langage naturel. Claude interprète l'expression par rapport à l'heure actuelle et confirme l'horodatage absolu avant d'enregistrer.

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

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

La même conversion de l'heure locale vers UTC que pour les planifications récurrentes s'applique aux horodatages ponctuels.

Les exécutions ponctuelles sont décomptées de la même limite horaire que les autres exécutions planifiées. Consultez Utilisation et limites pour plus de détails.

Ajouter un déclencheur API

Un déclencheur API donne à une tâche planifiée un endpoint HTTP dédié. Envoyer une requête POST à l'endpoint avec le jeton porteur de la tâche démarre une nouvelle session et renvoie une URL de session. Utilisez-le pour intégrer Claude Code dans des systèmes d'alerte, des pipelines de déploiement, des outils internes, ou partout où vous pouvez effectuer une requête HTTP authentifiée.

Ajoutez un déclencheur API sur le web, soit pendant que vous créez la tâche, soit plus tard avec les étapes ci-dessous. Vous ne pouvez pas ajouter de déclencheur API ni gérer son jeton à partir de la CLI.

1. Ouvrir la tâche pour la modifier

Rendez-vous sur claude.ai/code/routines, cliquez sur la tâche planifiée que vous souhaitez déclencher via l'API, puis ouvrez le menu à côté de son nom et sélectionnez Edit. La boîte de dialogue Edit scheduled task s'ouvre.

2. Ajouter un déclencheur API

Dans la ligne Trigger, cliquez sur + et sélectionnez API dans le menu qui s'ouvre. Un panneau avec la Fire URL et le Token de cette tâche apparaît.

3. Copier l'URL et générer un jeton

Copiez la Fire URL. Cliquez sur Generate token, puis copiez immédiatement le jeton depuis la boîte de dialogue Token generated. Le jeton n'est affiché qu'une seule fois et ne peut pas être récupéré ultérieurement, stockez-le donc dans un endroit sécurisé, comme le coffre de secrets de votre outil d'alerte.

Le déclencheur API prend effet dès que vous générez le jeton. Vous n'avez pas besoin de cliquer sur Save changes, fermez donc la boîte de dialogue lorsque vous avez terminé.

4. Appeler l'endpoint

Envoyez le jeton dans l'en-tête Authorization: Bearer lorsque vous envoyez une requête POST à l'URL. Déclencher une tâche planifiée présente un exemple complet.

Chaque tâche planifiée possède son propre jeton, limité au déclenchement de cette seule tâche. Pour désactiver l'accès API ou faire tourner le jeton, ouvrez à nouveau la boîte de dialogue Edit scheduled task de la tâche. Les deux contrôles se trouvent à côté du jeton dans le panneau du déclencheur API et prennent effet immédiatement :

  • Désactiver l'accès API : cliquez sur Delete token, l'icône de corbeille à côté de Regenerate. Cela supprime le déclencheur API
  • Faire tourner le jeton : cliquez sur Regenerate. Le jeton précédent cesse de fonctionner, et la boîte de dialogue Token generated affiche le nouveau une seule fois

Déclencher une tâche planifiée

Envoyez une requête POST à l'endpoint /fire avec le jeton porteur dans l'en-tête Authorization. Le corps de la requête accepte un champ text facultatif pour un contexte propre à l'exécution, tel que le corps d'une alerte ou un log d'échec, transmis à la tâche avec son prompt enregistré. La valeur est du texte libre et n'est pas analysée : si vous envoyez du JSON ou un autre payload structuré, la tâche le reçoit sous forme de chaîne littérale.

La valeur text n'atteint pas la routine sous forme de message brut. Elle arrive encapsulée dans un bloc <routine-fire-payload> qui l'étiquette comme donnée non fiable et indique à Claude de ne pas suivre les instructions qu'elle contient, sauf si le prompt de la routine elle-même le demande. La même encapsulation s'applique au texte fourni avec Run now dans l'interface web.

Cela signifie que le prompt enregistré d'une routine doit explicitement accepter d'agir sur le texte de déclenchement : rédigez le prompt pour qu'il fasse explicitement référence au payload, par exemple « Enquêter sur l'alerte décrite dans le bloc routine-fire-payload », sinon la routine traite le texte comme un contexte inerte. Quiconque détient le jeton porteur peut envoyer text, l'encapsulation fait donc en sorte que le texte de déclenchement provenant d'un jeton divulgué arrive étiqueté comme donnée non fiable plutôt que comme instructions directes à votre routine.

L'exemple ci-dessous déclenche une tâche planifiée à partir d'un shell. L'ID de tâche et le jeton affichés sont des valeurs fictives : remplacez-les par l'URL et le jeton que vous avez copiés lors de l'ajout du déclencheur API, sinon la requête échoue avec une erreur d'authentification 401 :

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 corps JSON avec l'ID 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"
}

Ouvrez l'URL de session dans un navigateur pour suivre l'exécution en temps réel, examiner les modifications ou poursuivre la conversation manuellement.

[!WARNING]

L'endpoint /fire est livré sous l'en-tête bêta experimental-cc-routine-2026-04-01. Les formats de requête et de réponse, les limites de débit et la sémantique des jetons peuvent changer tant que la fonctionnalité est en research preview. Les changements incompatibles sont livrés derrière de nouvelles versions datées de l'en-tête bêta, et les deux versions précédentes les plus récentes de l'en-tête continuent de fonctionner afin que les appelants aient le temps de migrer.

Référence API

Pour la référence API complète, y compris toutes les réponses d'erreur, les règles de validation et les limites de champs, consultez Trigger a routine through the API dans la documentation de la Claude Platform.

L'endpoint /fire est réservé aux utilisateurs de claude.ai et ne fait pas partie de la surface de l'API Claude Platform.

Ajouter un déclencheur GitHub

Un déclencheur GitHub démarre automatiquement une nouvelle session lorsqu'un événement correspondant se produit sur un dépôt connecté. Claude Code ne réutilise pas les sessions d'un événement à l'autre, de sorte que deux mises à jour de PR produisent deux sessions indépendantes.

[!NOTE]

Les événements webhook GitHub sont soumis à des plafonds horaires par tâche et par compte. Les événements au-delà de la limite sont ignorés jusqu'à la réinitialisation de la fenêtre.

La Claude GitHub App doit être installée sur le dépôt auquel vous souhaitez vous abonner, quelle que soit la surface à partir de laquelle vous configurez le déclencheur.

  • Configurez les déclencheurs GitHub à partir de l'interface web, qui vous invite à installer l'application si elle est absente. Suivez les étapes ci-dessous pour en configurer un sur le web.
  • À partir de la CLI, installez d'abord l'application depuis la page de la GitHub App, puis demandez à Claude d'attacher un déclencheur GitHub à une tâche planifiée existante, par exemple /schedule add a GitHub trigger to my nightly review for pull requests opened in acme/webapp. Le chemin CLI nécessite Claude Code v2.1.225 ou version ultérieure. Lorsque Claude ajoute le déclencheur, il répond avec un lien vers la tâche que le déclencheur lance.

1. Ouvrir la tâche pour la modifier

Rendez-vous sur claude.ai/code/routines, cliquez sur la tâche planifiée, puis ouvrez le menu à côté de son nom et sélectionnez Edit. La boîte de dialogue Edit scheduled task s'ouvre.

2. Ajouter un déclencheur d'événement GitHub

Dans la ligne Trigger, cliquez sur + et sélectionnez GitHub event dans le menu qui s'ouvre.

[!NOTE]

L'exécution de /web-setup dans la CLI accorde l'accès au dépôt pour le clonage, mais elle n'installe pas la Claude GitHub App et n'active pas la livraison des webhooks.

3. Configurer le déclencheur

Changez de dépôt si nécessaire, choisissez un événement dans la liste des événements pris en charge, et ajoutez éventuellement des filtres. Cliquez ensuite sur Save changes en bas de la boîte de dialogue pour appliquer le déclencheur.

Événements pris en charge

Les déclencheurs GitHub peuvent s'abonner à l'une ou l'autre des catégories d'événements suivantes. Dans chaque catégorie, vous pouvez choisir une action spécifique, comme pull_request.opened, ou réagir à toutes les actions de la catégorie.

Événement Se déclenche quand
Pull request Une PR est ouverte, fermée, assignée, étiquetée, synchronisée ou mise à jour d'une autre manière
Release Une release est créée, publiée, modifiée ou supprimée

Filtrer les pull requests

Utilisez des filtres pour restreindre les pull requests qui démarrent une nouvelle session. Toutes les conditions de filtre doivent correspondre pour que la tâche planifiée se déclenche. Les champs de filtre disponibles sont :

Filtre Correspond à
Author Nom d'utilisateur GitHub de l'auteur de la PR
Title Texte du titre de la PR
Body Texte de la description de la PR
Base branch Branche ciblée par la PR
Head branch Branche d'où provient la PR
Labels Étiquettes appliquées à la PR
Is draft Si la PR est à l'état brouillon
Is merged Si la PR a été fusionnée

Chaque filtre associe un champ à un opérateur : égal à, contient, commence par, est l'un de, n'est pas l'un de, ou correspond à la regex.

L'opérateur matches regex teste la valeur entière du champ, et non une sous-chaîne de celle-ci. Pour correspondre à n'importe quel titre contenant hotfix, écrivez .*hotfix.*. Sans les .* qui l'entourent, le filtre ne correspond qu'à un titre valant exactement hotfix, sans rien avant ni après. Pour une correspondance littérale de sous-chaîne sans syntaxe regex, utilisez plutôt l'opérateur contains.

Quelques exemples de combinaisons de filtres :

  • Revue du module d'authentification : branche de base main, branche de tête contenant auth-provider. Envoie toute PR touchant l'authentification à un relecteur dédié.
  • Uniquement les PR prêtes pour la revue : is draft vaut false. Ignore les brouillons afin que la tâche ne s'exécute que lorsque la PR est prête pour la revue.
  • Backport conditionné par une étiquette : les étiquettes incluent needs-backport. Déclenche une tâche de portage vers une autre branche uniquement lorsqu'un mainteneur étiquette la PR.

Gérer les tâches planifiées

Cliquez sur une tâche planifiée dans la liste pour ouvrir sa page de détail. La page de détail affiche les dépôts, les connecteurs, le prompt, la planification, les jetons API, les déclencheurs GitHub de la tâche et une liste des exécutions passées.

Afficher les exécutions et interagir avec elles

Cliquez sur n'importe quelle exécution pour l'ouvrir en tant que session complète. De là, vous pouvez voir ce que Claude a fait, examiner les modifications, créer une pull request ou poursuivre la conversation. Chaque session d'exécution fonctionne comme n'importe quelle autre session : utilisez le menu déroulant à côté du titre de la session pour la renommer, l'archiver ou la supprimer.

[!NOTE]

Un statut vert dans la liste des exécutions signifie que la session a démarré et s'est terminée sans erreur d'infrastructure. Cela ne signifie pas que le travail décrit par votre prompt a réussi. Ouvrez l'exécution pour lire la transcription et confirmer ce que Claude a réellement fait. Les requêtes réseau bloquées, les outils de connecteur manquants et les échecs du travail lui-même apparaissent tous là plutôt que dans l'indicateur de statut.

Modifier et contrôler les tâches planifiées

À partir de la page de détail, vous pouvez :

  • Cliquer sur Run now pour démarrer une exécution immédiatement sans attendre la prochaine heure planifiée.
  • Utiliser l'interrupteur marche/arrêt en haut de la page pour suspendre ou reprendre la planification. Les tâches suspendues conservent leur configuration mais ne s'exécutent pas tant que vous ne les réactivez pas.
  • Ouvrir le menu à côté du nom de la tâche et sélectionner Edit pour modifier le nom, le prompt, les dépôts, l'environnement, les connecteurs ou l'un des déclencheurs de la tâche. La boîte de dialogue Edit scheduled task s'ouvre avec la même disposition que la boîte de dialogue de création. Pour ajouter un déclencheur, cliquez sur + dans la ligne Trigger. Cliquez sur Save changes pour appliquer vos modifications. Les actions sur les jetons API prennent effet immédiatement, sans Save changes.
  • Ouvrir le même menu et sélectionner Delete pour supprimer la tâche.

Gérer les tâches planifiées à partir de la CLI

Exécutez /schedule list pour afficher vos tâches planifiées, /schedule update pour en modifier une, ou /schedule run pour en démarrer une immédiatement.

Vous pouvez également poser des questions sur l'historique des exécutions d'une tâche planifiée, par exemple /schedule why did my nightly review do nothing this morning?. Claude liste les exécutions récentes de la tâche avec leur statut et un lien pour ouvrir chaque exécution sur le web. Il lit également le log d'une exécution pour expliquer ce qui s'est passé, y compris les erreurs d'outils, les refus de permission et le résultat final. Nécessite Claude Code v2.1.227 ou version ultérieure.

Dépôts et permissions de branche

Les tâches planifiées ont besoin d'un accès GitHub pour cloner les dépôts. Lorsque vous créez une tâche planifiée à partir de la CLI avec /schedule, Claude vérifie si votre compte dispose d'un accès GitHub pour le dépôt à partir duquel vous l'avez exécutée. Si ce n'est pas le cas, Claude ajoute une note de configuration indiquant comment l'accorder.

[!NOTE]

Consultez Options d'authentification GitHub pour les deux façons d'accorder l'accès. Sur les plans Team et Enterprise, un propriétaire de votre organisation Claude doit activer chaque méthode avant que vous puissiez l'utiliser ; consultez Connecter GitHub.

Si votre connexion GitHub est absente ou expirée au moment où une exécution est prévue, la tâche planifiée ignore les exécutions jusqu'à ce que vous vous reconnectiez, pendant 72 heures au maximum. Reconnectez GitHub dans ce délai et la tâche reprend d'elle-même. Après 72 heures sans connexion, la tâche se désactive, et vous la réactivez après avoir reconnecté GitHub.

Chaque dépôt que vous ajoutez est cloné à chaque exécution. Claude part de la branche par défaut du dépôt, sauf indication contraire de votre prompt. Si un événement de pull request GitHub déclenche l'exécution et que le dépôt de la pull request est le premier dépôt de la tâche, ce dépôt part plutôt du commit de tête de la pull request.

Claude pousse son travail vers une branche préfixée par claude/, sauf si votre prompt lui demande de pousser vers une autre branche. Pour contrôler les branches vers lesquelles une exécution peut pousser, utilisez des règles de protection de branche ou des rulesets sur GitHub. Pour les exécutions sur l'infrastructure gérée par Anthropic, ainsi que pour les exécutions auto-hébergées qui poussent via le proxy git d'Anthropic, GitHub les applique à l'accès GitHub que vous avez connecté, de sorte qu'une règle que cet accès peut contourner ne bloque pas le push d'une exécution. Une exécution auto-hébergée qui pousse avec les identifiants git fournis par votre déploiement est plutôt vérifiée par rapport à ceux-ci. Consultez Configurer git.

Connecteurs

Les tâches planifiées peuvent utiliser vos connecteurs MCP connectés pour lire et écrire dans des services externes pendant chaque exécution. Par exemple, une tâche qui trie les demandes d'assistance peut lire un canal Slack et créer des tickets dans Linear.

Les connecteurs sont les intégrations claude.ai de votre compte. Les serveurs MCP que vous avez ajoutés localement dans la CLI avec claude mcp add sont stockés sur votre machine plutôt que sur votre compte claude.ai, ils n'apparaissent donc pas dans la liste des connecteurs. Pour utiliser l'un de ces serveurs dans une tâche planifiée :

  • En tant que connecteur : ajoutez-le en tant que connecteur sur claude.ai/customize/connectors
  • Dans le dépôt : pour une tâche planifiée avec un seul dépôt, vous pouvez plutôt déclarer le serveur dans un fichier .mcp.json commité afin qu'il fasse partie du dépôt cloné

Lorsque vous créez une tâche planifiée, tous vos connecteurs actuellement connectés sont inclus par défaut. Supprimez ceux qui ne sont pas nécessaires afin de limiter les outils auxquels Claude a accès pendant l'exécution. Vous pouvez également ajouter des connecteurs directement à partir de la boîte de dialogue de création ou de modification de la tâche.

Pour gérer ou ajouter des connecteurs en dehors de cette boîte de dialogue, rendez-vous sur claude.ai/customize/connectors ou utilisez /schedule update dans la CLI.

Quand une exécution publie un artefact sans demander

Lorsque la planification d'une tâche planifiée ou Run now démarre une exécution, Claude peut publier un nouvel artefact sans demander. Le nouvel artefact n'est visible que par vous jusqu'à ce que vous le partagiez. Si la publication déclare des capacités d'exécution pour la page, telles que des appels de connecteurs ou des téléchargements de fichiers, Claude demande d'abord.

Dans ces exécutions, Claude republie un artefact existant sans demander uniquement lorsque toutes ces conditions sont remplies :

  • Vous pouvez modifier l'artefact et il appartient à votre propre organisation
  • Si la publication contient plus que la page, comme des fichiers annexes, vous êtes le propriétaire de l'artefact
  • L'artefact n'est pas partagé publiquement
  • Si l'artefact est partagé avec des personnes spécifiques ou avec votre organisation, ses lecteurs ne voient pas automatiquement chaque nouvelle version
  • La publication n'écrase pas de force une version plus récente
  • La publication ne déclare pas de capacités d'exécution pour la page
  • La page existante ne détient aucune autorisation qui s'étend au-delà de la page, comme des appels de connecteurs

Dans tous les autres cas, y compris une exécution démarrée par un déclencheur API ou GitHub, Claude demande d'abord.

Lorsque le rôle d'une tâche planifiée est de maintenir une page à jour, fournissez-lui un artefact que vous avez déjà publié.

Environnements et accès réseau

Chaque tâche planifiée utilise un environnement cloud qui contrôle l'accès réseau, les variables d'environnement et les scripts de configuration. La tâche hérite de la politique réseau de l'environnement à chaque exécution.

L'environnement Default utilise l'accès réseau Trusted, qui n'autorise que la liste d'autorisation par défaut à travers le réseau de la session. Les requêtes sur ce chemin vers des hôtes en dehors de la liste d'autorisation échouent avec 403 et x-deny-reason: host_not_allowed. Le trafic des connecteurs MCP est acheminé via les serveurs d'Anthropic plutôt que par ce chemin, de sorte que les connecteurs que vous ajoutez à la tâche fonctionnent sans ajouter leurs hôtes aux Allowed domains. Supprimez les connecteurs dont vous n'avez pas besoin sous Connecteurs.

Pour autoriser des domaines supplémentaires sur l'un de vos propres environnements, suivez ces étapes. Un environnement partagé par l'organisation s'ouvre ici en lecture seule ; c'est donc un propriétaire qui modifie son accès réseau depuis la page Cloud environments des paramètres d'administration.

1. Ouvrir la tâche pour la modifier

Rendez-vous sur claude.ai/code/routines, cliquez sur la tâche planifiée, puis ouvrez le menu à côté de son nom et sélectionnez Edit. La boîte de dialogue Edit scheduled task s'ouvre.

2. Ouvrir le sélecteur d'environnement

Accédez à Advanced settings > General > Cloud environment, en développant d'abord Advanced settings s'il est replié. Cliquez sur l'icône cloud affichant le nom de votre environnement, par exemple Default.

3. Ouvrir les paramètres de l'environnement

Survolez l'environnement dans la liste et cliquez sur l'icône de paramètres qui apparaît à droite.

4. Modifier le niveau d'accès réseau

Dans la boîte de dialogue Edit cloud environment, passez Network access sur Custom et saisissez vos domaines dans Allowed domains. Cochez Also include default list of common package managers pour conserver la liste d'autorisation par défaut en plus de vos domaines personnalisés. Sélectionnez plutôt Full pour un accès sans restriction.

5. Enregistrer

Cliquez sur Save changes dans la boîte de dialogue Edit cloud environment, puis fermez la boîte de dialogue Edit scheduled task située derrière. La nouvelle politique s'applique à partir de la prochaine exécution.

Consultez Accès réseau pour plus de détails sur les niveaux d'accès et la liste d'autorisation par défaut.

Utilisation et limites

Les tâches planifiées consomment l'utilisation de l'abonnement de la même manière que les sessions interactives. Consultez votre consommation actuelle sur claude.ai/settings/usage.

Indépendamment de l'utilisation de l'abonnement, chaque façon de démarrer une exécution est soumise à une limite horaire :

Action Limite Comptée pour Au-delà de la limite
Exécutions planifiées, y compris les exécutions ponctuelles 100 par heure Votre compte L'exécution attend la réinitialisation de la limite
Run now, déclenchements API et reprogrammation d'une tâche ponctuelle 30 par heure Chaque tâche planifiée, un décompte partagé par les trois L'action échoue jusqu'à la réinitialisation de la limite
Run now et reprogrammation d'une tâche ponctuelle 100 par heure Votre compte Identique
Déclenchements API 100 par heure Votre compte, comptés séparément de Run now Identique
Événements GitHub Voir Ajouter un déclencheur GitHub

Aucune de ces limites horaires ne permet de dépassement.

Lorsqu'une tâche planifiée atteint votre limite d'utilisation d'abonnement, les organisations ayant activé les crédits d'utilisation peuvent continuer à exécuter des tâches planifiées en dépassement facturé à l'usage. Sans crédits d'utilisation, les exécutions supplémentaires sont rejetées jusqu'à la réinitialisation de votre fenêtre d'utilisation. Activez les crédits d'utilisation sur claude.ai/settings/usage. Sur les plans Team et Enterprise, un administrateur les active pour l'organisation sur claude.ai/admin-settings/usage.

Tant que votre abonnement est suspendu, vos tâches planifiées sont mises en attente et ne s'exécutent pas. Une fois votre abonnement de nouveau actif, réactivez-les.

Où le nom routines apparaît encore

Les tâches planifiées s'appelaient auparavant routines, et les emplacements suivants conservent l'ancien nom. Chacun désigne la même fonctionnalité :

  • Adresse web : claude.ai/code/routines
  • CLI : l'alias /routines de /schedule, la description de la commande et les réponses de Claude pendant qu'il configure une tâche
  • API : le chemin de l'endpoint /fire, son en-tête bêta, le type de sa réponse, la balise <routine-fire-payload> et la page de référence Trigger a routine through the API
  • Paramètres de l'organisation : le bouton bascule Scheduled tasks (Was Routines)

Dépannage

/schedule renvoie « Unknown command »

La CLI masque /schedule lorsque l'une de ses conditions requises n'est pas remplie : le menu des commandes affiche No commands match "/schedule" pendant que vous tapez. Sa soumission renvoie Unknown command: /schedule, sauf dans les cas ci-dessous qui indiquent une réponse différente.

La cause est généralement l'une des suivantes :

  • Vous êtes authentifié avec une clé API Console, un profil Anthropic ou des identifiants de fédération, ou un fournisseur cloud tel qu'Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry. /schedule nécessite une connexion par abonnement claude.ai. Avec une clé API Console ou un profil, et la récupération des feature flags activée, soumettre /schedule affiche plutôt /schedule is available with Claude for Enterprise — ask your admin about migrating from API-key access. Avec une connexion par fournisseur cloud, vous voyez toujours Unknown command: /schedule. Si ANTHROPIC_API_KEY ou ANTHROPIC_AUTH_TOKEN est défini dans votre shell, ou si apiKeyHelper est défini dans settings.json, supprimez-le d'abord, car ceux-ci ont priorité sur une connexion claude.ai. Un profil ou des identifiants de fédération ont également priorité, désactivez-les donc aussi
  • Vous êtes complètement déconnecté, sans clé API ni autres identifiants. Avec la récupération des feature flags activée, soumettre /schedule affiche /schedule requires a claude.ai subscription. Run /login to sign in with your claude.ai account. Avant la v2.1.268, une session déconnectée affichait le même message Claude for Enterprise qu'une clé API Console
  • Vous êtes dans une session cloud, où soumettre /schedule répond que la commande n'est pas disponible dans cet environnement. Gérez plutôt les tâches planifiées à partir de l'interface web
  • La politique de votre organisation désactive les sessions cloud, dont les tâches planifiées ont besoin. Dans ce cas, soumettre /schedule répond plutôt Cloud sessions are disabled by your organization's policy. Avant la v2.1.268, cela renvoyait Unknown command: /schedule
  • Un propriétaire a désactivé les tâches planifiées pour votre organisation Team ou Enterprise. Avant la v2.1.227, la commande apparaissait toujours dans ce cas, et claude.ai rejetait la tâche lorsque Claude tentait de la créer ou de l'exécuter

À moins que la politique de votre organisation ne désactive les tâches planifiées ou les sessions cloud, vous pouvez créer et gérer des tâches planifiées sur claude.ai/code/routines, quelle que soit la configuration de la CLI.

"Routines are disabled by your organization's policy"

Un propriétaire de votre organisation Team ou Enterprise a probablement désactivé le bouton bascule Scheduled tasks (Was Routines) dans Organization settings > Capabilities > Remote sessions. Sur Claude Code v2.1.227 ou version ultérieure, ce même bouton bascule masque également /schedule dans la CLI. Il s'agit d'un paramètre d'organisation côté serveur, il ne peut donc pas être remplacé par votre configuration locale. Demandez à un propriétaire de réactiver les tâches planifiées pour votre organisation.

Ressources connexes

  • /loop et planification en session : planifiez des tâches locales dans une session CLI ouverte
  • Tâches planifiées Desktop : tâches planifiées locales qui s'exécutent sur votre machine avec accès aux fichiers locaux
  • Environnements cloud : configurez l'accès réseau, les variables d'environnement et les scripts de configuration pour les sessions cloud
  • Projets : travail au long cours que Claude coordonne sur plusieurs sessions cloud parallèles ; les tâches planifiées créées à partir d'un projet apparaissent dans son onglet Scheduled tasks
  • Connecteurs MCP : connectez des services externes comme Slack, Linear et Google Drive
  • GitHub Actions : exécutez Claude dans votre pipeline CI sur les événements du dépôt