Claude Code Installationsanleitung: irm-Script, npm-Setup und https://claude.ai/install.ps1 Script

Einfuehrung

Claude Code ist mein bevorzugtes Kommandozeilen-Tool fuer KI-unterstuetztes Coding. Ob Sie unter Windows, macOS oder Linux arbeiten, die Installation ist unkompliziert mit mehreren Optionen:

• Native Binary (Empfohlen): curl -fsSL https://claude.ai/install.sh | bash fuer Linux/macOS
• Windows PowerShell: irm https://claude.ai/install.ps1 | iex fuer Windows-Nutzer
• npm Global Install: npm install -g @anthropic-ai/claude-code fuer Node.js-Umgebungen

Diese Anleitung behandelt jede Installationsmethode im Detail, plus Fehlerbehebung mit dem claude doctor-Befehl zur Diagnose und Behebung haeufiger Probleme.

Empfohlen: Native Binary

Stand 2025 gibt es mehrere Laufzeitumgebungen, in denen Claude verfuegbar ist, einschliesslich Node.js und Bun.js. Anthropic empfiehlt die Verwendung der nativen Binary-Installation. Diese Methode vermeidet Paketmanager-Konflikte und ist am stabilsten.

Native Binary installieren

1. Installations-Script ausfuehren:

   curl -fsSL https://claude.ai/install.sh | bash

2. Shell-Konfiguration neu laden:

   source ~/.bashrc
   # oder fuer zsh-Nutzer:
   source ~/.zshrc

3. Installation verifizieren:

   claude --version
   claude doctor

Das ist alles! Claude Code sollte jetzt unter ~/.claude/bin/claude oder ~/.local/bin/claude installiert sein.

Fehlerbehebung: Kaputte Installationen reparieren

Wenn Sie Probleme mit Claude Code erleben, wie Segmentation-Fault-Fehler, haben Sie wahrscheinlich eine gemischte oder veraltete Installation. Wenn Sie Claude wie ich von Anfang an nutzen, haben Sie moeglicherweise auch Node.js- oder Bun.js-Versionen installiert. So beheben Sie das:

Aktuelle Installation mit claude doctor diagnostizieren

Der claude doctor-Befehl ist Ihre erste Anlaufstelle fuer die Fehlerbehebung. Er analysiert Ihre Installation und meldet potenzielle Probleme.

claude doctor

Was claude doctor prueft

Der claude doctor-Befehl inspiziert:

• Installationsmethode: Native Binary, npm, Bun oder Homebrew
• Versionsinformationen: Aktuelle Version und Update-Status
• Auto-Update-Faehigkeit: Ob Updates angewendet werden koennen
• Suchfunktionalitaet: Ob ripgrep ordnungsgemaess gebundelt/installiert ist
• Pfad-Konfiguration: Ob Claude korrekt in Ihrem PATH ist
• Ausfuehrungspfad: Die tatsaechlich ausgefuehrte Binary

ALLE bestehenden Installationen entfernen

# Bun-Installation entfernen
bun uninstall -g @anthropic-ai/claude-code
rm -f ~/.bun/bin/claude

# npm/Node.js-Installation entfernen
npm uninstall -g @anthropic-ai/claude-code

# Alle nvm-spezifischen Installationen entfernen
nvm list
# Fuer jede Version wechseln und deinstallieren
nvm use <version>
npm uninstall -g @anthropic-ai/claude-code

Brew Uninstall Claude Code

Wenn Sie Claude Code via Homebrew installiert haben:

# Claude Code von Homebrew deinstallieren
brew uninstall claude-code

# Gecachte Dateien bereinigen
brew cleanup claude-code

Frische Native Binary Installation

Jetzt installieren Sie die native Binary:

curl -fsSL https://claude.ai/install.sh | bash

Fix verifizieren

Nach der Installation verifizieren Sie, dass alles funktioniert:

# Version pruefen
claude --version

# Diagnose ausfuehren
claude doctor

Eine gesunde Installation sollte zeigen:

• Version: native (2.0.x oder hoeher)
• Config install method: native
• Auto-updates: enabled
• Search: OK (bundled)

