Documentation Index
Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
Use this file to discover all available pages before exploring further.
- Planifiée : 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 à un point de terminaison par routine avec un jeton porteur
- GitHub : s’exécute automatiquement en réponse aux événements du référentiel tels que les demandes de tirage ou les versions
/schedule.
Les administrateurs Team et Enterprise peuvent désactiver les routines pour tous les membres avec le bouton bascule Routines sur claude.ai/admin-settings/claude-code. Lorsqu’elles sont désactivées, les routines existantes cessent de s’exécuter et les membres ne peuvent pas en créer de nouvelles.
Cette page couvre la création d’une routine, la configuration de chaque type de déclencheur, la gestion des exécutions et la façon dont les limites d’utilisation s’appliquent.
Exemples de cas d’usage
Chaque exemple associe un type de déclencheur au type de travail pour lequel les routines sont adaptées : sans surveillance, répétable et lié à un résultat clair. Maintenance du carnet de commandes. Un déclencheur de calendrier s’exécute chaque soir en semaine sur votre suivi des problèmes via un connecteur. La routine lit les problèmes ouverts depuis la dernière exécution, applique des étiquettes, assigne les propriétaires en fonction de la zone de code référencée, et publie un résumé sur Slack afin que l’équipe commence la journée avec une file d’attente organisée. Triage des alertes. Votre outil de surveillance appelle le point de terminaison API de la routine lorsqu’un seuil d’erreur est dépassé, en transmettant le corps de l’alerte en tant quetext. La routine extrait la trace de pile, la met en corrélation avec les commits récents du référentiel, et ouvre une demande de tirage brouillon avec un correctif proposé et un lien vers l’alerte. L’équipe d’astreinte examine la PR au lieu de commencer à partir d’un terminal vierge.
Examen du code sur mesure. Un déclencheur GitHub s’exécute sur pull_request.opened. La routine applique la liste de contrôle d’examen de votre équipe, laisse des commentaires en ligne pour les problèmes de sécurité, de performance et de style, et ajoute un commentaire récapitulatif afin que les examinateurs 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 le point de terminaison API de la routine après chaque déploiement en production. La routine exécute des vérifications de fumée sur la nouvelle version, analyse les journaux d’erreurs pour détecter les régressions, et publie un feu vert ou un feu rouge sur le canal de version avant la fermeture de la fenêtre de déploiement.
Dérive de la documentation. Un déclencheur de calendrier s’exécute chaque semaine. La routine analyse les PR fusionnées depuis la dernière exécution, signale la documentation qui référence les API modifiées, et ouvre des PR de mise à jour par rapport au référentiel de documentation pour qu’un éditeur les examine.
Portage de bibliothèque. Un déclencheur GitHub s’exécute sur pull_request.closed filtré pour les PR fusionnées dans un référentiel SDK. La routine porte la modification vers un SDK parallèle dans une autre langue et ouvre une PR correspondante, en gardant les deux bibliothèques synchronisées sans qu’un humain ne réimplémente chaque modification.
Les sections ci-dessous expliquent comment créer une routine et configurer chacun de ces types de déclencheurs.
Créer une routine
Créez une routine à partir du web sur claude.ai/code/routines, à partir de l’application de bureau, ou à partir de la CLI. Les trois surfaces écrivent dans le même compte cloud, de sorte qu’une routine que vous créez dans l’une d’elles apparaît immédiatement dans les autres. Dans l’application de bureau, cliquez sur Routines dans la barre latérale, puis sur New routine, et choisissez Remote ; choisir Local à la place crée une tâche planifiée de bureau, qui s’exécute sur votre machine plutôt que dans le cloud. Le formulaire de création configure l’invite de la routine, les référentiels, l’environnement, les connecteurs et les déclencheurs. Les routines s’exécutent de manière autonome en tant que sessions cloud Claude Code complètes : il n’y a pas de sélecteur de mode de permission et pas d’invites d’approbation pendant une exécution. La session peut exécuter des commandes shell, utiliser des skills validées dans le référentiel cloné, et appeler tous les connecteurs que vous incluez. Ce qu’une routine peut atteindre est déterminé par les référentiels que vous sélectionnez et leur paramètre de branche-push, l’accès réseau et les variables de l’environnement, et les connecteurs que vous incluez. Limitez chacun de ces éléments à ce dont la routine a réellement besoin. Les routines appartiennent à votre compte claude.ai individuel. Elles ne sont pas partagées avec les coéquipiers, et elles comptent dans votre allocation quotidienne d’exécutions. Tout ce qu’une routine fait via votre identité GitHub connectée ou les connecteurs apparaît comme vous : les commits et les demandes de tirage portent votre utilisateur GitHub, et les messages Slack, les tickets Linear ou d’autres actions de connecteur utilisent vos comptes liés pour ces services.Créer à partir du web
Ouvrir le formulaire de création
Nommer la routine et écrire l'invite
Sélectionner les référentiels
claude/ pour ses modifications.Sélectionner un environnement
- Network access : définissez le niveau d’accès à Internet disponible pendant chaque exécution
- Environment variables : fournissez des clés API, des jetons ou d’autres secrets que Claude peut utiliser
- Setup script : installez les dépendances et les outils dont la routine a besoin. Le résultat est mis en cache, de sorte que le script ne se réexécute pas à chaque session
Sélectionner un déclencheur
- Schedule
- GitHub event
- API
Examiner les connecteurs et les permissions
claude/.Créer la routine
Créer à partir de la CLI
Exécutez/schedule dans n’importe quelle session pour créer une routine planifiée de manière conversationnelle. Vous pouvez également transmettre une description directement, pour une routine récurrente comme /schedule daily PR review at 9am ou une exécution unique comme /schedule clean up feature flag in one week. Claude parcourt les mêmes informations que le formulaire web collecte, puis enregistre la routine sur votre compte.
/schedule dans la CLI crée uniquement des routines planifiées. Pour ajouter un déclencheur API ou GitHub, modifiez la routine sur le web sur claude.ai/code/routines.
La CLI prend également en charge la gestion des routines existantes. Exécutez /schedule list pour voir toutes les routines, /schedule update pour en modifier une, ou /schedule run pour la déclencher immédiatement.
Configurer les déclencheurs
Une routine démarre lorsque l’un de ses déclencheurs correspond. Vous pouvez attacher n’importe quelle combinaison de déclencheurs de calendrier, API et GitHub à la même routine, et les ajouter ou les supprimer à tout moment à partir de la section Select a trigger du formulaire d’édition de la routine.Ajouter un déclencheur de calendrier
Un déclencheur de calendrier exécute la routine selon une cadence récurrente, ou une seule fois à un moment futur spécifique. Choisissez une fréquence prédéfinie dans la section Select a trigger : toutes les heures, quotidienne, les jours de semaine ou hebdomadaire. Les heures sont entrées dans votre fuseau horaire local et converties automatiquement, de sorte que la routine s’exécute à cette heure murale indépendamment de l’endroit où se trouve l’infrastructure cloud. Les exécutions peuvent démarrer quelques minutes après l’heure planifiée en raison de l’échelonnement. Le décalage est cohérent pour chaque routine. Pour un intervalle personnalisé tel que toutes les deux heures ou le premier de chaque mois, choisissez la prédéfinie la plus proche dans le formulaire, 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 unique
Une exécution unique planifiée déclenche la routine une seule fois à un horodatage spécifique. Utilisez-la pour vous rappeler plus tard dans la semaine, pour ouvrir une PR de nettoyage après la fin d’un déploiement, ou pour lancer une tâche de suivi lorsqu’une modification en amont arrive. Après le déclenchement de la routine, elle se désactive automatiquement et l’interface utilisateur web la marque comme Ran. Pour l’exécuter à nouveau, modifiez la routine et définissez une nouvelle heure unique. Créez une exécution unique à partir de la CLI en décrivant l’heure en langage naturel. Claude résout la phrase par rapport à l’heure actuelle et confirme l’horodatage absolu avant d’enregistrer.Ajouter un déclencheur API
Un déclencheur API donne à une routine un point de terminaison HTTP dédié. POSTer sur le point de terminaison avec le jeton porteur de la routine démarre une nouvelle session et retourne une URL de session. Utilisez ceci pour intégrer Claude Code dans les systèmes d’alerte, les pipelines de déploiement, les outils internes ou n’importe où vous pouvez faire une requête HTTP authentifiée. Les déclencheurs API sont ajoutés à une routine existante à partir du web. La CLI ne peut actuellement pas créer ou révoquer des jetons.Ouvrir la routine pour l'édition
Ajouter un déclencheur API
Copier l'URL et générer un jeton
Appeler le point de terminaison
Authorization: Bearer lorsque vous POSTez sur l’URL. La section Trigger a routine ci-dessous montre un exemple complet.Déclencher une routine
Envoyez une requête POST au point de terminaison/fire avec le jeton porteur dans l’en-tête Authorization. Le corps de la requête accepte un champ text optionnel pour le contexte spécifique à l’exécution tel qu’un corps d’alerte ou un journal défaillant, transmis à la routine aux côtés de son invite enregistrée. La valeur est du texte libre et n’est pas analysée : si vous envoyez JSON ou une autre charge utile structurée, la routine la reçoit comme une chaîne littérale.
L’exemple ci-dessous déclenche une routine à partir d’un shell :
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 via API dans la documentation de la plateforme Claude. Le point de terminaison/fire est disponible pour les utilisateurs de claude.ai uniquement et ne fait pas partie de la surface de l’API Claude Platform.
Ajouter un déclencheur GitHub
Un déclencheur GitHub démarre une nouvelle session automatiquement lorsqu’un événement correspondant se produit sur un référentiel connecté. Chaque événement correspondant démarre sa propre session.Ouvrir la routine pour l'édition
Ajouter un déclencheur d'événement GitHub
Installer l'application Claude GitHub
/web-setup dans la CLI accorde l’accès au référentiel pour le clonage, mais elle n’installe pas l’application Claude GitHub et n’active pas la livraison des webhooks. Les déclencheurs GitHub nécessitent l’installation de l’application Claude GitHub, que la configuration du déclencheur vous invite à faire.Configurer le déclencheur
Événements pris en charge
Les déclencheurs GitHub peuvent s’abonner à l’une des catégories d’événements suivantes. Dans chaque catégorie, vous pouvez choisir une action spécifique, commepull_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 autrement mise à jour |
| Release | Une version est créée, publiée, modifiée ou supprimée |
Filtrer les demandes de tirage
Utilisez les filtres pour affiner les demandes de tirage qui démarrent une nouvelle session. Toutes les conditions de filtre doivent correspondre pour que la routine 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 |
matches regex teste la valeur de champ entière, pas une sous-chaîne à l’intérieur. Pour correspondre à n’importe quel titre contenant hotfix, écrivez .*hotfix.*. Sans le .* environnant, le filtre correspond uniquement à un titre qui est exactement hotfix sans rien avant ou après. Pour la correspondance de sous-chaîne littérale sans syntaxe regex, utilisez l’opérateur contains à la place.
Quelques exemples de combinaisons de filtres :
- Examen du module d’authentification : branche de base
main, branche de tête contientauth-provider. Envoie toute PR qui touche l’authentification à un examinateur ciblé. - Prêt pour l’examen uniquement : est brouillon est
false. Ignore les brouillons afin que la routine s’exécute uniquement lorsque la PR est prête pour l’examen. - Portage contrôlé par étiquette : les étiquettes incluent
needs-backport. Déclenche une routine de portage vers une autre branche uniquement lorsqu’un responsable marque la PR.
Comment les sessions correspondent aux événements
Chaque événement GitHub correspondant démarre une nouvelle session. La réutilisation de session entre les événements n’est pas disponible pour les routines déclenchées par GitHub, de sorte que deux mises à jour de PR produisent deux sessions indépendantes.Gérer les routines
Cliquez sur une routine dans la liste pour ouvrir sa page de détail. La page de détail affiche les référentiels de la routine, les connecteurs, l’invite, le calendrier, les jetons API, les déclencheurs GitHub et une liste des exécutions passées.Afficher et interagir avec les exécutions
Cliquez sur n’importe quelle exécution pour l’ouvrir en tant que session complète. À partir de là, vous pouvez voir ce que Claude a fait, examiner les modifications, créer une demande de tirage ou continuer 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.Éditer et contrôler les routines
À partir de la page de détail de la routine, vous pouvez :- Cliquer sur Run now pour démarrer une exécution immédiatement sans attendre l’heure planifiée suivante.
- Utiliser le bouton bascule dans la section Repeats pour mettre en pause ou reprendre le calendrier. Les routines en pause conservent leur configuration mais ne s’exécutent pas jusqu’à ce que vous les réactiviez.
- Cliquer sur l’icône de crayon pour ouvrir Edit routine et modifier le nom, l’invite, les référentiels, l’environnement, les connecteurs ou l’un des déclencheurs de la routine. La section Select a trigger est l’endroit où vous ajoutez ou supprimez les calendriers, les jetons API et les déclencheurs d’événements GitHub.
- Cliquer sur l’icône de suppression pour supprimer la routine. Les sessions passées créées par la routine restent dans votre liste de sessions.
Référentiels et permissions de branche
Les routines ont besoin d’un accès GitHub pour cloner les référentiels. Lorsque vous créez une routine à partir de la CLI avec/schedule, Claude vérifie si votre compte a GitHub connecté et vous invite à exécuter /web-setup si ce n’est pas le cas. Consultez GitHub authentication options pour les deux façons d’accorder l’accès.
Chaque référentiel que vous ajoutez est cloné à chaque exécution. Claude commence à partir de la branche par défaut du référentiel sauf si votre invite spécifie le contraire.
Par défaut, Claude ne peut pousser que vers les branches préfixées par claude/. Cela empêche les routines de modifier accidentellement les branches protégées ou longue durée. Pour supprimer cette restriction pour un référentiel spécifique, activez Allow unrestricted branch pushes pour ce référentiel lors de la création ou de l’édition de la routine.
Connecteurs
Les routines peuvent utiliser vos connecteurs MCP connectés pour lire et écrire dans les services externes pendant chaque exécution. Par exemple, une routine qui trie les demandes d’assistance peut lire à partir d’un canal Slack et créer des problèmes dans Linear. Les connecteurs sont les intégrations claude.ai sur votre compte. Les serveurs MCP que vous avez ajoutés localement dans la CLI avecclaude mcp add sont stockés sur votre machine plutôt que sur votre compte claude.ai, donc ils n’apparaissent pas dans la liste des connecteurs. Pour utiliser l’un de ces serveurs dans une routine, ajoutez-le en tant que connecteur sur claude.ai/customize/connectors, ou déclarez-le dans un .mcp.json engagé afin qu’il fasse partie du référentiel cloné.
Lorsque vous créez une routine, tous vos connecteurs actuellement connectés sont inclus par défaut. Supprimez tous ceux qui ne sont pas nécessaires pour limiter les outils auxquels Claude a accès pendant l’exécution. Vous pouvez également ajouter des connecteurs directement à partir du formulaire de routine.
Pour gérer ou ajouter des connecteurs en dehors du formulaire de routine, visitez Settings > Connectors sur claude.ai ou utilisez /schedule update dans la CLI.
Environnements et accès réseau
Chaque routine s’exécute dans un environnement cloud qui contrôle l’accès réseau, les variables d’environnement et les scripts de configuration. La routine hérite de la politique réseau de l’environnement à chaque exécution. L’environnement Default utilise l’accès réseau Trusted : la liste d’autorisation par défaut des registres de paquets, des API des fournisseurs de cloud, des registres de conteneurs et des domaines de développement courants est accessible, mais les domaines arbitraires ne le sont pas. Les demandes sortantes vers d’autres hôtes échouent avec403 et x-deny-reason: host_not_allowed. Le trafic des connecteurs MCP est acheminé via les serveurs d’Anthropic, donc les connecteurs que vous ajoutez à la routine fonctionnent sans ajouter leurs hôtes aux Allowed domains. Supprimez tous les connecteurs dont vous n’avez pas besoin sous Connecteurs.
Pour autoriser des domaines supplémentaires :
Ouvrir la routine pour l'édition
Ouvrir le sélecteur d'environnement
Ouvrir les paramètres d'environnement
Modifier le niveau d'accès réseau
Utilisation et limites
Les routines réduisent l’utilisation de l’abonnement de la même manière que les sessions interactives. En plus des limites d’abonnement standard, les routines ont un plafond quotidien sur le nombre d’exécutions qui peuvent démarrer par compte. Consultez votre consommation actuelle et vos exécutions de routine quotidiennes restantes sur claude.ai/code/routines ou claude.ai/settings/usage. Lorsqu’une routine atteint le plafond quotidien ou votre limite d’utilisation d’abonnement, les organisations avec crédits d’utilisation activés peuvent continuer à exécuter les routines sur dépassement mesuré. Sans crédits d’utilisation, les exécutions supplémentaires sont rejetées jusqu’à la réinitialisation de la fenêtre. Activez les crédits d’utilisation à partir de Settings > Billing sur claude.ai. Les exécutions ponctuelles ne comptent pas par rapport au plafond quotidien des routines. Elles réduisent votre utilisation d’abonnement régulière comme toute autre session, mais elles sont exemptes de l’allocation quotidienne d’exécutions de routine par compte.Dépannage
« Les routines sont désactivées par la politique de votre organisation »
Votre administrateur Team ou Enterprise a probablement désactivé le bouton bascule Routines sur claude.ai/admin-settings/claude-code. Il s’agit d’un paramètre d’organisation côté serveur, il ne peut donc pas être remplacé par votre configuration locale. Contactez votre administrateur pour demander que les routines soient activées pour votre organisation.Ressources connexes
/loopet planification en session : planifiez les tâches locales dans une session CLI ouverte- Desktop scheduled tasks : tâches planifiées locales qui s’exécutent sur votre machine avec accès aux fichiers locaux
- Cloud environment : configurez l’environnement d’exécution pour les sessions cloud
- MCP connectors : connectez les services externes comme Slack, Linear et Google Drive
- GitHub Actions : exécutez Claude dans votre pipeline CI sur les événements du référentiel