Passer au contenu principal
Les routines sont en aperçu de recherche. Le comportement, les limites et la surface de l’API peuvent changer.
Une routine est une configuration Claude Code enregistrée : une invite, un ou plusieurs référentiels, et un ensemble de connecteurs, empaquetés une fois et exécutés automatiquement. Les routines s’exécutent sur l’infrastructure cloud gérée par Anthropic, de sorte qu’elles continuent de fonctionner lorsque votre ordinateur portable est fermé. Chaque routine peut avoir un ou plusieurs déclencheurs attachés :
  • Planifiée : s’exécute selon une cadence récurrente comme toutes les heures, chaque nuit ou chaque semaine
  • 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
Une seule routine peut combiner des déclencheurs. Par exemple, une routine d’examen des PR peut s’exécuter chaque nuit, se déclencher à partir d’un script de déploiement, et réagir également à chaque nouvelle PR. Les routines sont disponibles sur les plans Pro, Max, Team et Enterprise avec Claude Code sur le web activé. Créez et gérez-les sur claude.ai/code/routines, ou à partir de la CLI avec /schedule. 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 que text. 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, de l’application de bureau ou de la CLI. Les trois surfaces écrivent dans le même compte cloud, de sorte qu’une routine que vous créez dans la CLI apparaît immédiatement sur claude.ai/code/routines. Dans l’application de bureau, cliquez sur New task et choisissez New remote task ; choisir New local task à la place crée une tâche planifiée locale de bureau, qui s’exécute sur votre machine et n’est pas une routine. 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

1

Ouvrir le formulaire de création

Visitez claude.ai/code/routines et cliquez sur New routine.
2

Nommer la routine et écrire l'invite

Donnez à la routine un nom descriptif et écrivez l’invite que Claude exécute à chaque fois. L’invite est la partie la plus importante : la routine s’exécute de manière autonome, donc l’invite doit être autonome et explicite sur ce qu’il faut faire et à quoi ressemble le succès.L’entrée d’invite inclut un sélecteur de modèle. Claude utilise le modèle sélectionné à chaque exécution.
3

Sélectionner les référentiels

Ajoutez un ou plusieurs référentiels GitHub pour que Claude y travaille. Chaque référentiel est cloné au début d’une exécution, en commençant par la branche par défaut. Claude crée des branches préfixées par claude/ pour ses modifications. Pour autoriser les poussées vers n’importe quelle branche, activez Allow unrestricted branch pushes pour ce référentiel.
4

Sélectionner un environnement

Choisissez un environnement cloud pour la routine. 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 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
Un environnement Default est fourni. Pour utiliser un environnement personnalisé, créez-en un avant de créer la routine.
5

Sélectionner un déclencheur

Sous Select a trigger, choisissez comment la routine démarre. Vous pouvez choisir un type de déclencheur ou en combiner plusieurs.
Choisissez une fréquence prédéfinie : toutes les heures, quotidienne, les jours de semaine ou hebdomadaire. Consultez Add a schedule trigger pour la gestion des fuseaux horaires, l’échelonnement et les intervalles cron personnalisés.
6

Examiner les connecteurs

Tous vos connecteurs MCP connectés sont inclus par défaut. Supprimez tous ceux dont la routine n’a pas besoin. Les connecteurs donnent à Claude accès aux services externes comme Slack, Linear ou Google Drive pendant chaque exécution.
7

Créer la routine

Cliquez sur Create. La routine apparaît dans la liste et 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 de la routine.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 demande de tirage.

​
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, comme dans /schedule daily PR review at 9am. 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.

​
Créer à partir de l’application de bureau

Ouvrez la page Schedule dans l’application de bureau, cliquez sur New task, et choisissez New remote task. L’application de bureau affiche à la fois les tâches planifiées locales et les routines dans la même grille. Consultez Desktop scheduled tasks pour plus de détails sur l’option locale.

​
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. 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.

​
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.
1

Ouvrir la routine pour l'édition

Allez sur claude.ai/code/routines, cliquez sur la routine que vous souhaitez déclencher via API, puis cliquez sur l’icône de crayon pour ouvrir Edit routine.
2

Ajouter un déclencheur API

Faites défiler jusqu’à la section Select a trigger sous l’invite, cliquez sur Add another trigger, et choisissez API.
3

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

