Brauche ich Node.js für Claude Code?

Nicht mehr zwingend. Der native Installer bringt alles mit. Nur die Installation über npm setzt Node.js 18 oder neuer voraus.

Wie aktualisiere ich Claude Code?

Der native Installer aktualisiert sich selbst im Hintergrund. Bei der npm-Variante führen Sie npm install -g @anthropic-ai/claude-code erneut aus. Innerhalb einer Sitzung zeigt /status die Version.

Claude Code startet nicht unter Windows. Was tun?

Prüfen Sie, ob Git für Windows installiert ist; Claude Code nutzt dessen Bash. Starten Sie das Terminal nach der Installation neu, damit der PATH aktualisiert ist. Alternativ funktioniert Claude Code zuverlässig in WSL.

Kann ich Claude Code ohne Anthropic-Konto nutzen?

Ja, mit einem API-Schlüssel über die Umgebungsvariable ANTHROPIC_API_KEY, oder über Amazon Bedrock, Google Vertex AI beziehungsweise Microsoft Foundry mit den jeweiligen Cloud-Zugangsdaten.

Claude Code installieren: Schritt für Schritt auf macOS, Linux und Windows

Die Installation von Claude Code dauert unter zwei Minuten. Die meisten Probleme entstehen danach: fehlende Anmeldung, falscher Projektordner, kein CLAUDE.md, oder die Frage, wo die Daten eigentlich hinlaufen. Dieser Ratgeber geht alles der Reihe nach durch. Was Claude Code ist und kann, steht im Überblick.

Voraussetzungen

macOS 10.15 oder neuer, Linux (Ubuntu 20.04+, Debian 10+ oder vergleichbar) oder Windows 10/11.
Unter Windows: Git für Windows, weil Claude Code dessen Bash für Shell-Befehle nutzt. Alternativ WSL 1 oder 2.
Ein Terminal und Internetzugang.
Ein Anthropic-Konto (Pro, Max, Team oder Enterprise) oder ein API-Schlüssel oder Zugang zu Bedrock, Vertex AI oder Microsoft Foundry.

Node.js ist nur für die npm-Installation nötig.

Variante 1: Nativer Installer (empfohlen)

Der native Installer legt eine eigenständige Binärdatei ab und hält sie automatisch aktuell.

# macOS und Linux
curl -fsSL https://claude.ai/install.sh | bash

# Windows, PowerShell
irm https://claude.ai/install.ps1 | iex

Nach der Installation das Terminal neu öffnen und prüfen:

claude --version

Variante 2: npm

Wenn Node.js 18 oder neuer vorhanden ist:

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

Wichtig: nicht mit sudo installieren. Wenn npm ohne Root keine globalen Pakete installieren darf, konfigurieren Sie ein benutzereigenes Präfix oder nutzen Sie den nativen Installer.

Erste Anmeldung

Wechseln Sie in einen Projektordner und starten Sie den Agenten:

cd ~/projekte/mein-repo
claude

Beim ersten Start öffnet sich der Browser zur Anmeldung. Sie können sich mit dem Claude-Konto (Pro, Max, Team, Enterprise) oder mit einem Konto der Anthropic Console (API-Abrechnung) anmelden. Danach ist der Agent einsatzbereit.

Für Skripte, CI und Umgebungen ohne Browser setzen Sie stattdessen einen Schlüssel:

export ANTHROPIC_API_KEY=sk-ant-...

Das Projekt einrichten

Der wichtigste Schritt nach der Installation ist eine CLAUDE.md im Repository. Sie wird bei jeder Sitzung geladen und sollte enthalten, wie das Projekt gebaut und getestet wird, welche Konventionen gelten und was der Agent nicht anfassen soll.

> /init

erstellt einen ersten Entwurf aus dem, was der Agent im Repository findet. Überarbeiten Sie ihn und committen Sie die Datei; sie gilt dann für das ganze Team.

Weitere nützliche Befehle in der Sitzung:

Befehl	Zweck
`/help`	Alle Befehle
`/status`	Version, Konto, Modell, Kontext
`/mcp`	MCP-Server anzeigen und anmelden
`/permissions`	Erlaubte und gesperrte Aktionen
`/clear`	Kontext leeren

Editor-Integration

Claude Code läuft unabhängig vom Editor, lässt sich aber einbinden:

VS Code: Erweiterung aus dem Marketplace installieren; Diffs erscheinen dann im Editor.
JetBrains (IntelliJ, PyCharm, WebStorm, ...): Plugin aus dem Marketplace.
Terminal im Editor: funktioniert überall, ohne Plugin.

Häufige Fehler

claude: command not found. Terminal neu starten, damit der PATH aktualisiert ist. Bei npm prüfen, ob das globale bin-Verzeichnis im PATH liegt (npm bin -g).

Windows: Shell-Befehle schlagen fehl. Git für Windows fehlt oder ist nicht im PATH. Nach der Installation von Git das Terminal neu starten.

Anmeldung schlägt in Firmennetzen fehl. Proxy-Variablen (HTTPS_PROXY) setzen; bei TLS-Inspektion das Firmen-Zertifikat für Node beziehungsweise das System hinterlegen.

"Rate limit" oder Kontingent erschöpft. Bei Pro und Max gelten Nutzungsfenster; bei API-Konten das Kontolimit. Details im Ratgeber Claude Code Preis und Kosten.

Betrieb über eine EU-Region

Standardmäßig gehen die Anfragen an Anthropic in den USA. Wenn Ihre Datenschutzvorgaben eine EU-Verarbeitung verlangen, betreiben Sie Claude Code über einen der unterstützten Cloud-Anbieter. Die Umschaltung erfolgt über Umgebungsvariablen, zum Beispiel für Bedrock:

export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION=eu-central-1

Entsprechende Variablen gibt es für Vertex AI und Microsoft Foundry. Entwickler nutzen weiter dasselbe Werkzeug; nur das Backend ändert sich.

Betrieb über ein Gateway

Für mehr als eine Handvoll Entwickler reicht die Region allein nicht. Sie brauchen eine zentrale Stelle für Modellfreigaben, Budgets, erlaubte MCP-Server und das Protokoll. Claude Code unterstützt dafür eine konfigurierbare Basis-URL, über die alle Anfragen an ein Gateway gehen:

export ANTHROPIC_BASE_URL=https://hub.ihr-unternehmen.eu
export ANTHROPIC_AUTH_TOKEN=...

Walma AI Hub ist ein solches Gateway im eigenen Azure-Tenant in einer EU-Region. Entwickler installieren einen signierten Client für Windows und macOS, der diese Konfiguration setzt, und arbeiten mit einem Schlüssel für Claude Code, Codex, Cursor und alle freigegebenen MCP-Server. Richtlinien gelten im Gateway, nicht auf dem Laptop. Mehr zum AI Hub.