Claude Code installieren und einrichten: Schritt-für-Schritt (2026)

TL;DR: Claude Code braucht Node.js 18+ und einen API Key (oder ein Claude Pro-Abo). Die Installation dauert 2 Minuten: npm install -g @anthropic-ai/claude-code. Die Konfiguration über CLAUDE.md macht den echten Unterschied. Falls du noch nicht weißt, was Claude Code ist, lies zuerst unseren kompletten Guide zu Claude Code.

---

Voraussetzungen

Bevor du startest, brauchst du drei Dinge:

1. Node.js 18 oder höher – Claude Code ist ein Node.js-Paket
2. Ein Anthropic API Key oder ein Claude Pro/Max Abo – für die Modellabfragen
3. Ein Terminal – macOS Terminal, iTerm2, Windows Terminal, oder jedes Linux-Terminal

Node.js prüfen und installieren

Öffne dein Terminal und prüfe deine Node.js-Version:

node --version

Du brauchst mindestens v18.0.0. Falls Node.js nicht installiert ist oder die Version zu alt:

macOS (mit Homebrew):

brew install node

macOS/Linux (mit nvm – empfohlen):

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
nvm install 22
nvm use 22

Windows: Lade den Installer von nodejs.org herunter und installiere die LTS-Version.

API Key oder Abo

Du hast zwei Optionen:

Option A: Anthropic API Key Erstelle einen Account auf console.anthropic.com. Unter "API Keys" generierst du einen neuen Key. Du zahlst pro Nutzung – durchschnittlich $6/Tag bei aktiver Entwicklung.

Option B: Claude Pro oder Max Abo Mit einem Claude-Abo ($20–$200/Monat) kannst du Claude Code nutzen, ohne einen separaten API Key zu verwalten. Du meldest dich beim ersten Start über den Browser an. Welcher Plan sich für dich lohnt, erfährst du im Claude Code Preise-Vergleich.

---

Installation

Ein einziger Befehl:

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

Das installiert Claude Code global auf deinem System. Prüfe die Installation:

claude --version

API Key setzen (nur bei Option A)

Setze deinen API Key als Umgebungsvariable:

export ANTHROPIC_API_KEY=sk-ant-...

Damit der Key dauerhaft verfügbar ist, füge die Zeile in deine Shell-Konfiguration ein:

# Für zsh (macOS Standard):
echo 'export ANTHROPIC_API_KEY=sk-ant-...' >> ~/.zshrc

# Für bash:
echo 'export ANTHROPIC_API_KEY=sk-ant-...' >> ~/.bashrc

Sicherheitshinweis: Speichere API Keys nie in Git-Repositories. Nutze .env-Dateien (mit .gitignore) oder einen Passwort-Manager.

Erster Start

Navigiere in dein Projektverzeichnis und starte Claude Code:

cd /pfad/zu/deinem/projekt
claude

Beim ersten Start passiert folgendes:

1. Claude Code fragt nach Authentifizierung (API Key oder Browser-Login)
2. Das Tool indexiert dein Projekt
3. Du siehst den Eingabeprompt – Claude Code ist bereit

---

CLAUDE.md einrichten

Die CLAUDE.md-Datei ist das Gedächtnis von Claude Code. Ohne sie funktioniert Claude Code. Mit ihr funktioniert er deutlich besser.

CLAUDE.md automatisch generieren

Claude Code kann die Datei für dich erstellen:

/init

Der /init-Befehl analysiert dein Projekt und generiert eine CLAUDE.md mit:

• Erkannter Projektstruktur
• Build-Befehlen
• Test-Setup
• Coding-Konventionen (basierend auf existierendem Code)

CLAUDE.md manuell erstellen

Erstelle eine CLAUDE.md im Projekt-Root. Hier ein praxiserprobtes Template:

# Projekt: [Name]

## Kontext
[Was macht dieses Projekt? 2-3 Sätze.]

## Tech Stack
- Frontend: [z.B. React, Next.js, TypeScript]
- Backend: [z.B. Node.js, Python, Go]
- Datenbank: [z.B. PostgreSQL, MongoDB]
- Hosting: [z.B. Vercel, AWS, Hetzner]

## Befehle
- Build: `npm run build`
- Dev: `npm run dev`
- Test: `npm test`
- Lint: `npm run lint`

## Architektur
[Kurze Beschreibung der Architektur. Welche Ordner machen was.]

## Konventionen
- [Naming: camelCase für Variablen, PascalCase für Komponenten]
- [Imports: absolute Pfade mit @/-Alias]
- [Commits: Conventional Commits (feat:, fix:, chore:)]
- [Tests: Jede Funktion braucht mindestens einen Unit-Test]

## Bekannte Probleme
- [Beschreibung + Workaround]

## Wichtig
- [Spezielle Hinweise, die Claude Code kennen muss]

Wo kann CLAUDE.md liegen?

Claude Code liest CLAUDE.md aus drei Orten (in dieser Reihenfolge):

1. Projekt-Root (./CLAUDE.md) – Projekt-spezifische Regeln
2. Home-Verzeichnis (~/.claude/CLAUDE.md) – Globale Regeln für alle Projekte
3. Unterverzeichnisse (./src/CLAUDE.md) – Modul-spezifische Regeln

Alle gefundenen Dateien werden kombiniert. Das ermöglicht eine Hierarchie: Globale Standards + projektspezifische Regeln + modulspezifische Details. Wie du eine wirklich effektive CLAUDE.md aufbaust, zeigen wir im Detail in CLAUDE.md schreiben: Der komplette Guide.

---

IDE-Setup

VS Code Extension

1. Öffne VS Code
2. Gehe zu Extensions (Cmd+Shift+X)
3. Suche nach "Claude Code"
4. Installiere die offizielle Anthropic-Extension
5. Claude Code erscheint als Panel in der Sidebar

