Planifier des tâches récurrentes dans Claude Code Desktop

Configurez des tâches planifiées dans Claude Code Desktop pour exécuter Claude automatiquement de manière récurrente pour les révisions de code quotidiennes, les audits de dépendances ou les briefings matinaux.

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 Tâches planifiées de l'application Desktop répertorie à la fois les tâches planifiées locales et les tâches planifiées cloud, anciennement appelées routines :

• 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
• Tâche cloud : s'exécute 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 tâches planifiées cloud et leurs options de déclenchement, consultez Automatiser le travail avec des tâches planifiées.

[!NOTE]

Si votre application affiche la fonctionnalité sous son ancien nom, cliquez sur Routines partout où cette page indique Planifiées et sur Nouvelle routine là où elle indique Nouvelle tâche.

Comparer les options de planification

Claude Code offre trois façons de planifier des tâches récurrentes ou ponctuelles :

[!TIP]

Utilisez les tâches cloud pour les travaux qui doivent s'exécuter de manière fiable sans votre machine. Utilisez les tâches Desktop lorsque vous avez besoin d'accès aux fichiers et outils locaux. Utilisez /loop pour un sondage rapide pendant une session.

[!NOTE]

Par défaut, les tâches planifiées locales s'exécutent sur l'état actuel de votre répertoire de travail, y compris les modifications non validées. Pour donner plutôt à chaque exécution son propre worktree Git isolé, sélectionnez Worktree dans le formulaire Edit de la tâche après l'avoir créée. La case à cocher est disponible lorsque le dossier de la tâche est un dépôt Git.

Créer une tâche planifiée

Les tâches planifiées locales nécessitent Claude Desktop 1.1.5368 ou une version ultérieure.

1. Ouvrir la page des tâches planifiées

Dans l'onglet Code, cliquez sur Scheduled dans la barre latérale ou dans le menu More de la barre latérale. Si la barre latérale affiche Routines au lieu de Scheduled, cliquez sur Routines, puis sur New routine, et poursuivez avec Formulaire pleine page.

2. Démarrer une nouvelle tâche

Cliquez sur New task pour ouvrir la boîte de dialogue New scheduled task. Vérifiez si l'un de ces écrans apparaît avant de continuer :

• Si un menu s'ouvre avec Create with Claude et Set up manually, sélectionnez Set up manually pour ouvrir la boîte de dialogue.
• Si Only on this computer se trouve en haut de la boîte de dialogue, consultez Boîte de dialogue avec Only on this computer en haut avant de saisir quoi que ce soit.
• Si un menu avec Local et Cloud s'ouvre, ou si une page complète s'ouvre à la place de la boîte de dialogue, consultez Formulaire pleine page.

3. Nommer la tâche

Saisissez un nom dans le champ Name. Desktop le convertit en minuscules kebab-case et l'utilise comme nom de dossier de la tâche sur le disque ; le nom doit donc être unique parmi vos tâches.

4. Rédiger les instructions

Dans la zone située sous le nom, saisissez ce que Claude doit faire lorsque la tâche s'exécute.

5. Activer Only on this computer

Ignorez la carte Trigger pour l'instant et développez Advanced settings en dessous. Dans l'onglet General, activez Only on this computer. Lorsque cette option est activée, la tâche s'exécute sur votre machine dans un dossier local.

Si l'interrupteur n'est pas disponible, retirez le dépôt ou le déclencheur d'événement GitHub ou d'API, car ceux-ci font de la tâche une tâche planifiée dans le cloud.

6. Choisir le dossier local

Dans la ligne Local folder, sélectionnez un dossier. Create reste indisponible tant que vous n'en avez pas choisi un.

7. Définir la planification

De retour dans la carte Trigger, sélectionnez un préréglage de planification.

8. Choisir le mode de permission et le modèle

Dans la barre d'outils de la zone d'instructions, sélectionnez un mode de permission et un modèle. Si vous ne les modifiez pas, les exécutions utilisent vos paramètres Claude Code et le modèle par défaut.

