Claude Code Masterkurs – KI-gestuetztes Programmieren lernen mit Anthropics Coding-Agent

Erste Schritte & Befehle

Level 1 | 25 Minuten

Claude Code starten und die wichtigsten Befehle meistern

Lernziele

Claude Code starten

Bevor du mit Claude Code arbeiten kannst, musst du wissen, wie du es startest und welche Optionen dir zur Verfügung stehen. Im Gegensatz zu vielen anderen KI-Tools läuft Claude Code direkt in deinem Terminal — es gibt keine grafische Oberfläche, keinen Browser und keine IDE, die du zuerst öffnen musst. Du tippst einfach einen Befehl, und schon bist du drin. Stell dir Claude Code wie einen extrem intelligenten Gesprächspartner vor, der in deinem Terminal lebt. Du startest eine Unterhaltung, stellst Fragen oder gibst Aufgaben — und Claude analysiert dein Projekt, schreibt Code, führt Tests aus und erstellt Commits. Alles passiert direkt dort, wo du als Entwickler ohnehin arbeitest. Es gibt drei grundlegende Wege, Claude Code zu nutzen: Im interaktiven Modus tippst du einfach 'claude' und startest eine Konversation. Im Prompt-Modus gibst du eine einzelne Anweisung mit dem -p Flag und bekommst sofort eine Antwort zurück. Und im Session-Modus kannst du eine frühere Unterhaltung fortsetzen, anstatt jedes Mal von vorne zu beginnen. Der interaktive Modus ist der Standardfall und ideal für die meisten Aufgaben. Du startest ihn, indem du in dein Projektverzeichnis wechselst und einfach 'claude' eingibst. Claude scannt dann automatisch dein Projekt, liest die CLAUDE.md falls vorhanden, und ist bereit für deine Fragen. Du kannst beliebig viele Nachrichten hin und her schicken, genau wie in einem Chat. Der Prompt-Modus mit 'claude -p' ist perfekt für schnelle Einzelaufgaben: eine Funktion erklären, einen Bug finden oder eine Datei analysieren. Claude gibt die Antwort aus und beendet sich dann. Dieser Modus ist auch die Grundlage für die Integration in Skripte und CI/CD-Pipelines, worüber wir in späteren Lektionen sprechen. Wichtig zu verstehen: Claude Code merkt sich standardmäßig nichts zwischen verschiedenen Sessions. Jede neue Session startet mit einem frischen Context Window. Wenn du an einem längeren Task arbeitest, solltest du daher innerhalb einer Session bleiben oder die Session-Fortsetzung mit 'claude -c' nutzen.

# In einem bestehenden Projekt starten
cd mein-projekt
claude

# Mit spezifischem Prompt starten
claude "Erkläre mir die Struktur dieses Projekts"

# Mit Datei-Kontext starten
claude "Refaktoriere diese Datei" src/app.ts

# Im Headless-Modus (nicht-interaktiv)
claude -p "Generiere eine README.md" --output-file README.md
💡 Pro-Tipp Starte Claude immer im Root-Verzeichnis deines Projekts, damit die CLAUDE.md Datei automatisch geladen wird.

Die wichtigsten Slash-Commands

