n8n Workflows mit Claude Code bauen: beschreiben statt klicken

Eine Automatisierung in n8n von Hand zu bauen heißt: Kästchen aufs Feld ziehen, verbinden, sich durch Einstellungsmenüs klicken und am Ende suchen, warum die Hälfte nicht läuft. Mit Claude Code gehst du einen anderen Weg: Du beschreibst den Ablauf in normaler Sprache, Claude Code schreibt die Workflow-Datei, und du importierst, testest und aktivierst sie. Hier siehst du das Setup, die einzelnen Schritte, ein durchgespieltes Beispiel und welche Kosten dabei anfallen.

Was ist ein n8n Workflow?

Ein n8n-Workflow besteht aus Bausteinen, in n8n heißen sie Nodes. Jedes Kästchen ist ein Schritt, zum Beispiel: Mail kommt rein → PDF ablegen → Nachricht senden. Du reihst die Schritte aneinander, und der Ablauf läuft von allein, sobald der Auslöser greift.

Der Bauplan eines Workflows lässt sich als JSON-Datei speichern, also als reiner Text, der beschreibt, welche Bausteine es gibt, wie sie eingestellt und wie sie verbunden sind. n8n kann Workflows genau in diesem Format exportieren und wieder importieren. Strukturierten Text nach festen Regeln zu schreiben, ist eine Aufgabe, die Claude Code gut liegt.

Damit ändert sich die Arbeitsweise. Statt Kästchen zu ziehen, beschreibst du in normaler Sprache, was passieren soll, und Claude Code übersetzt das in die Datei, die n8n versteht.

Wichtig ist aber auch, was nicht in der Datei steckt: deine Zugangsdaten, die laufende n8n-Instanz und die Entscheidung, den Workflow scharf zu schalten. Diese Teile erledigst du in n8n selbst, und sie gehören zu jedem Workflow dazu.

Klicken oder beschreiben: der Unterschied

Das Setup für deinen Arbeitsplatz

Bevor du loslegst, richtest du dir einen sauberen Arbeitsplatz ein. Das machst du einmal und ergänzt es später nur noch, wenn neue Tools dazukommen.

1Schritt 1: Eigener Ordner für n8n

Öffne eine eigene Claude-Code-Sitzung in einem leeren Ordner, nur für n8n. So kommt sich nichts mit deinen anderen Projekten in die Quere, und alle Workflow-Dateien liegen an einem Ort.

2Schritt 2: Optional einen API-Key anlegen

Wenn Claude Code die Workflows später direkt in dein n8n schreiben soll, statt dir nur die Datei zu geben, brauchst du einen API-Key. Das ist das Passwort, mit dem sich Claude Code bei deinem n8n anmeldet. Du legst ihn in n8n unter Settings → n8n API an, vergibst einen Namen und eine Ablaufzeit und kopierst den Key. Bei jeder Anfrage wird er als Kopfzeile X-N8N-API-KEY mitgeschickt, so steht es in der n8n-Dokumentation zur API.

3Schritt 3: Claude Code zeigen, wie du baust

Zwei Dinge machen die Ergebnisse besser. Erstens: Hast du schon einen Workflow, exportier ihn als JSON und leg ihn in den Ordner. Dann sieht Claude Code, wie du baust. Zweitens: eine kurze Notiz-Datei mit deinem Baukasten, also welche Tools du benutzt (Gmail, Google Sheets, Telegram und so weiter) und wie deine Zugangsdaten in n8n heißen.

Das ist der Friseur-Effekt: Beim neuen Friseur setzt du dich auch nicht hin und sagst nur „schneid mal“. Du gibst Kontext, dann kommt eher raus, was du willst.

So baust du einen Workflow mit Claude Code

Der Ablauf ist jedes Mal derselbe, egal was du automatisierst. Die ersten drei Schritte erledigt im Wesentlichen Claude Code, die übrigen sind deine Betriebsarbeit in n8n.

1Schritt 1: Beschreiben, was du willst

Sag Claude Code in normaler Sprache, was passieren soll: Was löst den Ablauf aus, was soll mit den Daten passieren, wo soll das Ergebnis landen, und was soll bei einem Fehler geschehen. Je konkreter du Auslöser, Ziel und Sonderfälle beschreibst, desto weniger muss Claude Code raten. Ein Auftrag kann so aussehen:

Baue mir einen n8n-Workflow als JSON-Datei.
Auslöser: neue Mail in Gmail mit PDF-Anhang.
Filter: nur Mails, deren Betreff "Rechnung" oder "Invoice" enthält.
Verarbeitung: PDF in Text umwandeln, mit dem Anthropic-Baustein
Anbieter, Datum, Nettobetrag, Umsatzsteuer und Bruttobetrag auslesen.
Ausgabe: PDF in den Drive-Ordner "Rechnungen/<Monat>",
eine Zeile im Google Sheet "Ausgaben", Telegram-Nachricht an mich.
Sonderfälle: kein Anhang oder unlesbare Felder -> Zeile mit Status "prüfen".
Nutze für die Zugangsdaten die Namen aus credentials.md.