9. Créer la tâche

Cliquez sur Create. Si vous n'avez pas encore approuvé le dossier, Desktop vous demande de l'approuver à ce moment-là. La page de détails de la tâche s'ouvre.

Sur la page de détails, cliquez sur l'icône en forme de crayon pour ouvrir le formulaire Edit. Vous pouvez y modifier la Description que Desktop a remplie à partir de vos instructions, sélectionner Worktree ou passer la planification en Manual ou Custom.

Vous pouvez également créer une tâche en décrivant ce que vous souhaitez dans n'importe quelle session. Par exemple, « configurer une revue de code quotidienne qui s'exécute chaque matin à 9h » crée une tâche récurrente. Une demande comme « rappelle-moi à 15h demain de vérifier le déploiement » crée une tâche unique qui se désactive après son exécution.

Boîte de dialogue avec Only on this computer en haut

Si Only on this computer se trouve en haut de la boîte de dialogue New scheduled task à son ouverture, activez cette option avant de saisir quoi que ce soit. Lorsque vous l'activez, un formulaire vierge distinct pour une tâche locale remplace le formulaire.

Remplissez ensuite les champs du formulaire local :

• Name : saisissez un nom, comme dans les étapes de création d'une tâche planifiée.
• Description : saisissez une description. Create reste indisponible tant que vous ne l'avez pas fait.
• La zone d'instructions : saisissez ce que Claude doit faire lorsque la tâche s'exécute. Sélectionnez le mode de permission et le modèle dans les menus de la zone.
• Working folder : sélectionnez le dossier dans lequel la tâche s'exécute. Create reste indisponible tant que vous n'en avez pas sélectionné un.
• Trigger : sélectionnez une planification. Pour les préréglages, consultez Options de planification.

Cliquez sur Create. La page de détails de la tâche s'ouvre.

Formulaire pleine page

Si un menu avec Local et Cloud s'ouvre, sélectionnez Local. Une page intitulée New local routine ou New local scheduled task s'ouvre. Remplissez ses champs :

• Name : saisissez un nom unique parmi vos tâches.
• Description : saisissez-en une.
• Instructions : saisissez ce que Claude doit faire lorsque la tâche s'exécute. Dans la même zone, sélectionnez le mode de permission, le modèle et le dossier dans lequel la tâche s'exécute.
• Schedule : sélectionnez l'une des options de planification.

Si Create n'est pas disponible, survolez-le pour voir ce qu'il manque encore au formulaire. Cliquez sur Create : la page de détails de la tâche s'ouvre.

Options de planification

Lorsque vous activez Only on this computer sous Advanced settings, la carte Trigger propose Hourly, Daily, Weekdays et Weekly. Pour obtenir Manual ou Custom pour une telle tâche, ouvrez son formulaire Edit après l'avoir créée. Ce formulaire, la boîte de dialogue avec Only on this computer en haut et le formulaire pleine page proposent ces six options :

• Hourly : s'exécute toutes les heures
• Daily : s'exécute chaque jour à l'heure locale que vous choisissez
• Weekdays : identique à Daily mais ignore samedi et dimanche
• Weekly : affiche un sélecteur d'heure et un sélecteur de jour
• 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
• Custom : s'exécute selon une expression cron que vous saisissez et qui est évaluée dans votre heure locale, comme 0 9 * * * pour 9 h 00 chaque jour. Écrivez les jours de la semaine et les mois sous forme de nombres, car leurs noms ne sont pas acceptés. Dimanche correspond à 0, et non à 7. Le formulaire rejette toute expression qui s'exécute plus d'une fois par heure.

Vous pouvez également demander à Claude dans n'importe quelle session Desktop de définir la planification. Claude n'est pas soumis à la limite d'une exécution par heure et peut programmer une exécution unique à un moment futur. Par exemple, demandez « exécuter la suite de tests toutes les 30 minutes » ou « lundi prochain à 9 h, résumer les pull requests fusionnées depuis vendredi ».

