Arbeit mit geplanten Aufgaben automatisieren

Setzen Sie Claude Code auf Autopilot. Erstellen Sie geplante Aufgaben, früher Routinen genannt, die in der Cloud nach einem Zeitplan, bei API-Aufrufen oder bei GitHub-Ereignissen ausgeführt werden.

[!NOTE]

Geplante Aufgaben befinden sich in der Research Preview. Verhalten, Limits und die API-Oberfläche können sich ändern.

Eine geplante Aufgabe in der Cloud, früher Routine genannt, ist eine gespeicherte Claude Code-Konfiguration: ein Prompt, ein oder mehrere Repositorys und eine Reihe von Konnektoren, die einmal verpackt und automatisch ausgeführt werden. Geplante Aufgaben werden auf der von Anthropic verwalteten Cloud-Infrastruktur ausgeführt, oder auf der selbstgehosteten Umgebung Ihrer Organisation, wenn sie dorthin weitergeleitet werden, sodass sie weiterhin funktionieren, wenn Ihr Laptop geschlossen ist.

Jede geplante Aufgabe kann einen oder mehrere Trigger haben:

• Zeitplan: Ausführung in einem wiederkehrenden Rhythmus wie stündlich, nächtlich oder wöchentlich, oder einmalig zu einem bestimmten zukünftigen Zeitpunkt
• API: Auslösung bei Bedarf durch Senden eines HTTP POST an den eigenen Endpunkt der Aufgabe mit einem Bearer-Token
• GitHub: Automatische Ausführung als Reaktion auf Repository-Ereignisse wie Pull Requests oder Releases

Eine einzelne geplante Aufgabe kann Trigger kombinieren. Beispielsweise kann eine PR-Review-Aufgabe nachts ausgeführt werden, von einem Deploy-Skript ausgelöst werden und auch auf jeden neuen PR reagieren.

Eine geplante Aufgabe benötigt keinen Zeitplan:

• Eine Aufgabe mit nur einem API-Trigger wird ausgeführt, wenn Sie ihren Endpunkt aufrufen.
• Eine Aufgabe mit nur einem GitHub-Trigger wird ausgeführt, wenn ein passendes Repository-Ereignis eintritt.

Geplante Aufgaben sind in den Plänen Pro, Max, Team und Enterprise verfügbar. Erstellen und verwalten Sie sie unter claude.ai/code/routines oder über die CLI mit /schedule. Der frühere Name, Routinen, erscheint weiterhin.

[!NOTE]

Zwei weitere Funktionen planen Arbeit auf Ihrem Computer statt in der Cloud: geplante Aufgaben in der Desktop-App und /loop. Informationen zur Auswahl zwischen allen drei Optionen finden Sie unter Planungsoptionen vergleichen.

Team- und Enterprise-Owner können geplante Aufgaben für alle Mitglieder mit dem Schalter Scheduled tasks (Was Routines) unter Organization settings > Capabilities > Remote sessions deaktivieren. Wenn der Schalter ausgeschaltet ist, werden vorhandene geplante Aufgaben nicht mehr ausgeführt und Mitglieder können keine neuen erstellen.

Wenn Ihre Enterprise-Organisation Ihren Zugriff mit benutzerdefinierten Rollen verwaltet, benötigen Sie außerdem eine Rolle, die die Berechtigung für geplante Aufgaben enthält. Ein Owner kann sie im Abschnitt Remote sessions einer Rolle unter Organization settings > Roles hinzufügen.

Beispiel-Anwendungsfälle

Jedes Beispiel kombiniert einen Trigger-Typ mit der Art von Arbeit, für die geplante Aufgaben geeignet sind: unbeaufsichtigt, wiederholbar und an ein klares Ergebnis gebunden.

• Backlog-Wartung: Ein Zeitplan-Trigger wird an jedem Wochentag abends in Ihrem Repository ausgeführt, wobei Ihr Issue-Tracker als Konnektor hinzugefügt ist. Die geplante Aufgabe liest seit der letzten Ausführung geöffnete Issues, vergibt Labels und weist Verantwortliche basierend auf dem referenzierten Code-Bereich zu. Anschließend postet sie eine Zusammenfassung in Slack, damit das Team den Tag mit einer gepflegten Warteschlange beginnt.
• Alert-Triage: Ihr Monitoring-Tool ruft den API-Endpunkt der geplanten Aufgabe auf, wenn ein Fehlerschwellenwert überschritten wird, und übergibt den Alert-Body als text. Der Prompt der Aufgabe weist Claude an, den Alert in der Fire-Payload zu untersuchen, sodass Claude den Stack Trace abruft und ihn mit kürzlichen Commits im Repository abgleicht. Anschließend öffnet Claude einen Draft-Pull-Request mit einem vorgeschlagenen Fix und einem Link zurück zum Alert. Die Rufbereitschaft prüft den PR, anstatt mit einem leeren Terminal zu beginnen.
• Individuelles Code-Review: Ein GitHub-Trigger wird bei pull_request.opened ausgeführt. Die geplante Aufgabe wendet die eigene Review-Checkliste Ihres Teams an und hinterlässt Inline-Kommentare zu Sicherheits-, Performance- und Stilproblemen. Außerdem fügt sie einen Zusammenfassungskommentar hinzu, damit sich menschliche Reviewer auf das Design statt auf mechanische Prüfungen konzentrieren können.
• Deploy-Verifizierung: Ihre CD-Pipeline ruft den API-Endpunkt der geplanten Aufgabe nach jedem Production-Deploy auf. Die Aufgabe führt Smoke-Tests gegen den neuen Build durch, durchsucht Error-Logs nach Regressionen und postet ein Go oder No-Go im Release-Kanal, bevor das Deploy-Fenster schließt.
• Dokumentations-Drift: Ein Zeitplan-Trigger wird wöchentlich ausgeführt. Die geplante Aufgabe durchsucht seit der letzten Ausführung gemergte PRs, kennzeichnet Dokumentation, die auf geänderte APIs verweist, und öffnet Update-PRs gegen das Dokumentations-Repository zur Prüfung durch einen Redakteur.
• Library-Port: Ein GitHub-Trigger wird bei pull_request.closed ausgeführt, gefiltert auf gemergte PRs in einem SDK-Repository. Die geplante Aufgabe portiert die Änderung in ein paralleles SDK in einer anderen Sprache und öffnet einen entsprechenden PR, sodass die beiden Bibliotheken synchron bleiben, ohne dass ein Mensch jede Änderung neu implementiert.

Eine geplante Aufgabe erstellen

Erstellen Sie eine geplante Aufgabe im Web unter claude.ai/code/routines, in der Desktop-App oder in der CLI. Alle drei Oberflächen schreiben in dasselbe Cloud-Konto, sodass eine geplante Aufgabe, die Sie in einer Oberfläche erstellen, sofort in den anderen angezeigt wird. Klicken Sie in der Desktop-App auf der Registerkarte Code in der Seitenleiste oder im Menü Mehr der Seitenleiste auf Geplant und dann auf Neue Aufgabe, und fahren Sie mit Im Web erstellen fort.

Geplante Aufgaben werden autonom als vollständige Claude Code-Cloud-Sitzungen ausgeführt. Die Sitzung führt Shell-Befehle aus, verwendet Skills und ruft alle Konnektoren auf, die Sie einbeziehen. Außerhalb der Threads eines Projekts gehören zu diesen Skills auch die im geklonten Repository committeten Skills. Beim Erstellen der Aufgabe wählen Sie keinen Berechtigungsmodus: Unter Berechtigungsabfragen während einer Ausführung erfahren Sie, wann eine Ausführung anhält und auf Sie wartet.

