Claude Code installieren — Windows, Mac und Linux Setup 2026

Answer-First: Was du wissen musst

Claude Code installieren geht über vier Wege: CLI (Terminal via npm), Desktop-App (Windows/Mac mit grafischer Oberfläche), Web-Version (Browser unter claude.ai/code) oder IDE-Extensions (VS Code/JetBrains). Alle Varianten brauchen ein Claude-Abo (Pro ab 20 USD/Monat, Max 5x/20x für höhere Limits) oder einen API-Key. Die Installation selbst dauert unter 5 Minuten — aber produktiv wird Claude Code erst mit CLAUDE.md-Setup und MCP-Server-Konfiguration.

Dieser Guide zeigt alle vier Installationswege mit konkreten Befehlen, typischen Problemen und was nach der Installation kommt.

Voraussetzungen — was du brauchst

Bevor du Claude Code installierst, prüfe diese Punkte:

Claude-Zugang:

• Claude Pro (20 USD/Monat, Basis-Kontingent im 5-Stunden-Fenster)
• Claude Max 5x (100 USD/Monat, ca. 5-faches Kontingent — Sweet Spot für tägliche Nutzung)
• Claude Max 20x (200 USD/Monat, ca. 20-faches Kontingent für Poweruser)
• Alternativ: Claude API-Key (Pay-as-you-go, für CI/Automatisierung)

Ohne eines dieser Abos funktioniert Claude Code nicht. Ein kostenloses Anthropic-Konto ohne Abo reicht nicht aus.

Technische Voraussetzungen (nur für CLI/IDE-Extensions):

• Node.js 18 oder höher (für npm-Installation)
• Git (empfohlen für Projektarbeit)
• Terminal/PowerShell (Windows) oder Terminal (Mac/Linux)

Desktop-App und Web-Version brauchen keine lokale Node.js-Installation.

Installationsweg 1: CLI im Terminal (der Klassiker)

Die CLI-Variante läuft direkt im Projektordner, liest Dateien, führt Befehle aus und macht Git-Commits. Der Workflow-Standard für Entwickler, die im Terminal arbeiten.

Installation (alle Plattformen):

Die offizielle Installations-Anleitung findest du unter code.claude.com/docs. Dort steht der aktuelle Installationsbefehl — typischerweise läuft die Installation über npm.

Nach der Installation meldest du dich mit deinem Claude-Abo oder API-Key an. Der Befehl dafür steht in der offiziellen Dokumentation.

Erster Test:

Navigiere in ein Testprojekt und starte Claude Code. Es liest automatisch die Projektstruktur und antwortet auf deine Anfragen.

Typische Probleme:

• command not found → npm-Global-Pfad nicht in PATH (Windows: User-Umgebungsvariablen prüfen; Mac/Linux: .bashrc oder .zshrc anpassen)
• Node.js-Version zu alt → Upgrade auf Node.js 18+
• Login schlägt fehl → Claude-Abo aktiv? API-Key korrekt?

Installationsweg 2: Desktop-App (Windows/Mac)

Die Desktop-App bietet dieselben Agent-Funktionen wie die CLI, aber mit grafischer Oberfläche und lokalem Datei-Browser. Guter Einstieg, wenn das Terminal abschreckt.

Download:

Die Desktop-App für Windows und Mac findest du auf der offiziellen Claude-Code-Website unter code.claude.com.

Installation:

1. Installer herunterladen (.exe für Windows, .dmg für Mac)
2. Installationsassistent durchlaufen
3. App starten und mit Claude-Account anmelden
4. Projektordner öffnen (Datei → Projekt öffnen)

Vorteile gegenüber CLI:

• Visueller Datei-Browser
• Chat-History übersichtlicher
• Drag-and-Drop für Dateien
• Kein Terminal nötig

Nachteile:

• Weniger scriptbar (keine CI/CD-Integration)
• Etwas langsamer beim Projektstart
• Mehr RAM-Verbrauch als CLI

Installationsweg 3: Web-Version (Browser)

Claude Code im Browser unter claude.ai/code — keine lokale Installation nötig. Praktisch für Cloud-Sessions oder Geräte ohne Installationsrechte.

Zugriff:

1. Öffne claude.ai/code im Browser
2. Melde dich mit deinem Claude-Account an
3. Lade Projektdateien hoch oder arbeite mit Snippets

Einschränkungen:

• Keine direkte Filesystem-Integration (nur Uploads)
• Keine lokalen MCP-Server (nur Cloud-MCP)
• Keine Git-Integration
• Sessions sind isoliert (kein persistenter Projekt-State)

Gut für:

• Schnelle Snippets/Prototypen
• Zugriff von fremden Rechnern
• Demos ohne Installation

Installationsweg 4: IDE-Extensions (VS Code/JetBrains)

Claude Code als Extension in VS Code oder JetBrains IDEs — für alle die in der IDE bleiben wollen.

Installation VS Code:

1. Extensions-Panel öffnen (Strg+Shift+X / Cmd+Shift+X)
2. "Claude Code" suchen
3. Install → Reload
4. Mit Claude-Account verbinden

Installation JetBrains (IntelliJ/PyCharm/WebStorm):

1. Settings → Plugins
2. Marketplace durchsuchen: "Claude Code"
3. Install → IDE neu starten
4. Claude-Account verbinden

Vorteile:

• Nahtlose Integration in gewohntes Setup
• Inline-Vorschläge im Editor
• Kein Context-Wechsel zwischen IDE und Terminal

Nachteile:

• Weniger Kontrolle über Agent-Verhalten
• MCP-Server-Setup komplexer
• Manchmal langsamer als native CLI

Die offizielle Dokumentation zu IDE-Extensions findest du unter code.claude.com/docs.

Nach der Installation: Produktives Setup

Claude Code ist installiert — aber produktiv wird es erst mit diesem Setup:

1. CLAUDE.md anlegen

CLAUDE.md ist eine Markdown-Datei im Projekt-Root, die Claude automatisch liest. Sie enthält:

• Stack-Informationen (Frameworks, Libraries, Dependencies)
• Coding-Rules (Formatierung, Naming, verbotene Patterns)
• Definition of Done (wann ist Code fertig?)
• Workflows (wie soll Claude vorgehen?)

Ohne CLAUDE.md produziert Claude generischen Code. Mit CLAUDE.md bekommst du projektspezifischen Output, der zu deinem Stack passt.

Beispiel-Template:

Deutschsprachige CLAUDE.md-Templates findest du in der FlowKI-Community und auf der Claude-Code-Deutsch-Landingpage.

2. MCP-Server konfigurieren

MCP-Server (Model Context Protocol) erweitern Claude mit Tools: Datenbank-Zugriff, APIs, Browser-Automation, Filesystem.

Installation Beispiel (Filesystem-Server):

npm install -g @modelcontextprotocol/server-filesystem

Konfiguration (claude_desktop_config.json):

Die Konfigurationsdatei liegt unter:

• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

Trage den installierten Server ein (genaue JSON-Syntax in der offiziellen Dokumentation unter modelcontextprotocol.io).

Häufigster Fehler: Claude lädt kommentarlos 0 Tools, obwohl Server konfiguriert → Pfade falsch oder Umgebungsvariablen fehlen. Logs prüfen: Desktop-App → Help → View Logs.

3. Skills nutzen

Skills sind wiederverwendbare Workflows. Installiere sie mit dem offiziellen Skills-CLI (genaue Befehle in der offiziellen Dokumentation).

Beispiele:

• supabase/agent-skills für Supabase-Integration
• workos/skills für Auth-Workflows
• heygen-com/hyperframes für Video-Projekte

Skills sparen Token und Zeit, weil häufige Patterns nicht jedes Mal neu erklärt werden müssen.

4. Erst testen, dann produktiv

Starte mit einem kleinen Use-Case:

• Einfaches Feature implementieren lassen (z.B. CRUD-Endpoint)
• Test-Coverage prüfen
• Code-Qualität bewerten
• CLAUDE.md-Regeln anpassen

Erst wenn der Workflow sitzt, skaliere auf größere Projekte. Claude ist kein Autopilot — es braucht klare Leitplanken.

Welcher Installationsweg passt zu dir?

CLI (Terminal): → Du arbeitest sowieso im Terminal, brauchst Git-Integration und willst MCP-Server nutzen.

Desktop-App: → Du willst grafische Oberfläche, aber volle Agent-Funktionen mit MCP-Servern.

Web-Version: → Du brauchst schnellen Zugriff ohne Installation oder arbeitest von fremden Rechnern.

IDE-Extension: → Du willst in VS Code/JetBrains bleiben und Inline-Vorschläge nutzen.

