Claude Code: Was es ist, wie du startest und was es kann

Lektion 3: Claude Code, Einstieg und erste Schritte

Was ist Claude Code?

Claude Code ist ein CLI-Tool (Command Line Interface, ein Programm, das du im Terminal, also der Kommandozeile deines Computers, ausführst). Es bringt Claude direkt in deine Arbeitsumgebung: dorthin, wo dein Code liegt, deine Dateien sind und deine Befehle laufen.

Das klingt nach einem Detail, ist aber ein fundamentaler Unterschied zu Claude.ai. In Claude.ai führst du Gespräche, du tippst, Claude antwortet im Chat. Claude Code hingegen handelt: Es liest Dateien aus deinem Dateisystem, schreibt Code direkt in deine Projekte, führt Tests aus, macht Git-Commits und orchestriert komplexe Aufgaben über mehrere Schritte, alles, ohne dass du einzelne Dateien hochladen oder Copy-Paste zwischen Editor und Browser betreiben musst.

Claude Code ist primär für technische Nutzer gedacht, aber es braucht kein tiefes Programmierwissen. Wer regelmäßig mit Dateien, Skripten oder der Kommandozeile arbeitet, profitiert erheblich davon.

Claude.ai vs. Claude Code: Der Kernunterschied

Claude.ai ist der beste Ausgangspunkt für alle Alltags- und Kreativaufgaben. Claude Code ist die richtige Wahl, sobald deine Aufgaben mit Dateien, Code oder wiederholbaren Workflows zu tun haben.

Claude Code installieren

Claude Code läuft als npm-Paket (Node Package Manager, ein verbreitetes Werkzeug zur Verwaltung von JavaScript-Programmen). Voraussetzung: Node.js (Version 18 oder höher) muss installiert sein, das ist eine Laufzeitumgebung für JavaScript, die du einmalig brauchst.

Schritt 1, Prüfen ob Node.js vorhanden ist:

node --version

Falls du eine Versionsnummer siehst (z. B. v22.3.0), kannst du direkt weitermachen. Falls nicht: nodejs.org → LTS-Version installieren.

Schritt 2, Claude Code installieren:

npm install -g @anthropic-ai/claude-code

Das -g steht für global, Claude Code wird systemweit verfügbar, nicht nur in einem einzelnen Projektordner.

Schritt 3, Starten und anmelden:

claude

Beim ersten Start wirst du nach einem API-Key (Application Programming Interface Key, ein persönlicher Zugriffsschlüssel, der dich bei Anthropics Diensten authentifiziert) gefragt, oder du kannst dich über deinen Browser mit deinem bestehenden Claude-Konto anmelden. Die Browser-Anmeldung ist der schnellste Weg, wenn du schon ein Claude Pro- oder Team-Konto hast.

Schritt 4, Im richtigen Ordner öffnen: Claude Code entfaltet seine volle Stärke, wenn du es direkt in deinem Projektverzeichnis startest:

cd /pfad/zu/deinem/projekt
claude

Claude “sieht” ab dann den kompletten Inhalt dieses Ordners und kann direkt damit arbeiten.

Wie die Bedienung funktioniert

Wenn Claude Code läuft, siehst du einen interaktiven Chat, ähnlich wie Claude.ai, aber direkt im Terminal. Du gibst Aufgaben in natürlicher Sprache ein, Claude antwortet und handelt.

Die wichtigsten eingebauten Befehle, sogenannte Slash-Commands (Befehle, die mit / beginnen und das Tool direkt steuern, ohne ans Sprachmodell zu gehen):

/help          → zeigt alle verfügbaren Befehle
/status        → zeigt Kontextstatus und aktive Konfiguration
/clear         → löscht den aktuellen Chat-Verlauf
/compact       → fasst langen Gesprächsverlauf zusammen, um Kontext-Speicher freizugeben
/cd <ordner>   → wechselt das Arbeitsverzeichnis innerhalb der laufenden Session
/exit          → beendet Claude Code

Slash-Commands sind direkte Steuerbefehle, sie gehen nicht an das Sprachmodell, sondern steuern das Tool selbst. Du wirst im Laufe des Kurses noch viele davon kennenlernen.

Was Claude Code in einem Projektordner tut

Sobald du Claude Code in einem Projektordner startest und eine Aufgabe gibst, kann es:

• Dateien lesen: „Lies alle Dateien im src-Ordner und erkläre mir die Architektur in fünf Sätzen.“
• Code schreiben und speichern: „Erstelle eine Funktion, die E-Mail-Adressen validiert, und schreib sie in utils.ts.“
• Fehler beheben: „Mein Build schlägt fehl, hier ist der Fehler: [Fehlertext]. Finde und behebe die Ursache.“
• Tests ausführen: Claude kann npm test, pytest oder andere Testbefehle direkt starten und auf die Ergebnisse reagieren.
• Git-Aktionen: Commits erstellen, Diffs erklären, Branch-Übersichten liefern.