Was eine geplante Aufgabe erreichen kann, wird bestimmt durch:

• Die Repositorys, die Sie auswählen
• Den Netzwerkzugriff und die Variablen der Umgebung
• Die Konnektoren, die Sie einbeziehen

Beschränken Sie jeden dieser Punkte auf das, was die Aufgabe benötigt.

Geplante Aufgaben gehören zu Ihrem individuellen claude.ai-Konto. Sie werden nicht mit Teamkollegen geteilt, und ihre Ausführungen zählen gegen die Nutzung und Limits Ihres Kontos. Alles, was eine geplante Aufgabe über Ihre verbundene GitHub-Identität oder Konnektoren tut, erscheint als von Ihnen ausgeführt. Commits und Pull Requests tragen Ihren GitHub-Benutzer, und Slack-Nachrichten, Linear-Tickets oder andere Konnektor-Aktionen verwenden Ihre verknüpften Konten für diese Dienste.

Im Web erstellen

1. Öffnen Sie den Erstellungsdialog

Besuchen Sie claude.ai/code/routines und klicken Sie auf Neue Aufgabe, um den Dialog Neue geplante Aufgabe zu öffnen. Achten Sie auf diese Bildschirme, bevor Sie fortfahren:

• Wenn die Schaltfläche Neue Routine statt Neue Aufgabe lautet, klicken Sie auf Neue Routine und fahren Sie mit Ganzseitiges Formular fort.
• Wenn sich in der Desktop-App ein Menü mit Lokal und Cloud öffnet, wechseln Sie zu Ganzseitiges Formular.
• Wenn sich ein Menü mit Mit Claude erstellen und Manuell einrichten öffnet, wählen Sie Manuell einrichten, um den Dialog zu öffnen. Mit Mit Claude erstellen können Sie die Aufgabe stattdessen in einem Chat beschreiben und von Claude erstellen lassen.
• Wenn sich anstelle des Dialogs eine ganze Seite öffnet, wechseln Sie zu Ganzseitiges Formular.

Wenn Repositorys und Umgebung bereits beim Öffnen des Dialogs angezeigt werden, lesen Sie, wie sich dieser Dialog unterscheidet. Andernfalls erstellt dieser Dialog auch geplante Aufgaben für Chats in claude.ai. Damit Ihre Aufgabe das wird, was der Dialog eine Claude Code-Aufgabe nennt, wählen Sie in den folgenden Schritten ein Repository aus oder fügen Sie einen GitHub-Ereignis- oder API-Trigger hinzu. Diese Art von Aufgabe führt Claude Code in einer Cloud-Sitzung aus.

2. Benennen Sie die Aufgabe und schreiben Sie den Prompt

Geben Sie der geplanten Aufgabe einen aussagekräftigen Namen und schreiben Sie den Prompt, den Claude jedes Mal ausführt. Der Prompt ist der wichtigste Teil: Die Aufgabe wird autonom ausgeführt, daher muss der Prompt in sich geschlossen und explizit darüber sein, was zu tun ist und wie Erfolg aussieht.

Wenn ein Trigger ausgelöst wird, erhält die Sitzung den gespeicherten Prompt als zugewiesene Aufgabe und führt ihn aus, anstatt ihn als nicht vertrauenswürdigen Inhalt zu behandeln, der mitten in einer Konversation angekommen ist. Der Trigger bestätigt nur, dass der Prompt vorher von einer autorisierten Sitzung in Ihrem Konto gespeichert wurde. Der ausgelöste Prompt ist daher keine Live-Benutzereingabe und kann nicht als Genehmigung oder Zustimmung für Aktionen während der Ausführung fungieren. Inhalte, die die Sitzung während der Ausführung abruft, behalten ihre normale Behandlung.

3. Wählen Sie einen Trigger aus

Wählen Sie in der Zeile Trigger, wie die Aufgabe startet. Um mehrere Trigger zu kombinieren, klicken Sie auf + am Ende der Zeile.

Zeitplan

Wählen Sie eine voreingestellte Häufigkeit für eine wiederkehrende Ausführung. Siehe Zeitplan-Trigger hinzufügen für Zeitzonenbehandlung, verspätete Starts, benutzerdefinierte Cron-Intervalle und einmalige Ausführungen.

GitHub-Ereignis

Wählen Sie das Repository, das Ereignis, auf das reagiert werden soll, und optionale Filter aus. Siehe GitHub-Trigger hinzufügen für die vollständige Liste der unterstützten Ereignisse und Filterfelder.

API

Wählen Sie hier API aus. Wenn Sie auf Erstellen klicken, zeigt der Dialog API-Token das Token einmal an. Kopieren Sie es daher, bevor Sie den Dialog schließen. Siehe API-Trigger hinzufügen, um die URL zu kopieren oder ein neues Token zu generieren.

4. Wählen Sie Repositorys aus

Klappen Sie Erweiterte Einstellungen auf. Wählen Sie unter Repository auf der Registerkarte Allgemein ein oder mehrere GitHub-Repositorys aus, in denen Claude arbeiten soll.

Jedes Repository wird zu Beginn einer Ausführung geklont. Claude erstellt Branches mit dem Präfix claude/ für seine Änderungen.

5. Wählen Sie eine Umgebung aus

Nachdem Sie ein Repository ausgewählt haben, erscheint darunter Cloud-Umgebung. Wählen Sie eine Cloud-Umgebung für die Aufgabe. Umgebungen steuern, worauf die Cloud-Sitzung Zugriff hat:

• Netzwerkzugriff: Legen Sie die Stufe des Internetzugriffs fest, der während jeder Ausführung verfügbar ist
• Umgebungsvariablen: Stellen Sie Werte bereit, die Claude während jeder Ausführung verwenden kann. Sie sind für jeden sichtbar, der die Umgebung nutzt. Speichern Sie daher in einer von Anthropic gehosteten Umgebung Schlüssel für die APIs, die Claude während einer Ausführung aufruft, stattdessen als Netzwerk-Secrets. Dieser Abschnitt listet auch die Anfragen auf, die niemals ein Secret erhalten
• Setup-Skript: Installieren Sie Abhängigkeiten und Tools, die die Aufgabe benötigt. Das Ergebnis wird zwischengespeichert, sodass das Skript nicht bei jeder Sitzung erneut ausgeführt wird

Eine Standard-Umgebung wird mit Vertrauenswürdigem Netzwerkzugriff bereitgestellt, der über das Netzwerk der Sitzung nur die Standard-Allowlist von Paket-Registries, Cloud-Provider-APIs, Container-Registries und gängigen Entwicklungsdomains zulässt. Konnektoren, die Sie zur Aufgabe hinzufügen, erreichen ihre Dienste über die Server von Anthropic, daher benötigen sie keine Änderungen an der Allowlist.

Wenn Ihre Aufgabe Ihre eigenen Dienste direkt oder eine Domain außerhalb dieser Liste erreichen muss, bearbeiten Sie den Netzwerkzugriff der Umgebung vor der Ausführung. Um eine separate Umgebung zu verwenden, erstellen Sie zuerst eine.

6. Wählen Sie ein Modell und eine Effort-Stufe aus

