Erfahre, wie du deinen ersten KI-Agenten in unter einer Stunde baust – mit diesem anfängerfreundlichen Claude Code-Guide. Inklusive der exakten Prompts, einer Schritt-für-Schritt-Anleitung, häufiger Fehler und dem einfachsten Weg, Tools, Skills und Loops zu verstehen.
Niemand hat mir verraten, dass mein erster KI-Agent so unspektakulär sein würde – und genau das war der Grund, warum er funktioniert hat.
Ich glaube, viele Anfänger stellen sich ihren ersten Agenten wie einen autonomen digitalen Mitarbeiter vor, der Flüge bucht, Code schreibt, das Internet durchforstet und irgendwie noch vor dem Mittagessen ihr Leben verändert. hahaha.
Diese Fantasie ist es, an der die meisten scheitern.
Sie verbringen Tage damit, Fachbegriffe zu lernen, Frameworks zu vergleichen und sich Demos von Leuten anzusehen, die bereits weit über das Anfängerniveau hinaus sind. Dabei war das Einzige, was sie wirklich brauchten, ein kleiner funktionierender Loop.
Diese Denkweise war der Moment, in dem Claude Code bei mir Klick gemacht hat.
Dein erster Agent muss nicht beeindruckend sein. Er muss ein Ziel aufnehmen, Kontext nutzen, eine Aktion ausführen, das Ergebnis prüfen und entweder fortfahren oder anhalten. Sobald du das einmal gebaut hast, schrumpft die ganze beängstigende Terminologie rund um Agenten wieder auf ein normales Maß.
Das hier ist also der Leitfaden, den ich gerne gehabt hätte, als ich angefangen habe. Keine überkomplizierte Theorie, sondern ein anfängerfreundlicher Weg, um mit Claude Code in unter einer Stunde deinen ersten nutzbaren KI-Agenten zu bauen.
Zuerst: Verstehe, was ein Agent eigentlich ist
Das Wort „Agent“ lässt das alles viel komplizierter klingen, als es ist.
Auf Anfängerniveau ist ein Agent einfach ein KI-System, das mehr kann, als nur einmal zu antworten. Es kann eine Aufgabe annehmen, den Kontext prüfen, Werkzeuge nutzen, schrittweise Fortschritte machen und entscheiden, was als Nächstes zu tun ist.
Das ist alles.
Du musst keine komplexen Architekturdiagramme verstehen, bevor du anfängst. Du musst nur den Loop verstehen.
Der Loop ist die ganze Idee:
Der Agent bekommt ein Ziel, schaut sich die Situation an, führt eine Aktion aus, prüft, ob diese Aktion geholfen hat, und fährt dann entweder fort oder stoppt.
Claude Code ist ein großartiger Ort, um das zu lernen, weil es sich bereits so verhält. Es spuckt nicht nur Code aus und verschwindet. Es kann Dateien untersuchen, bearbeiten, Prüfungen durchführen und weiter an einer Aufgabe arbeiten. Das macht es für Anfänger zum einfachsten Ort, um nicht mehr nur in Prompts zu denken, sondern in Arbeitsabläufen.
Was du in deiner ersten Stunde baust
Baue keinen „Recherche-Assistenten für alles“ ODER einen „vollständig autonomen Code-Mitarbeiter“. Baue etwas Winziges.
Der beste erste Agent ist einer, der eine enge Aufgabe klar erledigt. Zum Beispiel:
Einen Ordner lesen, die Dateien zusammenfassen, Aktionspunkte identifizieren und das Ergebnis sauber formatieren.
Das klingt vielleicht langweilig, aber langweilig ist gut. Langweilig bedeutet verständlich. Und verständlich ist das, was es dir ermöglicht, das System später zu verbessern.
Das Ziel in der ersten Stunde ist nicht, etwas Magisches zu bauen. Das Ziel ist, dir selbst zu beweisen, dass du einen funktionierenden Loop in Claude Code erstellen kannst, der echte Arbeit mit einer echten Struktur erledigt.
Der einfachste Arbeitsablauf für den ersten Agenten
Die einfachste Version sieht so aus:
Du gibst Claude Code eine Aufgabe wie:
„Überprüfe die Notizen in diesem Ordner, fasse die Hauptthemen zusammen, liste offene Fragen auf und erstelle eine saubere Zusammenfassungsdatei.“
Diese einzelne Aufgabe hat bereits das Grundgerüst eines Agenten:
- sie hat ein Ziel,
- sie hat Kontext,
- sie hat Aktionen,
- und sie hat ein Ergebnis, das überprüft werden kann.
Was sie agentenhaft macht, ist nicht nur die Formulierung. Es ist die Tatsache, dass Claude Code die Aufgabe in Schritten durchgehen kann, anstatt sie wie eine einmalige Antwort zu behandeln.
Das ist das Anfängermuster, das ich empfehle:
Beginne mit einem Ordner, einer Aufgabe, einer Ausgabedatei, einem Überprüfungsschritt.
Das ist genug.
Schritt für Schritt:
Öffne Claude Code und erstelle oder wähle einen kleinen Ordner, mit dem du arbeiten möchtest.
Das können ein paar Notizen, einige Markdown-Dateien, ein Miniprojekt oder sogar ein paar Textdateien sein, die du nur zum Üben selbst erstellt hast.
Halte es klein genug, dass du verstehen kannst, was der Agent tut.
Gib ihm dann eine direkte Anweisung wie diese:
1Überprüfe alle Dateien in diesem Ordner.2Identifiziere die Hauptthemen im Inhalt.3Liste unbeantwortete Fragen oder lose Enden auf.4Erstelle eine saubere Zusammenfassung in einer neuen Markdown-Datei namens SUMMARY.md.5Bevor du fertig bist, überprüfe, ob jede Datei in die Überprüfung einbezogen wurde.
Das funktioniert gut für Anfänger, weil es leise fast alles lehrt, worauf es ankommt.
Der Agent hat:
- einen Umfang: alle Dateien in diesem Ordner,
- ein Ziel: Themen und offene Fragen zusammenfassen,
- eine Aktion: lesen und synthetisieren,
- ein Ergebnis: SUMMARY.md,
- einen Verifikationsschritt: sicherstellen, dass jede Datei einbezogen wurde.
Das ist ein echter Loop, auch wenn er einfach ist.
Warum das in Claude Code so gut funktioniert
Claude Code ist gut für Anfänger, weil die Umgebung aufgabenbasiertes Denken fördert.
Viele KI-Tutorials lehren Agenten auf eine abstrakte Weise.
Sie sprechen über Werkzeuge, Gedächtnis, Orchestrierung und Autonomie, bevor du überhaupt ein nützliches Ergebnis gesehen hast.
Claude Code dreht das um.
Es ermöglicht dir, mit einer konkreten Aufgabe zu beginnen und dann, fast zufällig, zu bemerken, dass der Agent einem Loop folgt:
prüfen, handeln, verifizieren, fortfahren.
Das ist wichtig, weil die meisten Anfänger nicht mehr Theorie brauchen. Sie brauchen eine erfolgreiche Erfahrung und müssen sehen, dass ein Agent kein futuristisches Wesen ist.
Es ist nur ein strukturierter Arbeitsablauf, der KI nutzt, um durch Arbeit zu navigieren.
Claude Code lässt auch Skills und Tools weniger einschüchternd wirken, weil sie in einem praktischen Kontext sitzen. Anstatt zu fragen: „Was ist ein tool-fähiger Agent in der Theorie?“, stellst du bessere Fragen:
„Welches Tool würde dieser Aufgabe helfen?“
„Was sollte der Agent überprüfen, bevor er anhält?“
„Was passiert, wenn die Ausgabe unvollständig ist?“
Das sind die richtigen Anfängerfragen.
Hinzufügen von Tools und Skills
Sobald der grundlegende Agent funktioniert, besteht der nächste Schritt nicht darin, ihn überall schlauer zu machen, sondern ihm eine nützliche Erweiterung zu geben.
Zum Beispiel könnte dein Agent:
- Notizen lesen und eine Zusammenfassung erstellen,
- dann Aktionspunkte extrahieren,
- diese Aktionspunkte dann in eine Checkliste umschreiben,
- und sie dann in einer anderen Datei speichern.
Oder er könnte:
- einen Projektordner scannen,
- fehlende Dokumentation identifizieren,
- und vorschlagen, wo kurze README-Dateien benötigt werden.
Hier werden Tools und Skills nützlich. Ein Tool hilft dem Agenten, etwas Konkretes zu tun. Ein Skill gibt ihm ein wiederholbares Muster zur Bearbeitung einer Kategorie von Arbeit.
Für Anfänger ist der einfachste Weg, darüber nachzudenken, dieser:
Ein Tool ist das, was der Agent verwenden kann;
Ein Skill ist, wie der Agent lernt, es gut zu verwenden.
Überlaste dein erstes Projekt nicht. Füge eine nützliche Erweiterung erst hinzu, nachdem der erste Loop bereits funktioniert.
Der genaue Prompt, der gut funktioniert
Dies ist die Art von Prompt, die ich einem Anfänger geben würde, der Claude Code für einen ersten Agenten verwendet:
1Du hilfst mir, einen kleinen Datei-Review-Agenten zu bauen.23Aufgabe:41. Lese alle Dateien in diesem Ordner.52. Fasse die Hauptthemen über sie hinweg zusammen.63. Identifiziere unbeantwortete Fragen, fehlende Teile oder Aktionspunkte.74. Erstelle eine Markdown-Datei namens SUMMARY.md mit:8 - Hauptthemen9 - Offene Fragen10 - Vorgeschlagene nächste Schritte115. Überprüfe vor dem Abschluss, ob jede Datei im Ordner überprüft wurde.1213Mach die Ausgabe nicht zu kompliziert.14Halte die Zusammenfassung praktisch und leicht überfliegbar.
Was mir an diesem Prompt gefällt, ist, dass er nicht versucht, fortgeschritten zu klingen. Er ist klar, eng gefasst und operativ. Genau das, was Anfänger brauchen.
Wenn du eine etwas agentenhaftere Version möchtest, verwende diese:
1Überprüfe die Dateien in diesem Ordner als KI-Agent.2Arbeite Schritt für Schritt.3Prüfe zuerst die verfügbaren Dateien.4Extrahiere dann die wichtigsten Themen und Aktionspunkte.5Erstelle dann SUMMARY.md.6Überprüfe schließlich, ob keine Datei übersprungen wurde, bevor du anhältst.
Diese Version macht den Loop noch expliziter.
Wie man es richtig testet
Die meisten Anfänger „testen“ einen Agenten, indem sie sehen, ob er etwas produziert hat. Das ist zu schwach.
Der eigentliche Test ist, ob er die tatsächliche Aufgabe korrekt erledigt hat.
Für diesen ersten Agenten ist der Test einfach:
- Hat er alle Dateien überprüft?
- Spiegelt die Zusammenfassung den tatsächlichen Inhalt wider?
- Hat er etwas Offensichtliches übersehen?
- Hat er die richtige Ausgabedatei erstellt?
- Fühlte sich das Endergebnis nützlich an, nicht nur plausibel?
Dieser letzte Punkt ist sehr wichtig. KI-Ausgaben klingen oft glatt, selbst wenn sie oberflächlich sind. Überprüfe also nicht nur, ob die Formatierung gut aussieht. Überprüfe, ob der Inhalt tatsächlich richtig ist.
Hier hilft Claude Code wieder. Da es innerhalb der Aufgabenumgebung arbeitet, kannst du die Dateien überprüfen, das Ergebnis vergleichen und die Anweisung präzisieren, wenn etwas abgewichen ist.
So sieht das Bauen von Agenten am Anfang wirklich aus: kleiner Loop, testen, anpassen, erneut ausführen.
Häufige Fehler, die Anfänger machen
Der größte Fehler ist, zu früh etwas zu Ambitioniertes bauen zu wollen.
Dein erster Agent sollte keine zehn Tools, Gedächtnis, Zeitplanung und eine komplexe Kette von Unteragenten benötigen.
Das ist nicht „anfängerfreundlich.“ Das ist Verwirrung in einer coolen Jacke.
Der zweite Fehler ist die Verwendung vager Ziele.
Wenn du sagst „verbessere diesen Ordner“, hat der Agent keine starke Definition von Erfolg.
Wenn du sagst „überprüfe alle Dateien, fasse Themen zusammen, identifiziere offene Fragen und erstelle SUMMARY.md“, hat er jetzt eine Richtung.
Der dritte Fehler ist das Überspringen der Verifikation.
Ein System, das handelt ohne zu prüfen, ist kein starker Agent. Es ist nur schnelles Raten.
Der vierte Fehler ist die Besessenheit von Terminologie. Du musst nicht jeden KI-Agenten-Buzzword beherrschen, bevor du einen baust. Baue zuerst. Der Wortschatz kann aufholen.
Was du als Nächstes bauen solltest
Sobald dieser erste Agent funktioniert, kannst du auf sehr natürliche Weise aufsteigen.
Die nächsten nützlichen Anfängerprojekte sind normalerweise Dinge wie:
- ein Recherche-Agent, der Notizen liest und Briefings erstellt,
- ein Codebasis-Agent, der fehlende Dokus oder TODOs findet,
- ein Inhalts-Agent, der grobe Notizen in strukturierte Entwürfe verwandelt,
- ein täglicher Review-Agent, der Dateien scannt und ein Update-Protokoll erstellt.
Beachte das Muster: Alle sind immer noch Loops.
Sie werden nur etwas reichhaltiger im Kontext und etwas strenger in der Verifikation.
Das ist der wahre Anfängerpfad mit Claude Code. Keine Prompt-Tricks. Keine glänzende Komplexität. Nur lernen, den Loop jedes Mal klarer zu definieren.
Die wahre Erkenntnis
Dein erster KI-Agent sollte sich fast enttäuschend klein anfühlen.
Das ist ein gutes Zeichen. Es bedeutet, dass du etwas baust, das real genug ist, um es zu verstehen, zu testen und zu verbessern. Claude Code ist ein so starkes Anfängerwerkzeug, weil es diese Art des Lernens praktisch macht. Es zeigt dir, dass ein Agent keine Magie ist. Es ist ein strukturierter Kreislauf aus Ziel, Kontext, Aktion, Verifikation und Anhalten.
Baue einen kleinen Agenten, der funktioniert.
Mach ihn dann etwas besser.
Füge dann ein Tool hinzu.
Teste dann erneut.
So kommst du von „Ich habe keine Ahnung, was ein KI-Agent ist“ zu „Ich habe in unter einer Stunde einen gebaut.“
Ich hoffe, der Artikel hat dir gefallen.
Ich baue bessere KI-Workflows für Kreative wie dich.
❣️Ich bin Kanika (@KanikaBK) – folge mir für weitere praktische Tests und Setups.
