Claude Code für Einsteiger: Vom Terminal-Prompt zum autonomen KI-Agenten

[!NOTE] Ein Praxisleitfaden des KI-Teams von Um:bruch (Textsorte: Praxisleitfaden PL / Tutorial). Ziel ist die barrierefreie Vermittlung von KI-Kompetenz für Interessierte, Bildungseinrichtungen und Praxisanwender.

1. Was ist Claude Code?

Während klassische KI-Interfaces (wie Web-Chats) darauf beschränkt sind, Text in einem Browserfenster anzuzeigen, erweitert Claude Code (und vergleichbare CLI-Agenten-Frameworks) die Fähigkeiten von Sprachmodellen radikal: Sie agieren direkt auf der Kommandozeile (Terminal) Ihres Computers.

Das bedeutet:

Dateizugriff: Die KI kann Dateien in einem Projektordner lesen, analysieren, durchsuchen und direkt bearbeiten.
Befehlsausführung: Sie kann Entwicklungs-Befehle, Tests, Skripte oder Datenanalysen eigenständig ausführen und die Ausgaben auswerten.
Werkzeug-Nutzung (Tools): Über Schnittstellen (Model Context Protocol / MCP) kann die KI auf externe Werkzeuge zugreifen — von Datenbanken über Git-Versionsverwaltung bis hin zu spezialisierten Suchwerkzeugen.

+-------------------------------------------------------+
|                    MENSCH (User)                      |
+-------------------------------------------------------+
                           |
               Aufgabe & Bestätigung
                           v
+-------------------------------------------------------+
|                 CLAUDE CODE / AGENT                   |
|  - Liest Dateisystem                                  |
|  - Führt Befehle aus                                  |
|  - Plant Schritte & behebt Fehler selbstständig        |
+-------------------------------------------------------+
                           |
            Werkzeug-Aufrufe (MCP / Tools)
                           v
+-------------------------------------------------------+
|                  LOKALES SYSTEM                       |
|  Dateien (.md, .py, .js) | Git | Terminal / Build     |
+-------------------------------------------------------+

2. Die Grundbausteine einer Sitzung

Wenn Sie mit einem Terminal-Agenten wie Claude Code arbeiten, sind drei Kernkonzepte entscheidend:

a) Das Arbeitsverzeichnis (Workspace)

Der Agent sieht immer den Ordner, in dem er gestartet wurde. Innerhalb dieses Ordners kann er navigieren, Dateien durchsuchen und Strukturen auslesen. Eine klare Ordnerstruktur (mit Dokumenten wie README.md, TODO.md oder CLAUDE.md) hilft der KI, sich sofort zu orientieren.

b) Das Regelwerk (`CLAUDE.md`)

Kommandozeilen-Agenten prüfen beim Start oft projektspezifische Anweisungen in einer zentralen Konfigurationsdatei (z. B. CLAUDE.md oder AGENTS.md). Hier werden verbindliche Regeln festgelegt:

Schreib- und Stilregeln (z. B. Verwendung echter Umlaute in deutschen Texten)
Verbotene Operationen (z. B. kein automatischer Mailversand ohne menschliche Freigabe)
Pfadstruktur und Zuständigkeiten

c) Der Bestätigungskreislauf (Human-in-the-Loop)

Die KI handelt nicht völlig unkontrolliert. Befehle, die Dateien verändern, Terminalbefehle ausführen oder Netzwerkzugriffe starten, müssen vom Anwender im Terminal bestätigt werden. Sie behalten jederzeit die volle Kontrolle ([y/N]).

3. Schritt-für-Schritt: Der erste Arbeitsablauf

Schritt 1: Das Projekt vorbereiten

Legen Sie einen Ordner für Ihr Projekt an. Fügen Sie eine kurze Übersicht hinzu, worum es geht (README.md):

# Mein Erstes KI-Projekt

Zweck: Auswertung von Umfrage-Ergebnissen im CSV-Format.
Erwartetes Ergebnis: Eine zusammenfassende Markdown-Analyse.

Schritt 2: Den Agenten starten

Starten Sie das Terminal in Ihrem Projektordner und rufen Sie den Agenten auf:

claude

Schritt 3: Eine klare Aufgabe formulieren

Formulieren Sie Aufgaben nach dem ZIEL-ROUTINE-ABSCHLUSS-Schema:

Ziel: Was soll am Ende vorliegen?
Kontext: Welche Dateien sollen verwendet werden?
Einschränkung: Was darf nicht geändert werden?

Beispiel-Prompt:

„Lies die Datei daten.csv im Ordner data/. Erstelle eine Zusammenfassung der drei wichtigsten Trends und speichere das Ergebnis als bericht_draft.md. Verändere die Quelldatei daten.csv nicht.”

4. Best Practices für den Einsteiger-Alltag

Regel	Warum es wichtig ist	Praxis-Tipp
Kleine Häppchen statt Mammutaufgaben	Komplexe Aufgaben führen zu Fehlschlüssen.	Zerlegen Sie die Arbeit in überprüfbare Einzelschritte.
Beweisquellen verlangen	KI-Modelle neigen zum Bestätigen.	Bitten Sie die KI, Behauptungen mit Dateipfaden und Zeilennummern zu belegen.
Git-Versionskontrolle nutzen	Änderungen können leicht rückgängig gemacht werden.	Speichern Sie Ihren Stand (`git commit`), bevor Sie dem Agenten große Umbauten auftragen.
Sicherheitsgrenzen wahren	Keine Passwörter im Prompt.	Speichern Sie API-Schlüssel in `.env`-Dateien, die von `.gitignore` ausgeschlossen sind.

5. Fazit und Ausblick

Claude Code stellt eine Brücke dar zwischen reinem KI-Chat und vollwertiger Software-Entwicklung. Für Nicht-Programmierer eröffnet das Terminal die Möglichkeit, eigene Text- und Datenbestände hocheffizient zu organisieren. Für Entwickler wird es zum vollwertigen Pair-Programming-Partner.

In Teil 2 unserer Reihe beleuchten wir fortgeschrittene Workflows: Multi-Agenten-Setups, automatisierte Sitzungsprotokolle und das Anbinden eigener Tools via MCP.

Redaktioneller Hinweis: Dieser Beitrag wurde im Rahmen unseres KI-Bildungsauftrags (Beschluss der Redaktionssitzung RS001) entworfen. Feedbacks und Korrekturwünsche können über unser Kontaktformular oder per E-Mail eingereicht werden.