Wählen Sie im Modell-Selector der Prompt-Eingabe ein Modell aus, das Claude bei jeder Ausführung verwendet. Wenn das Modell bei einer Claude Code-Aufgabe Effort-Stufen anbietet, zeigt Effort im selben Selector die aktuelle Stufe an. Um sie zu ändern, wählen Sie eine andere Stufe aus. Die Option Standard des Selectors bietet keine Stufen an.

7. Überprüfen Sie die Konnektoren

Wechseln Sie zur Registerkarte Konnektoren unter Erweiterte Einstellungen. Alle Ihre verbundenen MCP-Konnektoren sind standardmäßig enthalten. Entfernen Sie alle, die die Aufgabe nicht benötigt: Claude kann einen eingebundenen Konnektor während einer Ausführung verwenden, einschließlich Schreibvorgängen. Wann eine Ausführung anhält, um Sie zuerst zu fragen, erfahren Sie unter Berechtigungsabfragen während einer Ausführung.

8. Erstellen Sie die Aufgabe

Klicken Sie auf Erstellen. Der Dialog wird geschlossen und die Detailseite der neuen Aufgabe öffnet sich. Die Aufgabe wird ausgeführt, sobald das nächste Mal einer ihrer Trigger passt. Um eine Ausführung sofort zu starten, klicken Sie auf der Detailseite auf Jetzt ausführen.

Um zu sehen, was eine Ausführung getan hat, klicken Sie in der Liste Verlauf auf der Detailseite darauf. Die Ausführung öffnet sich als vollständige Sitzung, eine neue für jede Ausführung, in der Sie sehen können, was Claude getan hat, Änderungen überprüfen und einen Pull Request erstellen können.

Dialog mit Repositorys und Umgebung in der Hauptansicht

Folgen Sie den Schritten zum Erstellen im Web und füllen Sie jedes Feld in der Hauptansicht des Dialogs aus statt unter Erweiterte Einstellungen. Dieser Dialog erstellt nur Claude Code-Aufgaben.

Wählen Sie das Repository aus, bevor Sie einen GitHub-Ereignis-Trigger hinzufügen, da dieser Trigger erst verfügbar ist, wenn ein Repository ausgewählt wurde.

Ganzseitiges Formular

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

• Name: Geben Sie einen ein.
• Anweisungen: Geben Sie den Prompt ein. Wählen Sie im selben Feld das Modell, die Effort-Stufe, sofern das Modell eine anbietet, die Repositorys und die Umgebung aus. Was jede dieser Optionen steuert, erfahren Sie in den Schritten unter Im Web erstellen.
• Trigger auswählen: Wählen Sie Zeitplan, GitHub-Ereignis oder API. Für einen Zeitplan siehe Zeitplan-Trigger hinzufügen. Für ein GitHub-Ereignis wählen Sie ein Repository aus. Für einen API-Trigger kopieren Sie das Token aus dem Dialog API-Token, der sich öffnet, nachdem Sie auf Erstellen geklickt haben, da es nur einmal angezeigt wird. Um mehrere Trigger zu kombinieren, klicken Sie auf Weiteren Trigger hinzufügen.
• Konnektoren: Alle Ihre verbundenen Konnektoren sind standardmäßig enthalten. Entfernen Sie daher diejenigen, die die Aufgabe nicht benötigt.

Wenn Erstellen nicht verfügbar ist, bewegen Sie den Mauszeiger darüber, um zu sehen, was das Formular noch benötigt. Klicken Sie auf Erstellen, und die Detailseite der Aufgabe öffnet sich.

In der CLI erstellen

Führen Sie /schedule in einer beliebigen Sitzung aus, um eine geplante Aufgabe im Dialog mit Claude zu erstellen. Sie können auch direkt eine Beschreibung übergeben, für eine wiederkehrende Aufgabe wie /schedule daily PR review at 9am oder eine einmalige wie /schedule clean up feature flag in one week. Claude fragt dieselben Informationen ab, die der Web-Dialog erfasst, und speichert die Aufgabe dann in Ihrem Konto. Der Befehl ist auch unter dem Alias /routines verfügbar.

Ein erfolgreicher Start sieht wie eine Konversation aus: Claude stellt vor dem Speichern Folgefragen zum Zeitplan, zu Repositorys und zum Prompt. Wenn Claude stattdessen antwortet, dass Sie sich authentifizieren müssen oder dass keine Verbindung zu Ihrem Remote-claude.ai-Konto hergestellt werden kann, wurde keine geplante Aufgabe erstellt; siehe Fehlerbehebung.

Eine Aufgabe, die Sie mit /schedule erstellen, hat einen Zeitplan-Trigger. Sie können auch die anderen Trigger-Typen hinzufügen:

• API-Trigger: Bearbeiten Sie die Aufgabe im Web unter claude.ai/code/routines
• GitHub-Trigger: Bearbeiten Sie die Aufgabe im Web oder fragen Sie Claude in der CLI. Das Hinzufügen über die CLI erfordert Claude Code v2.1.225 oder höher

Eine geplante Aufgabe ohne Zeitplan-Trigger, etwa eine, die nur durch API-Aufrufe oder GitHub-Ereignisse gestartet wird, hat keine nächste Ausführungszeit. Die CLI zeigt keine an, wenn Claude sie speichert oder aktualisiert.

Trigger konfigurieren

Eine geplante Aufgabe startet, wenn einer ihrer Trigger passt. Fügen Sie die Trigger einer Aufgabe jederzeit in der Zeile Trigger des Bearbeitungsdialogs der Aufgabe hinzu oder entfernen Sie sie.

Wenn eine Aufgabe zwei oder mehr Trigger hat, hat jeder davon in diesem Dialog ein Papierkorbsymbol. Um einen Zeitplan- oder GitHub-Ereignis-Trigger zu entfernen, klicken Sie auf sein Papierkorbsymbol und dann auf Änderungen speichern. Um einen API-Trigger zu entfernen, löschen Sie stattdessen sein Token.

Zeitplan-Trigger hinzufügen

Ein Zeitplan-Trigger führt die Aufgabe in einem wiederkehrenden Rhythmus oder einmalig zu einem bestimmten zukünftigen Zeitpunkt aus. Wählen Sie im Erstellungs- oder Bearbeitungsdialog der Aufgabe im Web eine voreingestellte Häufigkeit wie stündlich, täglich oder wöchentlich:

• Ausführungen zur vollen Stunde: Wenn Sie eine Ausführung genau zur vollen Stunde planen, z. B. 9:00, kann sie mehrere Minuten später starten. Um nahe an der geplanten Zeit zu starten, wählen Sie ein paar Minuten nach der vollen Stunde, z. B. 9:07.
• Benutzerdefinierte Intervalle: Für einen Rhythmus, den die Voreinstellungen nicht abdecken, erstellen Sie die Aufgabe und wählen Sie in ihrem Bearbeitungsdialog Benutzerdefiniert aus. Geben Sie dann einen Cron-Ausdruck ein, z. B. 0 */2 * * * für alle zwei Stunden. Um einen Ausdruck über die CLI festzulegen, führen Sie /schedule update aus. Ausdrücke, die häufiger als einmal pro Stunde ausgeführt werden, werden abgelehnt.
• Zeitzone: Wenn Sie eine voreingestellte Häufigkeit wählen, geben Sie die Uhrzeit in Ihrer lokalen Zeitzone ein.
• Zeitzone von Cron-Ausdrücken: Wenn der Ausdruck nur aus fünf Feldern besteht, geben Sie die Stunden in UTC an, sodass 0 9 * * 1-5 werktags um 9:00 Uhr UTC ausgeführt wird. Wenn das Feld mit einem CRON_TZ=-Präfix beginnt, behalten Sie es bei und geben Sie die Stunden in dessen Zeitzone an, oder löschen Sie es und geben Sie die Stunden in UTC an.

