Wiederkehrende Aufgaben in Claude Code Desktop planen

Richten Sie geplante Aufgaben in Claude Code Desktop ein, um Claude automatisch in regelmäßigen Abständen für tägliche Code-Reviews, Abhängigkeitsprüfungen oder morgendliche Briefings auszuführen.

Geplante Aufgaben starten automatisch eine neue Sitzung zu einem von Ihnen gewählten Zeitpunkt und in einer von Ihnen gewählten Häufigkeit. Verwenden Sie sie für wiederkehrende Arbeiten wie tägliche Code-Reviews, Überprüfungen von Abhängigkeitsaktualisierungen oder morgendliche Briefings, die Informationen aus Ihrem Kalender und Ihrer Inbox abrufen.

Die Seite Scheduled tasks der Desktop-App listet sowohl lokale geplante Aufgaben als auch geplante Cloud-Aufgaben auf, die früher Routinen hießen:

• Lokale Aufgabe: wird auf Ihrem Computer mit direktem Zugriff auf Ihre Dateien und Tools ausgeführt, wird aber nur ausgelöst, wenn die App offen ist und Ihr Computer aktiv ist
• Cloud-Aufgabe: wird auch dann ausgeführt, wenn Ihr Computer ausgeschaltet ist, und kann zusätzlich durch API-Aufrufe oder GitHub-Ereignisse gestartet werden

Diese Seite behandelt lokale geplante Aufgaben. Informationen zu geplanten Cloud-Aufgaben und deren Trigger-Optionen finden Sie unter Arbeit mit geplanten Aufgaben automatisieren.

[!NOTE]

Wenn Ihre App die Funktion noch unter ihrem früheren Namen anzeigt, klicken Sie auf Routines, wo auf dieser Seite Scheduled steht, und auf New routine, wo New task steht.

Planungsoptionen vergleichen

Claude Code bietet drei Möglichkeiten, um wiederkehrende oder einmalige Aufgaben zu planen:

[!TIP]

Verwenden Sie Cloud-Aufgaben für Arbeiten, die zuverlässig ohne Ihren Computer ausgeführt werden sollen. Verwenden Sie Desktop-Aufgaben, wenn Sie Zugriff auf lokale Dateien und Tools benötigen. Verwenden Sie /loop für schnelle Abfragen während einer Sitzung.

[!NOTE]

Standardmäßig werden lokale geplante Aufgaben für den aktuellen Zustand Ihres Arbeitsverzeichnisses ausgeführt, einschließlich nicht committeter Änderungen. Um stattdessen jeder Ausführung ihren eigenen isolierten Git-Worktree zu geben, wählen Sie nach dem Erstellen der Aufgabe im Edit-Formular der Aufgabe die Option Worktree aus. Das Kontrollkästchen ist verfügbar, wenn der Ordner der Aufgabe ein Git-Repository ist.

Erstellen Sie eine geplante Aufgabe

Lokale geplante Aufgaben erfordern Claude Desktop 1.1.5368 oder höher.

1. Seite „Geplante Aufgaben“ öffnen

Klicken Sie auf der Code-Registerkarte auf Geplant in der Seitenleiste oder im Menü Mehr der Seitenleiste. Wenn die Seitenleiste Routinen statt Geplant anzeigt, klicken Sie auf Routinen, dann auf Neue Routine, und fahren Sie mit Ganzseitiges Formular fort.

2. Neue Aufgabe beginnen

Klicken Sie auf Neue Aufgabe, um den Dialog Neue geplante Aufgabe zu öffnen. Achten Sie auf diese Bildschirme, bevor Sie fortfahren:

• Wenn sich ein Menü mit Mit Claude erstellen und Manuell einrichten öffnet, wählen Sie Manuell einrichten, um den Dialog zu öffnen.
• Wenn Nur auf diesem Computer oben im Dialog steht, gehen Sie zu Dialog mit „Nur auf diesem Computer“ oben, bevor Sie etwas eingeben.
• Wenn sich ein Menü mit Lokal und Cloud öffnet oder anstelle des Dialogs eine ganze Seite geöffnet wird, gehen Sie zu Ganzseitiges Formular.

3. Aufgabe benennen

