Claude Code einrichten — die Schritt-für-Schritt-Anleitung

Das Wichtigste in 60 Sekunden

• Claude Code ist eine CLI — läuft im Terminal, arbeitet mit Code, Git, Build-Tools, Datenbanken.
• Voraussetzung: Claude Pro, Team oder Enterprise (Free reicht nicht). Node.js 18+. Mac/Linux/Windows (WSL2).
• Installation: npm install -g @anthropic-ai/claude-code, dann claude im Projektordner.
• Der Hebel ist CLAUDE.md — das Projekt-Handbuch. Je besser dokumentiert, desto produktiver Claude.
• Weiter ausbauen mit: Slash-Commands, Hooks, MCP-Servern, Subagenten, Plugins.
• Team-Rollout: CLAUDE.md, Commands und Hooks via Git teilen. Settings local bleibt pro Entwickler.
• Kosten: Pro 20 USD/Monat reicht oft. Für heavy Usage: Max ab 100 USD/Monat, Team Premium ab 100 USD/Seat oder API-Billing.

Die wichtigsten Vertiefungen: Claude Code Download & Installation, Claude Code Kosten, Claude Code für Teams, Claude Code vs. Cursor und Claude Code vs. Codex.

Voraussetzungen und Vorbereitung

Software

• Betriebssystem: macOS 12+, Linux (Ubuntu 20+, Debian 11+, Fedora 38+), Windows 10/11 mit WSL2.
• Node.js: Version 18 oder höher. Prüfen mit node --version.
• Git: Für Versionierung und PR-Workflows.
• Terminal: iTerm2, Ghostty, Warp, Windows Terminal — alles funktioniert.

Account

• Claude Pro, Team oder Enterprise. Kostenloser Plan reicht nicht.
• Für Team-Rollout: Claude Team-Workspace mit zentraler Abrechnung. Mehr: Plan-Vergleich.

Vorbereitung im Projekt

• Ein sauberes Git-Repo mit aktuellem main-Stand.
• .gitignore prüfen — keine Secrets ins Repo.
• Ein kurzes README, an dem Claude beim ersten /init andocken kann.

Installation Schritt für Schritt

Via npm (empfohlen, plattformübergreifend)

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

Via Homebrew (macOS)

brew install anthropic/claude/claude-code

Erste Session

cd /pfad/zum/projekt
claude

Beim ersten Start führt dich der eingebaute Assistent durch:

1. Login via Browser — OAuth-Flow, dein Browser öffnet sich, Claude-Account bestätigen, fertig.
2. Default-Modell wählen (Sonnet 4.6 ist der richtige Default).
3. Projekt-Permissions setzen — was darf Claude ohne Rückfrage (Read-only, Schreiben in diesem Ordner, Shell-Kommandos).

Installation ist nach 3 Minuten durch. Jetzt wird's interessant.

CLAUDE.md: Dein wichtigstes Asset

CLAUDE.md ist das Projekt-Handbuch für Claude — und der mit Abstand größte Hebel für Qualität. Je sauberer dokumentiert, desto besser Claudes Vorschläge. Erster Entwurf per /init:

/init

Claude scannt dein Repo und erstellt eine CLAUDE.md im Root. Danach händisch nachschärfen. Die Bausteine, die sich in ~200 Rollouts bewährt haben:

Pflicht-Sektionen

• Projekt-Zweck (1–3 Sätze) — „Was tut dieses Repo?“
• Tech-Stack — Sprachen, Frameworks, wichtige Libraries, Versionen.
• Ordner-Struktur — welcher Ordner hat welchen Zweck.
• Konventionen — Naming, Code-Style, Commit-Messages, Test-Struktur.
• Befehle — npm run dev, npm test, npm run build, Deploy-Befehle.
• Warnungen — „finger weg von X“, „Migrationen nur nach Review“, „niemals Secrets committen“.

Optional, aber wertvoll

• Links zu wichtigen Docs (Architektur-Diagramm, OpenAPI-Spec).
• Projekt-Jargon („unser Auftrag“ = Order-Entity in der DB).
• Business-Regeln, die nicht aus dem Code abzuleiten sind.

Faustregel: Wenn du einen neuen Junior-Entwickler einarbeiten müsstest — genau das gehört in CLAUDE.md.

/init richtig nutzen: aus Auto-Doku wird Team-Standard