Einmalige Ausführung planen

Ein einmaliger Zeitplan führt die Aufgabe ein einziges Mal zu einem bestimmten Zeitstempel aus. Verwenden Sie ihn beispielsweise, um:

• Sich später in der Woche selbst zu erinnern
• Einen Cleanup-PR nach Abschluss eines Rollouts zu öffnen
• Folgearbeiten zu starten, nachdem eine vorgelagerte Änderung ausgeliefert wurde

Nach der Ausführung deaktiviert sich die Aufgabe selbst und die Web-UI markiert sie als Abgeschlossen. Um sie erneut auszuführen, öffnen Sie den Bearbeitungsdialog der Aufgabe im Web und wählen Sie Einmalig oder Einmal, je nachdem, welche Beschriftung Ihr Dialog anzeigt. Legen Sie dann ein neues Datum und eine neue Uhrzeit in Ihrer lokalen Zeitzone fest und speichern Sie.

Erstellen Sie eine einmalige Ausführung in der CLI, indem Sie die Zeit in natürlicher Sprache beschreiben. Claude löst den Ausdruck anhand der aktuellen Zeit auf und bestätigt den absoluten Zeitstempel vor dem Speichern.

/schedule tomorrow at 9am, summarize yesterday's merged PRs

/schedule in 2 weeks, open a cleanup PR that removes the feature flag

Einmalige Ausführungen zählen gegen dasselbe stündliche Limit wie andere geplante Ausführungen. Siehe Nutzung und Limits für Details.

API-Trigger hinzufügen

Ein API-Trigger gibt einer geplanten Aufgabe einen dedizierten HTTP-Endpunkt. Ein POST an den Endpunkt mit dem Bearer-Token der Aufgabe startet eine neue Sitzung und gibt eine Sitzungs-URL zurück. Verwenden Sie dies, um Claude Code in Alerting-Systeme, Deploy-Pipelines, interne Tools oder überall dort zu integrieren, wo Sie eine authentifizierte HTTP-Anfrage stellen können.

Fügen Sie einen API-Trigger im Web hinzu, entweder während Sie die Aufgabe erstellen oder später mit den folgenden Schritten. Sie können einen API-Trigger nicht über die CLI hinzufügen oder sein Token dort verwalten.

1. Öffnen Sie die Aufgabe zur Bearbeitung

Gehen Sie zu claude.ai/code/routines, klicken Sie auf die geplante Aufgabe, die Sie über die API auslösen möchten, öffnen Sie dann das Menü neben ihrem Namen und wählen Sie Bearbeiten. Der Dialog Geplante Aufgabe bearbeiten öffnet sich.

2. Fügen Sie einen API-Trigger hinzu

Klicken Sie in der Zeile Trigger auf + und wählen Sie im sich öffnenden Menü API aus. Ein Bereich mit der Fire-URL und dem Token für diese Aufgabe wird angezeigt.

3. Kopieren Sie die URL und generieren Sie ein Token

Kopieren Sie die Fire-URL. Klicken Sie auf Token generieren und kopieren Sie das Token dann sofort aus dem Dialog Token generiert. Das Token wird einmal angezeigt und kann später nicht abgerufen werden. Speichern Sie es daher an einem sicheren Ort wie dem Secret Store Ihres Alerting-Tools.

Der API-Trigger wird wirksam, sobald Sie das Token generieren. Sie müssen nicht auf Änderungen speichern klicken, schließen Sie den Dialog also einfach, wenn Sie fertig sind.

4. Rufen Sie den Endpunkt auf

Senden Sie das Token im Header Authorization: Bearer, wenn Sie einen POST an die URL senden. Eine geplante Aufgabe auslösen zeigt ein vollständiges Beispiel.

Jede geplante Aufgabe hat ihr eigenes Token, das nur zum Auslösen dieser Aufgabe berechtigt. Um den API-Zugriff auszuschalten oder das Token zu rotieren, öffnen Sie erneut den Dialog Geplante Aufgabe bearbeiten der Aufgabe. Beide Steuerelemente befinden sich neben dem Token im Bereich des API-Triggers und wirken sofort:

• API-Zugriff ausschalten: Klicken Sie auf Token löschen, das Papierkorbsymbol neben Neu generieren. Dadurch wird der API-Trigger entfernt
• Token rotieren: Klicken Sie auf Neu generieren. Das vorherige Token funktioniert nicht mehr, und der Dialog Token generiert zeigt das neue einmal an

Eine geplante Aufgabe auslösen

Senden Sie eine POST-Anfrage an den /fire-Endpunkt mit dem Bearer-Token im Authorization-Header. Der Request-Body akzeptiert ein optionales text-Feld für ausführungsspezifischen Kontext wie einen Alert-Body oder ein fehlgeschlagenes Log, das der Aufgabe zusammen mit ihrem gespeicherten Prompt übergeben wird. Der Wert ist Freitext und wird nicht geparst: Wenn Sie JSON oder eine andere strukturierte Payload senden, erhält die Aufgabe sie als wörtliche Zeichenkette.

Der text-Wert erreicht die Routine nicht als bloße Nachricht. Er kommt in einem <routine-fire-payload>-Block an, der ihn als nicht vertrauenswürdige Daten kennzeichnet und Claude mitteilt, Anweisungen darin nicht zu befolgen, es sei denn, der eigene Prompt der Routine sagt es. Die gleiche Umhüllung gilt für Text, der mit Jetzt ausführen in der Web-UI bereitgestellt wird.

Das bedeutet, dass der gespeicherte Prompt einer Routine ausdrücklich zulassen muss, auf Fire-Text zu reagieren: Schreiben Sie den Prompt so, dass er die Payload explizit referenziert, zum Beispiel „Untersuche den im routine-fire-payload-Block beschriebenen Alert“, andernfalls behandelt die Routine den Text als inerten Kontext. Jeder, der das Bearer-Token besitzt, kann text senden. Der Wrapper sorgt daher dafür, dass Fire-Text von einem durchgesickerten Token als nicht vertrauenswürdige Daten gekennzeichnet ankommt statt als direkte Anweisungen an Ihre Routine.

Das folgende Beispiel löst eine geplante Aufgabe aus einer Shell aus. Die angezeigte Aufgaben-ID und das Token sind Platzhalter: Ersetzen Sie sie durch die URL und das Token, die Sie beim Hinzufügen des API-Triggers kopiert haben, andernfalls schlägt die Anfrage mit einem 401-Authentifizierungsfehler fehl:

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."}'

Eine erfolgreiche Anfrage gibt einen JSON-Body mit der neuen Sitzungs-ID und URL zurück:

{
  "type": "routine_fire",
  "claude_code_session_id": "session_01HJKLMNOPQRSTUVWXYZ",
  "claude_code_session_url": "https://claude.ai/code/session_01HJKLMNOPQRSTUVWXYZ"
}

