Les tâches planifiées démarrent une nouvelle session automatiquement à une heure et une fréquence que vous choisissez. Utilisez-les pour les travaux récurrents comme les révisions de code quotidiennes, les vérifications de mises à jour de dépendances ou les briefings matinaux qui extraient des données de votre calendrier et de votre boîte de réception. La page Routines de l’application Desktop vous permet de créer à la fois des tâches planifiées locales et des routines distantes. Une tâche locale s’exécute sur votre machine avec un accès direct à vos fichiers et outils, mais ne s’active que lorsque l’application est ouverte et que votre ordinateur est actif. Une routine distante s’exécute sur l’infrastructure cloud gérée par Anthropic même lorsque votre ordinateur est éteint, et peut également s’activer lors d’appels API ou d’événements GitHub. Cette page couvre les tâches planifiées locales ; pour les routines distantes et leurs options de déclenchement, consultez Routines.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.
Comparer les options de planification
Claude Code offers three ways to schedule recurring or one-off work:| Cloud | Desktop | /loop | |
|---|---|---|---|
| Runs on | Anthropic cloud | Your machine | Your machine |
| Requires machine on | No | Yes | Yes |
| Requires open session | No | No | Yes |
| Persistent across restarts | Yes | Yes | Restored on --resume if unexpired |
| Access to local files | No (fresh clone) | Yes | Yes |
| MCP servers | Connectors configured per task | Config files and connectors | Inherits from session |
| Permission prompts | No (runs autonomously) | Configurable per task | Inherits from session |
| Customizable schedule | Via /schedule in the CLI | Yes | Yes |
| Minimum interval | 1 hour | 1 minute | 1 minute |
Par défaut, les tâches planifiées s’exécutent sur l’état actuel de votre répertoire de travail, y compris les modifications non validées. Activez le bouton bascule worktree lors de la création de la tâche pour donner à chaque exécution son propre worktree Git isolé, de la même manière que les sessions parallèles fonctionnent.
Créer une tâche planifiée
Cliquez sur Routines dans la barre latérale, puis cliquez sur New routine et choisissez Local. Configurez ces champs :| Champ | Description |
|---|---|
| Name | Identifiant de la tâche. Converti en minuscules kebab-case et utilisé comme nom de dossier sur le disque. Doit être unique parmi vos tâches. |
| Description | Résumé court affiché dans la liste des tâches. |
| Instructions | Ce que Claude doit faire lorsque la tâche s’exécute. Écrivez ceci de la même manière que vous écriviriez n’importe quel message dans la boîte de prompt. L’entrée des instructions inclut des sélecteurs pour le mode de permission et le modèle, et en dessous vous sélectionnez le dossier de travail et si vous souhaitez exécuter dans un worktree isolé. |
| Schedule | Fréquence d’exécution de la tâche. Voir options de planification ci-dessous. |
Options de planification
Choisissez un préréglage dans le contrôle Schedule :- Manual : pas de planification, s’exécute uniquement lorsque vous cliquez sur Run now. Utile pour enregistrer un prompt que vous déclenchez à la demande
- Hourly : s’exécute toutes les heures
- Daily : affiche un sélecteur d’heure, par défaut 9h00 heure locale
- Weekdays : identique à Daily mais ignore samedi et dimanche
- Weekly : affiche un sélecteur d’heure et un sélecteur de jour
Comment les tâches planifiées s’exécutent
Les tâches planifiées s’exécutent sur votre machine. Desktop vérifie la planification chaque minute lorsque l’application est ouverte et démarre une nouvelle session lorsqu’une tâche est due, indépendamment de toute session manuelle que vous avez ouverte. Chaque tâche reçoit un petit délai de quelques minutes après l’heure planifiée pour échelonner le trafic API. Le délai est déterministe : la même tâche démarre toujours au même décalage. Lorsqu’une tâche s’active, vous recevez une notification de bureau et une nouvelle session apparaît sous une section Scheduled dans la barre latérale. Ouvrez-la pour voir ce que Claude a fait, examiner les modifications ou répondre aux invites de permission. La session fonctionne comme n’importe quelle autre : Claude peut modifier des fichiers, exécuter des commandes, créer des commits et ouvrir des pull requests. Les tâches ne s’exécutent que lorsque l’application de bureau est en cours d’exécution et que votre ordinateur est actif. Si votre ordinateur se met en veille à une heure planifiée, l’exécution est ignorée. Pour empêcher la mise en veille inactive, activez Keep computer awake dans Paramètres sous Desktop app → General. Fermer le couvercle de l’ordinateur portable le met toujours en veille. Pour les tâches qui doivent s’exécuter même lorsque votre ordinateur est éteint, ou qui doivent être déclenchées par un appel API ou un événement GitHub, créez plutôt une routine distante.Exécutions manquées
Lorsque l’application démarre ou que votre ordinateur se réveille, Desktop vérifie si chaque tâche a manqué des exécutions au cours des sept derniers jours. Si c’est le cas, Desktop démarre exactement une exécution de rattrapage pour l’heure la plus récemment manquée et rejette tout ce qui est plus ancien. Une tâche quotidienne qui a manqué six jours s’exécute une fois au réveil. Desktop affiche une notification lorsqu’une exécution de rattrapage démarre. Gardez cela à l’esprit lors de la rédaction de prompts. Une tâche planifiée pour 9h peut s’exécuter à 23h si votre ordinateur était en veille toute la journée. Si le timing est important, ajoutez des garde-fous au prompt lui-même, par exemple : « Examinez uniquement les commits d’aujourd’hui. S’il est après 17h, ignorez la révision et publiez simplement un résumé de ce qui a été manqué. »Permissions pour les tâches planifiées
Chaque tâche a son propre mode de permission, que vous définissez lors de la création ou de la modification de la tâche. Les règles d’autorisation de~/.claude/settings.json s’appliquent également aux sessions de tâches planifiées. Si une tâche s’exécute en mode Ask et doit exécuter un outil pour lequel elle n’a pas de permission, l’exécution s’arrête jusqu’à ce que vous l’approuviez. La session reste ouverte dans la barre latérale pour que vous puissiez répondre plus tard.
Pour éviter les arrêts, cliquez sur Run now après avoir créé une tâche, surveillez les invites de permission et sélectionnez « always allow » pour chacune. Les exécutions futures de cette tâche approuvent automatiquement les mêmes outils sans demander. Vous pouvez examiner et révoquer ces approbations à partir de la page de détail de la tâche.
Gérer les tâches planifiées
Cliquez sur une tâche dans la liste Routines pour ouvrir sa page de détail. À partir de là, vous pouvez :- Run now : démarrer la tâche immédiatement sans attendre l’heure planifiée suivante
- Status : basculer entre Active et Paused pour mettre en pause ou reprendre les exécutions planifiées sans supprimer la tâche
- Edit : modifier les instructions, la planification, le dossier ou d’autres paramètres
- Review history : voir chaque exécution passée, y compris les exécutions ignorées. Survolez une entrée ignorée pour voir pourquoi : votre ordinateur était en veille, l’exécution précédente était toujours en cours ou d’autres tâches planifiées s’exécutaient déjà. Cliquez sur Show more pour charger les entrées plus anciennes.
- Review allowed permissions : voir et révoquer les approbations d’outils enregistrées pour cette tâche à partir du panneau Always allowed
- Delete : supprimer la tâche et archiver toutes les sessions qu’elle a créées. Une case à cocher Also delete files on disk apparaît dans la boîte de dialogue de confirmation ; cochez-la pour supprimer également le fichier
SKILL.mdde la tâche et les données associées de~/.claude/scheduled-tasks/.
update_scheduled_task. Cela permet à une tâche de se replanifier en fonction de ce qu’elle trouve, par exemple, replanifier une révision de code pour s’exécuter plus tôt lorsqu’elle détecte qu’une branche de version a été créée.
Pour modifier le prompt d’une tâche sur le disque, ouvrez ~/.claude/scheduled-tasks/<task-name>/SKILL.md (ou sous CLAUDE_CONFIG_DIR si défini). Le fichier utilise le frontmatter YAML pour name et description, avec le prompt comme corps. Les modifications prennent effet à la prochaine exécution. La planification, le dossier, le modèle et l’état activé ne sont pas dans ce fichier : modifiez-les via le formulaire Edit ou demandez à Claude.
Ressources connexes
- Routines : exécuter des tâches sur l’infrastructure gérée par Anthropic selon un calendrier, via un appel API ou en réponse à des événements GitHub, même lorsque votre ordinateur est éteint
- Run prompts on a schedule : planification au niveau de la session avec
/loopdans la CLI - Claude Code GitHub Actions : exécuter Claude selon un calendrier dans CI au lieu de sur votre machine
- Use Claude Code Desktop : le guide complet de l’application Desktop