Claude Code Tutorial fuer Einsteiger

Was Claude Code ist (und was nicht)

Claude Code ist ein Agent Harness: Software, die ein Claude-Modell in einen Loop mit Tools (Dateien lesen, Dateien editieren, Shell-Befehle ausführen, im Web suchen) und das Urteilsvermögen einpackt, sie auf ein Ziel hin einzusetzen, das du setzt. Er läuft im Terminal, in VS Code und JetBrains, in einer Desktop-App und im Web. Er ist nicht nur Autocomplete und kein Chat-Fenster, das dir Snippets zum Einfügen gibt: Er arbeitet direkt in deinem Repository, macht Multi-File-Änderungen, führt deine Tests aus und iteriert, bis die Aufgabe erledigt ist. Du behältst die Kontrolle, indem du prüfst, was er vorschlägt, und die wichtigen Aktionen freigibst.

• Er lebt, wo dein Code lebt: im Terminal, in deinem Editor oder im Browser-Tab.
• Er handelt, schlägt nicht nur vor: Er editiert Dateien und führt Befehle aus, dann liest er die Ergebnisse.
• Du beaufsichtigst: Er fragt bei sensiblen Aktionen um Erlaubnis, und du prüfst seine Pläne und Diffs.
• Er braucht einen Account: Claude Pro, Max, Team, Enterprise oder Console (pro Token). Der kostenlose Claude.ai-Plan enthält Claude Code nicht.

Claude Code installieren

Der empfohlene Weg, Claude Code 2026 zu installieren, ist der native Installer, der keine Node.js-Abhängigkeit hat und sich im Hintergrund selbst aktualisiert. Führe den Einzeiler für deine Plattform aus und bestätige dann, dass es geklappt hat. Wenn du npm bevorzugst, funktioniert das Paket weiterhin und installiert dasselbe Binary, braucht aber Node.js 18 oder neuer und aktualisiert sich nicht so sauber. Installiere niemals mit sudo: Ein root-eigenes npm-Verzeichnis verursacht bei jeder künftigen Installation Permission-Fehler.

# macOS, Linux, WSL (recommended native installer)
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

# npm fallback (needs Node.js 18+, do NOT use sudo)
npm install -g @anthropic-ai/claude-code

# Confirm it installed
claude --version

Wenn etwas seltsam aussieht, führe "claude doctor" für einen Gesundheits-Check deiner Installation und Konfiguration aus. Auf nativem Windows ist Git for Windows optional, lässt Claude Code aber Git Bash für Shell-Befehle nutzen.

Deine erste Session

Öffne ein Terminal in dem Projekt, an dem du arbeiten willst, und führe "claude" aus. Beim ersten Mal führt es dich durch den Login via Browser. Sobald du drin bist, bist du an einem interaktiven Prompt: Tippe eine Anfrage in normalem Deutsch oder Englisch und drück Enter. Fang klein an, um Vertrauen aufzubauen, zum Beispiel "erkläre, was dieses Projekt macht" oder "finde, wo der Hero der Startseite gerendert wird". Claude Code liest die relevanten Dateien selbst, du musst also keinen Code einfügen. Wenn du die Session beenden willst, tippe /exit, und um später weiterzumachen, führe "claude -c" aus, um deine letzte Session in dem Ordner fortzusetzen.

# Start Claude Code in the current project
claude

# Continue your most recent session in this folder
claude -c

# Resume a specific past session from a list
claude --resume

Der Kern-Workflow: plan, edit, run, review

Die eine Gewohnheit, die Claude Code zuverlässig macht, ist: planen, bevor du ihn editieren lässt. Drück Shift+Tab, um in den Plan-Modus zu gehen: Claude erkundet deine Codebasis und schlägt vor, was er vorhat, ohne eine einzige Datei zu ändern, damit du günstig gegensteuern kannst, bevor Code geschrieben wird. Gib den Plan frei, lass ihn die Edits machen, lass ihn deine Tests oder den Dev-Server laufen, und prüfe dann den Diff, bevor du committest. Dieser Explore-Plan-Implement-Commit-Loop hält den Agenten ehrlich und fängt eine falsche Richtung ab, solange sie noch gratis zu beheben ist.

• Plan: Drück Shift+Tab für den Plan-Modus, damit Claude Änderungen vor dem Editieren vorschlägt. Nutze ihn für alles, was mehrere Dateien, das Schema oder Security berührt.
• Edit: Gib den Plan frei und lass Claude die Multi-File-Änderungen machen.
• Run: Lass ihn deine Tests, den Type-Checker oder den Dev-Server laufen, damit er echte Ergebnisse sieht, nicht Annahmen.
• Review: Lies den Diff und committe. Du bist das Quality Gate, bevor Code dauerhaft wird.