Öffnen Sie die Sitzungs-URL in einem Browser, um die Ausführung in Echtzeit zu beobachten, Änderungen zu überprüfen oder die Konversation manuell fortzusetzen.

[!WARNING]

Der /fire-Endpunkt wird unter dem Beta-Header experimental-cc-routine-2026-04-01 ausgeliefert. Request- und Response-Formate, Rate-Limits und Token-Semantik können sich ändern, während sich die Funktion in der Research Preview befindet. Breaking Changes werden hinter neuen datierten Beta-Header-Versionen ausgeliefert, und die zwei neuesten vorherigen Header-Versionen funktionieren weiterhin, damit Aufrufer Zeit zur Migration haben.

API-Referenz

Für die vollständige API-Referenz, einschließlich aller Fehlerantworten, Validierungsregeln und Feldlimits, siehe Routine über API auslösen in der Claude Platform-Dokumentation.

Der /fire-Endpunkt ist nur für claude.ai-Benutzer verfügbar und nicht Teil der API-Oberfläche der Claude Platform.

GitHub-Trigger hinzufügen

Ein GitHub-Trigger startet automatisch eine neue Sitzung, wenn ein passendes Ereignis in einem verbundenen Repository auftritt. Claude Code verwendet Sitzungen nicht über Ereignisse hinweg wieder, daher erzeugen zwei PR-Updates zwei unabhängige Sitzungen.

[!NOTE]

GitHub-Webhook-Ereignisse unterliegen stündlichen Obergrenzen pro Aufgabe und pro Konto. Ereignisse über dem Limit werden verworfen, bis das Zeitfenster zurückgesetzt wird.

Die Claude GitHub App muss auf dem Repository installiert sein, das Sie abonnieren möchten, unabhängig davon, von welcher Oberfläche aus Sie den Trigger konfigurieren.

• Konfigurieren Sie GitHub-Trigger über die Web-UI, die Sie auffordert, die App zu installieren, wenn sie fehlt. Folgen Sie den folgenden Schritten, um einen Trigger im Web zu konfigurieren.
• Installieren Sie für die CLI zuerst die App von der GitHub App-Seite und bitten Sie dann Claude, einen GitHub-Trigger an eine vorhandene geplante Aufgabe anzuhängen, zum Beispiel /schedule add a GitHub trigger to my nightly review for pull requests opened in acme/webapp. Der CLI-Weg erfordert Claude Code v2.1.225 oder höher. Wenn Claude den Trigger hinzufügt, antwortet es mit einem Link zu der Aufgabe, die der Trigger auslöst.

1. Öffnen Sie die Aufgabe zur Bearbeitung

Gehen Sie zu claude.ai/code/routines, klicken Sie auf die geplante Aufgabe, öffnen Sie dann das Menü neben ihrem Namen und wählen Sie Bearbeiten. Der Dialog Geplante Aufgabe bearbeiten öffnet sich.

2. Fügen Sie einen GitHub-Ereignis-Trigger hinzu

Klicken Sie in der Zeile Trigger auf + und wählen Sie im sich öffnenden Menü GitHub-Ereignis aus.

[!NOTE]

Das Ausführen von /web-setup in der CLI gewährt Repository-Zugriff zum Klonen, installiert aber nicht die Claude GitHub App und aktiviert nicht die Webhook-Zustellung.

3. Konfigurieren Sie den Trigger

Ändern Sie bei Bedarf das Repository, wählen Sie ein Ereignis aus der Liste der unterstützten Ereignisse und fügen Sie optional Filter hinzu. Klicken Sie dann unten im Dialog auf Änderungen speichern, um den Trigger anzuwenden.

Unterstützte Ereignisse

Wählen Sie ein Ereignis aus einer der folgenden Kategorien. Innerhalb jeder Kategorie können Sie eine spezifische Aktion wie pull_request.opened auswählen oder auf alle Aktionen in der Kategorie reagieren.

Pull Requests filtern

Verwenden Sie Filter, um einzugrenzen, welche Pull Requests eine neue Sitzung starten. Alle Filterbedingungen müssen erfüllt sein, damit die geplante Aufgabe ausgelöst wird. Die verfügbaren Filterfelder sind:

Jeder Filter kombiniert ein Feld mit einem Operator: gleich, enthält, beginnt mit, ist einer von, ist keiner von oder passt auf Regex.

Der Operator matches regex prüft den gesamten Feldwert, nicht eine Teilzeichenkette darin. Um einen Titel zu finden, der hotfix enthält, schreiben Sie .*hotfix.*. Ohne die umgebenden .* passt der Filter nur auf einen Titel, der genau hotfix lautet, ohne etwas davor oder danach. Für wörtliches Substring-Matching ohne Regex-Syntax verwenden Sie stattdessen den Operator contains.

Ein paar Beispiel-Filterkombinationen:

• Auth-Modul-Review: Base-Branch main, Head-Branch enthält auth-provider. Sendet jeden PR, der die Authentifizierung betrifft, an einen spezialisierten Reviewer.
• Nur bereit für Review: Ist Entwurf ist false. Überspringt Entwürfe, sodass die Aufgabe nur ausgeführt wird, wenn der PR bereit für das Review ist.
• Label-gesteuerter Backport: Labels enthalten needs-backport. Löst eine Aufgabe zum Portieren in einen anderen Branch nur aus, wenn ein Maintainer den PR entsprechend kennzeichnet.

Geplante Aufgaben verwalten

Klicken Sie auf eine geplante Aufgabe in der Liste, um ihre Detailseite zu öffnen. Die Detailseite zeigt die Repositorys, Konnektoren, den Prompt, den Zeitplan, die API-Token und GitHub-Trigger der Aufgabe sowie eine Liste vergangener Ausführungen.

Ausführungen anzeigen und mit ihnen interagieren

Klicken Sie auf eine beliebige Ausführung, um sie als vollständige Sitzung zu öffnen. Von dort aus können Sie sehen, was Claude getan hat, Änderungen überprüfen, einen Pull Request erstellen oder die Konversation fortsetzen. Jede Ausführungssitzung funktioniert wie jede andere Sitzung: Verwenden Sie das Dropdown-Menü neben dem Sitzungstitel, um sie umzubenennen, zu archivieren oder zu löschen.

Unter Verlauf auf der Detailseite der Aufgabe endet die Zeile jeder abgeschlossenen Ausführung mit Fehler, wenn die Ausführung fehlgeschlagen ist, mit Abgebrochen, wenn sie abgebrochen wurde, und mit keinem der beiden Wörter, wenn sie erfolgreich war. Der Filter Status bezeichnet dieselben drei Ergebnisse als Fehlgeschlagen, Abgebrochen und Erfolgreich. Diese Ergebnisse geben an, wie die Sitzung geendet hat, nicht ob Claude die in Ihrem Prompt beschriebene Arbeit erledigt hat. Öffnen Sie daher die Ausführung und lesen Sie ihr Transkript, um zu sehen, was passiert ist.

• Erfolgreich: Die Sitzung endete, ohne dass Claude Code einen Fehler gemeldet hat. Blockierte Netzwerkanfragen, fehlende Konnektor-Tools und Arbeit, die Claude nicht abschließen konnte, erscheinen im Transkript statt in der Zeile
• Fehlgeschlagen: Die Sitzung wurde nicht normal beendet. Sie wurde beispielsweise unerwartet angehalten, endete mit einem Fehler oder wurde archiviert, bevor die Ausführung startete
• Abgebrochen: Die Ausführung ist nicht fehlgeschlagen, und ihre Sitzung wurde archiviert. Wenn Sie die Sitzung einer erfolgreichen Ausführung archivieren, ändert sich die Ausführung zu Abgebrochen. An der Aufgabe muss nichts geändert werden