Viele suchen nach /init claude code, weil der erste Befehl entscheidet, ob Claude nur ein Repo scannt oder wirklich nutzbaren Kontext aufbaut. Starte /init im Projekt-Root, lies die erzeugte CLAUDE.md direkt gegen und ergänze fehlende Geschäftsregeln, Testbefehle, Deployment-Abläufe und Warnungen.

Unser Standard im Team-Rollout: /init ausführen, danach 30 Minuten Review mit einem Senior-Entwickler, anschließend Commit in einen eigenen Branch. So sehen alle Entwickler denselben Kontext und Claude Code arbeitet nicht mit zufälligen lokalen Annahmen.

Claude Code mit VS Code und Terminal kombinieren

Claude Code bleibt ein Terminal-Werkzeug, lässt sich aber sehr gut neben VS Code, Cursor oder JetBrains nutzen. Bewährt hat sich: Editor für Navigation und Review, Claude Code für Analyse, Änderungen, Tests und Git-Arbeit.

Praktischer Workflow: Datei im Editor öffnen, Scope im Terminal benennen, Claude Code gezielt auf einen Branch oder Ordner ansetzen und Änderungen direkt im Diff prüfen. So bleibt der Mensch im Review-Modus, während Claude die Fleißarbeit übernimmt.

Slash-Commands für wiederkehrende Aufgaben

Slash-Commands sind Claudes Makros — eine Markdown-Datei in .claude/commands/, die Claude bei /name ausführt. Beispiel für einen Code-Review-Command:

.claude/commands/review.md:

---
description: Review aller Änderungen im aktuellen Branch gegen main
---
Führe folgenden Review durch:
1. Lies die Diff-Änderungen zwischen main und HEAD.
2. Prüfe auf: Sicherheitsprobleme, Performance-Issues, fehlende Tests, Konventions-Brüche.
3. Schreibe einen prägnanten Review-Report im Format:
   - Critical: ...
   - Warning: ...
   - Nice-to-have: ...

Weitere nützliche Commands, die wir bei Kunden standardmäßig einrichten:

• /test <file> — Tests für eine Datei generieren.
• /commit — Änderungen committen mit sauberer Message.
• /pr — PR-Beschreibung aus Diff erstellen.
• /refactor <scope> — Refactoring mit Testabdeckung.
• /explain <datei> — Datei dokumentieren, Jargon erklären.
• /security-review — Security-Pass mit OWASP-Fokus.

Hooks: Automatische Guard-Rails

Hooks sind Event-Handler in .claude/settings.json. Sie laufen automatisch bei bestimmten Ereignissen — z. B. vor einem Tool-Aufruf, nach einer Änderung oder bei Session-Ende. Nutzen: Sicherheit, Qualität, Konsistenz.

Beispiel — Blockiert rm -rf und automatisches Formatieren nach Edits:

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "command": "if [[ \"$CLAUDE_TOOL_INPUT\" == *\"rm -rf\"* ]]; then echo 'blocked' && exit 1; fi"
      }
    ],
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "command": "npm run format"
      }
    ]
  }
}

Typische Hooks in Produktiv-Setups:

• PreToolUse: Destructive-Commands blockieren, Secret-Scanner, Linter-Pre-Checks.
• PostToolUse: Auto-Format (Prettier, gofmt, black), Test-Run, Git-Hook-Trigger.
• Stop: Session-Log, Audit-Eintrag, Slack-Notification bei langen Läufen.
• UserPromptSubmit: Kontext-Injektion (z. B. aktuelle Sprint-Ziele auto-mitgeben).

MCP-Server anbinden

MCP-Server machen aus Claude Code einen aktiven Agenten, der mit deinen Tools arbeitet — nicht nur Code vorschlägt. Beispiele:

• github: PRs anlegen, Reviews lesen, Issues durchsuchen.
• postgres / mysql: Schema inspizieren, Queries testen, Migrations-Diffs erzeugen.
• sentry: Fehler-Tracking — Claude fragt bei Refactorings: „Welche Errors sind für das Modul aktuell offen?“
• filesystem: Lesezugriff auf weitere Projekte (Monorepo-Kontext).
• linear / jira: Tickets ins Prompt holen, Status aktualisieren.

Einrichtung in .mcp.json im Projekt-Root. Vollständige Anleitung: MCP Server einrichten.

Die wichtigsten Befehle in der Session

