Wenn du dein eigener Chef sein willst, solltest du dir 30 Minuten Zeit für dich nehmen.
Denn heute erkläre ich dir, wie du an einem einzigen Nachmittag einen voll funktionsfähigen KI-Agenten baust – ganz ohne Programmierkenntnisse.
Verwechsle nicht, was ich dir gleich erzählen werde, mit einem Chatbot. Ein Chatbot wartet auf eine Frage und gibt eine Antwort. Ein Agent arbeitet anders: Du gibst ihm ein Ziel, und er legt die Schritte selbst fest, liest Dateien, führt Befehle aus und arbeitet eigenständig weiter, bis die Aufgabe erledigt ist. Du steuerst nicht jede Bewegung; du zeichnest nur die Route vor.
Dieser Unterschied ist wichtig, denn du schreibst nicht mehr einen Prompt nach dem anderen. Während du dich anderen Aufgaben widmest, erledigt sich die Arbeit von selbst.
WAS WIRD BENÖTIGT?
Alles, was du vor der Installation brauchst, findest du hier:
- Ein bezahlter Claude-Plan (Pro, 20 $/Monat, beinhaltet Claude Code)
- Mac (macOS), Windows oder Linux
- Internet
- 30–45 Minuten freie Zeit
Es sind keine Programmierkenntnisse erforderlich. Jeder Befehl ist vollständig ausgeschrieben; du kopierst ihn einfach und drückst die Eingabetaste.
Es entstehen keine zusätzlichen Kosten. Du gibst keinen einzigen Cent zusätzlich zum Abonnement aus.
INSTALLATION: DESKTOP-ANWENDUNG, OHNE TERMINAL
Der einfachste Weg für Anfänger ist die Desktop-Anwendung. Sie legt dir die volle Leistungsfähigkeit von Claude Code in die Hände, ohne dass du das Terminal erlernen musst.
Lade die für dein Betriebssystem geeignete Desktop-Anwendung über claude.ai herunter. Öffne auf dem Mac die .dmg-Datei und ziehe Claude in den Programme-Ordner; führe unter Windows das Installationsprogramm aus. Öffne die Anwendung, melde dich mit deinem Konto an und klicke oben in der Mitte auf den Tab „Code“.
Wenn der Tab „Code“ nach einem Plan-Upgrade fragt, bedeutet das, dass dein aktueller Plan Claude Code nicht abdeckt. Wenn er nach einer Online-Anmeldung fragt, schließe die Anmeldung ab und starte die Anwendung neu. In beiden Fällen landest du schließlich in einem leeren Arbeitsbereich.
Erfolg bedeutet hier: ein leeres Eingabefeld, ein aktiver Tab „Code“ und keine Fehlermeldungen. Alles, was du von nun an baust, wird in diesem Bereich leben.
WAS WERDEN WIR BAUEN?
Wir werden einen einzigen, klaren Agenten bauen; wir werden mit demselben Agenten bis zum Ende des Artikels fortfahren.
Seine Aufgabe ist diese: Er wird die Textdateien in einem Ordner lesen, diejenigen mit fehlenden Titeln finden und einen Bericht namens missing-titles.txt erstellen, der die zu korrigierenden Dateien für dich auflistet.
Eine kleine, aber reale Aufgabe. Sie umfasst die drei grundlegenden Dinge, die ein Agent tun sollte: Dateien lesen, Entscheidungen treffen und Ausgaben schreiben. Und sie ist einfach genug, dass du mit eigenen Augen überprüfen kannst, ob sie funktioniert oder nicht.
SCHRITT 1: EINRICHTEN DES ARBEITSORDNERS
Erstelle einen Ordner mit dem Namen my-agent auf deinem Desktop. Der Agent wird hier arbeiten; er kann nur das Innere dieses Ordners sehen und berühren, sodass alles sicher bleibt.
Erstelle innerhalb von my-agent einen zweiten Ordner namens articles. Der Agent wird hier nach den zu prüfenden Dateien suchen.
Erstelle vier reine Textdateien im Ordner articles: post-one.txt, post-two.txt, post-three.txt, post-four.txt. Öffne zwei davon und schreibe ganz oben Folgendes:
Title: My Article
Lasse die anderen beiden vollständig leer. Die Aufgabe des Agenten ist es genau, diese leeren zu finden.
Deine Ordnerstruktur sollte my-agent/articles/ sein, mit vier .txt-Dateien, zwei mit Titeln und zwei ohne.
SCHRITT 2: SCHREIBE DIE CLAUDE.md-INSTRUKTIONSDATEI
CLAUDE.md ist eine reine Textdatei, die Claude Code zu Beginn jeder Sitzung liest. Betrachte sie als die festen Anweisungen deines Agenten, eine Stellenbeschreibung, die er nie vergisst.
Erstelle innerhalb des Ordners my-agent (nicht in articles) eine neue Datei mit dem Namen CLAUDE.md. Öffne sie in einem beliebigen Texteditor – Notepad unter Windows, TextEdit auf dem Mac – und füge genau Folgendes ein:
# My File Check Agent ## Your Task Check every .txt file in the /articles folder.
## What to look for A valid file starts with this line: Title: If the first line does not start with "Title:", the file's title is missing.
## What to do 1. Read every .txt file inside /articles one by one. 2. Note which files have missing titles. 3. Create a file named missing-titles.txt in the main folder. 4. Write each filename that failed the check into this file, one per line. 5. If all files are valid, write "All files have titles." into missing-titles.txt.
## What not to do Do not edit any article files. Only read. Only write to the missing-titles.txt file.
Speichere sie. Das ist das gesamte Gehirn deines Agenten. Claude Code wird dies vor allem anderen lesen.
Die Datei my-agent/CLAUDE.md ist erstellt und enthält die obigen Anweisungen, das ist alles.
SCHRITT 3: WEISE CLAUDE CODE ZUM ORDNER
Öffne die Claude Code Desktop-Anwendung, klicke auf das Ordnersymbol oder die Option „Ordner öffnen“ und navigiere zum my-agent-Ordner. Wähle ihn aus und bestätige.
Claude Code wird deine CLAUDE.md-Datei automatisch lesen. Du wirst keine Bestätigungsmeldung sehen; dies geschieht jedes Mal im Hintergrund, wenn du einen Ordner öffnest.
Wenn du ein Terminal verwendest, öffne das Terminal und führe Folgendes aus:
cd ~/Desktop/my-agent claude
Der Befehl cd bedeutet „Verzeichnis wechseln“; er bewegt dich in den Ordner my-agent. Die Eingabe von claude startet die Sitzung von diesem Ordner aus.
SCHRITT 4: FÜHRE DEN AGENTEN AUS
Gib genau Folgendes in das Eingabefeld am unteren Rand der Claude Code-Oberfläche ein:
Read every .txt file in the articles folder. Find any file missing a Title line at the top. Write the results to missing-titles.txt as instructed in CLAUDE.md.
Drücke die Eingabetaste. Und schau zu.
Claude Code zeigt dir alles an, was es während der Arbeit tut: welche Datei es liest, was es in jeder findet und was es schreibt. Diese Transparenz ist beabsichtigt. Du kannst jede Aktion sehen, bevor sie passiert, und sie stoppen, wenn etwas seltsam aussieht.
Claude liest die vier Dateien, erkennt die beiden ohne Titel und erstellt die Datei missing-titles.txt in deinem my-agent-Ordner. Wenn du sie öffnest, solltest du die beiden Dateinamen untereinander geschrieben sehen.
HÄUFIGSTER FEHLER: AGENT SAGT „FERTIG“, ABER DIE DATEI IST LEER
Dies passiert normalerweise, wenn der Agent die Datei missing-titles.txt erstellt, aber nichts hineinschreibt. Der Grund ist fast immer, dass die Anweisung in CLAUDE.md zu vage ist.
Lösung: Öffne CLAUDE.md und mache die Ausgabeanweisungen konkreter. Schreibe anstelle von „Liste die Dateien auf“: „Schreibe jeden Dateinamen in eine eigene Zeile, zum Beispiel: post-two.txt.“ Ein konkretes Beispiel in der Anweisung zu nennen, macht die Ausgabe jedes Mal konkret.
Wenn der Agent den falschen Dateinamen schreibt oder einen auslässt, stelle sicher, dass deine Artikeldateien wirklich die Erweiterung .txt haben, nicht .txt.txt. Dies passiert oft unter Windows, wenn Dateierweiterungen ausgeblendet sind. Aktiviere „Dateierweiterungen anzeigen“ in den Explorer-Einstellungen und überprüfe es.
SCHRITT 5: ÜBERPRÜFEN UND ERWEITERN
Öffne die Datei missing-titles.txt und überprüfe, ob die beiden Dateien, die du leer gelassen hast, aufgelistet sind. Wenn es korrekt ist, bedeutet das, dass dein Agent von Anfang bis Ende richtig gearbeitet hat.
Jetzt hast du einen funktionierenden Agenten. Er lebt in my-agent, bezieht seine Anweisungen aus CLAUDE.md, und du kannst ihn mit demselben Prompt erneut ausführen, wenn du neue Dateien in den articles-Ordner legst.
Der nächste klare Schritt: Aktualisiere CLAUDE.md und lasse ihn auch prüfen, ob jede Datei länger als fünf Zeilen ist. Füge dies unter der Überschrift „What to look for“ hinzu:
**A valid file also contains content longer than 5 lines. If a file is 5 lines or shorter, also mark it as "too short" next to the title check.**
Führe den Agenten erneut mit demselben Prompt aus. Jetzt wird er zwei Dinge statt einem prüfen; du hast keine Änderungen an deinem Prompt vorgenommen, nur die Anweisungsdatei hat sich geändert.
WAS HAST DU GETAN UND WARUM IST ES WICHTIG?
Du hast einen Agenten gebaut, der Dateien liest, Entscheidungen trifft, Ausgaben schreibt und dies tut, ohne dass du jeden Schritt überwachen musst. Dies ist das grundlegende Muster für jeden fortgeschritteneren Agenten, den du von nun an bauen wirst.
Der Teil, der skaliert, ist CLAUDE.md. Jede neue Regel, jede neue Prüfung und jedes neue Ausgabeformat, das du dort hinzufügst, ändert, was der Agent tut, ohne dass du änderst, wie du ihn ausführst. Der Prompt bleibt gleich, die Anweisung entwickelt sich weiter.
Natürliche nächste Schritte: Überprüfen weiterer Dateitypen, Schreiben des Berichts in einem anderen Format wie CSV oder automatisches Wiederholen der Prüfung in bestimmten Abständen.
Herzlichen Glückwunsch, du hast den ersten Schritt gemacht; der Rest liegt in deinen Händen, proportional zu deiner Vorstellungskraft.
Handle, bevor die Lücke größer wird.
Vergiss nicht zu speichern und zu teilen, und unterstütze uns mit einem Kommentar.
