SpyBara
Go Premium

routines.md 2026-09-18 23:58 UTC to 2026-09-19 23:57 UTC

This page contains 18 additions and 3 deletions.

2026
Wed 9 22:58 Fri 18 23:58 Sat 19 23:57

Automatisieren Sie Arbeitsabläufe mit Routinen

Setzen Sie Claude Code auf Autopilot. Definieren Sie Routinen, die nach einem Zeitplan ausgeführt werden, durch API-Aufrufe ausgelöst werden oder auf GitHub-Ereignisse von der Cloud-Infrastruktur reagieren.

Eine Routine ist eine gespeicherte Claude Code-Konfiguration: ein Prompt, ein oder mehrere Repositories und eine Reihe von Konnektoren, die einmal verpackt und automatisch ausgeführt werden. Routinen 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 Routine kann einen oder mehrere Trigger haben:

  • 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

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

Routinen sind auf Pro-, Max-, Team- und Enterprise-Plänen verfügbar. Erstellen und verwalten Sie sie unter claude.ai/code/routines oder über die CLI mit /schedule.

Team- und Enterprise-Inhaber 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 als text. 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.

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 der Registerkarte Code auf Routinen in der Seitenleiste oder im Menü Mehr der Seitenleiste und dann auf Neue Routine, und wählen Sie Cloud; 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 die Sitzung führt Shell-Befehle aus, verwendet Skills, die im geklonten Repository committed sind, und ruft alle Konnektoren auf, die Sie einbeziehen, alles ohne Unterbrechung für Genehmigung außer einigen Artefakt-Aktionen.

Was eine Routine erreichen kann, wird durch die Repositories bestimmt, die Sie auswählen, 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.

Wenn der Zeitplan der Routine oder Jetzt ausführen eine Ausführung startet, republiziert Claude ein vorhandenes Artefakt ohne Nachfrage nur, wenn alle diese Bedingungen erfüllt sind:

  • Sie können das Artefakt bearbeiten und es gehört zu Ihrer eigenen Organisation
  • Das Artefakt wird nicht öffentlich geteilt und nicht mit bestimmten Personen oder Ihrer Organisation geteilt, wobei die neueste Version als die Version ausgewählt ist, die Betrachter sehen
  • Die Veröffentlichung enthält nur die Seite, ohne unterstützende Dateien oder etwas anderes hinzugefügt, und erzwingt keine neuere Version
  • Die Seite enthält keine Berechtigung, die über die Seite hinausgeht, wie z. B. Konnektor-Aufrufe

In jedem anderen Fall, einschließlich der Veröffentlichung eines neuen Artefakts, fragt Claude zuerst. Wenn die Aufgabe einer Routine darin besteht, eine Seite aktuell zu halten, geben Sie ihr ein Artefakt, das Sie bereits veröffentlicht haben.

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

1

Öffnen Sie das Erstellungsformular

Besuchen Sie claude.ai/code/routines und klicken Sie auf Neue Routine.

2

Benennen Sie die Routine und schreiben Sie den Prompt

Geben Sie der Routine einen aussagekräftigen Namen und schreiben Sie den Prompt, den Claude jedes Mal ausführt. Der Prompt ist der wichtigste Teil: Die Routine 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 der Routine als zugewiesene Aufgabe und führt ihn aus, anstatt ihn als nicht vertrauenswürdigen Inhalt zu behandeln, der mitten in einem Gespräch angekommen ist. Der Trigger bestätigt nur, dass der Prompt vorher von einer autorisierten Sitzung auf Ihrem Konto gespeichert wurde, sodass der ausgelöste Prompt keine Live-Benutzereingabe ist und nicht als Genehmigung oder Zustimmung für Aktionen während der Ausführung fungieren kann. Inhalte, die die Sitzung während der Ausführung abruft, behalten ihre normale Behandlung. Vor v2.1.213 erhielt die Sitzung denselben Prompt als nicht vertrauenswürdige Hintergrundbenachrichtigung und konnte sich weigern, danach zu handeln.

Die Prompt-Eingabe enthält einen Modell-Selector. Claude verwendet das ausgewählte Modell bei jeder Ausführung.

3

Wählen Sie Repositories aus