Geben Sie im Feld Name einen Namen ein. Desktop konvertiert ihn in Kleinbuchstaben-Kebab-Case und verwendet ihn als Ordnernamen der Aufgabe auf der Festplatte, daher muss der Name über alle Ihre Aufgaben hinweg eindeutig sein.

4. Anweisungen schreiben

Geben Sie im Feld unter dem Namen ein, was Claude tun soll, wenn die Aufgabe ausgeführt wird.

5. „Nur auf diesem Computer“ einschalten

Überspringen Sie die Karte Auslöser vorerst und klappen Sie darunter Erweiterte Einstellungen auf. Schalten Sie auf der Registerkarte Allgemein die Option Nur auf diesem Computer ein. Wenn diese Option eingeschaltet ist, wird die Aufgabe auf Ihrem Rechner in einem lokalen Ordner ausgeführt.

Wenn der Schalter nicht verfügbar ist, entfernen Sie das Repository oder den GitHub-Ereignis- bzw. API-Auslöser, da diese die Aufgabe zu einer geplanten Cloud-Aufgabe machen.

6. Lokalen Ordner auswählen

Wählen Sie in der Zeile Lokaler Ordner einen Ordner aus. Erstellen bleibt nicht verfügbar, bis Sie einen ausgewählt haben.

7. Zeitplan festlegen

Wählen Sie wieder in der Karte Auslöser eine Zeitplan-Voreinstellung aus.

8. Berechtigungsmodus und Modell auswählen

Wählen Sie in der Symbolleiste des Anweisungsfelds einen Berechtigungsmodus und ein Modell aus. Wenn Sie diese unverändert lassen, verwenden Ausführungen Ihre Claude Code-Einstellungen und das Standardmodell.

9. Aufgabe erstellen

Klicken Sie auf Erstellen. Wenn Sie dem Ordner noch nicht vertraut haben, fordert Desktop Sie an dieser Stelle auf, ihm zu vertrauen. Die Detailseite der Aufgabe wird geöffnet.

Klicken Sie auf der Detailseite auf das Stiftsymbol, um das Bearbeiten-Formular zu öffnen. Dort können Sie die Beschreibung ändern, die Desktop aus Ihren Anweisungen ausgefüllt hat, Worktree auswählen oder den Zeitplan auf Manuell oder Benutzerdefiniert umstellen.

Sie können auch eine Aufgabe erstellen, indem Sie in einer beliebigen Sitzung beschreiben, was Sie möchten. Zum Beispiel erstellt „Richten Sie ein tägliches Code-Review ein, das jeden Morgen um 9 Uhr ausgeführt wird“ eine wiederkehrende Aufgabe. Eine Anfrage wie „Erinnern Sie mich morgen um 15 Uhr, die Bereitstellung zu überprüfen“ erstellt eine einmalige Aufgabe, die sich nach der Ausführung selbst deaktiviert.

Dialog mit „Nur auf diesem Computer“ oben

Wenn Nur auf diesem Computer beim Öffnen oben im Dialog Neue geplante Aufgabe steht, schalten Sie diese Option ein, bevor Sie etwas eingeben. Wenn Sie sie einschalten, ersetzt ein separates leeres Formular für eine lokale Aufgabe das Formular.

Füllen Sie dann die Felder des lokalen Formulars aus:

• Name: Geben Sie einen Namen ein, wie in den Schritten zum Erstellen einer geplanten Aufgabe beschrieben.
• Beschreibung: Geben Sie eine Beschreibung ein. Erstellen bleibt nicht verfügbar, bis Sie dies tun.
• Das Anweisungsfeld: Geben Sie ein, was Claude tun soll, wenn die Aufgabe ausgeführt wird. Wählen Sie den Berechtigungsmodus und das Modell aus den Menüs im Feld aus.
• Arbeitsordner: Wählen Sie den Ordner aus, in dem die Aufgabe ausgeführt wird. Erstellen bleibt nicht verfügbar, bis Sie einen ausgewählt haben.
• Auslöser: Wählen Sie einen Zeitplan aus. Informationen zu den Voreinstellungen finden Sie unter Planungsoptionen.

Klicken Sie auf Erstellen. Die Detailseite der Aufgabe wird geöffnet.

Ganzseitiges Formular