Ein konkreter Beispiel-Prompt für Claude Code:

Lies die Datei src/api.ts und schreibe für jede exportierte Funktion
einen kurzen deutschen Kommentar, der erklärt was sie tut.
Ändere sonst nichts an der Datei.

Claude liest die Datei, schreibt die Kommentare, und fragt dich, bevor es Änderungen speichert. Du behältst immer die Kontrolle.

Wann Claude Code die bessere Wahl ist

Nutze Claude Code statt Claude.ai, wenn:

1. Du mit lokalen Dateien arbeitest, die du nicht einzeln hochladen möchtest.
2. Du wiederholbare Aufgaben automatisieren willst, z. B. „refaktoriere alle Dateien in diesem Ordner nach Schema X“.
3. Du technische Fehler debuggen willst, für die Claude den genauen Code und Kontext sehen muss.
4. Du Werkzeuge ausführen musst: Tests, Linter, Build-Prozesse.
5. Du mehrstufige Workflows bauen willst, die automatisch mehrere Schritte durchlaufen.

Für alles andere, E-Mails, Texte, Recherche, Brainstorming, schnelle Fragen, ist Claude.ai die schnellere und einfachere Wahl.

CLAUDE.md, das Gedächtnis deines Projekts

Eine der wichtigsten Funktionen, die Claude Code von einem einfachen Chat-Assistenten unterscheidet, ist CLAUDE.md. Das ist eine Markdown-Datei im Root-Verzeichnis (Wurzelverzeichnis, der oberste Ordner deines Projekts), die Claude Code beim Start automatisch liest.

In CLAUDE.md hinterlegst du dauerhafte Anweisungen für dein Projekt: Welche Code-Konventionen gelten? Welche Ordnerstruktur gibt es? Welche Befehle soll Claude immer oder nie ausführen? So musst du diesen Kontext nicht bei jedem Chat neu erklären, Claude weiß es einfach. CLAUDE.md bekommt in Lektion 5 eine eigene ausführliche Vertiefung.

Heute mit Claude Code ausprobieren (ca. 10-15 min)

Du startest Claude Code zum ersten Mal und stellst deine erste echte Aufgabe.

Schritt 1, Installation (falls noch nicht erledigt):

node --version          # Prüfen ob Node.js da ist
npm install -g @anthropic-ai/claude-code   # Claude Code installieren

Schritt 2, In einen Ordner wechseln, in dem Dateien liegen: Suche dir einen Ordner auf deinem Computer aus, in dem schon etwas liegt, ein Projekt, ein Skript, ein paar Textdateien. Kein leerer Ordner.

cd ~/dein-projektordner
claude

Melde dich beim ersten Start mit deinem Claude-Konto an (Browser-Login oder API-Key).

Schritt 3, Erste Aufgabe eingeben:

Schau dir diesen Ordner an und erkläre mir kurz auf Deutsch,
was hier liegt: Dateitypen, grobe Struktur, erkennbarer Zweck.
Maximal 150 Wörter.

Schritt 4, Erfolg messen: Claude sollte dir eine knappe, konkrete Beschreibung deines Ordnerinhalts liefern, ohne dass du etwas hochgeladen hast. Das ist der zentrale Unterschied zu Claude.ai: Claude Code sieht den Ordner direkt.

Probiere anschließend /status und /help aus, um ein Gefühl für die Steuerung zu bekommen.

Neu bei Claude

• /cd, Arbeitsverzeichnis wechseln ohne Session-Neustart (seit v2.1.166, Juni 2026), Was ist neu: Du kannst das Arbeitsverzeichnis jetzt mitten in einer laufenden Claude Code Session wechseln, ohne den Prompt-Cache (gespeicherte Kontextdaten, die das erneute Verarbeiten langer Gespräche beschleunigen) zu verlieren. Bisher bedeutete ein Ordnerwechsel einen kompletten Neustart. Was bringt es dir: Du kannst in einer einzigen Session nahtlos zwischen zwei Projekten hin- und herspringen, nützlich, wenn du z. B. Frontend und Backend in verschiedenen Ordnern hast. Quelle

Glossar des Tages

• CLI (Command Line Interface), Ein Programm, das über Texteingabe im Terminal bedient wird, ohne grafische Oberfläche; Claude Code ist ein CLI.
• npm (Node Package Manager), Ein Werkzeug zur Verwaltung von JavaScript-Paketen; wird verwendet, um Claude Code global zu installieren.
• API-Key, Ein persönlicher Zugriffsschlüssel für einen Dienst; Claude Code nutzt ihn, um sich bei Anthropic zu authentifizieren.
• Slash-Command, Ein Befehl in Claude Code, der mit / beginnt und das Tool direkt steuert (z. B. /help, /status, /cd).
• CLAUDE.md, Eine Markdown-Datei im Projektordner, die Claude Code beim Start automatisch einliest und als dauerhafte Projektanweisung behandelt.