Fügen Sie ein oder mehrere GitHub-Repositories hinzu, in denen Claude arbeiten kann. Jedes Repository wird zu Beginn einer Ausführung geklont, beginnend mit dem Standard-Branch. Claude erstellt claude/-prefixierte Branches für seine Änderungen.

4

Wählen Sie eine Umgebung aus

Wählen Sie eine Cloud-Umgebung für die Routine. Umgebungen steuern, worauf die Cloud-Sitzung Zugriff hat:

  • Netzwerkzugriff: Legen Sie die Stufe des Internet-Zugriffs 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, daher speichern Sie auf Pro- und Max-Plänen Schlüssel für die APIs, die Claude während einer Ausführung aufruft, stattdessen als API-Anmeldedaten. Dieser Abschnitt listet auch die Anfragen auf, die niemals Anmeldedaten erhalten
  • 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

Eine Standard-Umgebung wird mit Vertrauenswürdigem Netzwerkzugriff bereitgestellt, der nur die Standard-Zulassungsliste von Paket-Registries, Cloud-Provider-APIs, Container-Registries und häufigen Entwicklungsdomänen ermöglicht. Konnektoren, die Sie zur Routine hinzufügen, erreichen ihre Dienste über Anthropic-Server, daher benötigen sie keine Änderungen an der Zulassungsliste. Wenn Ihre Routine 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 eine zuerst.

5

Wählen Sie einen Trigger aus

Wählen Sie unter Trigger auswählen, wie die Routine startet. Sie können einen Trigger-Typ auswählen oder mehrere kombinieren.

Wählen Sie eine voreingestellte Häufigkeit für eine wiederkehrende Ausführung, oder planen Sie eine einmalige Ausführung zu einem bestimmten Zeitstempel. Siehe Zeitplan-Trigger hinzufügen für Zeitzonenbehandlung, Staffelung, benutzerdefinierte Cron-Intervalle und einmalige Ausführungen.

6

Überprüfen Sie Konnektoren

Unter Konnektoren am unteren Ende des Formulars sind alle Ihre verbundenen MCP-Konnektoren standardmäßig enthalten. Entfernen Sie alle, die die Routine nicht benötigt: Claude kann alle Tools aus einem eingebundenen Konnektor verwenden, einschließlich Schreibvorgänge, ohne während einer Ausführung um Genehmigung zu fragen.

7

Erstellen Sie die Routine

Klicken Sie auf Erstellen. Die Routine wird in der Liste angezeigt und wird das nächste Mal ausgeführt, wenn einer ihrer Trigger passt. Um eine Ausführung sofort zu starten, klicken Sie auf Jetzt ausführen auf der Detail-Seite der Routine.

Jede Ausführung erstellt eine neue Sitzung neben Ihren anderen Sitzungen, in der Sie sehen können, was Claude getan hat, Änderungen überprüfen und einen Pull Request erstellen können.

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. Der Befehl ist auch unter dem Alias /routines verfügbar.

Eine erfolgreiche Ausführung sieht wie ein Gespräch aus: Claude stellt Folgefragen zum Zeitplan, zu Repositories und zum Prompt, bevor die Routine gespeichert wird. Wenn Claude stattdessen antwortet, dass Sie sich authentifizieren müssen oder dass es keine Verbindung zu Ihrem Remote-claude.ai-Konto herstellen kann, wurde keine Routine erstellt; siehe Fehlerbehebung.

/schedule in der CLI erstellt geplante Routinen. Um einen API-Trigger hinzuzufügen, bearbeiten Sie die Routine im Web unter claude.ai/code/routines. Sie können einen GitHub-Trigger aus dem Web oder aus der CLI hinzufügen. Der CLI-Pfad erfordert Claude Code v2.1.225 oder später.

Eine Routine ohne Zeitplan-Trigger, wie eine, die nur durch API-Aufrufe oder GitHub-Ereignisse gestartet wird, hat keine nächste Ausführungszeit, und die CLI zeigt keine an, wenn Claude sie speichert oder aktualisiert. Vor v2.1.211 meldete die CLI eine nächste Ausführungszeit im Jahr 1 für diese Routinen.

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

Eine einmalige Planung führt die Routine zu einem bestimmten Zeitstempel aus. Verwenden Sie sie, 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.

