- Geplant: Ausführung nach einem wiederkehrenden Zeitplan wie stündlich, nächtlich oder wöchentlich
- API: Auslösung auf Anforderung durch Senden eines HTTP POST an einen Routine-spezifischen Endpunkt mit einem Bearer-Token
- GitHub: Automatische Ausführung als Reaktion auf Repository-Ereignisse wie Pull Requests oder Releases
/schedule.
Diese Seite behandelt das Erstellen einer Routine, das Konfigurieren jedes Trigger-Typs, das Verwalten von Ausführungen und wie Nutzungslimits angewendet werden.
Beispiel-Anwendungsfälle
Jedes Beispiel kombiniert einen Trigger-Typ mit der Art von Arbeit, für die Routinen geeignet sind: unbeaufsichtigt, wiederholbar und an ein klares Ergebnis gebunden. Backlog-Wartung. Ein Schedule-Trigger wird jede Wochnacht gegen Ihren Issue-Tracker über einen Konnektor ausgeführt. Die Routine liest seit der letzten Ausführung geöffnete Issues, wendet Labels an, weist Besitzer basierend auf dem referenzierten Code-Bereich zu und postet eine Zusammenfassung an Slack, damit das Team den Tag mit einer gepflegten Warteschlange beginnt. Alert-Triage. Ihr Monitoring-Tool ruft den API-Endpunkt der Routine auf, wenn ein Error-Schwellenwert überschritten wird, und übergibt den Alert-Body alstext. Die Routine zieht den Stack Trace, korreliert ihn mit kürzlichen Commits im Repository und öffnet einen Draft-Pull-Request mit einem vorgeschlagenen Fix und einem Link zurück zum Alert. Der On-Call-Mitarbeiter überprüft den PR, anstatt von einem leeren Terminal zu beginnen.
Benutzerdefinierte Code-Review. Ein GitHub-Trigger wird auf pull_request.opened ausgeführt. Die Routine wendet die eigene Review-Checkliste Ihres Teams an, hinterlässt Inline-Kommentare zu Sicherheits-, Performance- und Style-Problemen und fügt einen Zusammenfassungskommentar hinzu, damit sich menschliche Reviewer auf Design statt auf mechanische Überprüfungen konzentrieren können.
Deploy-Verifizierung. Ihre CD-Pipeline ruft den API-Endpunkt der Routine nach jedem Production-Deploy auf. Die Routine führt Smoke-Tests gegen den neuen Build durch, scannt Error-Logs auf Regressionen und postet ein Go oder No-Go zum Release-Channel, bevor das Deploy-Fenster schließt.
Dokumentations-Drift. Ein Schedule-Trigger wird wöchentlich ausgeführt. Die Routine scannt seit der letzten Ausführung zusammengeführte PRs, kennzeichnet Dokumentation, die auf geänderte APIs verweist, und öffnet Update-PRs gegen das Dokumentations-Repository zur Überprüfung durch einen Editor.
Library-Port. Ein GitHub-Trigger wird auf pull_request.closed ausgeführt, gefiltert auf zusammengeführte PRs in einem SDK-Repository. Die Routine portiert die Änderung zu einem parallelen SDK in einer anderen Sprache und öffnet einen entsprechenden PR, um die beiden Bibliotheken synchron zu halten, ohne dass ein Mensch jede Änderung neu implementiert.
Die folgenden Abschnitte führen Sie durch das Erstellen einer Routine und das Konfigurieren jedes dieser Trigger-Typen.
Erstellen Sie eine Routine
Erstellen Sie eine Routine aus dem Web, der Desktop-App oder der CLI. Alle drei Oberflächen schreiben auf dasselbe Cloud-Konto, sodass eine Routine, die Sie in der CLI erstellen, sofort unter claude.ai/code/routines angezeigt wird. Klicken Sie in der Desktop-App auf Neue Aufgabe und wählen Sie Neue Remote-Aufgabe; wenn Sie stattdessen Neue lokale Aufgabe wählen, wird eine lokale Desktop-geplante Aufgabe erstellt, die auf Ihrem Computer ausgeführt wird und keine Routine ist. Das Erstellungsformular richtet den Prompt der Routine, Repositories, Umgebung, Konnektoren und Trigger ein. Routinen werden autonom als vollständige Claude Code-Cloud-Sitzungen ausgeführt: Es gibt keinen Berechtigungsmodus-Picker und keine Genehmigungsaufforderungen während einer Ausführung. Die Sitzung kann Shell-Befehle ausführen, Skills verwenden, die im geklonten Repository committed sind, und alle Konnektoren aufrufen, die Sie einbeziehen. Was eine Routine erreichen kann, wird durch die Repositories bestimmt, die Sie auswählen, und deren Branch-Push-Einstellung, den Netzwerkzugriff und die Variablen der Umgebung und die Konnektoren, die Sie einbeziehen. Beschränken Sie jeden dieser Punkte auf das, was die Routine tatsächlich benötigt. Routinen gehören zu Ihrem individuellen claude.ai-Konto. Sie werden nicht mit Teamkollegen geteilt und zählen gegen die tägliche Ausführungszulage Ihres Kontos. Alles, was eine Routine durch Ihre verbundene GitHub-Identität oder Konnektoren tut, erscheint als Sie: 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.Erstellen aus dem Web
Öffnen Sie das Erstellungsformular
Benennen Sie die Routine und schreiben Sie den Prompt
Wählen Sie Repositories aus
claude/-prefixierte Branches für seine Änderungen. Um Pushes zu jedem Branch zu ermöglichen, aktivieren Sie Uneingeschränkte Branch-Pushes zulassen für dieses Repository.Wählen Sie eine Umgebung aus
- Netzwerkzugriff: Legen Sie die Stufe des Internet-Zugriffs fest, der während jeder Ausführung verfügbar ist
- Umgebungsvariablen: Stellen Sie API-Schlüssel, Tokens oder andere Geheimnisse bereit, die Claude verwenden kann
- Setup-Skript: Installieren Sie Abhängigkeiten und Tools, die die Routine benötigt. Das Ergebnis wird zwischengespeichert, sodass das Skript nicht bei jeder Sitzung erneut ausgeführt wird
Wählen Sie einen Trigger aus
- Zeitplan
- GitHub-Ereignis
- API
Überprüfen Sie Konnektoren
Erstellen Sie die Routine
Erstellen aus der CLI
Führen Sie/schedule in einer beliebigen Sitzung aus, um eine geplante Routine im Gespräch zu erstellen. Sie können auch eine Beschreibung direkt übergeben, wie in /schedule daily PR review at 9am. Claude führt Sie durch die gleichen Informationen, die das Web-Formular sammelt, und speichert dann die Routine in Ihrem Konto.
/schedule in der CLI erstellt nur geplante Routinen. Um einen API- oder GitHub-Trigger hinzuzufügen, bearbeiten Sie die Routine im Web unter claude.ai/code/routines.
Die CLI unterstützt auch die Verwaltung vorhandener Routinen. Führen Sie /schedule list aus, um alle Routinen anzuzeigen, /schedule update, um eine zu ändern, oder /schedule run, um sie sofort auszulösen.
Erstellen aus der Desktop-App
Öffnen Sie die Schedule-Seite in der Desktop-App, klicken Sie auf Neue Aufgabe und wählen Sie Neue Remote-Aufgabe. Die Desktop-App zeigt sowohl lokale geplante Aufgaben als auch Routinen im gleichen Raster an. Siehe Desktop-geplante Aufgaben für Details zur lokalen Option.Konfigurieren Sie Trigger
Eine Routine startet, wenn einer ihrer Trigger passt. Sie können jede Kombination von Schedule-, API- und GitHub-Triggern an die gleiche Routine anhängen und sie jederzeit aus dem Abschnitt Trigger auswählen des Bearbeitungsformulars der Routine hinzufügen oder entfernen.Zeitplan-Trigger hinzufügen
Ein Schedule-Trigger führt die Routine nach einem wiederkehrenden Zeitplan aus. Wählen Sie eine voreingestellte Häufigkeit im Abschnitt Trigger auswählen: stündlich, täglich, Wochentage oder wöchentlich. Zeiten werden in Ihrer lokalen Zone eingegeben und automatisch konvertiert, sodass die Routine zu dieser Wanduhr-Zeit unabhängig davon ausgeführt wird, wo sich die Cloud-Infrastruktur befindet. Ausführungen können aufgrund von Staffelung einige Minuten nach der geplanten Zeit beginnen. Der Offset ist für jede Routine konsistent. Für ein benutzerdefiniertes Intervall wie alle zwei Stunden oder den ersten jedes Monats wählen Sie die nächste Voreinstellung im Formular aus und führen dann/schedule update in der CLI aus, um einen spezifischen Cron-Ausdruck festzulegen. Das Mindestintervall beträgt eine Stunde; Ausdrücke, die häufiger ausgeführt werden, werden abgelehnt.
API-Trigger hinzufügen
Ein API-Trigger gibt einer Routine einen dedizierten HTTP-Endpunkt. Das Posten zum Endpunkt mit dem Bearer-Token der Routine 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. API-Trigger werden einer vorhandenen Routine aus dem Web hinzugefügt. Die CLI kann derzeit keine Tokens erstellen oder widerrufen.Öffnen Sie die Routine zur Bearbeitung
Fügen Sie einen API-Trigger hinzu
Kopieren Sie die URL und generieren Sie einen Token
Rufen Sie den Endpunkt auf
Authorization: Bearer-Header, wenn Sie zur URL posten. Der Abschnitt Routine auslösen unten zeigt ein vollständiges Beispiel.Routine 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ührungs-spezifischen Kontext wie einen Alert-Body oder ein fehlgeschlagenes Log, das der Routine zusammen mit ihrem gespeicherten Prompt übergeben wird. Der Wert ist freier Text und wird nicht geparst: Wenn Sie JSON oder eine andere strukturierte Payload senden, erhält die Routine sie als wörtliche Zeichenkette.
Das Beispiel unten löst eine Routine aus einer Shell aus:
API-Referenz
Für die vollständige API-Referenz, einschließlich aller Error-Responses, 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 ist nicht Teil der Claude Platform API-Oberfläche.
GitHub-Trigger hinzufügen
Ein GitHub-Trigger startet automatisch eine neue Sitzung, wenn ein passendes Ereignis in einem verbundenen Repository auftritt. Jedes passende Ereignis startet seine eigene Sitzung.Öffnen Sie die Routine zur Bearbeitung
Fügen Sie einen GitHub-Ereignis-Trigger hinzu
Installieren Sie die Claude GitHub App
/web-setup in der CLI gewährt Repository-Zugriff zum Klonen, installiert aber nicht die Claude GitHub App und aktiviert nicht die Webhook-Bereitstellung. GitHub-Trigger erfordern die Installation der Claude GitHub App, die das Trigger-Setup Sie auffordert zu tun.Konfigurieren Sie den Trigger
Unterstützte Ereignisse
GitHub-Trigger können sich auf eine der folgenden Ereigniskategorien abonnieren. Innerhalb jeder Kategorie können Sie eine spezifische Aktion wiepull_request.opened auswählen oder auf alle Aktionen in der Kategorie reagieren.
| Ereignis | Wird ausgelöst, wenn |
|---|---|
| Pull Request | Ein PR wird geöffnet, geschlossen, zugewiesen, gekennzeichnet, synchronisiert oder anderweitig aktualisiert |
| Release | Ein Release wird erstellt, veröffentlicht, bearbeitet oder gelöscht |
Pull Requests filtern
Verwenden Sie Filter, um einzugrenzen, welche Pull Requests eine neue Sitzung starten. Alle Filterbedingungen müssen übereinstimmen, damit die Routine ausgelöst wird. Die verfügbaren Filterfelder sind:| Filter | Passt auf |
|---|---|
| Autor | GitHub-Benutzername des PR-Autors |
| Titel | PR-Titeltext |
| Body | PR-Beschreibungstext |
| Base-Branch | Branch, auf den der PR abzielt |
| Head-Branch | Branch, von dem der PR kommt |
| Labels | Auf den PR angewendete Labels |
| Ist Entwurf | Ob der PR im Entwurfszustand ist |
| Ist zusammengeführt | Ob der PR zusammengeführt wurde |
| Aus Fork | Ob der PR aus einem Fork kommt |
matches regex testet 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 ist, 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ältauth-provider. Sendet jeden PR, der Authentifizierung berührt, an einen fokussierten Reviewer. - Externe Mitwirkende Triage: Aus Fork ist
true. Leitet jeden Fork-basierten PR durch eine zusätzliche Sicherheits- und Style-Review, bevor ein Mensch ihn ansieht. - Nur bereit zur Überprüfung: Ist Entwurf ist
false. Überspringt Entwürfe, sodass die Routine nur ausgeführt wird, wenn der PR zur Überprüfung bereit ist. - Label-gesteuerter Backport: Labels enthalten
needs-backport. Löst eine Port-zu-anderem-Branch-Routine nur aus, wenn ein Maintainer den PR kennzeichnet.
Wie Sitzungen zu Ereignissen zugeordnet werden
Jedes passende GitHub-Ereignis startet eine neue Sitzung. Sitzungswiederverwendung über Ereignisse hinweg ist nicht für GitHub-ausgelöste Routinen verfügbar, daher produzieren zwei PR-Updates zwei unabhängige Sitzungen.Verwalten Sie Routinen
Klicken Sie auf eine Routine in der Liste, um ihre Detail-Seite zu öffnen. Die Detail-Seite zeigt die Repositories der Routine, Konnektoren, Prompt, Schedule, API-Tokens, GitHub-Trigger und eine Liste vergangener Ausführungen.Zeigen Sie Ausführungen an und interagieren Sie mit ihnen
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 das Gespräch fortsetzen. Jede Ausführungs-Sitzung funktioniert wie jede andere Sitzung: Verwenden Sie das Dropdown-Menü neben dem Sitzungstitel, um sie umzubenennen, zu archivieren oder zu löschen.Bearbeiten und steuern Sie Routinen
Von der Routine-Detail-Seite 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 Toggle im Abschnitt Wiederholt verwenden, um den Schedule zu pausieren oder fortzusetzen. Pausierte Routinen behalten ihre Konfiguration, werden aber nicht ausgeführt, bis Sie sie erneut aktivieren.
- Auf das Stiftsymbol klicken, um Routine bearbeiten zu öffnen und den Namen, Prompt, Repositories, Umgebung, Konnektoren oder einen der Trigger der Routine zu ändern. Der Abschnitt Trigger auswählen ist der Ort, an dem Sie Schedules, API-Tokens und GitHub-Ereignis-Trigger hinzufügen oder entfernen.
- Auf das Löschsymbol klicken, um die Routine zu entfernen. Vergangene Sitzungen, die von der Routine erstellt wurden, bleiben in Ihrer Sitzungsliste.
Repositories und Branch-Berechtigungen
Routinen benötigen GitHub-Zugriff zum Klonen von Repositories. Wenn Sie eine Routine aus der CLI mit/schedule erstellen, überprüft Claude, ob Ihr Konto GitHub verbunden hat, und fordert Sie auf, /web-setup auszuführen, falls nicht. Siehe GitHub-Authentifizierungsoptionen für die zwei Möglichkeiten, Zugriff zu gewähren.
Jedes Repository, das Sie hinzufügen, wird bei jeder Ausführung geklont. Claude startet vom Standard-Branch des Repositories, es sei denn, Ihr Prompt gibt etwas anderes an.
Standardmäßig kann Claude nur zu Branches mit dem Präfix claude/ pushen. Dies verhindert, dass Routinen versehentlich geschützte oder langlebige Branches ändern. Um diese Einschränkung für ein bestimmtes Repository zu entfernen, aktivieren Sie Uneingeschränkte Branch-Pushes zulassen für dieses Repository beim Erstellen oder Bearbeiten der Routine.
Konnektoren
Routinen können Ihre verbundenen MCP-Konnektoren verwenden, um während jeder Ausführung von externen Diensten zu lesen und zu schreiben. Beispielsweise könnte eine Routine, die Support-Anfragen triagiert, aus einem Slack-Channel lesen und Issues in Linear erstellen. Wenn Sie eine Routine 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 auch Konnektoren direkt aus dem Routine-Formular hinzufügen. Um Konnektoren außerhalb des Routine-Formulars zu verwalten oder hinzuzufügen, besuchen Sie Einstellungen > Konnektoren auf claude.ai oder verwenden Sie/schedule update in der CLI.
Umgebungen
Jede Routine wird in einer Cloud-Umgebung ausgeführt, die Netzwerkzugriff, Umgebungsvariablen und Setup-Skripte steuert. Konfigurieren Sie Umgebungen vor dem Erstellen einer Routine, um Claude Zugriff auf APIs zu geben, Abhängigkeiten zu installieren oder den Netzwerk-Umfang zu beschränken. Siehe Cloud-Umgebung für das vollständige Setup-Handbuch.Nutzung und Limits
Routinen verbrauchen Abonnement-Nutzung auf die gleiche Weise wie interaktive Sitzungen. Zusätzlich zu den Standard-Abonnement-Limits haben Routinen eine tägliche Obergrenze für die Anzahl der Ausführungen, die pro Konto starten können. Sehen Sie Ihren aktuellen Verbrauch und verbleibende tägliche Routine-Ausführungen unter claude.ai/code/routines oder claude.ai/settings/usage. Wenn eine Routine das tägliche Limit oder Ihr Abonnement-Nutzungslimit erreicht, können Organisationen mit aktivierter zusätzlicher Nutzung Routinen weiterhin auf gemessener Überschreitung ausführen. Ohne zusätzliche Nutzung werden weitere Ausführungen abgelehnt, bis sich das Fenster zurückgesetzt hat. Aktivieren Sie zusätzliche Nutzung unter Einstellungen > Abrechnung auf claude.ai.Verwandte Ressourcen
/loopund In-Session-Planung: Planen Sie lokale Aufgaben innerhalb einer offenen CLI-Sitzung- Desktop-geplante Aufgaben: Lokale geplante Aufgaben, die auf Ihrem Computer mit Zugriff auf lokale Dateien ausgeführt werden
- Cloud-Umgebung: Konfigurieren Sie die Laufzeitumgebung für Cloud-Sitzungen
- 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