CLAUDE.md: dem Agenten deine Regeln beibringen

CLAUDE.md ist eine einfache Markdown-Datei im Wurzelverzeichnis deines Repos, die Claude Code zu Beginn jeder Session automatisch liest und als stehende Anweisungen behandelt. Sie ist das wirkungsvollste Upgrade, das du machen kannst: Schreib deinen Stack, deine Konventionen, dein Quality Gate und deinen Ton einmal hinein, und der Agent hört auf, sie bei jeder Aufgabe neu zu entscheiden. Erzeuge eine Startdatei mit /init, das dein Projekt scannt und eine CLAUDE.md entwirft, und kürze sie dann auf die Regeln, die du tatsächlich immer wieder korrigierst. Halte sie knapp, denn sie wird jede Runde neu geladen und frisst dasselbe Context Window, das deine Aufgabe braucht.

# Project Rules

## Stack
- TypeScript only. Package manager is bun, never npm.

## Conventions
- Use rounded-sm for border-radius. Never use em dashes; use "-".

## Quality
- Before saying a task is done, run: bun run lint && bun run typecheck && bun run test.

## Tone
- Direct and concise. No filler.

Tiefer einsteigen: die vier Skills, die dich zum Power-User machen

Sobald die Basics sitzen, machen vier Features aus Claude Code statt einem hilfreichen Assistenten einen zuverlässigen Teamkollegen. Jedes hat seinen eigenen Deep-Dive-Guide in diesem Cluster. Subagents lassen dich laute Nebenarbeit an einen frischen Kontext delegieren, damit deine Hauptsession scharf bleibt. Hooks lassen deine Quality Gates automatisch laufen, damit keine kaputte Änderung durchrutscht. Skills und Slash Commands packen deine besten Workflows in Ein-Wort-Trigger. Und MCP verbindet den Agenten mit deinen Datenbanken, Browsern und Services. Lies sie in beliebiger Reihenfolge; zusammen sind sie der Unterschied zwischen Claude Code nutzen und Claude Code meistern.

• Subagents: Delegiere Recherche, Review oder Tests an einen spezialisierten Agenten in eigenem Context Window. Siehe den Claude Code Subagents Guide.
• Hooks: Feuere Shell-Befehle automatisch bei Lifecycle-Events, um Formatierung, Tests und Sicherheit durchzusetzen. Siehe den Claude Code Hooks Guide.
• Skills und Slash Commands: Halte einen wiederholten Workflow als wiederverwendbaren /command oder Skill fest. Siehe den Skills-und-Commands-Guide.
• MCP: Verbinde externe Tools und Daten über ein Standardprotokoll. Siehe den MCP-Setup-Guide.

Schritt für Schritt

1. 01

   Claude Code installieren

   Führe den nativen Installer für deine Plattform aus (curl auf macOS/Linux/WSL, irm in Windows PowerShell) oder nutze npm mit Node.js 18+. Bestätige mit "claude --version".

2. 02

   Deine erste Session starten

   Öffne ein Terminal in deinem Projekt, führe "claude" aus und logge dich via Browser ein, wenn du dazu aufgefordert wirst. Beginne mit einer risikoarmen Anfrage wie "erkläre, was dieses Projekt macht".

3. 03

   Planen, bevor du editierst

   Drück Shift+Tab, um in den Plan-Modus zu gehen. Lass Claude seinen Ansatz vorschlagen, ohne Dateien zu berühren, und korrigiere ihn günstig, bevor Code geschrieben wird.

4. 04

   Implementieren und laufen lassen

   Gib den Plan frei, lass Claude die Edits machen, und lass ihn deine Tests oder den Dev-Server laufen, damit er von echten Ergebnissen ausgeht statt von Annahmen.

5. 05

   Prüfen und committen

   Lies den Diff, behebe, was nicht stimmt, und committe. Du bist das Quality Gate, das entscheidet, was dauerhaft wird.

6. 06

   Eine CLAUDE.md hinzufügen

   Führe /init aus, um eine Start-CLAUDE.md zu erzeugen, und kürze sie dann auf deinen Stack, deine Konventionen und deinen Quality-Gate-Befehl, damit der Agent jede Session deine Regeln befolgt.

Häufige Fragen

Weiterlernen