So installieren Sie Claude Code

Node.js für Claude Code: welche Version und wie Sie darauf verzichten können

Die Installation über npm benötigt Node.js 18 oder neuer — node -v zum Prüfen; nvm (nvm install --lts) zum Beheben. Eine ältere Node-Version ist der häufigste Grund, warum eine neue Installation nicht startet. Wenn Node nicht zu Ihrer Toolchain gehört, verzichten Sie darauf: Der native Installer unten liefert eine eigenständige Binärdatei und aktualisiert sich selbst.

Option 1 — npm (jedes Betriebssystem mit Node.js 18+)

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

Wenn npm install -g unter macOS oder Linux mit EACCES fehlschlägt, verwenden Sie nicht sudo — korrigieren Sie stattdessen das npm-Präfix: npm config set prefix ~/.npm-global und fügen Sie ~/.npm-global/bin zu Ihrer PATH hinzu. Führen Sie die Installation unter Windows in einem normalen Terminal ohne Administratorrechte aus.

Option 2 — nativer Installer für Mac, Linux und Windows (ohne Node.js)

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

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

# Windows CMD (the one-liner people search for)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Claude Code unter Linux und Ubuntu installieren

Unter Ubuntu, Debian, Fedora oder einer beliebigen Distribution: Der native Installer (curl -fsSL https://claude.ai/install.sh | bash) legt eine sich selbst aktualisierende Binärdatei in Ihrem Home-Verzeichnis ab und benötigt weder Root-Rechte noch Node.js. Wenn Sie npm bevorzugen, installieren Sie zuerst Node 18+ über NodeSource oder nvm — die Node-Version aus Ubuntus apt ist meist zu alt — und anschließend npm install -g @anthropic-ai/claude-code. Auf einem Server mit reinem Terminalzugang oder in einem Container ist die native Binärdatei die bessere Wahl; fügen Sie die beiden Gateway-Variablen zu ~/.bashrc hinzu, und es funktioniert über SSH genauso wie lokal.

Die native Version aktualisiert sich selbst und vermeidet Konflikte zwischen Node-Versionen. Sie ist die bessere Wahl auf Rechnern, auf denen Node noch nicht zu Ihrer Toolchain gehört.

Option 3 — Desktop-App oder IDE-Erweiterung

Die Claude-Desktop-App enthält Claude Code, und die Erweiterungen für VS Code und JetBrains installieren die CLI bei der ersten Verwendung für Sie. Im Leitfaden zu Web, Desktop und IDE erfahren Sie, was die jeweilige Oberfläche kann und was nicht.

Hinweise zu Windows

Claude Code läuft nativ unter Windows 10/11 (PowerShell oder Git Bash) und innerhalb von WSL. WSL bietet die reibungslosere Nutzung für Projekte, die eine Unix-Shell voraussetzen. Wenn claude nach einer npm-Installation unter Windows nicht gefunden wird, öffnen Sie ein neues Terminal, damit PATH erneut eingelesen wird, oder prüfen Sie npm config get prefix und fügen Sie dessen bin Ordner hinzu.

Claude Code ohne Anmeldung ausführen: mit einem API-Schlüssel authentifizieren

Führen Sie claude und wählen Sie /login , um sich mit einem Claude Pro/Max-Abonnement anzumelden — oder überspringen Sie die Anmeldung vollständig. Wenn ANTHROPIC_API_KEY (oder ANTHROPIC_AUTH_TOKEN) gesetzt ist, zeigt Claude Code den Anmeldebildschirm nie an und läuft lokal mit dem Endpunkt, den ANTHROPIC_BASE_URL angibt. So läuft es auch auf Rechnern, die keinen Browser öffnen können. Verwenden Sie für dieses Gateway die Authentifizierung per Schlüssel:

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_gateway_key   # or ANTHROPIC_AUTH_TOKEN
claude

Tragen Sie diese beiden Zeilen in ~/.zshrc, ~/.bashrc oder in Ihr PowerShell-Profil ein, damit sie in jedem neuen Terminal verfügbar sind. In Claude Code zeigt /status an, welcher Endpunkt und welcher Schlüssel aktiv sind.

Claude Code aktualisieren und deinstallieren

claude update                      # native / self-update
npm update -g @anthropic-ai/claude-code   # npm install
npm uninstall -g @anthropic-ai/claude-code

Wenn die Installation funktioniert hat, Claude Code aber nicht startet

• command not found → PATH: Öffnen Sie eine neue Shell oder fügen Sie das globale bin-Verzeichnis von npm hinzu.
• Node version Fehler → Node.js 18 oder neuer ist erforderlich; node -v zum Prüfen, oder wechseln Sie zum nativen Installer.
• Hängt beim ersten Start → Unternehmensproxy; setzen Sie HTTPS_PROXY oder die Gateway-Basis-URL, wenn Ihr Netzwerk api.anthropic.com blockiert.
• 401 / ungültiger Schlüssel → der Schlüssel muss ein Gateway-Schlüssel sein, wenn ANTHROPIC_BASE_URL hierher verweist; ein Schlüssel aus der Anthropic-Konsole wird abgelehnt.

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key

Häufig gestellte Fragen

AI Prime Tech ist ein unabhängiges API-Gateway und ist weder mit Anthropic verbunden noch wird es von Anthropic unterstützt oder gesponsert. „Claude“ und „Claude Code“ sind Marken von Anthropic. Die hier beschriebenen Funktionen von Claude Code entsprechen der öffentlichen Dokumentation von Anthropic zum Zeitpunkt der Erstellung und ändern sich häufig; Preise und Modelllisten auf dieser Seite werden aus den aktuellen Einstellungen dieses Gateways ausgelesen.