Wenn unter Verlauf eine Warnung angezeigt wird, siehe Warnungen zu „The last run“.

Geplante Aufgaben bearbeiten und steuern

Auf der Detailseite können Sie:

• Auf Jetzt ausführen klicken, um eine Ausführung sofort zu starten, ohne auf die nächste geplante Zeit zu warten.
• Den Ein-/Aus-Schalter oben auf der Seite verwenden, um den Zeitplan zu pausieren oder fortzusetzen. Pausierte Aufgaben behalten ihre Konfiguration, werden aber nicht ausgeführt, bis Sie sie wieder einschalten.
• Das Menü neben dem Namen der Aufgabe öffnen und Bearbeiten auswählen, um den Namen, den Prompt, die Repositorys, die Umgebung, die Konnektoren oder einen der Trigger der Aufgabe zu ändern. Der Dialog Geplante Aufgabe bearbeiten öffnet sich mit demselben Layout wie der Erstellungsdialog. Um einen Trigger hinzuzufügen, klicken Sie in der Zeile Trigger auf +. Klicken Sie auf Änderungen speichern, um Ihre Änderungen anzuwenden. Aktionen für API-Token werden sofort wirksam, ohne Änderungen speichern.
• Dasselbe Menü öffnen und Löschen auswählen, um die Aufgabe zu löschen.

Geplante Aufgaben über die CLI verwalten

Führen Sie /schedule list aus, um Ihre geplanten Aufgaben anzuzeigen, /schedule update, um eine zu ändern, oder /schedule run, um eine sofort zu starten.

Sie können auch nach dem Ausführungsverlauf einer geplanten Aufgabe fragen, zum Beispiel /schedule why did my nightly review do nothing this morning?. Claude listet die letzten Ausführungen der Aufgabe mit ihrem Status und einem Link zum Öffnen jeder Ausführung im Web auf. Außerdem liest Claude das Log einer Ausführung, um zu erklären, was passiert ist, einschließlich Tool-Fehlern, verweigerten Berechtigungen und des Endergebnisses. Erfordert Claude Code v2.1.227 oder höher.

Repositorys und Branch-Berechtigungen

Geplante Aufgaben benötigen GitHub-Zugriff zum Klonen von Repositorys. Wenn Sie eine geplante Aufgabe in der CLI mit /schedule erstellen, prüft Claude, ob Ihr Konto GitHub-Zugriff auf das Repository hat, aus dem Sie den Befehl ausgeführt haben. Falls nicht, fügt Claude einen Setup-Hinweis hinzu, der beschreibt, wie Sie den Zugriff gewähren.

[!NOTE]

Siehe GitHub-Authentifizierungsoptionen für die zwei Möglichkeiten, Zugriff zu gewähren. In Team- und Enterprise-Plänen muss ein Owner Ihrer Claude-Organisation jede Methode aktivieren, bevor Sie sie verwenden können; siehe GitHub verbinden.

Wenn Ihre GitHub-Verbindung fehlt oder abgelaufen ist, wenn eine Ausführung fällig ist, überspringt die geplante Aufgabe Ausführungen für bis zu 72 Stunden, bis Sie die Verbindung wiederherstellen. Verbinden Sie GitHub innerhalb dieses Zeitfensters erneut, und die Aufgabe wird automatisch fortgesetzt. Nach 72 Stunden ohne Verbindung wird die Aufgabe deaktiviert, und Sie schalten sie wieder ein, nachdem Sie GitHub erneut verbunden haben.

Jedes Repository, das Sie hinzufügen, wird bei jeder Ausführung geklont. Claude startet vom Standard-Branch des Repositorys, es sei denn, Ihr Prompt gibt etwas anderes an. Wenn ein GitHub-Pull-Request-Ereignis die Ausführung auslöst und das Repository des Pull Requests das erste Repository der Aufgabe ist, startet dieses Repository stattdessen vom Head-Commit des Pull Requests.

Claude pusht seine Arbeit in einen Branch mit dem Präfix claude/, es sei denn, Ihr Prompt weist Claude an, in einen anderen Branch zu pushen. Um zu steuern, in welche Branches eine Ausführung pushen kann, verwenden Sie Branch-Schutzregeln oder Rulesets auf GitHub. Bei Ausführungen auf von Anthropic verwalteter Infrastruktur und bei selbst gehosteten Ausführungen, die über den Git-Proxy von Anthropic pushen, wendet GitHub diese Regeln auf den von Ihnen verbundenen GitHub-Zugriff an, sodass eine Regel, die dieser Zugriff umgehen kann, den Push einer Ausführung nicht blockiert. Eine selbst gehostete Ausführung, die mit den Git-Anmeldedaten pusht, die Ihre Bereitstellung zur Verfügung stellt, wird stattdessen anhand dieser Anmeldedaten geprüft. Siehe Git konfigurieren.

Konnektoren

Geplante Aufgaben können Ihre verbundenen MCP-Konnektoren verwenden, um während jeder Ausführung aus externen Diensten zu lesen und in sie zu schreiben. Beispielsweise könnte eine Aufgabe, die Support-Anfragen triagiert, aus einem Slack-Channel lesen und Issues in Linear erstellen.

Konnektoren sind die claude.ai-Integrationen in Ihrem Konto. MCP-Server, die Sie lokal in der CLI mit claude mcp add hinzugefügt haben, werden auf Ihrem Computer gespeichert statt in Ihrem claude.ai-Konto, daher erscheinen sie nicht in der Konnektorenliste. Um einen dieser Server in einer geplanten Aufgabe zu verwenden:

• Als Konnektor: Fügen Sie ihn als Konnektor unter claude.ai/customize/connectors hinzu
• Im Repository: Bei einer geplanten Aufgabe mit einem einzigen Repository können Sie den Server stattdessen in einer committeten .mcp.json deklarieren, es sei denn, die Aufgabe wird als Threads in einem Projekt ausgeführt. In diesem Fall fügen Sie den Server als Konnektor hinzu.

Wenn Sie eine geplante Aufgabe erstellen, sind alle Ihre derzeit verbundenen Konnektoren standardmäßig enthalten. Entfernen Sie alle, die nicht benötigt werden, um zu begrenzen, auf welche Tools Claude während der Ausführung Zugriff hat. Sie können Konnektoren auch direkt im Erstellungs- oder Bearbeitungsdialog der Aufgabe hinzufügen.

Um Konnektoren außerhalb dieses Dialogs zu verwalten oder hinzuzufügen, besuchen Sie claude.ai/customize/connectors oder verwenden Sie /schedule update in der CLI.

Berechtigungsabfragen während einer Ausführung

[!NOTE]

Für eine Aufgabe, die in der selbst gehosteten Umgebung Ihrer Organisation ausgeführt wird, siehe Berechtigungen und Tool-Genehmigung.

Wenn eine Ausführung eine neue Sitzung in der Cloud von Anthropic startet, beginnt diese Sitzung im Auto-Modus, sofern der Auto-Modus verfügbar ist. Im Auto-Modus erlaubt oder blockiert ein Klassifikatormodell Aktionen, die sonst auf Ihre Genehmigung warten würden.