Slash-Commands sind spezielle Befehle, die du direkt in der Claude Code Konversation eingeben kannst. Sie beginnen immer mit einem Schrägstrich (/) und steuern das Verhalten von Claude Code selbst — im Gegensatz zu normalen Nachrichten, die Claude als KI-Anfrage interpretiert. Denk an Slash-Commands wie an Menübefehle in einer App: Statt Claude zu bitten etwas zu tun, sagst du dem Tool selbst was es machen soll. Der Befehl /compact zum Beispiel komprimiert deine bisherige Konversation, um Platz im Context Window zu schaffen. Das ist kein Befehl AN Claude, sondern ein Befehl an das Claude Code System. Die wichtigsten Slash-Commands die du von Anfang an kennen solltest sind: /help zeigt dir alle verfügbaren Befehle an — das ist dein Rettungsanker wenn du nicht weiterweißt. /compact fasst die bisherige Konversation zusammen und gibt dir frischen Kontext-Platz. /clear löscht den gesamten Kontext und startet quasi eine neue Session. /cost zeigt dir an, wie viele Tokens du bisher verbraucht hast und was das kostet. Besonders mächtig sind die Kontext-Befehle: /context zeigt dir an, welche Dateien Claude gerade 'im Kopf' hat und wie voll das Context Window ist. /init lässt Claude dein Projekt scannen und eine CLAUDE.md Datei erstellen — der perfekte Startpunkt für jedes neue Projekt. /memory speichert wichtige Informationen dauerhaft in der CLAUDE.md. Für fortgeschrittene Nutzer gibt es noch /plan (wechselt in den Plan-Modus wo Claude nur analysiert aber nichts ändert), /review (startet ein Code Review), und /permissions (verwaltet welche Aktionen Claude ohne Nachfrage ausführen darf). Ein häufiger Fehler am Anfang: Slash-Commands und normale Nachrichten zu verwechseln. Wenn du tippst '/compact', wird der Befehl ausgeführt. Wenn du tippst 'bitte komprimiere den Kontext', versteht Claude zwar was du meinst, aber es ist weniger effizient. Nutze die Slash-Commands — sie sind schneller und zuverlässiger.

📌 NAVIGATION & KONTROLLE
━━━━━━━━━━━━━━━━━━━━━━━━━
/help          Zeigt alle verfügbaren Befehle
/clear         Löscht die Konversation und startet neu
/compact       Komprimiert den Kontext (spart Tokens)
/exit oder /quit   Beendet Claude Code

📌 KONTEXT & MEMORY
━━━━━━━━━━━━━━━━━━━
/init          Erstellt CLAUDE.md im aktuellen Verzeichnis
/memory        Zeigt/bearbeitet persistenten Memory
/context       Zeigt aktuellen Kontext an

📌 KONFIGURATION
━━━━━━━━━━━━━━━━
/config        Zeigt/ändert Konfiguration
/model         Wechselt das Claude-Modell
/theme         Ändert das Farbschema

📌 SPEZIELL
━━━━━━━━━━━
/diff          Zeigt Änderungen als Diff
/undo          Macht letzte Änderung rückgängig
/cost          Zeigt Token-Kosten der Session

Effektiv kommunizieren

Die Art wie du mit Claude kommunizierst, entscheidet maßgeblich über die Qualität der Ergebnisse. Claude Code ist ein extrem leistungsfähiges Tool, aber es ist nur so gut wie die Anweisungen die es bekommt. Stell dir vor, du briefst einen hochqualifizierten Freelancer: Je klarer und präziser dein Briefing, desto besser das Ergebnis. Der wichtigste Grundsatz lautet: Sei spezifisch, nicht vage. Statt 'Mach die App besser' sag 'Optimiere die Ladezeit der Dashboard-Seite, indem du die API-Aufrufe parallelisierst und ein Loading-Skeleton hinzufügst'. Statt 'Schreib Tests' sag 'Schreib Unit Tests für die validateUser Funktion in src/auth/validation.ts, die alle Edge Cases wie leere Strings, ungültige E-Mails und zu kurze Passwörter abdecken'. Der zweite Grundsatz: Gib Kontext mit. Claude kennt dein Projekt grundlegend, aber nicht die Hintergründe deiner Entscheidungen. Erkläre WARUM du etwas brauchst, nicht nur WAS. 'Wir brauchen Pagination weil die Tabelle bei Kunden mit über 10.000 Einträgen zu langsam lädt' ist viel besser als 'Füge Pagination hinzu'. Der dritte Grundsatz: Ein Task pro Nachricht. Claude arbeitet am besten wenn es einen klar definierten Auftrag hat. Wenn du drei verschiedene Dinge gleichzeitig fragst, leidet die Qualität bei allen dreien. Teile komplexe Aufgaben in Schritte auf und arbeite sie nacheinander ab. Vermeide außerdem negative Formulierungen. Statt 'Mach es nicht wie beim letzten Mal falsch' sag 'Stelle sicher dass alle API-Aufrufe Fehlerbehandlung mit try/catch haben und Fehler geloggt werden'. Claude reagiert viel besser auf positive, konstruktive Anweisungen als auf Warnungen. Und schließlich: Nutze die Stärke des Dialogs. Du musst nicht alles in einer einzigen Nachricht unterbringen. Starte mit einer Aufgabe, prüfe das Ergebnis, und verfeinere dann iterativ. Das ist oft effektiver als der Versuch, den perfekten Prompt zu schreiben.

