Node.js installieren

Auf dieser Seite erfahren Sie, wie Sie Node.js unter Windows, macOS und Linux installieren. Desktop und die Microsoft Store-Version enthalten kein Node.js mehr; sie verwenden direkt node und npm aus Ihrem System. Auch OpenSpec und die meisten Agent CLIs sind darauf angewiesen.

Versionsanforderung

Erforderlich ist Node.js 24 oder höher; auch die Mindestanforderung ist 24. In der Regel genügt es, einfach die neueste LTS-Version zu installieren. npm wird zusammen mit Node.js installiert und muss nicht separat installiert werden.

Welche Installationsmethoden es benötigen

• Microsoft Store / Desktop: Erforderlich, und node sowie npm müssen im System-PATH auffindbar sein.

Node.js installieren

Windows

Methode eins: Offizieller Installer (empfohlen)

1. Besuchen Sie die offizielle Website von Node.js
2. Laden Sie das Windows-Installationsprogramm der Version LTS (Long Term Support) herunter (.msi-Datei) und stellen Sie sicher, dass die Versionsnummer mindestens 24 ist
3. Doppelklicken Sie, um das Installationsprogramm auszuführen
4. Befolgen Sie die Anweisungen des Installationsassistenten, um die Installation abzuschließen:
   • Akzeptieren Sie die Lizenzvereinbarung
   • Wählen Sie den Installationspfad (die Standardeinstellung genügt)
   • Lassen Sie die Option „Add to PATH“ aktiviert
   • Klicken Sie auf „Install“, um die Installation zu starten
5. Klicken Sie nach Abschluss der Installation auf „Finish“

Methode zwei: winget verwenden

Öffnen Sie PowerShell oder die Eingabeaufforderung und führen Sie den folgenden Befehl aus:

winget install OpenJS.NodeJS.LTS

Öffnen Sie nach der Installation das Terminal erneut, damit die Änderungen wirksam werden.

macOS

Methode eins: Offizieller Installer (empfohlen)

1. Besuchen Sie die offizielle Website von Node.js
2. Laden Sie das macOS-Installationsprogramm der Version LTS (Long Term Support) herunter (.pkg-Datei) und stellen Sie sicher, dass die Versionsnummer mindestens 24 ist
3. Doppelklicken Sie, um das Installationsprogramm auszuführen
4. Befolgen Sie die Anweisungen des Installationsassistenten, um die Installation abzuschließen:
   • Klicken Sie auf „Fortfahren“
   • Akzeptieren Sie die Lizenzvereinbarung
   • Wählen Sie das Installationsvolume
   • Klicken Sie auf „Installieren“ und geben Sie das Administratorkennwort ein
5. Klicken Sie nach Abschluss der Installation auf „Schließen“

Methode zwei: Homebrew verwenden

Wenn Sie Homebrew bereits installiert haben, können Sie Node.js über das Terminal installieren:

brew install node

Homebrew fügt Node.js automatisch zu Ihrem PATH hinzu. Wenn der Befehl nicht verfügbar ist, starten Sie das Terminal neu oder führen Sie Folgendes aus:

eval "$(/opt/homebrew/bin/brew shellenv)"

Ubuntu/Debian

NodeSource-Repository verwenden (empfohlen)

Das Node.js in den Standard-Repositories der Distribution ist meist älter als 24. Verwenden Sie daher das 24.x-Repository von NodeSource:

# Installationsskript mit curl herunterladen
curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt-get install -y nodejs

Installieren Sie nicht mit sudo apt-get install nodejs npm die mit der Distribution gelieferte Version. Sie erfüllt die Mindestanforderung 24 mit hoher Wahrscheinlichkeit nicht.

Wenn Sie keine Paketquelle eines Drittanbieters hinzufügen möchten, können Sie auch nvm oder fnm verwenden (siehe unten).

CentOS/RHEL

NodeSource-Repository verwenden (empfohlen)

# Installationsskript mit curl herunterladen
curl -fsSL https://rpm.nodesource.com/setup_24.x | sudo bash -
sudo yum install -y nodejs

Das Node.js in den Standard-Repositories der Distribution ist meist älter als 24 und wird daher nicht zur direkten Verwendung empfohlen. Sie können stattdessen auch nvm oder fnm verwenden (siehe unten).

Fedora

dnf-Paketmanager verwenden

sudo dnf install -y nodejs npm

Führen Sie nach der Installation node --version aus und bestätigen Sie, dass die Version mindestens 24 ist. Ist die Version im Repository älter, verwenden Sie stattdessen das 24.x-Repository von NodeSource oder nvm oder fnm (siehe unten).

