Claude Code Setup-Guide — Von der Installation zum produktiven Workflow

Claude Code ist Anthropics offizielles CLI-Tool, das Claude direkt in dein Terminal bringt. Es kann deine Codebasis lesen, Dateien bearbeiten, Befehle ausführen und über komplexe Aufgaben nachdenken — alles von der Kommandozeile aus. Ich nutze es täglich, und dieser Guide deckt alles ab, was du brauchst, um von der Installation zu einem produktiven Workflow zu kommen.

Was ist Claude Code?

Claude Code ist kein Chatbot im Terminal. Es ist ein agentisches Coding-Tool. Du beschreibst, was du willst, und es liest Dateien, schreibt Code, führt Tests aus und iteriert — mit deiner Erlaubnis. Es versteht Projektstrukturen, kann große Codebasen durchsuchen und behält den Kontext über eine Sitzung hinweg.

Stell es dir vor wie einen erfahrenen Entwickler neben dir, der den Code tatsächlich anfassen kann.

Installation

Voraussetzungen

• Node.js 18 oder neuer
• Ein Anthropic-API-Key oder ein Claude Pro/Max-Abo

Global installieren via npm

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

Installation überprüfen:

claude --version

Authentifizierung

Beim ersten Start fordert Claude Code zur Authentifizierung auf. Zwei Optionen:

1. API-Key: ANTHROPIC_API_KEY als Umgebungsvariable setzen oder bei Aufforderung eingeben
2. Claude-Abo: Mit dem Anthropic-Account einloggen (Pro- oder Max-Plan)

# Option 1: Umgebungsvariable
export ANTHROPIC_API_KEY=sk-ant-...

# Option 2: Interaktiver Login
claude  # den Anweisungen folgen

Erste Befehle

In ein Projektverzeichnis wechseln und Claude Code starten:

cd ~/projects/my-app
claude

Du bist jetzt in einer interaktiven Sitzung. Probier zum Einstieg:

> Erkläre die Architektur dieses Projekts
> Finde alle Dateien, die Authentifizierung behandeln
> Was macht die handleSubmit-Funktion in ContactForm.tsx?

Claude Code liest die relevanten Dateien, analysiert den Code und antwortet kontextbezogen.

One-Shot-Modus

Für schnelle Aufgaben den -p-Flag verwenden, um einen einzelnen Prompt auszuführen, ohne die interaktive Sitzung zu betreten:

claude -p "Welches Test-Framework nutzt dieses Projekt?"
claude -p "Liste alle API-Endpunkte im Backend auf"

CLAUDE.md konfigurieren

Die CLAUDE.md-Datei ist das Handbuch deines Projekts für Claude Code. Lege sie ins Projektstammverzeichnis, und Claude liest sie zu Beginn jeder Sitzung.

Eine gute CLAUDE.md enthält:

# CLAUDE.md

## Architektur
- Frontend: React + TypeScript in frontend/
- Backend: NestJS in backend/

## Konventionen
- CSS Modules, kein Tailwind
- Conventional Commits
- Alle UI-Texte über i18next

## Befehle
- npm run dev — Frontend-Dev-Server starten
- npm run test — Tests ausführen
- npm run lint — ESLint ausführen

Das ist die wirkungsvollste Maßnahme, um Claude Codes Effektivität in deinem Projekt zu verbessern. Je mehr Kontext du lieferst, desto besser die Ergebnisse. Ich pflege für jedes meiner Projekte eine detaillierte CLAUDE.md.

Bereichsspezifische Konfiguration

Du kannst auch CLAUDE.md-Dateien in Unterverzeichnissen erstellen. Claude Code führt sie hierarchisch zusammen — eine frontend/CLAUDE.md fügt Kontext hinzu, wenn im Frontend-Verzeichnis gearbeitet wird, ohne die Root-Datei zu überschreiben.

Berechtigungsmodi

Claude Code arbeitet in drei Berechtigungsmodi:

Standard (Ask-Modus)

Claude fragt vor jedem Dateischreiben, jeder Befehlsausführung und jeder destruktiven Aktion um Bestätigung. Der sicherste Modus, empfohlen für den Einstieg.

Auto-Accept (YOLO-Modus)

claude --dangerously-skip-permissions