Die Extension verbindet sich automatisch mit deiner lokalen Claude-Code-Installation. Du brauchst keine separate Konfiguration.

JetBrains Plugin

1. Öffne deine JetBrains-IDE (IntelliJ, WebStorm, PyCharm, etc.)
2. Gehe zu Settings > Plugins > Marketplace
3. Suche nach "Claude Code"
4. Installiere das Plugin und starte die IDE neu
5. Claude Code erscheint als Tool Window

Terminal-only (ohne IDE)

Claude Code braucht keine IDE. Wenn du Neovim, Emacs oder einen anderen Editor nutzt: Starte Claude Code einfach in einem separaten Terminal-Fenster neben deinem Editor.

---

Erste Schritte nach der Installation

1. Plan Mode kennenlernen

Drücke Shift+Tab zweimal, um den Plan Mode zu aktivieren. Gib dann deine erste Aufgabe ein:

Analysiere dieses Projekt und erkläre mir die Architektur.

Claude Code wird die Codebase durchgehen und dir eine Übersicht geben. Im Plan Mode schreibt er keinen Code – er analysiert und plant.

2. Erste echte Aufgabe

Starte mit etwas Kleinem:

Schreibe Unit-Tests für die Datei src/utils/helpers.ts

Claude Code liest die Datei, versteht die Funktionen und generiert passende Tests. Du siehst die Änderungen und kannst sie bestätigen oder anpassen.

3. Sandbox aktivieren

Die Sandbox reduziert Permission-Prompts um 84 %. Claude Code fragt standardmäßig bei vielen Aktionen nach Erlaubnis. Mit der Sandbox arbeitet er innerhalb des Projektverzeichnisses frei.

Aktiviere die Sandbox beim Start:

claude --sandbox

Oder setze es in deiner Konfiguration als Standard.

4. Nützliche Slash-Commands

Command	Funktion
/init	CLAUDE.md generieren
/compact	Konversation komprimieren (spart Token)
/clear	Konversation zurücksetzen
/help	Alle verfügbaren Commands anzeigen

Alle Befehle, Shortcuts und CLI-Flags findest du in unserem Claude Code Befehle Cheatsheet.

---

Konfiguration für Fortgeschrittene

Modell wählen

Standardmäßig nutzt Claude Code das beste verfügbare Modell. Du kannst das Modell explizit setzen:

claude --model opus
claude --model sonnet

Opus für komplexe Tasks (tieferes Reasoning, höhere Kosten). Sonnet für schnelle, einfache Aufgaben (schnellere Antworten, geringere Kosten).

MCP-Server anbinden

MCP (Model Context Protocol) erweitert Claude Code um externe Tools. Beispiel: Eine Datenbank-Verbindung.

Erstelle oder bearbeite .claude/mcp.json im Projektverzeichnis:

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"],
      "env": {
        "DATABASE_URL": "postgresql://user:pass@localhost:5432/mydb"
      }
    }
  }
}

Nach dem nächsten Start kann Claude Code direkt mit deiner Datenbank interagieren.

Git-Integration

Claude Code arbeitet nativ mit Git. Er erstellt Branches, staged Dateien, schreibt Commit-Messages und kann Pull Requests öffnen. Dafür ist keine zusätzliche Konfiguration nötig – Claude Code erkennt Git-Repositories automatisch.

---

Häufige Probleme und Lösungen

"command not found: claude"

Node.js global bin-Verzeichnis ist nicht im PATH. Lösung:

npm config get prefix
# Füge den Pfad /bin zu deinem PATH hinzu

"Authentication failed"

API Key nicht gesetzt oder abgelaufen. Prüfe:

echo $ANTHROPIC_API_KEY

Claude Code ist langsam

Große Codebases brauchen beim ersten Start mehr Zeit für die Indexierung. Nutze /compact, um den Kontext zu komprimieren, oder /clear für einen Neustart.

Token-Limit erreicht

Bei langen Sessions: /compact komprimiert den bisherigen Kontext. Bei sehr langen Sessions: /clear und die Aufgabe neu starten.

---

FAQ

Funktioniert Claude Code offline?

Nein. Claude Code braucht eine Internetverbindung, um die Cloud-Modelle von Anthropic abzufragen. Der Code selbst bleibt lokal.

Muss ich Node.js-Entwickler sein?

Nein. Node.js ist nur die Laufzeitumgebung für Claude Code. Du installierst es einmal und vergisst es. Claude Code selbst arbeitet mit jeder Programmiersprache. Unser Anfänger-Guide zeigt dir den Einstieg ohne Vorkenntnisse.

Wie viel Speicherplatz braucht Claude Code?

Die Installation ist unter 100 MB. Der Großteil des Speicherbedarfs entsteht durch Node.js selbst.

Kann ich Claude Code auf einem Server installieren?

Ja. Claude Code läuft auf jedem System mit Node.js 18+. Linux-Server, Docker-Container, CI/CD-Pipelines – alles möglich.

Wie aktualisiere ich Claude Code?

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

Ist die CLAUDE.md-Datei Pflicht?

Nein. Claude Code funktioniert ohne sie. Aber die Qualität der Ergebnisse steigt deutlich, wenn Claude Code den Projektkontext kennt.

Kann ich mehrere API Keys für verschiedene Projekte nutzen?

Ja. Setze den API Key projektspezifisch in einer .env-Datei statt global. Claude Code liest .env-Dateien automatisch.

Was passiert mit meinem Code? Wird er für Training genutzt?

Anthropic gibt an, API-Daten nicht für Modell-Training zu verwenden. Dein Code wird zur Verarbeitung an die API gesendet, aber nicht gespeichert oder weiterverwendet.