SpyBara
Go Premium

desktop-scheduled-tasks.md 2026-10-19 23:58 UTC to 2026-10-20 23:00 UTC

This page contains 85 additions and 47 deletions.

2026
Sat 3 23:57 Tue 6 23:59 Mon 19 23: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

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.

Comparer les options de planification

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

Cloud Desktop /loop
S'exécute sur Cloud, géré par Anthropic par défaut Votre machine Votre machine
Nécessite que la machine soit allumée Non Oui Oui
Nécessite une session ouverte Non Non Oui
Persistant après redémarrage Oui Oui Restauré sur --resume, avec exceptions
Accès aux fichiers locaux Non (clone frais) Oui Oui
Serveurs MCP Connecteurs configurés par tâche Fichiers de configuration et connecteurs Hérité de la session
Invites de permission Non (s'exécute de manière autonome) Configurable par tâche Hérité de la session
Planification personnalisable Via /schedule dans la CLI Oui Oui
Intervalle minimum 1 heure 1 minute 1 minute

[!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.

2. Démarrer une nouvelle tâche

Cliquez sur New task. Si un menu s'ouvre avec Create with Claude et Set up manually, sélectionnez Set up manually. La boîte de dialogue New scheduled task s'ouvre. 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.

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, et la carte Trigger propose les préréglages répertoriés dans Options de planification.

Si l'interrupteur n'est pas disponible, supprimez 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.

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. Custom accepte une expression cron. Pour les autres préréglages, consultez Options de planification.

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. Le formulaire Edit de la tâche propose également Manual.

  • 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

Pour les intervalles que le sélecteur n'offre pas, comme toutes les 15 minutes, le premier de chaque mois ou une exécution unique à un moment futur spécifique, demandez à Claude dans n'importe quelle session Desktop de définir la planification. Utilisez le langage naturel ; par exemple, « planifier une tâche pour exécuter tous les tests toutes les 6 heures ».

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

Lorsqu'une tâche locale s'active, 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 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. Si une tâche s'exécute en mode Manuel 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.

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 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.md de la tâche et les données associées de ~/.claude/scheduled-tasks/.

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.

Une tâche planifiée peut également modifier sa propre planification ou son prompt depuis une session en cours d'exécution à l'aide de l'outil MCP 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