Comment les tâches planifiées s'exécutent

Les tâches planifiées locales 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.

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 Settings > Desktop app ou Settings > This computer > System. Fermer le couvercle de l'ordinateur portable le met toujours en veille.

[!NOTE]

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 tâche planifiée dans le cloud.

Trouver la session d'une exécution

Pour ouvrir la session démarrée par une exécution, accédez à la page de détails de la tâche et cliquez sur la ligne de cette exécution dans la liste History.

La liste des sessions de la barre latérale peut également afficher un groupe Scheduled, avec une ligne par tâche. Pour ouvrir la session de la dernière exécution d'une tâche, cliquez sur la ligne de la tâche dans ce groupe. Pour afficher le groupe, vérifiez quelle disposition vous utilisez :

• Disposition actuelle : ouvrez le menu Group and sort, sélectionnez Show, puis sélectionnez Scheduled. Le groupe est initialement réduit ; cliquez donc sur son en-tête pour le développer. Show liste Scheduled lorsqu'au moins une de vos tâches est Active, le Status affiché sur la page de détails d'une tâche. S'il n'est pas listé, utilisez la liste History, qui fonctionne que le groupe soit affiché ou non.
• Disposition antérieure : le groupe se trouve dans la liste des sessions, sans rien à activer

Dans la session d'une exécution, quelle que soit la manière dont vous y avez accédé, vous pouvez voir ce que Claude a fait, examiner les modifications et répondre aux demandes de permission. Claude peut modifier des fichiers, exécuter des commandes, créer des commits et ouvrir des pull requests, comme dans une session que vous démarrez vous-même.

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 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. Lorsqu'une exécution est bloquée sur une demande de permission, trouvez la session de l'exécution et répondez-y à la demande.

Pour éviter les arrêts, cliquez sur Run now après avoir créé une tâche, surveillez les demandes de permission et sélectionnez « always allow » pour chacune. Les exécutions futures ignorent la plupart de ces demandes. Vous pouvez examiner et révoquer ces approbations à partir de la page de détail de la tâche. Si vous sélectionnez « always allow » pour une modification de fichier dans le dossier de la tâche, seule cette session passe en Accept edits ; définissez donc le mode de permission de la tâche sur Accept edits.

Les outils MCP marqués requiresUserInteraction demandent une approbation à chaque appel et n'offrent pas d'option « always allow ». Les exécutions qui appellent ces outils s'arrêtent à chaque fois.

Gérer les tâches planifiées

Dans l'onglet Code, cliquez sur Scheduled dans la barre latérale, puis cliquez sur une tâche dans la liste 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. Les sessions créées par la tâche sont archivées, et non supprimées. Le dossier contenant le fichier SKILL.md de la tâche reste sur le disque dans ~/.claude/scheduled-tasks/<task-name>/, ou dans scheduled-tasks/<task-name>/ sous CLAUDE_CONFIG_DIR si vous avez défini cette variable. Pour supprimer ce dossier, supprimez-le vous-même.

Vous pouvez également lister, créer, modifier et mettre en pause des tâches en demandant à Claude dans n'importe quelle session Desktop. Par exemple, « pause my dependency-audit task » ou « show me my scheduled tasks ». Pour supprimer une tâche, utilisez le bouton Delete sur sa page de détail.

Pour permettre à une tâche de modifier sa propre planification ou son prompt avec l'outil MCP update_scheduled_task, cliquez sur Run now et approuvez l'appel à chaque fois.

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

• Tâches planifiées dans le cloud : exécuter des tâches dans le cloud selon un calendrier, via un appel API ou en réponse à des événements GitHub, même lorsque votre ordinateur est éteint
• Exécuter des prompts selon un calendrier : planification au niveau de la session avec /loop dans la CLI
• Claude Code GitHub Actions : exécuter Claude selon un calendrier dans CI au lieu de sur votre machine
• Utiliser Claude Code Desktop : le guide complet de l'application Desktop