Wenn sich ein Menü mit Lokal und Cloud öffnet, wählen Sie Lokal. Eine Seite mit dem Titel Neue lokale Routine oder Neue lokale geplante Aufgabe wird geöffnet. Füllen Sie ihre Felder aus:

• Name: Geben Sie einen Namen ein, der über alle Ihre Aufgaben hinweg eindeutig ist.
• Beschreibung: Geben Sie eine Beschreibung ein.
• Anweisungen: Geben Sie ein, was Claude tun soll, wenn die Aufgabe ausgeführt wird. Wählen Sie im selben Feld den Berechtigungsmodus, das Modell und den Ordner aus, in dem die Aufgabe ausgeführt wird.
• Zeitplan: Wählen Sie eine der Planungsoptionen aus.

Wenn Erstellen nicht verfügbar ist, bewegen Sie den Mauszeiger darüber, um zu sehen, was im Formular noch fehlt. Klicken Sie auf Erstellen, und die Detailseite der Aufgabe wird geöffnet.

Planungsoptionen

Wenn Sie unter Advanced settings die Option Only on this computer aktivieren, bietet die Karte Trigger die Optionen Stündlich, Täglich, Wochentage und Wöchentlich. Um für eine solche Aufgabe Manuell oder Benutzerdefiniert zu erhalten, öffnen Sie nach dem Erstellen ihr Edit-Formular. Dieses Formular, der Dialog mit Only on this computer oben und das ganzseitige Formular bieten diese sechs Optionen:

• Stündlich: wird jede Stunde ausgeführt
• Täglich: wird jeden Tag zur lokalen Zeit ausgeführt, die Sie auswählen
• Wochentage: wie täglich, aber überspringt Samstag und Sonntag
• Wöchentlich: zeigt eine Zeitauswahl und eine Tagesauswahl an
• Manuell: kein Zeitplan, wird nur ausgeführt, wenn Sie auf Run now klicken. Nützlich zum Speichern eines Prompts, den Sie bei Bedarf auslösen
• Benutzerdefiniert: wird nach einem Cron-Ausdruck ausgeführt, den Sie eingeben und der in Ihrer lokalen Zeit ausgewertet wird, z. B. 0 9 * * * für täglich 9:00 Uhr. Geben Sie Wochentage und Monate als Zahlen an, da ihre Namen nicht akzeptiert werden. Sonntag ist 0, nicht 7. Das Formular lehnt einen Ausdruck ab, der häufiger als einmal pro Stunde ausgeführt wird.

Sie können Claude auch in einer beliebigen Desktop-Sitzung bitten, den Zeitplan festzulegen. Für Claude gilt die Beschränkung auf einmal pro Stunde nicht, und Claude kann eine einzelne Ausführung zu einem zukünftigen Zeitpunkt festlegen. Bitten Sie zum Beispiel: „Führe die Testsuite alle 30 Minuten aus“ oder „Fasse nächsten Montag um 9 Uhr die seit Freitag gemergten Pull Requests zusammen.“

Wie geplante Aufgaben ausgeführt werden

Lokale geplante Aufgaben werden auf Ihrem Computer ausgeführt. Desktop überprüft den Zeitplan jede Minute, während die App offen ist, und startet eine neue Sitzung, wenn eine Aufgabe fällig ist, unabhängig von manuellen Sitzungen, die Sie offen haben. Jede Aufgabe erhält eine kleine Verzögerung von einigen Minuten nach der geplanten Zeit, um den API-Verkehr zu staffeln. Die Verzögerung ist deterministisch: die gleiche Aufgabe startet immer mit dem gleichen Offset.

Aufgaben werden nur ausgeführt, während die Desktop-App ausgeführt wird und Ihr Computer aktiv ist. Wenn Ihr Computer durch eine geplante Zeit schläft, wird die Ausführung übersprungen. Um den Ruhezustand bei Inaktivität zu verhindern, aktivieren Sie Computer aktiv halten unter Einstellungen > Desktop-App oder Einstellungen > Dieser Computer > System. Das Schließen des Laptop-Deckels versetzt ihn dennoch in den Ruhezustand.

[!NOTE]