# ❌ SCHLECHT - Zu vage
"Mach den Code besser"
"Fix die Bugs"
"Schreib Tests"

# ✅ GUT - Spezifisch & Klar
"Refaktoriere die getUserById Funktion um async/await zu nutzen"
"Finde und behebe den TypeError in src/utils/parser.ts"
"Schreibe Unit Tests für alle Funktionen in UserService"

# 🚀 BEST - Mit Kontext & Constraints
"Refaktoriere getUserById in src/services/user.ts:
- Nutze async/await statt Promises
- Füge Error Handling hinzu
- Behalte die aktuelle Interface-Signatur bei"
🔑 Die 5 Regeln für gute Prompts 1. Spezifisch sein: Welche Datei? Welche Funktion? 2. Kontext geben: Warum? Was ist das Ziel? 3. Constraints setzen: Was soll NICHT geändert werden? 4. Beispiele geben: Zeige gewünschtes Format/Stil 5. Schrittweise arbeiten: Große Tasks aufteilen

Keyboard Shortcuts

Keyboard Shortcuts machen dich in Claude Code deutlich schneller — sie ersparen dir das Tippen von Befehlen und ermöglichen blitzschnelle Navigation. Die wichtigsten Shortcuts solltest du auswendig kennen, weil du sie in jeder Session mehrfach brauchst. Die essentiellen Shortcuts: Escape unterbricht Claude's aktuelle Antwort sofort — unverzichtbar wenn Claude in die falsche Richtung geht und du Tokens sparen willst. Ctrl+C bricht den aktuellen Vorgang ab und gibt dir die Kontrolle zurück — nutze es wenn Claude in einer Schleife steckt oder zu lange braucht. Navigation: Pfeil-Hoch holt den letzten Prompt zurück — praktisch wenn du einen Prompt leicht abwandeln willst. Tab vervollständigt Dateinamen und Befehle — nutze es intensiv um Tippfehler zu vermeiden. Die @ Taste referenziert Dateien: Tippe @src/ und Tab zeigt dir verfügbare Dateien. Session-Management: /compact komprimiert die aktuelle Konversation — der wichtigste Befehl für lange Sessions. /clear löscht den gesamten Kontext und startet frisch. /cost zeigt die bisherigen Kosten der Session. /plan wechselt in den Plan-Mode für Analyse ohne Code-Änderungen. Multiline-Input: Für längere Prompts brauchst du Multiline-Eingabe. Drücke Shift+Enter für einen Zeilenumbruch innerhalb des Prompts. Oder nutze den Backslash () am Ende einer Zeile um in der nächsten Zeile weiterzuschreiben. Für sehr lange Prompts: Schreibe den Prompt in eine Datei und referenziere sie mit @datei.md. Effizienz-Tipps: Lerne die 5 wichtigsten Shortcuts auswendig (Escape, Ctrl+C, Pfeil-Hoch, Tab, /compact). Allein diese fünf werden dein Arbeitstempo spürbar verbessern. Alles andere kannst du bei Bedarf nachschlagen. Für Vim-Nutzer: Claude Code unterstützt Vim-Keybindings im Editor-Mode. Aktiviere sie in den Einstellungen wenn du gewohnt bist mit Vim-Shortcuts zu arbeiten. Merke dir: Escape ist dein bester Freund. Wenn Claude etwas tut das du nicht willst — sofort Escape drücken. Jede Sekunde die Claude in die falsche Richtung arbeitet, kostet Tokens und Zeit.

📌 EINGABE
━━━━━━━━━
Enter          Neue Zeile (mehrzeilige Eingabe)
Ctrl+J         Eingabe absenden (Alternative)
Escape         Aktuelle Eingabe abbrechen
Tab            Autocomplete für Dateipfade

📌 NAVIGATION
━━━━━━━━━━━━
↑ / ↓          Durch Verlauf scrollen
Ctrl+C         Aktuelle Operation abbrechen
Ctrl+D         Claude Code beenden
Ctrl+L         Terminal leeren (nicht Konversation)

