Claude Code installieren: Schritt-für-Schritt Anleitung (2026)
Von Null zum ersten autonomen Agenten in 10 Minuten — vollständige Anleitung für Mac, Linux und Windows, inklusive API-Key-Einrichtung und erstem Test.
Claude Code ist Anthropics KI-Coding-Assistent, der direkt im Terminal läuft und eigenständig Dateien lesen, ändern, Befehle ausführen und komplexe Aufgaben über mehrere Schritte hinweg erledigt. Diese Anleitung zeigt, wie du ihn in unter 10 Minuten einrichtest.
Voraussetzungen
| Voraussetzung | Version | Prüfen mit |
|---|---|---|
| Node.js | v18 oder höher | node --version |
| npm | v8 oder höher | npm --version |
| Anthropic API-Key | — | console.anthropic.com |
| Betriebssystem | Mac, Linux oder Windows (WSL) | — |
Windows-Nutzer: Claude Code läuft nativ unter Linux und macOS. Unter Windows empfehlen wir WSL2 (Windows Subsystem for Linux). Die Installation von WSL dauert ca. 5 Minuten — Microsoft hat eine offizielle Anleitung unter learn.microsoft.com/wsl.
Installation Schritt für Schritt
1 Node.js installieren (falls noch nicht vorhanden)
# Mit Homebrew (empfohlen)
brew install node
# Prüfen
node --version # sollte v18+ ausgebencurl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs
node --version# In WSL2-Terminal ausführen:
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs2 Claude Code via npm installieren
npm install -g @anthropic-ai/claude-codeDas -g Flag installiert Claude Code global, sodass du claude von jedem Verzeichnis aus aufrufen kannst.
Erfolg: Nach der Installation sollte claude --version die aktuelle Versionsnummer ausgeben.
3 Anthropic API-Key erstellen
- Gehe zu console.anthropic.com
- Registriere dich oder melde dich an
- Navigiere zu API Keys → Create Key
- Kopiere den Key (er wird nur einmal angezeigt)
Kosten: Anthropic gibt neuen Accounts ein Startguthaben. Für erste Tests reicht das problemlos. Danach zahlt man pro genutztem Token — eine typische Claude Code Session kostet wenige Cent.
4 API-Key als Umgebungsvariable setzen
# In ~/.bashrc oder ~/.zshrc einfügen:
export ANTHROPIC_API_KEY="sk-ant-..."
# Datei neu laden:
source ~/.bashrc # oder: source ~/.zshrcexport ANTHROPIC_API_KEY="sk-ant-..."# In ~/.bashrc einfügen:
export ANTHROPIC_API_KEY="sk-ant-..."
source ~/.bashrc5 Erste Session starten und testen
# Navigiere zu einem Projektverzeichnis
cd ~/mein-projekt
# Claude Code starten
claudeClaude Code liest automatisch alle Dateien im aktuellen Verzeichnis und wartet auf deine erste Aufgabe. Du kannst direkt in natürlicher Sprache schreiben:
> Erklär mir die Struktur dieses Projekts
> Finde alle TODO-Kommentare und liste sie auf
> Erstelle eine README.md für dieses ProjektFunktioniert: Wenn Claude Code antwortet und Dateien liest, ist die Installation erfolgreich abgeschlossen.
Häufige Probleme und Lösungen
Error: command not found: claude
npm hat das Binary nicht in den PATH geschrieben. Lösung: export PATH="$PATH:$(npm bin -g)" ausführen oder Node.js neu installieren.
Error: ANTHROPIC_API_KEY is not set
Der API-Key ist nicht gesetzt oder nicht in der aktuellen Shell sichtbar. Lösung: echo $ANTHROPIC_API_KEY prüfen. Wenn leer: source ~/.bashrc ausführen.
Error: 401 Unauthorized / Invalid API key
Der API-Key ist falsch oder abgelaufen. Lösung: In console.anthropic.com einen neuen Key erstellen und neu setzen.
Error: EACCES permission denied (npm install -g)
npm hat keine Schreibrechte für den globalen Ordner. Lösung: sudo npm install -g @anthropic-ai/claude-code oder npm-Prefix im User-Verzeichnis konfigurieren.
Windows: claude startet, hängt oder zeigt Zeichenfehler
Claude Code ist für Unix-Terminals optimiert. Unter Windows immer WSL2 verwenden, nicht cmd.exe oder PowerShell direkt.
Nächste Schritte nach der Installation
CLAUDE.md erstellen
Die wichtigste Datei für produktiven Einsatz: Eine CLAUDE.md im Projektverzeichnis gibt Claude Code dauerhafte Anweisungen — Coding-Standards, was es nicht anfassen darf, wie es committen soll.
# Beispiel CLAUDE.md
## Rolle
Du bist ein Python-Backend-Entwickler für dieses Projekt.
## Regeln
- Immer Type Hints verwenden
- Keine externen Libraries ohne Rückfrage
- Commit-Format: [feat|fix|refactor] kurze Beschreibung
## Verboten
- .env Dateien anfassen
- Produktionsdatenbank direkt ändernAutonome Sessions starten
Für längere Aufgaben ohne manuelle Bestätigung:
# Mit --max-turns läuft Claude Code ohne Pause durch
claude -p "Schreibe Unit-Tests für alle Funktionen in src/utils.py" --max-turns 20Modell auswählen
# Standard: claude-sonnet-4-6 (empfohlen für die meisten Tasks)
claude
# Für komplexe Architektur-Entscheidungen:
claude --model claude-opus-4-6
# Für einfache, schnelle Tasks (günstiger):
claude --model claude-haiku-4-5Was kostet Claude Code wirklich?
| Nutzungstyp | Geschätzte Kosten |
|---|---|
| Gelegentliche Nutzung (1–2h/Tag) | €5–15/Monat |
| Aktive Entwicklung (4–6h/Tag) | €20–50/Monat |
| Autonome Agenten (24/7 Betrieb) | €30–80/Monat |
| Claude Max Plan (Flat-Rate) | $100/Monat (unbegrenzt) |
Tipp: Verwende Haiku für einfache Tasks und Sonnet für komplexe Aufgaben. Opus ist deutlich teurer und lohnt sich nur für Orchestrierungs-Aufgaben.
Claude Code produktiv nutzen — Schritt für Schritt
Der Kurs Claude Code Mastery zeigt, wie du echte autonome Agenten baust: CLAUDE.md-Hierarchien, Multi-Agent-Koordination, n8n-Integration und Produktionsmuster aus 3 Monaten Praxis.
7 Tage kostenlos testen → Keine Kreditkarte · Sofortiger Zugriff · Jederzeit kündbar