Claude führt Aktionen ohne Nachfrage aus. Nützlich für vertrauenswürdige, risikoarme Aufgaben auf versionskontrolliertem Code. Ich nutze das für Routineaufgaben wie Dependency-Updates oder Boilerplate-Generierung — aber nur, wenn ich mit git leicht zurücksetzen kann.

Selektive Berechtigungen

Über den /allowed-tools-Befehl oder in den Einstellungen konfigurieren, welche Tools Genehmigung erfordern und welche automatisch laufen dürfen. Das ist der Sweet Spot für den täglichen Einsatz — Lesezugriffe und Suchen automatisch erlauben, Schreibzugriffe und Befehle genehmigungspflichtig machen.

Nützliche Slash-Befehle

/init

Generiert eine initiale CLAUDE.md für dein Projekt, basierend auf Codebase-Struktur, Build-Dateien und Konventionen. Ein guter Startpunkt zum Verfeinern.

/compact

Komprimiert den Gesprächsverlauf, um Platz im Kontextfenster freizugeben. Unverzichtbar bei langen Sitzungen mit großen Codebasen.

/review

Claude reviewt deine aktuellen Änderungen (staged und unstaged), liest die Diffs und gibt Feedback zu Bugs, Stilfragen und Verbesserungsmöglichkeiten.

/cost

Zeigt den Token-Verbrauch und die Kosten der aktuellen Sitzung.

Tipps für effektives Prompting

Nach Monaten täglicher Nutzung erzeugen diese Muster durchgängig bessere Ergebnisse:

Sei spezifisch über das gewünschte Ergebnis

# Vage
> Behebe den Login-Bug

# Spezifisch
> Das Login-Formular wird abgeschickt, aber der Nutzer wird nach
> erfolgreicher Authentifizierung nicht zu /dashboard weitergeleitet.
> Prüfe den Auth-Callback in useAuth.ts und die Router-Konfiguration.

Gib Einschränkungen mit

> Füge Input-Validierung zum Kontaktformular hinzu.
> Verwende zod für die Schema-Validierung.
> Keine neuen Dependencies außer zod.
> Folge dem bestehenden Muster in ProfileForm.tsx.

Iteriere, statt von vorne anzufangen

Wenn das erste Ergebnis zu 80 % passt, sag Claude, was angepasst werden soll, statt komplett neu zu prompten. Es hat den vollen Kontext dessen, was es gerade getan hat.

Nutze es zur Analyse, nicht nur zur Generierung

Claude Code glänzt beim Codeverständnis, nicht nur beim Schreiben:

> Warum schlägt der Build fehl, wenn ich aus @/utils importiere?
> Verfolge den Datenfluss von der API-Antwort bis zur gerenderten Komponente
> Was würde kaputtgehen, wenn ich die user_id-Spalte in userId umbenenne?

Integration in deinen Workflow

Terminal-Integration

Claude Code läuft in jedem Terminal. Ich nutze es in tmux neben meinem Editor — ein Pane für Claude, eins für den Editor, eins für den Dev-Server.

Git-Workflow

Claude Code ist git-aware. Es kann Commits erstellen, Diffs reviewen und mit Branches arbeiten. Mein typischer Workflow:

1. Feature-Branch erstellen
2. Das Feature an Claude Code beschreiben
3. Die vorgenommenen Änderungen reviewen
4. Claude /review auf die eigene Arbeit ausführen lassen
5. Committen und pushen

Was Claude Code nicht ist

• Es ist kein Autopilot. Du triffst die Entscheidungen.
• Es ist nicht unfehlbar. Output reviewen, besonders bei sicherheitskritischem Code.
• Es ersetzt nicht das Verständnis deiner Codebasis. Es ist ein Kraftmultiplikator für Entwickler, die bereits wissen, was sie wollen.

Heute loslegen

1. Claude Code installieren: npm install -g @anthropic-ai/claude-code
2. Mit API-Key oder Abo authentifizieren
3. /init im Projekt ausführen, um eine CLAUDE.md zu generieren
4. Mit Leseaufgaben starten (Code erklären, Muster finden)
5. Zu Edits übergehen, sobald das Vertrauen wächst

Die Lernkurve beträgt etwa 30 Minuten. Der Produktivitätsgewinn ist sofort spürbar.