Claude Code Tutorial für Einsteiger: Dein erster KI-Agent in 30 Minuten (2026)

30 Min
Bis zum ersten Agenten
0
Vorwissen nötig
kostenlos
Claude Code CLI

Claude Code ist das Terminal-Tool von Anthropic — du gibst ihm eine Aufgabe in normaler Sprache, und es führt sie selbstständig aus. Dateien erstellen, Code schreiben, APIs aufrufen, Berichte generieren. Ohne dass du jeden Schritt erklären musst.

In diesem Tutorial richtest du es komplett von Null ein — und baust deinen ersten funktionierenden Agenten. Kein Programmierhintergrund vorausgesetzt.

Was du am Ende hast: Einen laufenden KI-Agenten der eine echte Aufgabe autonom erledigt, plus eine CLAUDE.md-Vorlage die du für eigene Projekte wiederverwenden kannst.

Was ist Claude Code überhaupt?

Claude Code ist eine Erweiterung des Claude-KI-Modells — aber statt im Browser zu chatten, läuft es direkt im Terminal. Das gibt ihm echten Zugriff auf deinen Computer: es kann Dateien lesen und schreiben, Befehle ausführen, APIs aufrufen und über mehrere Schritte hinweg denken.

Der Unterschied zu ChatGPT oder dem normalen Claude-Chat ist fundamental:

Chat-KI
Gibt dir Antworten — du musst sie lesen, verstehen, und dann selbst umsetzen. Jeder Schritt erfordert dich.
Claude Code
Führt Aufgaben aus — es plant, führt aus, überprüft das Ergebnis, und meldet nur wenn es wirklich fertig ist oder Hilfe braucht.

Schritt 1: Claude Code installieren (5 Min)

Claude Code läuft im Terminal auf Mac, Linux und Windows (via WSL). Du brauchst:

TerminalInstallation
# Node.js prüfen (muss ≥18 sein)
node --version

# Claude Code installieren
npm install -g @anthropic-ai/claude-code

# Prüfen ob es funktioniert
claude --version

Dann loggst du dich ein:

TerminalLogin
claude login

Ein Browser-Fenster öffnet sich — mit deinem Anthropic-Konto einloggen, fertig. Der API-Key wird automatisch gespeichert.

Schritt 2: Dein erstes Projekt vorbereiten (2 Min)

Erstelle einen neuen Ordner für deinen Agenten. Claude Code arbeitet immer im aktuellen Verzeichnis — das ist wichtig.

Terminal
mkdir mein-agent
cd mein-agent

Jetzt kommt die wichtigste Datei: CLAUDE.md. Diese Datei liest Claude Code automatisch beim Start — sie ist das "Gedächtnis" und die "Persönlichkeit" deines Agenten.

Schritt 3: CLAUDE.md erstellen — die wichtigste Datei (5 Min)

Erstelle eine Datei namens CLAUDE.md in deinem Projektordner. Das ist eine einfache Textdatei mit Markdown-Format.

Warum CLAUDE.md so wichtig ist: Ohne CLAUDE.md ist Claude Code ein generalist der bei jeder Aufgabe neu "lernen" muss wer er ist. Mit CLAUDE.md hat er eine klare Rolle, Regeln, und weiß genau was er tun darf und was nicht.

Hier ist eine Starter-Vorlage für deinen ersten Agenten — einen einfachen Recherche-Agenten:

MarkdownCLAUDE.md (Starter-Vorlage)
# Mein Recherche-Agent

## Rolle
Du bist ein Recherche-Agent. Du sammelst Informationen zu einem Thema,
fasst sie zusammen, und speicherst das Ergebnis als strukturierte Datei.

## Was du selbstständig tun kannst
- Informationen analysieren und strukturieren
- Dateien erstellen und beschreiben
- Zusammenfassungen schreiben
- Listen und Tabellen erstellen

## Was du NICHT tun darfst
- Nichts aus dem Internetladen (kein curl/wget ohne Erlaubnis)
- Keine Dateien löschen
- Keine externen Dienste aufrufen

## Output-Format
Nach jeder Aufgabe:
- Erstelle eine Datei: output/[aufgabe]-ergebnis.md
- Erste Zeile: Datum und Aufgabe
- Dann: strukturiertes Ergebnis