Die meisten professionellen Entwickler nutzen CLI oder Desktop-App — diese bieten vollen MCP-Zugriff und lokale Filesystem-Integration.

Kosten nach Installation

Claude Code ist in drei Abo-Stufen enthalten:

| Abo | Kosten | Kontingent | Geeignet für | |-----|--------|-----------|--------------| | Claude Pro | 20 USD/Monat (17 USD/Jahr) | Basis-Kontingent im 5-Stunden-Fenster (ca. 40–80 Sonnet-Stunden/Woche) | Gelegentliche Sessions, Einstieg | | Claude Max 5x | 100 USD/Monat | Ca. 5-faches Pro-Kontingent (ca. 140–280 Sonnet- + 15–35 Opus-Stunden/Woche) | Tägliche professionelle Nutzung | | Claude Max 20x | 200 USD/Monat | Ca. 20-faches Pro-Kontingent (ca. 240–480 Sonnet- + 24–40 Opus-Stunden/Woche, Wochen-Limit) | Poweruser, parallele Sessions |

Faustregel: Wer 2–3 Mal pro Woche eine Session macht, kommt mit Pro aus. Wer täglich arbeitet, braucht Max 5x. Max 20x lohnt sich erst bei parallelen Agent-Sessions (Subagenten, lange Refactorings).

Upgrade geht jederzeit — fang klein an und miss deine echten Limits.

Typische Anfänger-Fehler

Keine CLAUDE.md angelegt

Ohne projektspezifische Regeln produziert Claude Code generischen Code, der nicht zu deinem Stack passt. CLAUDE.md ist der wichtigste Hebel für Output-Qualität.

MCP-Server falsch konfiguriert

Häufigster Fehler: claude_desktop_config.json mit falschen Pfaden oder fehlenden Umgebungsvariablen. Claude lädt dann kommentarlos 0 Tools. Tipp: Logs prüfen (Help → View Logs in der Desktop-App).

Zu breite Prompts ohne Kontext

Claude braucht klaren Kontext: Was ist der aktuelle Stand? Was soll geändert werden? Was ist das Definition of Done? Ohne das entsteht Stub-Code oder Over-Engineering.

API-Calls ohne Budget-Monitoring

API-Kosten skalieren mit Tokens. Ein Agent mit langen Kontexten kann schnell 100€+ am Tag kosten. Setze Budget-Alerts im Anthropic-Account unter Settings → Billing.

Deutschsprachiger Support

Die offizielle Anthropic-Dokumentation ist auf Englisch. Deutschsprachigen Support, CLAUDE.md-Templates und MCP-Server-Guides findest du in der FlowKI-Community.

Dort kannst du Setup-Fragen direkt stellen und funktionierende Workflows für gängige Stacks (Next.js, FastAPI, Django, Supabase, Postgres) teilen.

Weitere Artikel:

• Claude Code auf Deutsch nutzen — kompletter Guide
• Claude Code Plan Mode erklärt
• MCP-Server bauen in 60 Minuten

Häufige Fragen

Wie lange dauert die Installation? CLI/Desktop-App: unter 5 Minuten. MCP-Server-Setup: 15–30 Minuten beim ersten Mal. CLAUDE.md-Erstellung: 1–2 Stunden für ein produktionsreifes Template.

Kann ich Claude Code offline nutzen? Nein. Claude Code braucht Verbindung zu Anthropics API. Für Offline-Arbeit gibt es lokale LLM-Alternativen (z.B. Llama, CodeLlama), die aber deutlich schwächer sind.

Funktioniert Claude Code mit GitLab/Bitbucket? Ja. Claude Code ist Git-agnostisch — es nutzt lokale Git-Befehle, unabhängig vom Remote-Provider.

Kann ich Claude Code in CI/CD nutzen? Ja, über die API mit eigenem API-Key. Abo-basierte CLI-Nutzung ist nicht für CI gedacht (Limitprobleme). Für CI/CD: Claude API mit Budget-Alerts.

Welche Programmiersprachen unterstützt Claude Code? Alle gängigen Sprachen: Python, JavaScript/TypeScript, Go, Rust, Java, C++, PHP, Ruby, Swift, Kotlin. Die Qualität hängt vom Training-Datenvolumen ab — Python/JS/TS sind am stärksten.

Stand: 12. August 2026 – Alle Installations-Details und aktuelle Befehle in der offiziellen Claude-Code-Dokumentation unter code.claude.com/docs.