La fenêtre modale affiche l’URL de cette routine ainsi qu’un exemple de commande curl. Copiez l’URL, puis cliquez sur Generate token et copiez le jeton immédiatement. Le jeton est affiché une seule fois et ne peut pas être récupéré ultérieurement, alors stockez-le quelque part de sécurisé comme le magasin de secrets de votre outil d’alerte.
4

Appeler le point de terminaison

Envoyez le jeton dans l’en-tête Authorization: Bearer lorsque vous POSTez sur l’URL. La section Trigger a routine ci-dessous montre un exemple complet.
Chaque routine a son propre jeton, limité au déclenchement de cette routine uniquement. Pour le faire tourner ou le révoquer, retournez à la même fenêtre modale et cliquez sur Regenerate ou Revoke.

​
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 : 
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 retourne un corps JSON avec le nouvel ID de session et l’URL : 
{
  "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 regarder l’exécution en temps réel, examiner les modifications ou continuer la conversation manuellement.
Le point de terminaison /fire est livré sous l’en-tête bêta experimental-cc-routine-2026-04-01. Les formes de requête et de réponse, les limites de débit et la sémantique des jetons peuvent changer pendant que la fonctionnalité est en aperçu de recherche. Les modifications de rupture sont livrées derrière les nouvelles versions d’en-tête bêta datées, et les deux versions d’en-tête précédentes les plus récentes 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 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.
Pendant l’aperçu de recherche, les événements webhook GitHub sont soumis à des limites horaires par routine et par compte. Les événements au-delà de la limite sont supprimés jusqu’à la réinitialisation de la fenêtre. Consultez vos limites actuelles sur claude.ai/code/routines.
Les déclencheurs GitHub sont configurés uniquement à partir de l’interface utilisateur web.
1

Ouvrir la routine pour l'édition

Allez sur claude.ai/code/routines, cliquez sur la routine, puis cliquez sur l’icône de crayon pour ouvrir Edit routine.
2

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

Faites défiler jusqu’à la section Select a trigger, cliquez sur Add another trigger, et choisissez GitHub event.
3

Installer l'application Claude GitHub

L’application Claude GitHub doit être installée sur le référentiel auquel vous souhaitez vous abonner. La configuration du déclencheur vous invite à l’installer si ce n’est pas déjà fait.
L’exécution de /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.
4

Configurer le déclencheur

Sélectionnez le référentiel, choisissez un événement dans la liste des événements pris en charge, et ajoutez éventuellement des filtres. Enregistrez 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, comme pull_request.opened, ou réagir à toutes les actions de la catégorie.
ÉvénementSe déclenche quand
Pull requestUne PR est ouverte, fermée, assignée, étiquetée, synchronisée ou autrement mise à jour
ReleaseUne 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 :
FiltreCorrespond à
AuthorNom d’utilisateur GitHub de l’auteur de la PR
TitleTexte du titre de la PR
BodyTexte de la description de la PR
Base branchBranche ciblée par la PR
Head branchBranche d’où provient la PR
LabelsÉtiquettes appliquées à la PR
Is draftSi la PR est à l’état brouillon
Is mergedSi la PR a été fusionnée
From forkSi la PR provient d’une fourche
Chaque filtre associe un champ à un opérateur : égal à, contient, commence par, est l’un de, n’est pas l’un de, ou correspond à regex. L’opérateur 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 contient auth-provider. Envoie toute PR qui touche l’authentification à un examinateur ciblé.
  • Triage des contributeurs externes : la fourche est true. Achemine chaque PR basée sur une fourche via un examen supplémentaire de sécurité et de style avant qu’un humain ne la regarde.
  • 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. 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

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. Configurez les environnements avant de créer une routine pour donner à Claude accès aux API, installer les dépendances ou restreindre la portée du réseau. Consultez cloud environment pour le guide de configuration complet.

​
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 utilisation supplémentaire activée peuvent continuer à exécuter les routines sur dépassement mesuré. Sans utilisation supplémentaire, les exécutions supplémentaires sont rejetées jusqu’à la réinitialisation de la fenêtre. Activez l’utilisation supplémentaire à partir de Settings > Billing sur claude.ai.

​
Ressources connexes