• /help — alle Kommandos und Shortcuts.
• /init — Initiales CLAUDE.md generieren.
• /compact — Kontext zusammenfassen, Tokens sparen (wichtig bei langen Sessions).
• /clear — Session zurücksetzen (aber CLAUDE.md bleibt).
• /mcp — MCP-Server verwalten.
• /model — Modell wechseln (z. B. von Sonnet auf Opus für harte Tasks).
• /cost — aktuelle Token- und Kostenabrechnung der Session.
• /hooks — Hooks prüfen und testen.
• /resume — Session aus vorheriger Arbeit fortführen.
• /permissions — Berechtigungen prüfen und anpassen.

Tastatur-Shortcuts: Ctrl+C zum Unterbrechen, Esc für aktuelle Aktion abbrechen, ↑ im Prompt-Feld für History.

Team-Rollout: Claude Code im Dev-Team

Für Teams gilt: Einheitlichkeit schlägt Individual-Konfig. Was ins Repo gehört (via Git geteilt), was lokal bleibt:

Ins Repo (geteilt)

• CLAUDE.md — das Projekt-Handbuch für alle.
• .claude/commands/ — Team-Slash-Commands.
• .claude/agents/ — Subagenten (spezialisiert auf Security-Review, Test-Writing etc.).
• .mcp.json — gemeinsame MCP-Server-Definitionen.
• .claude/settings.json — Team-Hooks (Blocker für destructive Commands, Auto-Format).

Lokal (nicht committen)

• .claude/settings.local.json — persönliche Overrides (z. B. Modell-Default).
• API-Keys für MCP-Server — via Env-Variablen oder Secret-Manager.
• Persönliche Permissions-Overrides.

Wir sehen in Rollouts regelmäßig: Teams mit gepflegtem CLAUDE.md + 5–8 geteilten Slash-Commands sind nach 6 Wochen 30–50 % schneller bei Standard-Tasks.

Kosten, Token-Verbrauch und Kontrolle

Claude Code selbst kostet nichts — verbraucht aber das Kontingent deines Plans. Orientierungswerte aus der Praxis:

• Claude Pro (20 USD monatlich / 17 USD jährlich): für Hobby-Projekte, kleine Side-Projects, leichter Einsatz. 1–2 Stunden CLI-Nutzung pro Tag ist oft drin.
• Claude Max (ab 100 USD/Monat): für Vollzeit-Entwickler mit intensivem Einsatz und höherem Nutzungskontingent.
• Team Standard (20/25 USD pro Seat): für Dev-Teams mit zentraler Abrechnung; Premium-Seats (100/125 USD) für Power-User.
• API-Billing: Für wirklich heavy Usage oder CI/CD-Integration. Bezahl-nach-Verbrauch, typisch 30–100 USD/Monat pro intensivem Entwickler.

Kosten-Kontrolle: /cost in der Session, /compact bei langen Läufen, sparsames Opus-Nutzen (nur für Tasks, die es wirklich brauchen).

Typische Stolperfallen und Lösungen

• CLAUDE.md zu dünn. Häufigster Fehler. Eine Stunde in das Handbuch zu investieren, zahlt sich zehnfach aus.
• Zu weite Permissions. „Darf alles“ klingt bequem, führt aber zu versehentlichen Änderungen. Lieber eng beginnen, bei Bedarf erweitern.
• Kontext-Overflow. Nach ~30 Min ohne /compact wird Claude langsam. Regelmäßig verdichten.
• Alles auf Opus laufen lassen. Standard-Tasks mit Sonnet machen, Opus gezielt einschalten. Spart bis zu 70 % Tokens.
• Hooks zu komplex. Fangen bei uns zu 50 % mit „das hätte ich nicht committen dürfen“ an. Lieber einfach beginnen.
• Secrets im Projekt-Handbuch. CLAUDE.md ist im Repo. Keine API-Keys, keine Passwörter dort — die gehören in Env-Variablen.
• Kein Backup-Prozess. Claude kann falsch abbiegen. Ein sauberer Git-Workflow mit häufigen Commits ist Pflicht.

Claude Code professionell aufsetzen lassen

Wenn du direkt ein produktives Setup willst — CLAUDE.md für deine Codebase, 8–10 saubere Slash-Commands, passende Hooks, MCP-Server für eure Tools, Schulung für das Team — übernehmen wir das. Typischer Aufwand: 1–2 Tage, Ergebnis: Team ist ab Woche 1 produktiv.

Details: Claude Code einrichten lassen. Oder 30-Minuten-Erstgespräch buchen.