Alternative Installationsmethoden

Waehrend die native Binary empfohlen wird, hier sind andere Optionen:

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

Wenn Sie npm (Node Package Manager) bevorzugen, koennen Sie Claude Code global installieren. Diese Methode erfordert Node.js 18 oder hoeher.

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

Wichtig: Verwenden Sie niemals sudo npm install -g, da dies Berechtigungsprobleme verursacht.

Windows: Verwendung von irm https://claude.ai/install.ps1 | iex

Fuer Windows-Nutzer haben Sie drei Optionen:

1. WSL (Empfohlen): WSL installieren und den Linux-Anweisungen folgen
2. Git Bash: Den nativen Installer mit Git Bash verwenden
3. PowerShell (Natives Windows):

   irm https://claude.ai/install.ps1 | iex

Den irm-Befehl verstehen

Der irm-Befehl ist PowerShells Invoke-RestMethod, der Inhalte von einer URL herunterlaed. Hier ist, was der Befehl macht:

• irm https://claude.ai/install.ps1 - Laedt das Installations-Script von Anthropics Servern herunter
• | iex - Leitet das Script an Invoke-Expression weiter, das es ausfuehrt

Das https://claude.ai/install.ps1-Script handhabt:

• Erkennung Ihrer Windows-Architektur (x64, ARM64)
• Download der entsprechenden Claude Code Binary
• Installation in Ihr Benutzerverzeichnis
• Hinzufuegen von Claude zu Ihrer PATH-Umgebungsvariable

Sicherheitshinweis: Verifizieren Sie immer, dass Sie von der offiziellen claude.ai-Domain herunterladen, bevor Sie Installations-Scripts ausfuehren.

Nach der Installation: Setup

Authentifizierung

Nach der Installation authentifizieren Sie Claude Code:

claude

Sie werden aufgefordert, Ihre Authentifizierungsmethode zu waehlen:

• Claude Console (Standard): Fuer API-Zugang mit Abrechnung unter console.anthropic.com
• Claude Pro/Max: Wenn Sie ein Claude-Abonnement haben
• Enterprise: Fuer AWS Bedrock oder Google Vertex AI Deployments

Grundlegende Verwendung

Beginnen Sie mit Claude Code:

# Zu Ihrem Projekt navigieren
cd /pfad/zu/ihrem/projekt

# Claude Code starten
claude

# Hilfe anzeigen
claude help

# In einer Sitzung Slash-Befehle verwenden
/help    # Verfuegbare Befehle anzeigen
/clear   # Konversation loeschen
/exit    # Claude Code beenden

Haeufige Probleme und Loesungen

Problem: "Insufficient permissions to install update"

Das passiert typischerweise bei npm/Bun-Installationen. Loesung: Zur nativen Binary-Installation wechseln.

Problem: "command not found: claude"

Der PATH wurde nicht aktualisiert. Zu Ihrer Shell-Konfiguration hinzufuegen:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

Best Practices

1. Immer die native Binary verwenden, es sei denn, Sie haben spezifische Anforderungen
2. sudo vermeiden bei jeder Installationsmethode
3. Auto-Updates aktiviert lassen fuer Sicherheit und Features
4. claude doctor ausfuehren nach jeder Installation oder jedem Update
5. Alte Installationen bereinigen bevor Sie neue Versionen installieren

Fazit

Denken Sie daran: Im Zweifel alles entfernen und frisch mit der nativen Binary starten. Es ist die einfachste, schnellste und zuverlaessigste Art, Claude Code auszufuehren.

Weiterfuehrende Lektuere

Jetzt, wo Sie Claude Code installiert haben, setzen Sie es ein:

• Einen Warenkorb mit Flask bauen - Ein praktisches Tutorial, in dem Sie Claude Code verwenden koennen, um ein komplettes E-Commerce-Backend mit Python und Flask zu bauen

Kurzreferenz

• Installieren: curl -fsSL https://claude.ai/install.sh | bash
• Version pruefen: claude --version
• Diagnostizieren: claude doctor
• Aktualisieren: claude update
• Starten: claude
• Hilfe: claude help