/schedule tomorrow at 9am, summarize yesterday's merged PRs
/schedule in 2 weeks, open a cleanup PR that removes the feature flag

Die gleiche lokale-zu-UTC-Konvertierung wie bei wiederkehrenden Schedules gilt auch für einmalige Zeitstempel.

Einmalige Ausführungen zählen nicht gegen das tägliche Routine-Ausführungs-Limit. Siehe Nutzung und Limits für Details.

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.

1

Öffnen Sie die Routine zur Bearbeitung

Gehen Sie zu claude.ai/code/routines, klicken Sie auf die Routine, die Sie über API auslösen möchten, und öffnen Sie dann das Menü neben dem Namen der Routine und wählen Sie Bearbeiten.

2

Fügen Sie einen API-Trigger hinzu

Scrollen Sie zum Abschnitt Trigger auswählen unter dem Feld Anweisungen, klicken Sie auf Weiteren Trigger hinzufügen und wählen Sie API.

3

Kopieren Sie die URL und generieren Sie einen Token

Das Modal zeigt die URL für diese Routine zusammen mit einem Beispiel-curl-Befehl. Kopieren Sie die URL, klicken Sie dann auf Token generieren und kopieren Sie den Token sofort. Der Token wird einmal angezeigt und kann später nicht abgerufen werden, daher speichern Sie ihn an einem sicheren Ort wie dem Secret Store Ihres Alerting-Tools.

4

Rufen Sie den Endpunkt auf

Senden Sie den Token im Authorization: Bearer-Header, wenn Sie zur URL posten. Der Abschnitt Routine auslösen unten zeigt ein vollständiges Beispiel.

Jede Routine hat ihren eigenen Token, der nur zum Auslösen dieser Routine begrenzt ist. Um ihn zu rotieren oder zu widerrufen, kehren Sie zum gleichen Modal zurück und klicken Sie auf Neu generieren oder Widerrufen.

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.

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, dass er Anweisungen darin nicht befolgen soll, es sei denn, der Prompt der Routine sagt es. Die gleiche Umhüllung gilt für Text, der mit Jetzt ausführen in der Web-UI bereitgestellt wird.

Dies bedeutet, dass der gespeicherte Prompt einer Routine sich dafür entscheiden muss, auf Fire-Text zu reagieren: Schreiben Sie den Prompt so, dass er die Payload explizit referenziert, zum Beispiel „Untersuchen Sie den in dem routine-fire-payload-Block beschriebenen Alert", oder die Routine behandelt den Text als inerten Kontext. Jeder, der den Bearer-Token hält, kann text senden, daher macht der Wrapper Fire-Text von einem durchgesickerten Token als nicht vertrauenswürdige Daten gekennzeichnet ankommen, anstatt als direkte Anweisungen an Ihre Routine.

Das Beispiel unten löst eine Routine aus einer Shell aus. Die angezeigte Routine-ID und der Token sind Platzhalter: Ersetzen Sie sie mit der URL und dem Token, die Sie beim Hinzufügen des API-Triggers kopiert haben, oder die Anfrage schlägt 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 das Gespräch manuell fortzusetzen.

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. Claude Code verwendet Sitzungen nicht über Ereignisse hinweg wieder, daher produzieren zwei PR-Updates zwei unabhängige Sitzungen.

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 eine über das Web zu konfigurieren.
  • Installieren Sie die App aus der CLI von der GitHub App-Seite aus, und bitten Sie dann Claude, einen GitHub-Trigger an eine vorhandene Routine anzuhängen, zum Beispiel /schedule add a GitHub trigger to my nightly review for pull requests opened in acme/webapp. Der CLI-Pfad erfordert Claude Code v2.1.225 oder später. Wenn Claude den Trigger hinzufügt, antwortet es mit einem Link zu der Routine, die der Trigger auslöst.
1

Öffnen Sie die Routine zur Bearbeitung

Gehen Sie zu claude.ai/code/routines, klicken Sie auf die Routine, und öffnen Sie dann das Menü neben dem Namen der Routine und wählen Sie Bearbeiten.

2

Fügen Sie einen GitHub-Ereignis-Trigger hinzu

Scrollen Sie zum Abschnitt Trigger auswählen, klicken Sie auf Weiteren Trigger hinzufügen, und wählen Sie GitHub-Ereignis.