📌 WÄHREND CLAUDE ARBEITET
━━━━━━━━━━━━━━━━━━━━━━━━━
Escape         Unterbricht Claude's Antwort
y              Bestätigt vorgeschlagene Änderung
n              Lehnt vorgeschlagene Änderung ab
e              Öffnet Editor für Anpassung

Der Conversation Flow

Jede Session mit Claude Code folgt einem natürlichen Gesprächsverlauf, den du verstehen solltest um das Tool effektiv zu nutzen. Anders als ein einmaliger API-Aufruf baut Claude Code über die Konversation hinweg ein immer tieferes Verständnis deines Problems auf. Die ersten Nachrichten einer Session sind daher besonders wichtig. Stell dir eine Claude Code Session wie ein Gespräch mit einem Kollegen vor, der gerade neu ins Team gekommen ist. Am Anfang braucht er Orientierung: Was ist das Projekt? Welche Technologien werden verwendet? Was ist das aktuelle Problem? Je besser du ihn einarbeitest, desto schneller und besser kann er helfen. Eine typische Session verläuft in vier Phasen: In der Orientierungsphase scannt Claude dein Projekt und liest die CLAUDE.md. In der Analysephase stellst du deine Frage oder Aufgabe und Claude untersucht die relevanten Dateien. In der Implementierungsphase schreibt Claude Code, erstellt Tests oder macht Änderungen. In der Verfeinerungsphase prüfst du das Ergebnis und gibst Feedback für Anpassungen. Wichtig zu verstehen ist das Konzept des Context Windows: Claude merkt sich alles was in der aktuellen Session passiert ist, aber dieses Gedächtnis hat eine begrenzte Kapazität. Jede Nachricht, jede gelesene Datei und jedes Code-Ergebnis füllt diesen Speicher. Wenn er voll wird, beginnt Claude ältere Details zu vergessen. Deshalb ist es klug, die Session-Struktur bewusst zu gestalten. Beginne mit den wichtigsten Informationen, gib Kontext der für den gesamten Task relevant ist am Anfang, und arbeite dann die Details ab. Wenn du merkst dass Claude sich an frühere Entscheidungen nicht mehr erinnert, ist es Zeit für /compact (Zusammenfassung) oder eine neue Session. Ein Pro-Tipp: Wenn du einen komplexen Task startest, fasse am Anfang zusammen was du vorhast. 'Ich möchte heute die User-Authentifizierung von Session-basiert auf JWT umstellen. Das betrifft die Dateien in src/auth/ und die Middleware in src/middleware/. Wir nutzen Express und PostgreSQL.' Diese Art von Einleitung gibt Claude die perfekte Grundlage.

┌─────────────────────────────────────────────┐
│ 1. START                                    │
│    claude (im Projektverzeichnis)           │
├─────────────────────────────────────────────┤
│ 2. CONTEXT LOADING                          │
│    → Liest CLAUDE.md                        │
│    → Analysiert Projektstruktur             │
│    → Lädt relevante Dateien                 │
├─────────────────────────────────────────────┤
│ 3. DEINE ANFRAGE                            │
│    "Erstelle einen neuen API-Endpoint..."   │
├─────────────────────────────────────────────┤
│ 4. CLAUDE'S ANALYSE                         │
│    → Versteht Anforderung                   │
│    → Plant Umsetzung                        │
│    → Identifiziert relevante Dateien        │
├─────────────────────────────────────────────┤
│ 5. VORSCHLAG & BESTÄTIGUNG                  │
│    → Zeigt geplante Änderungen              │
│    → Wartet auf dein OK (y/n/e)             │
├─────────────────────────────────────────────┤
│ 6. UMSETZUNG                                │
│    → Schreibt/ändert Code                   │
│    → Zeigt Ergebnis                         │
├─────────────────────────────────────────────┤
│ 7. ITERATION                                │
│    → Feedback geben                         │
│    → Weitere Anpassungen                    │
│    → Oder: /clear für neuen Task            │
└─────────────────────────────────────────────┘

Wichtige CLI-Flags

