Documentation Index
Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
Use this file to discover all available pages before exploring further.
- Geplant: Ausführung nach einem wiederkehrenden Zeitplan wie stündlich, nächtlich oder wöchentlich, oder einmalig zu einem bestimmten zukünftigen Zeitpunkt
- 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.
Team- und Enterprise-Administratoren können Routinen für alle Mitglieder mit dem Routinen-Toggle unter claude.ai/admin-settings/claude-code deaktivieren. Wenn deaktiviert, werden vorhandene Routinen nicht mehr ausgeführt und Mitglieder können keine neuen erstellen.
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 unter claude.ai/code/routines, aus der Desktop-App oder aus der CLI. Alle drei Oberflächen schreiben auf dasselbe Cloud-Konto, sodass eine Routine, die Sie in einer erstellen, sofort in den anderen angezeigt wird. Klicken Sie in der Desktop-App auf Routinen in der Seitenleiste und dann auf Neue Routine, und wählen Sie Remote; wenn Sie stattdessen Lokal wählen, wird eine Desktop-geplante Aufgabe erstellt, die auf Ihrem Computer ausgeführt wird, anstatt in der Cloud. 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.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 und Berechtigungen
claude/-prefixierten.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, für eine wiederkehrende Routine wie /schedule daily PR review at 9am oder eine einmalige wie /schedule clean up feature flag in one week. 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.
Trigger konfigurieren
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.Schedule-Trigger hinzufügen
Ein Schedule-Trigger führt die Routine nach einem wiederkehrenden Zeitplan oder einmalig zu einem bestimmten zukünftigen Zeitpunkt 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.
Einmalige Ausführung planen
Ein einmaliger Schedule-Trigger führt die Routine zu einem bestimmten Zeitstempel aus. Verwenden Sie ihn, um sich später in der Woche selbst zu erinnern, um einen Cleanup-PR nach Abschluss eines Rollouts zu öffnen, oder um eine Folgeaufgabe zu starten, wenn eine vorgelagerte Änderung ankommt. Nach der Ausführung der Routine wird sie automatisch deaktiviert und die Web-UI markiert sie als Ausgeführt. Um sie erneut auszuführen, bearbeiten Sie die Routine und legen Sie einen neuen einmaligen Zeitpunkt fest. Erstellen Sie eine einmalige Ausführung aus der CLI, indem Sie die Zeit in natürlicher Sprache beschreiben. Claude löst den Ausdruck gegen die aktuelle Zeit auf und bestätigt den absoluten Zeitstempel vor dem Speichern.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 |
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. - 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.Routinen verwalten
Klicken Sie auf eine Routine in der Liste, um ihre Detailseite zu öffnen. Die Detailseite zeigt die Repositories der Routine, Konnektoren, Prompt, Schedule, API-Tokens, GitHub-Trigger und 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 das Gespräch 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.Routinen bearbeiten und steuern
Von der Routine-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 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. Konnektoren sind die claude.ai-Integrationen auf Ihrem Konto. MCP-Server, die Sie lokal in der CLI mitclaude mcp add hinzugefügt haben, werden auf Ihrem Computer gespeichert, anstatt auf Ihrem claude.ai-Konto, daher werden sie nicht in der Konnektoren-Liste angezeigt. Um einen dieser Server in einer Routine zu verwenden, fügen Sie ihn als Konnektoren unter claude.ai/customize/connectors hinzu, oder deklarieren Sie ihn in einer committed .mcp.json, damit er Teil des geklonten Repositories ist.
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 und Netzwerkzugriff
Jede Routine wird in einer Cloud-Umgebung ausgeführt, die Netzwerkzugriff, Umgebungsvariablen und Setup-Skripte steuert. Die Routine erbt die Netzwerk-Richtlinie der Umgebung bei jeder Ausführung. Die Standard-Umgebung verwendet Vertrauenswürdigen Netzwerkzugriff: Die Standard-Zulassungsliste von Paket-Registries, Cloud-Provider-APIs, Container-Registries und häufigen Entwicklungs-Domains ist erreichbar, aber beliebige Domains sind nicht. Ausgehende Anfragen an andere Hosts schlagen mit403 und x-deny-reason: host_not_allowed fehl. MCP-Konnektoren-Datenverkehr wird über Anthropic-Server geleitet, daher funktionieren die Konnektoren, die Sie der Routine 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 zuzulassen:
Öffnen Sie die Routine zur Bearbeitung
Öffnen Sie die Umgebungsauswahl
Öffnen Sie die Umgebungseinstellungen
Ändern Sie die Netzwerkzugriff-Ebene
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. Einmalige Ausführungen werden nicht auf das tägliche Routine-Ausführungslimit angerechnet. Sie verbrauchen Ihre reguläre Abonnement-Nutzung wie jede andere Sitzung, sind aber von der täglichen Routine-Ausführungszulage pro Konto ausgenommen.Fehlerbehebung
’Routinen sind durch die Richtlinie Ihrer Organisation deaktiviert”
Ihr Team- oder Enterprise-Administrator hat wahrscheinlich den Routinen-Toggle unter claude.ai/admin-settings/claude-code ausgeschaltet. Dies ist eine serverseitige Organisationseinstellung, daher kann sie nicht aus Ihrer lokalen Konfiguration überschrieben werden. Kontaktieren Sie Ihren Administrator, um anzufordern, dass Routinen für Ihre Organisation aktiviert werden.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