Eine Ausführung hält dennoch an und wartet auf eine Antwort, etwa in folgenden Fällen:

• Aktionen, die selbst im Auto-Modus nachfragen: zum Beispiel eine Aktion, die einer Ask-Regel entspricht. Siehe Wie der Auto-Modus Aktionen bewertet
• Wiederholte Blockierungen: Eine einzelne Blockierung beendet die Ausführung nicht. Sobald Blockierungen die Schwellenwerte für wiederholte Blockierungen des Auto-Modus erreichen, erscheint eine Berechtigungsabfrage in der Sitzung der Ausführung und wartet, bis jemand sie beantwortet

Wenn der Auto-Modus nicht verfügbar ist, etwa weil Ihre Organisation ihn deaktiviert hat oder das Modell der Aufgabe ihn nicht unterstützt, behält die Ausführung den Berechtigungsmodus bei, in dem sie gestartet wurde. Um eine wartende Abfrage zu beantworten, öffnen Sie die Ausführung über die Detailseite der Aufgabe.

In einem Projekt kann eine Ausführung einen Thread fortsetzen, statt eine neue Sitzung zu starten. Diese Ausführung behält den Berechtigungsmodus bei, in dem sich der Thread zu diesem Zeitpunkt befindet. Als dieser Thread erstellt wurde, begann er im Auto-Modus, sofern der Auto-Modus verfügbar war. Um eine Abfrage zu beantworten, die in diesem Thread wartet, siehe Einen Thread entsperren, der auf Genehmigung wartet.

Wenn eine Ausführung ein Artefakt ohne Nachfrage veröffentlicht

Während einer Ausführung im Auto-Modus veröffentlicht Claude ein Artefakt ohne Nachfrage, sobald der Klassifikator die Veröffentlichung zulässt. Sie werden dennoch zuerst gefragt, wenn die Veröffentlichung beispielsweise einer Ask-Regel entspricht. Ein neues Artefakt ist nur für Sie sichtbar, bis Sie es teilen. Die nachfolgenden Regeln für den Accept-edits-Modus gelten im Auto-Modus nicht.

Wenn die Aufgabe einer geplanten Aufgabe darin besteht, eine Seite aktuell zu halten, geben Sie ihr ein Artefakt, das Sie bereits veröffentlicht haben.

Artefakte im Accept-edits-Modus

Wenn der Zeitplan einer geplanten Aufgabe oder Jetzt ausführen eine Ausführung startet, kann Claude ein neues Artefakt veröffentlichen, ohne nachzufragen. Das neue Artefakt ist nur für Sie sichtbar, bis Sie es teilen. Wenn die Veröffentlichung Laufzeitfähigkeiten für die Seite deklariert, etwa Konnektor-Aufrufe oder Datei-Downloads, fragt Claude zuerst nach.

Bei diesen Ausführungen veröffentlicht Claude ein vorhandenes Artefakt nur dann ohne Nachfrage erneut, wenn alle folgenden Bedingungen erfüllt sind:

• Sie können das Artefakt bearbeiten, und es gehört zu Ihrer eigenen Organisation
• Wenn die Veröffentlichung mehr als die Seite umfasst, etwa unterstützende Dateien, sind Sie Eigentümer des Artefakts
• Das Artefakt ist nicht öffentlich geteilt
• Wenn das Artefakt mit bestimmten Personen oder Ihrer Organisation geteilt ist, sehen seine Betrachter nicht automatisch jede neue Version
• Die Veröffentlichung erzwingt kein Überschreiben einer neueren Version
• Die Veröffentlichung deklariert keine Laufzeitfähigkeiten für die Seite
• Die vorhandene Seite besitzt keine Freigabe, die über die Seite hinausreicht, etwa Konnektor-Aufrufe

In allen anderen Fällen, einschließlich einer Ausführung, die ein API- oder GitHub-Trigger startet, fragt Claude zuerst nach.

Umgebungen und Netzwerkzugriff

Jede geplante Aufgabe verwendet eine Cloud-Umgebung, die Netzwerkzugriff, Umgebungsvariablen und Setup-Skripte steuert. Die Aufgabe übernimmt bei jeder Ausführung die Netzwerkrichtlinie der Umgebung.

Die Standard-Umgebung verwendet Vertrauenswürdigen Netzwerkzugriff, der über das Netzwerk der Sitzung nur die Standard-Allowlist zulässt. Anfragen auf diesem Weg an Hosts außerhalb der Allowlist schlagen mit 403 und x-deny-reason: host_not_allowed fehl. Der Datenverkehr von MCP-Konnektoren wird über die Server von Anthropic statt über diesen Weg geleitet, daher funktionieren die Konnektoren, die Sie der Aufgabe hinzufügen, ohne dass Sie ihre Hosts zu Zulässige Domains hinzufügen müssen. Entfernen Sie alle Konnektoren, die Sie nicht benötigen, unter Konnektoren.

Um zusätzliche Domains in einer Ihrer eigenen Umgebungen zuzulassen, führen Sie diese Schritte aus. Eine organisationsweit geteilte Umgebung wird hier schreibgeschützt geöffnet, daher ändert ein Owner ihren Netzwerkzugriff stattdessen auf der Seite Cloud-Umgebungen in den Admin-Einstellungen.

1. Öffnen Sie die Aufgabe zur Bearbeitung

Gehen Sie zu claude.ai/code/routines, klicken Sie auf die geplante Aufgabe, öffnen Sie dann das Menü neben ihrem Namen und wählen Sie Bearbeiten. Der Dialog Geplante Aufgabe bearbeiten öffnet sich.

2. Öffnen Sie die Umgebungsauswahl

Gehen Sie zu Erweiterte Einstellungen > Allgemein > Cloud-Umgebung und klappen Sie zuvor Erweiterte Einstellungen auf, falls der Bereich eingeklappt ist. Klicken Sie auf das Cloud-Symbol mit dem Namen Ihrer Umgebung, z. B. Standard.

3. Öffnen Sie die Umgebungseinstellungen

Bewegen Sie den Mauszeiger über die Umgebung in der Liste und klicken Sie auf das Einstellungssymbol, das auf der rechten Seite angezeigt wird.

4. Ändern Sie die Stufe des Netzwerkzugriffs

Ändern Sie im Dialog Cloud-Umgebung bearbeiten den Netzwerkzugriff auf Benutzerdefiniert und geben Sie Ihre Domains unter Zulässige Domains ein. Aktivieren Sie Auch Standardliste gängiger Paketmanager einschließen, um die Standard-Allowlist neben Ihren benutzerdefinierten Domains beizubehalten. Wählen Sie stattdessen Vollständig für uneingeschränkten Zugriff.

5. Speichern

Klicken Sie im Dialog Cloud-Umgebung bearbeiten auf Änderungen speichern und schließen Sie dann den dahinterliegenden Dialog Geplante Aufgabe bearbeiten. Die neue Richtlinie gilt ab der nächsten Ausführung.

Siehe Netzwerkzugriff für Details zu Zugriffsstufen und zur Standard-Allowlist.

Nutzung und Limits

Geplante Aufgaben verbrauchen Abonnement-Nutzung auf die gleiche Weise wie interaktive Sitzungen. Ihren aktuellen Verbrauch sehen Sie unter claude.ai/settings/usage.

