Erfahren Sie, wie Sie Claude Code installieren, Ihren ersten Agenten von Grund auf selbst schreiben und am Ende etwas Reales in Händen halten: einen funktionierenden Agenten, der einen Ordner liest, Probleme erkennt und einen Bericht erstellt – ganz ohne Programmiererfahrung.
Ein Chatbot wartet darauf, dass Sie eine Frage stellen, und beantwortet sie. Ein KI-Agent ist anders: Sie geben ihm ein Ziel, und er findet selbstständig die nötigen Schritte, liest Dateien, führt Befehle aus und handelt eigenständig, bis die Aufgabe erledigt ist. Sie steuern nicht jede Bewegung. Sie legen nur das Ziel fest.
Dieser Unterschied ist wichtig, denn er verändert, was Sie automatisieren können. Sie tippen nicht einen Prompt nach dem anderen ein. Sie bauen etwas, das die Arbeit erledigt, während Sie sich auf andere Dinge konzentrieren.
Was Sie vor dem Start benötigen
Hier ist alles, was Sie brauchen, bevor Sie auch nur einen Befehl eingeben:
- Ein Claude-Konto mit einem kostenpflichtigen Tarif (Pro für 20 $/Monat ist das Minimum; Claude Code ist enthalten)
- Einen Mac mit macOS 13 oder neuer, einen Windows-PC oder einen Linux-Computer
- Eine Internetverbindung
- Etwa 30 bis 45 Minuten für die vollständige Einrichtung und den ersten Bau
Keine Vorkenntnisse im Programmieren erforderlich. Jeder Befehl in dieser Anleitung ist vollständig ausgeschrieben. Sie kopieren, fügen ein und drücken die Eingabetaste.
Kosten für die Befolgung dieser Anleitung: 0 $ zusätzlich zu Ihrem Abonnement. Claude Code ist in allen kostenpflichtigen Claude-Tarifen enthalten.
Claude Code installieren (Desktop-App-Weg, kein Terminal erforderlich)
Der einfachste Weg für Anfänger ist die Desktop-App. Sie bietet Ihnen die volle Leistung von Claude Code, ohne dass Sie zuerst Terminal-Befehle lernen müssen.
Gehen Sie zu claude.ai und laden Sie die Desktop-App für Ihre Plattform herunter. Öffnen Sie auf dem Mac die .dmg-Datei und ziehen Sie Claude in Ihren Programme-Ordner. Führen Sie unter Windows das Installationsprogramm aus. Starten Sie die App, melden Sie sich mit Ihrem Claude-Konto an und klicken Sie oben in der Bildschirmmitte auf den Tab „Code“.
Wenn der Tab „Code“ Sie auffordert, Ihren Tarif zu aktualisieren, enthält Ihr aktueller Tarif Claude Code nicht. Wenn er Sie auffordert, sich online anzumelden, schließen Sie die Anmeldung ab und starten Sie die App neu. In beiden Fällen landen Sie in einem sauberen Arbeitsbereich, sobald Sie angemeldet sind.
Wie Erfolg aussieht: Sie sehen ein leeres Eingabefeld mit einem aktiven Tab „Code“ und keine Fehlermeldungen. Das ist Ihr Agenten-Arbeitsbereich. Alles, was Sie bauen, lebt hier.
Was Sie bauen werden
Sie werden einen bestimmten Agenten bauen und ihn während dieser gesamten Anleitung verwenden.
Die Aufgabe des Agenten: Einen Ordner mit Textdateien lesen, jede Datei finden, der oben eine Titelzeile fehlt, und einen Bericht namens missing-titles.txt schreiben, der jede Datei auflistet, die repariert werden muss.
Dies ist eine reale, nützliche Aufgabe. Sie zeigt jedes Kernverhalten eines Agenten: Dateien lesen, Entscheidungen treffen und Ausgaben schreiben. Und sie ist einfach genug, um bei Erfolg mit eigenen Augen überprüft zu werden.
Schritt 1: Erstellen Sie Ihren Arbeitsordner
Erstellen Sie einen neuen Ordner auf Ihrem Desktop mit dem Namen my-agent. Dies ist der Ordner, in dem der Agent arbeiten wird. Er kann nur Dateien innerhalb dieses Ordners sehen und bearbeiten, was alles sicher und eingegrenzt hält.
Erstellen Sie innerhalb von my-agent einen zweiten Ordner namens articles. Dies ist der Ordner, in dem der Agent nach zu überprüfenden Dateien suchen wird.
Erstellen Sie nun vier reine Textdateien innerhalb von articles. Nennen Sie sie post-one.txt, post-two.txt, post-three.txt und post-four.txt. Öffnen Sie zwei davon und fügen Sie dies als allererste Zeile hinzu:
1Title: My Article
Lassen Sie die anderen beiden Dateien vollständig leer. Die Aufgabe des Agenten ist es, diese leeren Dateien zu finden.
Wie Erfolg aussieht: Ihre Ordnerstruktur ist my-agent/articles/ und sie enthält vier .txt-Dateien, zwei mit einer Titelzeile und zwei ohne.
Schritt 2: Schreiben Sie die CLAUDE.md-Anweisungsdatei
CLAUDE.md ist eine reine Textdatei, die Claude Code zu Beginn jeder Sitzung liest. Sie enthält die ständigen Anweisungen für Ihren Agenten, das Äquivalent einer Stellenbeschreibung, die er nie vergisst.
Erstellen Sie innerhalb des Ordners my-agent (nicht innerhalb von articles) eine neue Datei namens CLAUDE.md. Öffnen Sie sie in einem beliebigen Texteditor, einschließlich Notepad unter Windows oder TextEdit auf dem Mac, und fügen Sie dies genau so ein:
1# My File Checker Agent23## Ihre Aufgabe45Überprüfen Sie jede .txt-Datei im Ordner /articles.67## Worauf Sie achten sollen89Eine gültige Datei beginnt mit einer Zeile, die genau so lautet: Title:1011Wenn die erste Zeile nicht mit "Title:" beginnt, fehlt der Datei ihr Titel.1213## Was zu tun ist14151. Lesen Sie jede .txt-Datei in /articles nacheinander.162. Notieren Sie, welche Dateien die Title-Zeile vermissen lassen.173. Schreiben Sie eine Datei namens missing-titles.txt in den Hauptordner.184. Listen Sie in dieser Datei jeden Dateinamen auf, der die Überprüfung nicht bestanden hat, einen pro Zeile.195. Wenn alle Dateien bestehen, schreiben Sie stattdessen "All files have titles." in missing-titles.txt.2021## Was nicht zu tun ist2223Bearbeiten Sie keine der Artikeldateien. Nur lesen. Schreiben Sie nur in missing-titles.txt.
Speichern Sie die Datei. Das ist das gesamte Gehirn Ihres Agenten. Claude Code wird dies lesen, bevor es irgendetwas tut.
Wie Erfolg aussieht: Sie haben eine Datei unter my-agent/CLAUDE.md und sie enthält die obigen Anweisungen.
Schritt 3: Weisen Sie Claude Code auf Ihren Ordner hin
Öffnen Sie die Claude Code Desktop-App und klicken Sie auf das Ordnersymbol oder die Option „Ordner öffnen“, um zu Ihrem my-agent-Ordner zu navigieren. Wählen Sie ihn aus und bestätigen Sie.
Claude Code wird Ihre CLAUDE.md-Datei automatisch lesen. Sie werden keine Bestätigungsmeldung dafür sehen; dies geschieht jedes Mal im Hintergrund, wenn Sie einen Ordner öffnen.
Wenn Sie stattdessen das Terminal verwenden, öffnen Sie Ihr Terminal und führen Sie Folgendes aus:
1cd ~/Desktop/my-agent2claude
Der Befehl cd bedeutet „Verzeichnis wechseln“. Er bringt Sie in Ihren my-agent-Ordner. Die Eingabe von claude startet die Agentensitzung von diesem Ordner aus.
Schritt 4: Führen Sie den Agenten aus
Geben Sie im Eingabefeld am unteren Rand der Claude Code-Oberfläche genau dies ein:
1Lesen Sie jede .txt-Datei im Ordner articles. Finden Sie jede Datei, der oben eine Title-Zeile fehlt. Schreiben Sie die Ergebnisse wie in CLAUDE.md angewiesen in missing-titles.txt.
Drücken Sie die Eingabetaste. Beobachten Sie, was passiert.
Claude Code zeigt Ihnen seine Arbeit während der Ausführung an: welche Dateien es liest, was es in jeder findet und was es schreibt. Diese Transparenz ist beabsichtigt. Sie können jede Aktion sehen, bevor sie passiert, und sie stoppen, wenn etwas falsch aussieht.
Wie Erfolg aussieht: Claude liest vier Dateien, identifiziert zwei ohne Titel und erstellt missing-titles.txt in Ihrem my-agent-Ordner. Öffnen Sie diese Datei und Sie sollten die beiden Dateinamen sehen, einen pro Zeile aufgelistet.
Häufiger Anfängerfehler: Der Agent sagt, er sei fertig, aber die Datei ist leer
Dies passiert, wenn der Agent missing-titles.txt schreibt, aber tatsächlich nichts hineinschreibt. Die Ursache ist fast immer eine zu vage Anweisung in CLAUDE.md.
Die Lösung: Öffnen Sie CLAUDE.md und machen Sie die Ausgabeanweisungen expliziter. Schreiben Sie statt „die Dateien auflisten“ „jeden Dateinamen in eine eigene Zeile schreiben, wie folgt: post-two.txt“. Konkrete Beispiele in Ihren Anweisungen führen jedes Mal zu konkreten Ergebnissen.
Wenn der Agent die falschen Dateinamen schreibt oder einen übersieht, überprüfen Sie, ob Ihre Artikeldateien tatsächlich die Erweiterung .txt und nicht .txt.txt haben, was unter Windows passieren kann, wenn Dateierweiterungen ausgeblendet sind. Aktivieren Sie „Dateierweiterungen anzeigen“ in Ihren Datei-Explorer-Einstellungen, um dies zu überprüfen.
Schritt 5: Überprüfen und erweitern
Öffnen Sie missing-titles.txt und bestätigen Sie, dass es genau die beiden Dateien auflistet, die Sie leer gelassen haben. Wenn dies der Fall ist, hat Ihr Agent korrekt von Anfang bis Ende funktioniert.
Sie haben jetzt einen funktionierenden Agenten. Er lebt in my-agent, liest aus CLAUDE.md und kann jedes Mal ausgeführt werden, wenn Sie neue Dateien in den articles-Ordner legen und denselben Prompt ausführen.
Der naheliegende nächste Schritt: Aktualisieren Sie CLAUDE.md, um auch zu überprüfen, ob jede Datei länger als fünf Zeilen ist. Fügen Sie dies unter „Worauf Sie achten sollen“ hinzu:
1Eine gültige Datei hat auch mehr als 5 Zeilen Inhalt.2Wenn eine Datei 5 Zeilen oder weniger hat, markieren Sie sie zusammen mit der Titelprüfung als "zu kurz".
Führen Sie den Agenten erneut mit demselben Prompt aus. Er wird nun zwei Dinge statt einem überprüfen, ohne Änderungen an Ihrem Prompt, nur durch eine Änderung der Anweisungsdatei.
Was Sie gerade gebaut haben und warum es wichtig ist
Sie haben einen Agenten gebaut, der Dateien liest, Entscheidungen trifft und Ausgaben schreibt, ohne dass Sie jeden Schritt überwachen müssen. Das ist das Kernmuster hinter jedem fortschrittlicheren Agenten, den Sie jemals bauen werden.
Die CLAUDE.md-Datei ist der Teil, der skaliert. Jede neue Regel, neue Überprüfung oder jedes neue Ausgabeformat, das Sie dort hinzufügen, ändert, was der Agent tut, ohne dass Sie ändern, wie Sie ihn ausführen. Der Prompt bleibt gleich. Die Anweisungen entwickeln sich weiter.
Von hier aus sind die natürlichen Erweiterungen: Überprüfung weiterer Dateitypen, Schreiben des Berichts in ein anderes Format wie CSV oder Ausführen der Überprüfung nach einem Zeitplan mit der integrierten Routinen-Funktion von Claude Code.
Fragen zu einem Schritt? Hinterlassen Sie sie unten.
