Claude Code Agenten: So arbeitet ein ganzes Team für dich

Ruwen Bädorf·15. September 2026·7 Min. Lesezeit

Von den eingebauten Subagents bis zum Ruflo-Schwarm: So lässt du in Claude Code mehrere Agenten gleichzeitig für dich arbeiten.

Claude Code Agenten sind Helfer, die parallel und eigenständig an deiner Aufgabe arbeiten, während du nur den Auftrag gibst. Du startest sie entweder mit den eingebauten Subagents von Claude Code oder mit einem kompletten Schwarm über das kostenlose Tool Ruflo.

Ich baue seit Monaten Systeme, die mit KI von allein arbeiten. Der größte Sprung war der Moment, in dem ich aufgehört habe, alles selbst in einem Chat abzuarbeiten. Statt einer KI, die eine Sache nach der anderen macht, lasse ich heute mehrere Claude Code Agenten gleichzeitig laufen. Einer recherchiert, einer schreibt Code, einer testet, einer prüft. Genau das zeige ich dir hier von der einfachen Variante bis zum großen Schwarm.

Das Ganze habe ich auch als kurzes Reel aufgenommen. Wenn du es lieber siehst als liest, findest du es auf meinem Instagram-Profil @ruwen.ai.

🔥 Willst du den Agenten-Schwarm aus dem Video zum Nachbauen? Im Guide zum Ruflo-Schwarm steht jeder Befehl zum Kopieren. → Guide holen

Was Claude Code Agenten sind und wie sie arbeiten

Claude Code Agenten sind eigenständige KI-Helfer, die innerhalb von Claude Code jeweils eine abgegrenzte Aufgabe übernehmen. Ein führender Agent verteilt die Arbeit an mehrere Helfer. Jeder Helfer bekommt sein eigenes Kontext-Fenster und arbeitet unabhängig von den anderen. Danach fließen die Ergebnisse zurück zum führenden Agenten, der sie zusammensetzt.

Der Vorteil liegt auf der Hand. Fünf Recherchen laufen gleichzeitig statt nacheinander. Drei Dateien werden zur selben Zeit geprüft. Du wartest also nicht mehr, während eine einzige KI Schritt für Schritt abarbeitet.

Ein Beispiel aus meinem Alltag macht das greifbar. Wenn ich einen neuen Ordner mit Code aufräume, gebe ich früher jeden Schritt einzeln vor. Heute sage ich einmal, was passieren soll, und mehrere Claude Code Agenten teilen sich die Arbeit. Einer liest den Code, einer sucht die Fehler, einer schreibt die Tests dazu. Ich sehe am Ende ein sauberes Ergebnis, statt eine halbe Stunde daneben zu sitzen.

Wichtig ist der Unterschied zwischen den eingebauten Subagents und einem echten Agenten-Schwarm. Die Subagents stecken schon in Claude Code und reichen für klar abgegrenzte Aufgaben. Der Schwarm über Ruflo geht weiter und koordiniert viele Agenten mit einem gemeinsamen Gedächtnis. Beides schauen wir uns der Reihe nach an.

Claude Code Agenten einrichten: die eingebauten Subagents

Die schnellste Art, mit Claude Code Agenten zu starten, sind die eingebauten Subagents. Du brauchst dafür kein Zusatz-Tool, nur Claude Code selbst.

Du legst einen Subagent über den Befehl /agents an. Hinter jedem Subagent steckt eine kleine Markdown-Datei im Ordner .claude/agents/. In dieser Datei legst du den Namen fest, eine Beschreibung, die erlaubten Werkzeuge und das Modell. Laut der offiziellen Claude-Code-Dokumentation startet der führende Agent die Subagents dann automatisch, sobald eine Aufgabe sich aufteilen lässt.

So gehst du vor:

1. Öffne Claude Code und tippe /agents, um einen neuen Helfer anzulegen.
2. Gib ihm einen Namen und eine klare Beschreibung, zum Beispiel „Rechercheur" oder „Test-Prüfer".
3. Lege fest, welche Werkzeuge er nutzen darf und welches Modell er bekommt.
4. Beschreibe deine Aufgabe im Chat so, dass sie sich in Teile zerlegen lässt.
5. Sieh dir mit /tasks an, welcher Agent gerade woran arbeitet.

Diese Variante ist ideal, wenn du schnell mehrere kleine Dinge parallel erledigen willst. Für ein ganzes Projekt mit vielen Schritten stößt sie aber an ihre Grenzen, weil die Subagents nach der Sitzung wieder weg sind und sich nichts merken.

🔥 Du willst nicht nur ein paar Helfer, sondern ein ganzes Team? Der Ruflo-Guide zeigt dir den kompletten Aufbau in drei Befehlen. → Zum Guide

Mehr Power: Claude Code Agenten als Schwarm mit Ruflo

Wenn du deine Claude Code Agenten zu einem echten Team ausbauen willst, kommt Ruflo ins Spiel. Ruflo ist ein kostenloses Open-Source-Tool von ruvnet, das sich direkt in Claude Code einklinkt und dort einen ganzen Schwarm aus Agenten laufen lässt. Das Projekt ist auf GitHub frei verfügbar und gehört dort zu den meistbeachteten Werkzeugen für Multi-Agenten-Arbeit.

Der Unterschied zu den eingebauten Subagents ist das Prinzip dahinter. Ein zentraler Koordinator, der sogenannte Queen-Agent, führt die Teams. Die technischen Agenten übernehmen die eigentliche Arbeit, also Recherche, Code, Tests und Prüfung. Alle teilen sich ein gemeinsames Gedächtnis, dadurch werden die Ergebnisse mit jedem Durchlauf besser.