3

Konfigurieren Sie den Trigger

Wählen Sie das Repository, wählen Sie ein Ereignis aus der Liste Unterstützte Ereignisse und fügen Sie optional Filter hinzu. Speichern 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 wie pull_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

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

Der Operator 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ält auth-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.

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. Sie können optional laufspezifischen Text bereitstellen, der die Routine auf die gleiche Weise erreicht wie das Feld text des API-Triggers.
  • Den Ein-/Aus-Schalter oben auf der Seite verwenden, um den Schedule zu pausieren oder fortzusetzen. Pausierte Routinen behalten ihre Konfiguration, werden aber nicht ausgeführt, bis Sie sie erneut aktivieren.
  • Das Menü neben dem Namen der Routine öffnen und Bearbeiten auswählen, um 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.
  • Das gleiche Menü öffnen und Löschen auswählen, um die Routine zu löschen.

Routinen über die CLI verwalten

Die CLI unterstützt 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.

Sie können auch nach der Ausführungshistorie einer Routine fragen, zum Beispiel /schedule why did my nightly review do nothing this morning?. Claude listet die letzten Ausführungen der Routine mit ihrem Status und einem Link zum Öffnen jeder Ausführung im Web auf und liest das Protokoll einer Ausführung, um zu erklären, was passiert ist, einschließlich Tool-Fehler, Berechtigungsverweigerungen und des Endergebnisses. Erfordert Claude Code v2.1.227 oder später.

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-Zugriff für das Repository hat, von dem aus Sie es ausgeführt haben, und fügt bei Bedarf eine Setup-Notiz hinzu, die angibt, wie Zugriff gewährt wird. Siehe GitHub-Authentifizierungsoptionen für die zwei Möglichkeiten, Zugriff zu gewähren.

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

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.

Claude pusht seine Arbeit zu Branches mit dem Präfix claude/, die immer akzeptiert werden. Wenn Ihr Prompt Claude anweist, zu einem anderen Branch zu pushen, überprüft Claude Code den Push zuerst und lehnt ihn ab, wenn eine der folgenden Bedingungen erfüllt ist:

  • Der Branch ist auf GitHub geschützt
  • Jemand anderes hat einen offenen Pull Request von diesem Branch
  • Der Branch enthält Commits, die von jemandem anderem als Ihnen verfasst wurden

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 mit claude 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 claude.ai/customize/connectors oder verwenden Sie /schedule update in der CLI.

Umgebungen und Netzwerkzugriff

Jede Routine verwendet eine Cloud-Umgebung, 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, der nur die Standard-Zulassungsliste durch das Netzwerk der Sitzung zulässt. Anfragen auf diesem Pfad an Hosts außerhalb der Zulassungsliste schlagen mit 403 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 auf einer Ihrer eigenen Umgebungen zuzulassen, führen Sie diese Schritte aus. Eine organisationsweite gemeinsame Umgebung wird hier schreibgeschützt angezeigt, daher ändert ein Eigentümer seinen Netzwerkzugriff stattdessen auf der Seite Cloud-Umgebungen in den Admin-Einstellungen.

1

Öffnen Sie die Routine zur Bearbeitung

Auf der Detailseite der Routine öffnen Sie das Menü neben dem Namen der Routine und wählen Bearbeiten aus.

2

Öffnen Sie die Umgebungsauswahl

Wählen Sie unter dem Feld Anweisungen das Cloud-Symbol aus, das den Namen Ihrer Umgebung anzeigt, 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 Netzwerkzugriff-Ebene

Ändern Sie im Dialog Cloud-Umgebung aktualisieren den Netzwerkzugriff zu Benutzerdefiniert und geben Sie Ihre Domains in Zulässige Domains ein. Aktivieren Sie Auch Standard-Liste häufiger Paket-Manager einschließen, um die Standard-Zulassungsliste neben Ihren benutzerdefinierten Domains zu behalten. Wählen Sie stattdessen Vollständig für uneingeschränkten Zugriff.

5

Speichern

Klicken Sie auf Änderungen speichern. Die neue Richtlinie wird ab der nächsten Ausführung angewendet.