Für Aufgaben, die auch ausgeführt werden müssen, wenn Ihr Computer ausgeschaltet ist, oder die durch einen API-Aufruf oder ein GitHub-Ereignis ausgelöst werden sollen, erstellen Sie stattdessen eine geplante Cloud-Aufgabe.

Die Sitzung einer Ausführung finden

Um die Sitzung zu öffnen, die eine Ausführung gestartet hat, gehen Sie zur Detailseite der Aufgabe und klicken Sie in der Liste Verlauf auf die Zeile dieser Ausführung.

Die Sitzungsliste in der Seitenleiste kann außerdem eine Gruppe Geplant anzeigen, mit einer Zeile pro Aufgabe. Um die Sitzung der letzten Ausführung einer Aufgabe zu öffnen, klicken Sie in dieser Gruppe auf die Zeile der Aufgabe. Um die Gruppe anzuzeigen, prüfen Sie, welches Layout Sie haben:

• Aktuelles Layout: Öffnen Sie das Menü Gruppieren und sortieren, wählen Sie Anzeigen und dann Geplant. Die Gruppe ist anfangs eingeklappt, klicken Sie also auf ihre Überschrift, um sie auszuklappen. Anzeigen listet Geplant auf, wenn mindestens eine Ihrer Aufgaben Aktiv ist, also den Status, den die Detailseite einer Aufgabe anzeigt. Wenn der Eintrag nicht aufgeführt ist, verwenden Sie die Liste Verlauf, die unabhängig davon funktioniert, ob die Gruppe angezeigt wird.
• Früheres Layout: Die Gruppe befindet sich in der Sitzungsliste, ohne dass Sie etwas aktivieren müssen

In der Sitzung einer Ausführung können Sie, unabhängig davon, wie Sie sie erreicht haben, sehen, was Claude getan hat, Änderungen überprüfen und auf Berechtigungsabfragen reagieren. Claude kann Dateien bearbeiten, Befehle ausführen, Commits erstellen und Pull Requests öffnen, genau wie in einer Sitzung, die Sie selbst starten.

Verpasste Ausführungen

Wenn die App startet oder Ihr Computer aufwacht, überprüft Desktop, ob jede Aufgabe in den letzten sieben Tagen Ausführungen verpasst hat. Wenn ja, startet Desktop genau eine Nachholausführung für die zuletzt verpasste Zeit und verwirft alles Ältere. Eine tägliche Aufgabe, die sechs Tage verpasst hat, wird einmal beim Aufwachen ausgeführt. Desktop zeigt eine Benachrichtigung an, wenn eine Nachholausführung startet.

Beachten Sie dies beim Schreiben von Prompts. Eine Aufgabe, die für 9 Uhr geplant ist, könnte um 23 Uhr ausgeführt werden, wenn Ihr Computer den ganzen Tag über im Ruhezustand war. Wenn das Timing wichtig ist, fügen Sie Schutzmaßnahmen zum Prompt selbst hinzu, zum Beispiel: „Überprüfen Sie nur die heutigen Commits. Wenn es nach 17 Uhr ist, überspringen Sie die Überprüfung und posten Sie eine Zusammenfassung dessen, was verpasst wurde.“

Berechtigungen für geplante Aufgaben

Jede Aufgabe hat ihren eigenen Berechtigungsmodus, den Sie beim Erstellen oder Bearbeiten der Aufgabe festlegen. Zulassungsregeln aus ~/.claude/settings.json gelten auch für geplante Aufgabensitzungen. Wenn eine Aufgabe im Manuellen Modus ausgeführt wird und ein Tool ausführen muss, für das sie keine Berechtigung hat, bleibt die Ausführung stehen, bis Sie sie genehmigen. Um sie zu genehmigen, suchen Sie die Sitzung der Ausführung und beantworten Sie dort die Berechtigungsabfrage.

Um Stalls zu vermeiden, klicken Sie nach dem Erstellen einer Aufgabe auf Jetzt ausführen, achten Sie auf Berechtigungsaufforderungen und wählen Sie für jede „immer zulassen“. Zukünftige Ausführungen dieser Aufgabe genehmigen automatisch die gleichen Tools ohne Aufforderung. Sie können diese Genehmigungen auf der Detailseite der Aufgabe überprüfen und widerrufen.