Claude Code lässt sich über Kommandozeilen-Flags beim Start fein steuern. Diese Flags sind wie Einstellungsknöpfe: Du bestimmst vor dem Start der Session, wie sich Claude verhalten soll — welches Modell es nutzt, welche Dateien es sehen darf, wie es Ergebnisse ausgibt und vieles mehr. Denk an CLI-Flags wie an die Einstellungen einer Kamera: Die Automatik liefert meist gute Ergebnisse, aber für spezielle Situationen willst du Blende, Verschlusszeit und ISO manuell einstellen. Genauso funktionieren die Claude Code Flags — du brauchst sie nicht für den Alltag, aber wenn du sie kennst, hast du deutlich mehr Kontrolle. Das wichtigste Flag ist --model, mit dem du das KI-Modell auswählst. Claude Code bietet verschiedene Modelle an: Opus ist das leistungsstärkste (aber teuerste), Sonnet bietet die beste Balance aus Qualität und Geschwindigkeit, und Haiku ist das schnellste und günstigste. Standardmäßig nutzt Claude Code Sonnet, was für die meisten Aufgaben perfekt ist. Mit --include und --exclude bestimmst du, welche Dateien Claude sehen soll. Das ist besonders bei großen Projekten wichtig: Statt das gesamte Repository zu analysieren, fokussierst du Claude auf die relevanten Ordner. Zum Beispiel: 'claude --include src/auth/' wenn du nur am Authentifizierungsmodul arbeitest. Das --add-dir Flag erlaubt es dir, zusätzliche Verzeichnisse außerhalb des Projektordners hinzuzufügen. Nützlich wenn du zum Beispiel auf eine Shared Library in einem anderen Ordner zugreifen musst. Das -p Flag (Print Mode) ist entscheidend für Automatisierung: Claude gibt die Antwort direkt aus und beendet sich. Kombiniert mit --output-format json bekommst du strukturierte Daten, die du in Skripten weiterverarbeiten kannst. --max-turns begrenzt die Anzahl der Iterationen, was in CI/CD-Pipelines wichtig ist. Für den täglichen Gebrauch reicht meist der einfache 'claude' Aufruf. Aber wenn du in speziellen Szenarien arbeitest — große Projekte, Automatisierung, Kosten-Kontrolle — sind diese Flags unverzichtbar.

# Model-Auswahl
claude --model opus "Komplexe Architekturanalyse"
claude --model haiku "Schneller Typo-Fix"

# Output-Kontrolle
claude -p "Query" --output-file result.md    # Ausgabe in Datei
claude -p "Query" --print                    # Nur stdout, keine Dateien

# Kontext-Steuerung
claude --no-context "Allgemeine Frage"       # Ohne Projektkontext
claude --include "src/**/*.ts"               # Nur bestimmte Dateien
claude --exclude "node_modules"              # Dateien ausschließen

# Session-Management
claude --resume                              # Letzte Session fortsetzen
claude --conversation-id abc123             # Spezifische Session laden

# Debugging
claude --verbose                             # Ausführliche Logs
claude --debug                               # Debug-Modus

Praktisches Beispiel: Erste Session

Theorie ist gut, aber nichts ersetzt die Praxis. Hier siehst du eine realistische erste Session mit Claude Code — Schritt für Schritt, so wie sie tatsächlich abläuft. Dieses Beispiel zeigt dir nicht nur die Befehle, sondern erklärt auch was im Hintergrund passiert und warum jeder Schritt wichtig ist. Stell dir vor, du hast ein kleines Node.js-Projekt und möchtest Claude Code zum ersten Mal damit nutzen. Du öffnest dein Terminal, navigierst ins Projektverzeichnis und tippst 'claude'. Was dann passiert: Claude Code startet, liest automatisch die Projektstruktur, erkennt die package.json, den Tech-Stack und die Verzeichnisstruktur. Falls eine CLAUDE.md existiert, wird sie als erstes gelesen. Nach dem Start siehst du einen Prompt und kannst sofort Fragen stellen. Ein guter erster Befehl wäre 'Erkläre mir die Projektstruktur und die wichtigsten Dateien'. Claude wird dann die Verzeichnisse durchgehen, die Architektur erklären und dir einen Überblick geben. Das ist perfekt um zu sehen, wie gut Claude dein Projekt bereits versteht. Der nächste Schritt könnte sein: 'Finde potenzielle Bugs oder Verbesserungsmöglichkeiten in src/utils.ts'. Claude liest die Datei, analysiert den Code und gibt dir konkrete Vorschläge — von fehlender Fehlerbehandlung über potenzielle Null-Pointer bis zu Performance-Verbesserungen. Wichtig dabei: Claude fragt dich um Erlaubnis bevor es Dateien ändert. Beim ersten Mal musst du für jede Aktion bestätigen. Du kannst mit 'y' für Ja oder 'n' für Nein antworten. Wenn du Claude für bestimmte Aktionen generell vertraust, kannst du 'Always allow' wählen — dann fragt es bei dieser Aktion nicht mehr nach. Nach ein paar Interaktionen solltest du /cost eingeben um zu sehen, wie viele Tokens du verbraucht hast. Das hilft dir ein Gefühl für die Kosten zu entwickeln. Eine typische 10-Minuten Session verbraucht zwischen 5.000 und 20.000 Tokens, abhängig davon wie viele Dateien gelesen werden.