Siehe Netzwerkzugriff für Details zu Zugriffsstufen und der Standard-Zulassungsliste.

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 aktiviertem Nutzungsguthaben Routinen weiterhin auf gemessener Überschreitung ausführen. Ohne Nutzungsguthaben werden weitere Ausführungen abgelehnt, bis sich das Fenster zurückgesetzt hat. Aktivieren Sie Nutzungsguthaben unter claude.ai/settings/usage. Bei Team- und Enterprise-Plänen aktiviert ein Administrator diese für die Organisation unter claude.ai/admin-settings/usage.

Einmalige Ausführungen werden nicht auf das tägliche Routine-Limit angerechnet. Sie verbrauchen Ihre reguläre Abonnement-Nutzung wie jede andere Sitzung.

Während Ihr Abonnement pausiert ist, werden Ihre Routinen angehalten und führen nicht aus. Sobald Ihr Abonnement wieder aktiv ist, schalten Sie sie wieder ein.

Fehlerbehebung

`/schedule` zeigt "Unknown command" an

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

Die Ursache ist normalerweise eine der folgenden:

  • Sie sind mit einem Console-API-Schlüssel, einem Anthropic-Profil oder Verbundsanmeldedaten oder einem Cloud-Anbieter wie Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry authentifiziert. /schedule erfordert eine claude.ai-Abonnement-Anmeldung. Mit einem Console-API-Schlüssel oder einem Profil und aktiviertem Feature-Flag-Abrufen 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 immer noch Unknown command: /schedule. Wenn ANTHROPIC_API_KEY oder ANTHROPIC_AUTH_TOKEN in Ihrer Shell oder apiKeyHelper in settings.json gesetzt ist, entfernen Sie es zuerst, da diese Vorrang vor einer claude.ai-Anmeldung haben. Ein Profil oder eine Verbundsanmeldedaten hat ebenfalls Vorrang, daher schalten Sie diese auch aus
  • Sie sind vollständig abgemeldet, ohne API-Schlüssel oder andere Anmeldedaten. Mit aktiviertem Feature-Flag-Abrufen 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 die gleiche Claude for Enterprise-Nachricht wie ein Console-API-Schlüssel
  • Sie befinden sich in einer Cloud-Sitzung, wo das Absenden von /schedule antwortet, dass der Befehl in dieser Umgebung nicht verfügbar ist. Verwalten Sie Routinen stattdessen über die Web-Benutzeroberfläche
  • Die Richtlinie Ihrer Organisation deaktiviert Cloud-Sitzungen, auf denen Routinen ausgeführt werden. In diesem Fall antwortet das Absenden von /schedule mit Cloud sessions are disabled by your organization's policy. Vor v2.1.268 gab es Unknown command: /schedule zurück
  • Ein Inhaber hat Routinen deaktiviert für Ihre Team- oder Enterprise-Organisation. Vor v2.1.227 erschien der Befehl in diesem Fall immer noch, und claude.ai lehnte die Routine ab, wenn Claude versuchte, sie zu erstellen oder auszuführen

Sofern die Richtlinie Ihrer Organisation Routinen oder Cloud-Sitzungen nicht deaktiviert, können Sie Routinen jederzeit unter claude.ai/code/routines erstellen und verwalten, unabhängig davon, wie die CLI konfiguriert ist.

"Routinen sind durch die Richtlinie Ihrer Organisation deaktiviert"

Ein Inhaber in Ihrer Team- oder Enterprise-Organisation hat wahrscheinlich den Routinen-Schalter unter claude.ai/admin-settings/claude-code ausgeschaltet. In Claude Code v2.1.227 oder später blendet derselbe Schalter auch /schedule in der CLI aus. Dies ist eine serverseitige Organisationseinstellung, daher kann sie nicht aus Ihrer lokalen Konfiguration überschrieben werden. Bitten Sie einen Inhaber, Routinen für Ihre Organisation zu aktivieren.

  • /loop und 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-Umgebungen: Konfigurieren Sie Netzwerkzugriff, Umgebungsvariablen und Setup-Skripte für Cloud-Sitzungen
  • Projekte: Laufende Arbeiten, die Claude über parallele Cloud-Sitzungen koordiniert; aus einem Projekt erstellte Routinen werden auf der Registerkarte Routinen angezeigt
  • 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