MCP-Tools, die mit requiresUserInteraction gekennzeichnet sind, werden bei jedem Aufruf angefordert und bieten keine Option „immer zulassen“. Ausführungen, die diese Tools aufrufen, bleiben jedes Mal stehen.

Verwalten Sie geplante Aufgaben

Klicken Sie auf der Registerkarte Code in der Seitenleiste auf Geplant und dann auf eine Aufgabe in der Liste, um ihre Detailseite zu öffnen. Von hier aus können Sie:

• Jetzt ausführen: Starten Sie die Aufgabe sofort, ohne auf die nächste geplante Zeit zu warten
• Status: Umschalten zwischen Aktiv und Pausiert, um geplante Ausführungen zu pausieren oder fortzusetzen, ohne die Aufgabe zu löschen
• Bearbeiten: Ändern Sie die Anweisungen, den Zeitplan, den Ordner oder andere Einstellungen
• Verlauf überprüfen: Sehen Sie jede vergangene Ausführung, einschließlich übersprungener Ausführungen. Bewegen Sie den Mauszeiger über einen übersprungenen Eintrag, um zu sehen, warum: Ihr Computer war im Ruhezustand, die vorherige Ausführung war noch in Bearbeitung, oder andere geplante Aufgaben wurden bereits ausgeführt. Klicken Sie auf Mehr anzeigen, um ältere Einträge zu laden.
• Zulässige Berechtigungen überprüfen: Sehen Sie und widerrufen Sie gespeicherte Tool-Genehmigungen für diese Aufgabe aus dem Bereich Immer zulässig
• Löschen: Entfernen Sie die Aufgabe. Die Sitzungen, die die Aufgabe erstellt hat, werden archiviert, nicht gelöscht. Der Ordner mit der Datei SKILL.md der Aufgabe verbleibt auf der Festplatte unter ~/.claude/scheduled-tasks/<task-name>/ bzw. unter scheduled-tasks/<task-name>/ in CLAUDE_CONFIG_DIR, falls Sie diese Variable gesetzt haben. Um diesen Ordner zu entfernen, löschen Sie ihn selbst.

Sie können Aufgaben auch auflisten, erstellen, bearbeiten und pausieren, indem Sie Claude in einer beliebigen Desktop-Sitzung bitten. Zum Beispiel „Pausieren Sie meine Aufgabe zur Abhängigkeitsprüfung“ oder „Zeigen Sie mir meine geplanten Aufgaben.“ Um eine Aufgabe zu löschen, verwenden Sie die Schaltfläche Löschen auf ihrer Detailseite.

Eine geplante Aufgabe kann auch ihren eigenen Zeitplan oder ihre Eingabeaufforderung innerhalb einer laufenden Sitzung mit dem MCP-Tool update_scheduled_task ändern. Dies ermöglicht es einer Aufgabe, sich selbst neu zu planen, basierend auf dem, was sie findet, zum Beispiel das Umplanen eines Code-Reviews, um früher ausgeführt zu werden, wenn es einen Release-Branch erkennt.

Um die Eingabeaufforderung einer Aufgabe auf der Festplatte zu bearbeiten, öffnen Sie ~/.claude/scheduled-tasks/<task-name>/SKILL.md (oder unter CLAUDE_CONFIG_DIR, falls gesetzt). Die Datei verwendet YAML-Frontmatter für name und description, mit der Eingabeaufforderung als Text. Änderungen werden bei der nächsten Ausführung wirksam. Zeitplan, Ordner, Modell und aktivierter Status befinden sich nicht in dieser Datei: Ändern Sie sie über das Bearbeitungsformular oder bitten Sie Claude.

Verwandte Ressourcen

• Geplante Aufgaben in der Cloud: Führen Sie Aufgaben in der Cloud nach einem Zeitplan, über einen API-Aufruf oder als Reaktion auf GitHub-Ereignisse aus, auch wenn Ihr Computer ausgeschaltet ist
• Eingabeaufforderungen nach einem Zeitplan ausführen: Sitzungsbezogene Planung mit /loop in der CLI
• Claude Code GitHub Actions: Führen Sie Claude nach einem Zeitplan in CI statt auf Ihrem Computer aus
• Verwenden Sie Claude Code Desktop: Das vollständige Desktop-App-Handbuch