Unabhängig von der Abonnement-Nutzung hat jede Methode zum Starten einer Ausführung ein stündliches Limit:

Für keines dieser stündlichen Limits gibt es eine Überschreitungsoption.

Wenn eine geplante Aufgabe Ihr Abonnement-Nutzungslimit erreicht, können Organisationen mit aktiviertem Nutzungsguthaben geplante Aufgaben über abgerechnete Mehrnutzung weiter ausführen. Ohne Nutzungsguthaben werden weitere Ausführungen abgelehnt, bis Ihr Nutzungsfenster zurückgesetzt wird. Aktivieren Sie Nutzungsguthaben unter claude.ai/settings/usage. In Team- und Enterprise-Plänen aktiviert ein Admin es für die Organisation unter claude.ai/admin-settings/usage.

Während Ihr Abonnement pausiert ist, werden Ihre geplanten Aufgaben angehalten und nicht ausgeführt. Sobald Ihr Abonnement wieder aktiv ist, schalten Sie sie wieder ein.

Wo der Name Routinen weiterhin erscheint

Geplante Aufgaben hießen früher Routinen (routines), und an den folgenden Stellen wird der frühere Name beibehalten. Jede davon bezieht sich auf dieselbe Funktion:

• App: In einigen Konten lauten der Eintrag in der Seitenleiste und der Seitentitel Routines, die Schaltfläche lautet New routine, und andere Beschriftungen verwenden routine. Informationen zum Erstellen einer Aufgabe dort finden Sie unter Ganzseitiges Formular.
• Webadresse: claude.ai/code/routines
• CLI: der Alias /routines für /schedule, die Beschreibung des Befehls und Claudes Antworten, während es eine Aufgabe einrichtet
• API: der Pfad des /fire-Endpunkts, sein Beta-Header, das Feld type seiner Antwort, das Tag <routine-fire-payload> und die Referenzseite Routine über API auslösen
• Organisationseinstellungen: der Schalter Scheduled tasks (Was Routines)

Fehlerbehebung

/schedule zeigt "Unknown command" an

Die CLI blendet /schedule aus, wenn eine ihrer Voraussetzungen nicht erfüllt ist: Das Befehlsmenü zeigt während der Eingabe No commands match "/schedule" an. Das Absenden gibt Unknown command: /schedule zurück, außer in den folgenden Fällen, in denen eine andere Antwort angegeben ist.

Die Ursache ist in der Regel eine der folgenden:

• Sie sind mit einem Console-API-Schlüssel, einem Anthropic-Profil oder Federation-Anmeldedaten oder über einen Cloud-Anbieter wie Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry authentifiziert. /schedule erfordert eine Anmeldung mit einem claude.ai-Abonnement. Mit einem Console-API-Schlüssel oder einem Profil und aktiviertem Abrufen von Feature-Flags zeigt das Absenden von /schedule stattdessen /schedule is available with Claude for Enterprise — ask your admin about migrating from API-key access an. Mit einer Cloud-Anbieter-Anmeldung sehen Sie weiterhin Unknown command: /schedule. Wenn ANTHROPIC_API_KEY oder ANTHROPIC_AUTH_TOKEN in Ihrer Shell oder apiKeyHelper in settings.json gesetzt ist, entfernen Sie diese Einstellung zuerst, da sie Vorrang vor einer claude.ai-Anmeldung hat. Ein Profil oder Federation-Anmeldedaten haben ebenfalls Vorrang, schalten Sie diese daher ebenfalls aus
• Sie sind vollständig abgemeldet, ohne API-Schlüssel oder andere Anmeldedaten. Mit aktiviertem Abrufen von Feature-Flags zeigt das Absenden von /schedule /schedule requires a claude.ai subscription. Run /login to sign in with your claude.ai account. an Vor v2.1.268 zeigte eine abgemeldete Sitzung dieselbe Claude for Enterprise-Nachricht wie bei einem Console-API-Schlüssel
• Sie befinden sich in einer Cloud-Sitzung, in der das Absenden von /schedule mit dem Hinweis beantwortet wird, dass der Befehl in dieser Umgebung nicht verfügbar ist. Verwalten Sie geplante Aufgaben stattdessen über die Web-UI
• Die Richtlinie Ihrer Organisation deaktiviert Cloud-Sitzungen, die für geplante Aufgaben erforderlich sind. In diesem Fall antwortet das Absenden von /schedule stattdessen mit Cloud sessions are disabled by your organization's policy. Vor v2.1.268 gab es Unknown command: /schedule zurück
• Ein Owner hat für Ihre Team- oder Enterprise-Organisation geplante Aufgaben deaktiviert. Vor v2.1.227 erschien der Befehl in diesem Fall weiterhin, und claude.ai lehnte die Aufgabe ab, wenn Claude versuchte, sie zu erstellen oder auszuführen
• Ihre Enterprise-Organisation verwaltet Ihren Zugriff mit benutzerdefinierten Rollen, und keine Ihrer Rollen enthält die Berechtigung für geplante Aufgaben unter Remote sessions. Bitten Sie einen Owner, sie einer Ihrer Rollen hinzuzufügen

Wenn die Ursache Ihre CLI-Anmeldung ist oder Sie sich in einer Cloud-Sitzung befinden, können Sie geplante Aufgaben weiterhin unter claude.ai/code/routines erstellen und verwalten. Dafür benötigen Sie dort ein Pro-, Max-, Team- oder Enterprise-Konto. Wenn geplante Aufgaben oder Cloud-Sitzungen für Ihre Organisation deaktiviert sind oder in Ihren Rollen fehlen, können Sie sie auch im Web nicht erstellen.

"Routines are disabled by your organization's policy"

Ein Owner in Ihrer Team- oder Enterprise-Organisation hat wahrscheinlich den Schalter Scheduled tasks (Was Routines) unter Organization settings > Capabilities > Remote sessions ausgeschaltet. In Claude Code v2.1.227 oder höher blendet derselbe Schalter auch /schedule in der CLI aus. Dies ist eine serverseitige Organisationseinstellung, daher kann sie nicht über Ihre lokale Konfiguration überschrieben werden. Bitten Sie einen Owner, geplante Aufgaben für Ihre Organisation wieder zu aktivieren.

Warnungen "The last run"

Wenn eine Warnung unter History mit "The last run" beginnt, suchen Sie sie in der ersten Spalte und gehen Sie wie in der zugehörigen Zeile beschrieben vor. Die Warnung verschwindet, sobald ein späterer Lauf startet.

Verwandte Ressourcen

• /loop und Planung innerhalb einer Sitzung: Planen Sie lokale Aufgaben innerhalb einer offenen CLI-Sitzung
• Geplante Aufgaben in der Desktop-App: Lokale geplante Aufgaben, die auf Ihrem Computer mit Zugriff auf lokale Dateien ausgeführt werden
• Cloud-Umgebungen: Konfigurieren Sie Netzwerkzugriff, Umgebungsvariablen und Setup-Skripte für Cloud-Sitzungen
• Projekte: Laufende Arbeit, die Claude über parallele Cloud-Sitzungen koordiniert; aus einem Projekt erstellte geplante Aufgaben erscheinen auf dessen Registerkarte Geplante Aufgaben
• MCP-Konnektoren: Verbinden Sie externe Dienste wie Slack, Linear und Google Drive
• GitHub Actions: Führen Sie Claude in Ihrer CI-Pipeline bei Repository-Ereignissen aus