Die Einrichtung sind drei Schritte, die du im Terminal ausführst. Du brauchst dafür Node.js, damit der Befehl npx funktioniert.

1. Ruflo einrichten mit npx ruflo@latest init wizard, das legt Konfiguration und Agenten an.
2. Den Schwarm aufstellen mit npx ruflo@latest swarm init --topology hierarchical --max-agents 8 --strategy specialized.
3. Den Hintergrunddienst starten mit npx ruflo@latest daemon start, der die Aufträge verteilt.

Ab jetzt gibst du deine Aufgabe direkt in Claude Code, mit der Markierung @task davor. Ruflo verteilt sie automatisch an den passenden Agenten und nutzt das gemeinsame Gedächtnis. Über die Zahl bei --max-agents bestimmst du, wie viele Agenten parallel laufen. Fang mit acht an und dreh erst hoch, wenn dein Rechner und deine Aufgabe es hergeben.

Den Fortschritt siehst du jederzeit mit npx ruflo@latest swarm status. Dort steht, welcher Agent gerade woran arbeitet und was schon fertig ist. Das gemeinsame Gedächtnis ist dabei der eigentliche Unterschied zu den eingebauten Subagents. Es sorgt dafür, dass der Schwarm beim nächsten Auftrag schon weiß, was er beim letzten gelernt hat. So musst du dieselbe Vorgeschichte nicht jedes Mal neu erklären.

Eingebaute Subagents oder Ruflo-Schwarm: was für dich passt

Bevor du dich für einen Weg mit Claude Code Agenten entscheidest, hilft ein direkter Vergleich. Die eingebauten Subagents sind sofort da, der Ruflo-Schwarm kann deutlich mehr.

Für einen schnellen Zwischenschritt reichen die eingebauten Subagents völlig. Sobald du ein größeres Vorhaben hast, das sich über mehrere Läufe zieht, spielt der Schwarm seine Stärke aus.

Was Claude Code Agenten dich an Tokens sparen

Ein Punkt macht die Claude Code Agenten im Schwarm besonders interessant, und das ist der Verbrauch. Ruflo erkennt, wie komplex eine Aufgabe ist, und wählt danach das passende Modell. Einfache Aufgaben bekommen das günstige Modell, schwere Aufgaben ein starkes.

Das ist der gleiche Gedanke, den du auch von Hand nutzen kannst. Du lässt einfache Routine von einem sparsamen Modell wie Haiku erledigen und hebst dir das starke Modell für die kniffligen Teile auf. Laut dem Ruflo-Projekt senkt genau diese automatische Verteilung den Token-Verbrauch spürbar und streckt damit deine Nutzung.

Wichtig bleibt eine Sache. Der Schwarm nimmt dir die Fleißarbeit ab, die Kontrolle bleibt bei dir. Sieh dir an, was die Agenten liefern, bevor du es übernimmst, denn ein großer Schwarm auf einer riesigen Aufgabe verbraucht trotz der cleveren Modellwahl etwas.

🔥 Bereit, deinen ersten Schwarm aufzustellen? Im Guide zu den Claude Code Agenten mit Ruflo steht jeder Befehl zum Kopieren. → Guide holen

Die häufigsten Fehler mit Claude Code Agenten

Beim Start mit Claude Code Agenten laufen die meisten in dieselben zwei Fallen. Die erste ist der Griff zur größten Variante, obwohl die kleinste reicht. Wer nur schnell drei Dateien prüfen will, braucht keinen Schwarm aus vielen Agenten, sondern zwei eingebaute Subagents. Nimm also erst die einfache Lösung und wechsle zum Schwarm, wenn die Aufgabe wirklich groß wird.

Die zweite Falle ist fehlende Kontrolle über das Ergebnis. Agenten arbeiten schnell und selbstständig, aber sie treffen keine Entscheidung für dich. Lies immer, was am Ende herauskommt, bevor du es übernimmst. Ein kurzer Blick auf das Ergebnis kostet dich eine Minute und spart dir später Stunden. Wenn du diese Kontrolle nicht allein übernehmen willst, lass ein zweites Modell prüfen, wie in Code Review mit KI beschrieben.

Ein letzter Punkt betrifft die Einrichtung selbst. Wenn der Befehl npx bei dir nicht funktioniert, fehlt Node.js auf deinem Rechner. Installier es einmal von der offiziellen Seite, danach laufen alle Ruflo-Befehle sauber durch.

Über Ruwen Bädorf

Ich bin Ruwen Bädorf und ich baue Systeme, die mit KI von allein arbeiten. Ich helfe Selbstständigen, ihre Arbeit einmal zu bauen statt jeden Tag zu wiederholen.

• Ich baue und betreibe die komplette Reel-Fabrik auf ki-imperium.com selbst, vom Skript über den Guide bis zur Auslieferung.
• Ich arbeite täglich mit Claude, Lovable und Higgsfield und zeige genau die Abläufe, die ich selbst fahre.
• Auf Instagram zeige ich diese Abläufe als Reels, jeweils mit Guide zum Nachbauen.

→ Folg mir auf Instagram

Weiterlesen

Wenn dich Claude Code Agenten weiterbringen, passt der Beitrag KI Agenten selbst bauen als nächster Schritt. Wie du deine Agenten mit externen Werkzeugen verbindest, steht in MCP Server in Claude Code einrichten. Und wie du wiederkehrende Abläufe fest in Claude hinterlegst, zeigt Claude Skills nutzen. Und wann sich ein Neustart lohnt, ohne den Stand zu verlieren, steht in Claude Code Session neu starten.

Wer heute lernt, mit Claude Code Agenten ein ganzes Team zu führen, erledigt morgen in Minuten, wofür andere noch Stunden allein am Chat sitzen.