Versionsverwaltungstools verwenden

Wenn Sie zwischen mehreren Node.js-Versionen wechseln müssen, können Sie Versionsverwaltungstools verwenden.

Hinweis für Desktop-Nutzer

Unter macOS und Linux setzen Tools wie nvm und fnm den PATH in der Regel nur in Shell-Konfigurationsdateien (etwa .bashrc, .zshrc). Ein Desktop, das über das Dock, das Anwendungsmenü oder ein Desktop-Symbol gestartet wird, liest diese Konfiguration nicht und findet node möglicherweise nicht. Wenn Sie ein Versionsverwaltungstool verwenden, starten Sie Desktop aus einem Terminal, in dem node bereits funktioniert, oder verwenden Sie stattdessen die oben beschriebene systemweite Installation.

nvm (Node Version Manager)

nvm installieren

Linux/macOS

Kopieren Sie bitte direkt den aktuellen Installationsbefehl aus der README des offiziellen nvm-Repositorys und verwenden Sie keine veralteten Adressen von Installationsskripten.

Laden Sie nach der Installation Ihre Shell-Konfiguration neu:

source ~/.bashrc
# Oder für Zsh-Nutzer
source ~/.zshrc

Windows

Unter Windows empfehlen wir nvm-windows:

1. Laden Sie die neueste nvm-setup.exe von den nvm-windows-Releases herunter
2. Führen Sie das Installationsprogramm aus
3. Öffnen Sie die Eingabeaufforderung oder PowerShell erneut

nvm verwenden

Nach der Installation von nvm können Sie damit Node.js-Versionen installieren und verwalten:

# Node.js 24 installieren
nvm install 24

# Zu Node.js 24 wechseln
nvm use 24

# Standardversion festlegen
nvm alias default 24

# Installierte Versionen auflisten
nvm list

Der Befehl alias von nvm-windows ist nicht verfügbar; verwenden Sie nvm install 24 und nvm use 24.

fnm (Fast Node Manager)

fnm ist ein schnelleres und einfacheres Node.js-Versionsverwaltungstool, das mit Rust erstellt wurde.

fnm installieren

Linux/macOS

# Mit curl installieren
curl -fsSL https://fnm.vercel.app/install | bash

# Nach der Installation die Shell-Konfiguration neu laden
source ~/.bashrc
# Oder für Zsh-Nutzer
source ~/.zshrc

Windows

Verwenden Sie scoop oder winget:

# Mit scoop
scoop install fnm

# Oder mit winget
winget install Schniz.fnm

fnm verwenden

# Node.js 24 installieren
fnm install 24

# Zu Node.js 24 wechseln
fnm use 24

# Standardversion festlegen
fnm default 24

# Installierte Versionen auflisten
fnm list

Beschleunigung für Benutzer auf dem chinesischen Festland

Wenn Sie sich auf dem chinesischen Festland befinden, kann das Herunterladen von Node.js- und npm-Paketen langsam sein. Sie können dann inländische Mirrors verwenden.

npm-Mirror

# Mirror vorübergehend für die Installation verwenden
npm install --registry=https://registry.npmmirror.com

# Mirror dauerhaft festlegen
npm config set registry https://registry.npmmirror.com

# Prüfen, ob der Mirror erfolgreich festgelegt wurde
npm config get registry

Mirror für Node.js-Installationspakete

Auch für Node.js-Installationspakete gibt es eine Mirror-Download-Adresse: https://npmmirror.com/mirrors/node/. Wählen Sie dort zum Herunterladen eine Version ab 24.

Homebrew-Mirror

Wenn Sie Homebrew auf dem chinesischen Festland verwenden, können Sie für Bottles den Mirror der USTC konfigurieren:

export HOMEBREW_BOTTLE_DOMAIN=https://mirrors.ustc.edu.cn/homebrew-bottles

Installation überprüfen

Prüfen Sie nach der Installation in einem neu geöffneten Terminal, ob Node.js und npm verfügbar sind:

# Node.js-Version prüfen, erforderlich ist v24.0.0 oder höher
node --version

# npm-Version prüfen
npm --version

Die Ausgabe einer erfolgreichen Überprüfung sollte etwa so aussehen:

$ node --version
v24.3.0

$ npm --version
11.4.2

Wenn node --version eine Version unter 24 anzeigt, installieren Sie Node.js gemäß den obigen Methoden neu oder wechseln Sie mit einem Versionsverwaltungstool auf Version 24 oder höher.

Globales npm-Verzeichnis konfigurieren