2Schritt 2: Claude Code schreibt die JSON-Datei

Claude Code baut daraus die Workflow-Datei mit allen Bausteinen und Verbindungen. Mit API-Key kann es den Workflow auch direkt in dein n8n schreiben. Lass dir dabei kurz erklären, welcher Baustein was tut, damit du später weißt, wo du suchen musst.

3Schritt 3: In n8n importieren

Ohne API-Key importierst du die Datei selbst. Im Editor findest du oben rechts über die drei Punkte „Import from File“ für eine Datei auf deinem Rechner und „Import from URL“ für eine Datei im Netz. Alternativ kopierst du den JSON-Text und fügst ihn mit Strg+V direkt in den Editor ein.

4Schritt 4: Zugangsdaten zuordnen

Gespeicherte n8n-Credentials werden in einer Workflow-Datei nur über Namen und IDs referenziert, die Zugangsdaten selbst stehen nicht darin. Direkt in Bausteinen eingetragene Schlüssel oder Authentifizierungsheader können dagegen in der Datei enthalten sein. Öffne jeden Baustein, der ein Konto braucht, und wähle dort deine Zugangsdaten aus, zum Beispiel dein Gmail-Konto oder deinen Anthropic-Schlüssel. Fehlen sie noch, legst du sie in n8n einmal an.

5Schritt 5: Mit Testdaten prüfen

Starte einen Testlauf mit Daten, die du kennst: eine Testmail an dich selbst mit einer Beispielrechnung, ein Test-Sheet statt deines echten. Schau dir an, ob jeder Baustein durchläuft und was er weitergibt.

6Schritt 6: Ergebnis kontrollieren

Ein Workflow, der ohne Fehlermeldung durchläuft, ist noch nicht richtig. Vergleich das Ergebnis mit dem Original: Stimmen Betrag, Datum und Anbieter? Liegt die Datei im richtigen Ordner? Kommt die Nachricht an? Kommt ein Fehler oder ein falsches Ergebnis, kopierst du die Fehlermeldung oder beschreibst die Abweichung, gibst sie an Claude Code zurück, importierst die korrigierte Fassung und testest erneut.

7Schritt 7: Workflow aktivieren

Erst wenn der Test sitzt, schaltest du den Workflow scharf. In aktuellen n8n-Versionen geschieht das über den Button „Publish“, in älteren über den Schalter „Active“. Danach läuft der Workflow mit seinen echten Auslösern, wie in der n8n-Dokumentation zum Veröffentlichen beschrieben. Schau in den ersten Tagen in die Ausführungen, ob alles wie geplant läuft.

Beispiel: Rechnungen automatisch erfassen

Ein Beispiel, an dem sich der Ablauf gut zeigen lässt: Du bist Freelancer, und jeden Monat kommen Rechnungen per Mail: Design-Software, Hosting, KI-Tools, Werbeanzeigen. Am Monatsende überträgst du sie von Hand in eine Tabelle. Genau diese Routine eignet sich für einen ersten Workflow.

Ein typischer Workflow dafür sieht so aus:

• Gmail-Trigger: der Auslöser, der den Ablauf startet, sobald eine neue Mail im Postfach landet.
• Filter: Ist das überhaupt eine Rechnung? Dafür prüft er Betreff oder Absender.
• PDF auslesen: Der Anhang wird geöffnet und in Text umgewandelt.
• Claude liest die Rechnung: Das ist der KI-Baustein, in n8n der Anthropic-Baustein mit einem Claude-Modell. Er zieht Anbieter, Betrag, Umsatzsteuer und Datum heraus und ordnet eine Kategorie zu.
• Ablage in Google Drive: Die PDF landet im passenden Ordner.
• Eintrag in ein Google Sheet: eine Zeile pro Rechnung, sortiert nach Monat, Kategorie und Vorsteuer.
• Telegram-Nachricht: kurzer Hinweis aufs Handy, dass eine Rechnung erfasst wurde.

Ein Eintrag im Sheet könnte dann so aussehen: Software · 59,49 € · Vorsteuer 9,50 €. Die Zahlen sind ein ausgedachtes Beispiel, keine echte Rechnung.

Im Betrieb musst du drei Sonderfälle einplanen:

• Dubletten: Dieselbe Rechnung kommt zweimal, etwa als Erinnerung. Ein Abgleich über Rechnungsnummer und Anbieter verhindert doppelte Zeilen.
• Fehlende Anhänge: Manche Anbieter schicken nur einen Link zum Kundenportal. Solche Mails markiert der Workflow zur Handarbeit, statt sie zu überspringen.
• Fehlerhafte Extraktion: Die KI kann eine Zahl falsch lesen, besonders bei unscharfen Scans. Ein Status „prüfen“ für unklare Felder und ein kurzer Blick am Monatsende fangen das ab.

Ob dein Steuerberater die Daten später an lexoffice, sevDesk oder DATEV weiterreicht, ist ein eigenes Thema. Die Methode ist immer dieselbe, nur die Bausteine wechseln: Leads in eine Liste eintragen, Content vorbereiten, Anfragen sortieren.

Was das kostet: Bauen und Betreiben trennen

Hier werden zwei Dinge leicht vermischt. Das Bauen des Workflows erledigt Claude Code auf deinem Rechner: Es schreibt die JSON-Datei und korrigiert sie. Das läuft über deinen Claude-Zugang, also dein Abo oder deinen API-Schlüssel, und fällt nur an, solange du baust oder änderst.

Der Betrieb ist etwas anderes. Enthält dein Workflow einen KI-Baustein, wie den Anthropic-Baustein im Rechnungsbeispiel, ruft n8n bei jeder verarbeiteten Rechnung ein Modell auf. Dieser Aufruf läuft über den API-Schlüssel, den du in n8n hinterlegst, und wird pro Token abgerechnet. Er ist nicht in einem Claude-Abo für die App enthalten. Wie viel das ausmacht, hängt von Modell, Länge der Dokumente und Anzahl der Durchläufe ab; die aktuellen Preise findest du auf der Preisseite von Anthropic.

Dazu kommen die Kosten für n8n selbst, also ein Cloud-Tarif oder der Server für die selbst gehostete Version, und die Zeit für Wartung: Zugangsdaten laufen ab, Anbieter ändern ihre Mails, ein Baustein bekommt ein Update. Plane für jeden Workflow ab und zu einen kurzen Blick in die Ausführungen ein.

Typische Fehler beim Import und Testlauf

Beim ersten Import oder Testlauf hakt es oft an Kleinigkeiten: ein Baustein falsch verknüpft, ein fehlendes Feld, ein Name, der nicht zu deinen Zugangsdaten passt. Das ist kein Grund zur Sorge, sondern Teil des Ablaufs.

Am häufigsten fehlen nach dem Import die Zugangsdaten, weil die Datei gespeicherte Credentials nur über Namen und IDs referenziert. Die ordnest du wie in Schritt 4 beschrieben selbst zu.

Für den Rest gilt der Loop aus Schritt 6: Fehlermeldung kopieren, an Claude Code zurückgeben, korrigierte Fassung importieren, erneut testen. Manchmal sitzt die Korrektur beim ersten Mal, manchmal braucht es mehrere Runden. Hilfreich ist, wenn du ungefähr verstehst, was jeder Baustein tut; jedes Detail von n8n musst du dafür nicht kennen.

Die Abkürzung: fertige Vorlagen

Du musst nicht jeden Workflow von Grund auf beschreiben. n8n bietet unter n8n.io/workflows eine große Sammlung fertiger Vorlagen aus der Community, für viele gängige Aufgaben gibt es schon einen Startpunkt.

Der Ablauf wird dann kürzer: Vorlage raussuchen, JSON herunterladen, an Claude Code geben und sagen: „Bau mir das auf mein Setup um“ oder „Erweitere das um X“. Danach geht es mit denselben Schritten weiter: Zugangsdaten zuordnen, testen, kontrollieren, aktivieren.

Fang mit einem an, nicht mit dreien

Ein häufiger Fehler: alles auf einmal automatisieren wollen und dann bei nichts fertig werden. Mach es andersrum. Nimm einen Ablauf, den du sowieso jede Woche von Hand machst, zum Beispiel Rechnungen ablegen, einen Lead eintragen oder einen Post vorbereiten, und bring genau den diese Woche bis zur Aktivierung.

Fazit

n8n mit Claude Code heißt: beschreiben statt klicken. Du richtest einen sauberen Arbeitsplatz ein, beschreibst den Ablauf, lässt die Datei schreiben und erledigst danach die Betriebsarbeit in n8n: Zugangsdaten zuordnen, mit Testdaten prüfen, Ergebnis kontrollieren, aktivieren. Behalte dabei im Blick, dass der KI-Baustein im Betrieb eigene laufende Kosten hat. Ein Workflow, der geprüft läuft, ist mehr wert als drei, die halb fertig in der Schublade liegen. Also such dir diese Woche den einen Ablauf aus, der dich am meisten Zeit kostet, und bring ihn bis zur Aktivierung.