## Wenn du nicht weiter weißt
Sage: "STOPP: Ich brauche mehr Informationen zu [X]"
Nie raten — lieber fragen.

Speichere diese Datei als CLAUDE.md in deinem mein-agent Ordner.

Schritt 4: Den Agenten starten (2 Min)

Starte Claude Code im Terminal:

Terminal
# Normaler Modus (interaktiv)
claude

# Oder direkt eine Aufgabe übergeben
claude -p "Erstelle eine Zusammenfassung der 5 wichtigsten KI-Trends 2026"

Claude Code liest automatisch deine CLAUDE.md und weiß sofort: ich bin ein Recherche-Agent, ich speichere Ergebnisse in output/, und ich frage wenn ich nicht weiter weiß.

Schritt 5: Deine erste echte Aufgabe (10 Min)

Lass deinen Agenten etwas Nützliches tun. Kopiere diesen Befehl und passe das Thema an:

Terminal
claude -p "Analysiere die Hauptthemen in den folgenden 3 Texten und erstelle eine strukturierte Zusammenfassung mit den wichtigsten Gemeinsamkeiten und Unterschieden. Speichere das Ergebnis in output/analyse.md"

Was jetzt passiert: Claude Code liest die CLAUDE.md, versteht seine Rolle, plant die Aufgabe, führt sie Schritt für Schritt aus, und erstellt die Ausgabe-Datei. Du siehst jeden Schritt live im Terminal.

Das ist der "Aha-Moment": Du hast nicht jeden Schritt erklärt. Du hast das Ziel beschrieben — und der Agent hat selbst entschieden wie er es erreicht. Das ist der Unterschied zwischen einem Chatbot und einem Agenten.

Nützliche Claude Code Befehle für Einsteiger

/compact
Kontext komprimieren — wenn der Agent nach langer Arbeit langsamer wird, komprimiert dieser Befehl den Gesprächsverlauf ohne wichtige Infos zu verlieren. Unverzichtbar für lange Sessions.
/clear
Neustart — startet eine frische Konversation. Der Agent liest wieder die CLAUDE.md von vorne. Gut wenn du ein neues Projekt startest.
/help
Alle Befehle anzeigen — zeigt alle verfügbaren Claude Code Slash-Befehle. Immer hilfreich wenn man nicht weiter weiß.
--output-format json
Strukturierter Output — nützlich wenn du die Ergebnisse in anderen Skripten weiterverarbeiten willst. Gibt alles als JSON zurück statt als lesbaren Text.

Die 3 häufigsten Anfängerfehler

  1. Keine CLAUDE.md erstellen. Ohne diese Datei hat dein Agent keine Persönlichkeit, keine Grenzen, und keine Regeln. Er wird bei jeder Aufgabe anders reagieren. CLAUDE.md immer zuerst.
  2. Zu vage beschreiben was erlaubt ist. "Mach was sinnvoll ist" = Agent tut unerwartete Dinge. Stattdessen: explizit aufschreiben was er tun darf und was nicht. Je konkreter, desto verlässlicher.
  3. Zu lange Sessions ohne /compact. Nach ~40 Minuten intensiver Arbeit beginnt der Agent wichtige frühere Anweisungen zu "vergessen". /compact löst das in Sekunden.

Nächste Schritte: Vom Einzel-Agenten zum System

Was du jetzt hast, ist ein Einzelagent — gut für einen Anwendungsfall. Das echte Potenzial liegt in mehreren Agenten die zusammenarbeiten: ein "Manager"-Agent der Aufgaben verteilt, Spezial-Agenten die einzelne Schritte ausführen, ein "Kontroll"-Agent der die Qualität prüft.

Genau das zeigen wir in unserem Kurs — mit den echten Templates die unser System mit 20+ Agenten täglich laufen lässt.

Vertiefend lesen: CLAUDE.md — The Complete Guide zeigt alle Muster für Multi-Agent-Setups. Claude Code Multi-Agent System aufbauen zeigt die vollständige Hierarchie.

Fertig mit dem Einzelagenten?

Im Kurs bekommst du die vollständigen Templates aus unserem laufenden 20-Agenten-System — CEO, Department Heads, Workers. Copy-paste ready.

7 Tage kostenlos starten → Kein Kreditkarte · Sofortiger Zugang · alle 5 Module