Desktop installiert verwaltete Pakete wie Agent CLIs in das globale npm-Verzeichnis Ihres Rechners. Liegt das globale Verzeichnis an einem Ort, der Administratorrechte erfordert, kann bei der Installation der Berechtigungsfehler EACCES auftreten. Statt die Berechtigungen von Systemverzeichnissen zu ändern, empfiehlt es sich, das globale Verzeichnis in das Benutzerverzeichnis zu verlegen:

mkdir -p ~/.npm-global
npm config set prefix ~/.npm-global

Fügen Sie anschließend ~/.npm-global/bin (unter Windows das globale npm-Verzeichnis selbst) zum System-PATH hinzu und starten Sie Terminal und Desktop neu. Bei Verwendung von nvm oder fnm liegt das globale Verzeichnis bereits im Benutzerverzeichnis; dieser Schritt ist dann nicht nötig.

Fehlerbehebung

Windows-Probleme

Befehl nicht verfügbar

Wenn die Befehle node oder npm nach der Installation nicht verfügbar sind:

1. Starten Sie die Eingabeaufforderung oder PowerShell neu
2. Wenn sie weiterhin nicht verfügbar sind, fügen Sie Node.js manuell zum PATH hinzu:
   • Suchen Sie nach „Umgebungsvariablen“ und öffnen Sie „Systemumgebungsvariablen bearbeiten“
   • Klicken Sie auf „Umgebungsvariablen“
   • Suchen Sie unter „Systemvariablen“ nach „Path“ und klicken Sie auf „Bearbeiten“
   • Fügen Sie den Installationspfad von Node.js hinzu (Standard: C:\Program Files\nodejs\)
   • Klicken Sie auf „OK“, um die Änderungen zu speichern
3. Beenden Sie Desktop vollständig und starten Sie es neu

PowerShell-Ausführungsrichtlinie

Wenn bei der Verwendung von nvm- oder npm-Skripten Fehler wegen der Ausführungsrichtlinie auftreten:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

macOS-Probleme

Berechtigungsfehler

Wenn bei der Installation globaler npm-Pakete Berechtigungsfehler auftreten, lesen Sie den Abschnitt Globales npm-Verzeichnis konfigurieren oben oder verwenden Sie stattdessen nvm / fnm.

Befehl nicht verfügbar

Wenn der Befehl nach der Installation nicht verfügbar ist, starten Sie das Terminal neu und stellen Sie sicher, dass das Verzeichnis von Node.js (meist /usr/local/bin oder /opt/homebrew/bin) im PATH enthalten ist.

Linux-Probleme

Berechtigungsfehler

Wenn bei der Installation globaler npm-Pakete Berechtigungsfehler auftreten, lesen Sie den Abschnitt Globales npm-Verzeichnis konfigurieren oben oder verwenden Sie nvm / fnm, anstatt globale Pakete mit sudo zu installieren.

Version zu alt

Wenn die über den System-Paketmanager installierte Node.js-Version älter als 24 ist:

1. Verwenden Sie das 24.x-Repository von NodeSource (siehe oben)
2. Oder verwenden Sie Versionsverwaltungstools (nvm / fnm)

Umgebung prüfen

Wenn die Überprüfung fehlschlägt, kontrollieren Sie Folgendes:

Windows

# Prüfen, ob Node.js im PATH enthalten ist
where node

# Installationspfad prüfen
Get-Command node

macOS

# Prüfen, ob Node.js im PATH enthalten ist
which node

# Installationspfad prüfen
ls -l $(which node)

Linux

# Prüfen, ob Node.js im PATH enthalten ist
which node

# Installationspfad prüfen
ls -l $(which node)

Nächste Schritte

Nachdem die Installation von Node.js abgeschlossen ist, können Sie mit den folgenden Schritten fortfahren:

Zurück zur InstallationsanleitungRichten Sie Voraussetzungen wie Git ein und wählen Sie den für Sie passenden Installationsweg.

Einführung in OpenSpecWechseln Sie zur eigenständigen OpenSpec-Dokumentation und lernen Sie Installationsweg, Kernkonzepte und den spezifikationsgetriebenen Workflow kennen.

AI Agent CLI installierenSehen Sie sich die offiziellen Installationseinstiege der aktuell unterstützten Agent CLIs an und unterscheiden Sie zwischen Ein-Klick-Installation und manueller Installation / Authentifizierung.

Benötigen Sie weitere Hilfe?

Wenn Sie auf Probleme stoßen, die hier nicht behandelt werden:

1. Besuchen Sie die offizielle Node.js-Dokumentation
2. Lesen Sie Wie Desktop Ihre Node-Umgebung verwendet
3. Lesen Sie die HagiCode-Produktübersicht, um den aktuellen Produkt- und Werkzeugkontext kennenzulernen