# Terminal öffnen und zum Projekt navigieren
cd ~/projects/my-webapp

# Claude starten
claude

# Claude begrüßt dich und zeigt Projektinfo
# > Hallo! Ich habe dein Projekt analysiert:
# > - React + TypeScript Webapp
# > - 45 Dateien, 12.000 Zeilen Code
# > - Wie kann ich helfen?

# Deine erste Anfrage
> Zeige mir alle TODO-Kommentare im Code

# Claude findet und listet alle TODOs

# Folge-Anfrage
> Erstelle für jedes TODO ein GitHub Issue

# Claude erstellt Issues (nach Bestätigung)

# Session beenden
> /exit
⚡ Quick Reference Starten: claude oder claude "Aufgabe" Beenden: /exit, /quit oder Ctrl+D Hilfe: /help Neu starten: /clear Abbrechen: Escape oder Ctrl+C

Häufige Anfänger-Fehler

Jeder macht am Anfang Fehler mit Claude Code — das ist normal und gehört zum Lernprozess. Aber manche Fehler kosten unnötig viel Zeit, Geld oder Nerven. Wenn du diese typischen Stolperfallen kennst, bevor du sie selbst machst, sparst du dir Stunden an Frustration. Der häufigste Fehler: Zu vage Anweisungen geben. 'Mach den Code besser' oder 'Fix die Bugs' sind keine guten Prompts. Claude ist extrem leistungsfähig, aber es braucht klare Richtung. Es ist wie bei einem GPS: 'Bring mich irgendwo hin' funktioniert nicht, 'Navigiere zum Berliner Hauptbahnhof' schon. Der zweitehäufigste Fehler: Den Context nicht managen. Viele Anfänger chatten stundenlang in einer einzigen Session weiter, laden immer mehr Dateien, und wundern sich dann warum Claude plötzlich schlechtere Antworten gibt. Der Grund ist Context Rot — das Context Window ist voll und Claude verliert den Überblick. Nutze /compact regelmäßig und starte neue Sessions für neue Aufgaben. Fehler Nummer drei: Alles gleichzeitig wollen. 'Refactore die gesamte Codebase, schreib Tests für alles und aktualisiere die Dokumentation' überfordert selbst das beste KI-Modell. Teile große Aufgaben in kleinere Schritte auf. Ein Feature nach dem anderen, eine Datei nach der anderen. Fehler vier: Die CLAUDE.md vernachlässigen. Ohne CLAUDE.md muss Claude bei jeder Session von Null anfangen und dein Projekt neu verstehen. Mit einer guten CLAUDE.md hat Claude sofort den nötigen Kontext und produziert konsistent bessere Ergebnisse. Fehler fünf: Zu viel Vertrauen ohne Überprüfung. Claude produziert meistens guten Code, aber nicht immer perfekten. Prüfe die Ergebnisse, lass Tests laufen, und lies den generierten Code zumindest kurz durch. Claude ist ein Werkzeug das dich unterstützt, nicht ersetzt. Und schließlich: Vergessen die Kosten im Blick zu behalten. Regelmäßig /cost checken verhindert böse Überraschungen auf der Rechnung.

Zusammenfassung