Claude Code pnpm: Schneller Package Manager für Node.js-Projekte mit KI

Wer mehrere Node.js-Projekte parallel entwickelt, kennt das Problem: node_modules-Ordner fressen Gigabytes auf der Festplatte, npm install dauert in CI gefühlt eine Ewigkeit, und bei Monorepos wird das Dependency-Management schnell unübersichtlich. pnpm löst alle drei Probleme — und Claude Code macht den Einstieg, die Konfiguration und die Migration erheblich einfacher.

Dieser Artikel erklärt, wie pnpm funktioniert, wo es gegenüber npm und yarn gewinnt, und wie Claude Code bei Workspaces, Skripten und der Migration konkret hilft.

1. Was pnpm anders macht

pnpm steht für performant npm. Das Kernkonzept: statt jede Dependency pro Projekt separat in node_modules zu kopieren, legt pnpm alle Pakete genau einmal in einem globalen Content-Addressable Store ab — standardmäßig unter ~/.pnpm-store. Projekte erhalten dann lediglich Hard-Links auf diesen Store.

Das hat zwei direkte Konsequenzen. Erstens: massiv weniger Disk-Verbrauch. Wenn fünf Projekte dasselbe React in derselben Version nutzen, liegt es trotzdem nur einmal auf der Festplatte. Zweitens: schnellere Installs, weil pnpm bereits vorhandene Pakete nicht neu herunterladen oder entpacken muss — es erstellt nur neue Links.

2. pnpm vs. npm vs. yarn: Was wirklich zählt

Die drei Package Manager unterscheiden sich vor allem in zwei Dimensionen: Geschwindigkeit und Dependency-Isolation.

Geschwindigkeit

npm hat über die Jahre aufgeholt, ist aber in CI-Umgebungen bei kaltem Cache noch immer langsamer als pnpm. yarn (v1 Classic wie v2/v3 Berry) ist schneller als npm, aber pnpm hat bei Wiederholungs-Installs einen strukturellen Vorteil: weil alle Dateien bereits im Store liegen, entfällt das Entpacken vollständig.

• Kalter Cache (erstes Install): pnpm und yarn berry liegen gleichauf, npm ist langsamer
• Warmer Cache (Wiederholung): pnpm gewinnt deutlich, da nur Links erstellt werden
• CI ohne Cache: pnpm gewinnt durch parallele Auflösung und kompakten Store

Dependency-Isolation (Hoisting-Verhalten)

Das ist der wichtigste Unterschied für Produktivprojekte. npm und yarn v1 hoisten Abhängigkeiten: transitive Dependencies landen flach in node_modules und sind damit für alle Pakete im Projekt direkt importierbar — auch wenn sie nicht in package.json deklariert sind. Das nennt sich Phantom-Dependencies: du nutzt etwas, das du nie installiert hast.

pnpm verhindert das durch strikte Isolation. Nur was explizit in package.json steht, ist importierbar. Das klingt streng — ist aber genau das Richtige, weil Phantom-Dependencies zu Problemen führen, die sich erst später zeigen: wenn eine transitive Dependency ihre Version ändert oder wegfällt.

"Mit pnpm hatte ich zum ersten Mal das Gefühl, dass meine Dependencies tatsächlich das sind, was in package.json steht — und nichts anderes."

3. Die wichtigsten pnpm-Befehle

Der Einstieg ist unkompliziert, weil pnpm die npm-Syntax weitgehend beibehält:

# Installation
npm install -g pnpm

# Dependencies installieren (wie npm install)
pnpm install

# Paket hinzufügen
pnpm add express
pnpm add -D typescript          # dev dependency
pnpm add -g nodemon             # global

# Paket entfernen
pnpm remove express

# Skript ausführen
pnpm run build
pnpm build                      # run-Präfix ist optional

# Paket temporär ausführen (wie npx)
pnpm dlx create-react-app mein-projekt
pnpm dlx prettier --write .

pnpm dlx ist das pnpm-Äquivalent zu npx: es lädt das Paket temporär herunter, führt es aus und verwirft es danach. Anders als npx nutzt es aber den pnpm-Store für den Download.

4. .npmrc für pnpm konfigurieren

pnpm liest dieselbe .npmrc-Datei wie npm, erkennt aber zusätzliche pnpm-spezifische Einstellungen:

# .npmrc
shamefully-hoist=false          # Default: strikte Isolation (empfohlen)
strict-peer-dependencies=false  # Peer-Dep-Warnungen nicht als Fehler behandeln
auto-install-peers=true         # Peer-Deps automatisch mit installieren
store-dir=~/.pnpm-store         # Globaler Store-Pfad (Standard)
prefer-frozen-lockfile=true     # In CI: lockfile nicht ändern

5. Workspaces und Monorepos mit pnpm

pnpm hat erstklassige Monorepo-Unterstützung eingebaut. Wer mehrere Pakete in einem Repository verwaltet — etwa eine Shared-Library, ein Frontend und ein Backend — profitiert von pnpm Workspaces erheblich.

Workspace einrichten

Eine pnpm-workspace.yaml im Root-Verzeichnis definiert die Workspace-Struktur:

# pnpm-workspace.yaml
packages:
  - 'packages/*'
  - 'apps/*'

Danach hat jedes Paket sein eigenes package.json. pnpm installiert alle Dependencies einmal und verlinkt lokale Pakete automatisch:

# Lokales Paket als Dependency referenzieren
# In apps/frontend/package.json:
{
  "dependencies": {
    "@mein-projekt/shared": "workspace:*"
  }
}

Workspace-Befehle

# Befehl in allen Paketen ausführen
pnpm -r run build               # rekursiv in allen Workspaces
pnpm -r run test

# Befehl in einem bestimmten Paket ausführen
pnpm --filter @mein-projekt/frontend run dev

# Paket nur in einem Workspace hinzufügen
pnpm --filter @mein-projekt/backend add express

6. Claude Code bei pnpm einsetzen

Hier wird es konkret: Claude Code hilft nicht nur dabei, pnpm-Befehle nachzuschlagen. Es liest deine bestehende Projektstruktur, erkennt das Setup und schreibt passende Konfiguration.

Workspace-Konfiguration generieren lassen

claude "Ich habe ein Monorepo mit den Verzeichnissen packages/ui,
packages/utils und apps/web. Erstelle eine pnpm-workspace.yaml
und pass die package.json-Dateien an, damit alle Pakete sich
gegenseitig über workspace:* referenzieren können."

Claude Code liest die vorhandenen package.json-Dateien, erkennt die Paket-Namen und Abhängigkeiten, und schreibt eine konsistente Konfiguration — inklusive der richtigen workspace:*-Verweise zwischen den Paketen.

CI-Pipeline auf pnpm umstellen

claude "Unsere GitHub Actions CI nutzt noch npm ci. Stell es auf
pnpm um, mit korrektem Store-Caching damit Installs schnell bleiben."

Claude Code liest die bestehende Workflow-Datei und schreibt eine aktualisierte Version mit pnpm/action-setup, dem korrekten Cache-Key auf Basis von pnpm-lock.yaml und pnpm install --frozen-lockfile für reproduzierbare CI-Builds.

7. Von npm oder yarn zu pnpm migrieren

Die Migration ist in den meisten Fällen unkompliziert. Der wesentliche Schritt: package-lock.json oder yarn.lock entfernen und pnpm import nutzen, um aus dem alten Lockfile ein pnpm-lock.yaml zu erzeugen.

# Von npm migrieren
rm package-lock.json
pnpm import                     # liest package-lock.json, erzeugt pnpm-lock.yaml
pnpm install

# Von yarn v1 migrieren
rm yarn.lock
pnpm import                     # liest yarn.lock, erzeugt pnpm-lock.yaml
pnpm install

Nach der Migration den Build und die Tests laufen lassen. Falls Phantom-Dependency-Fehler auftreten — Imports die funktioniert haben, aber nicht in package.json stehen — sind das die Stellen, die sauber gemacht werden müssen.

Migration mit Claude Code

claude "Migriere dieses Projekt von npm auf pnpm. Prüfe danach
ob alle Imports in den Quelldateien korrekt in package.json
deklariert sind und behebe eventuelle Phantom-Dependency-Probleme."

Claude Code führt den Import durch, führt pnpm install aus, liest die Fehlermeldungen falls etwas fehlt, und ergänzt fehlende Abhängigkeiten direkt in package.json. Das manuelle Suchen nach Phantom-Dependencies entfällt.

8. Fazit: pnpm lohnt sich, Claude Code macht den Einstieg einfach

pnpm ist für die meisten Node.js-Projekte die bessere Wahl als npm oder yarn — schnellere Installs, weniger Disk-Verbrauch und strikte Dependency-Isolation, die Probleme verhindert statt sie zu verschleiern. Der Preis ist minimal: einmal pnpm import, eventuell ein paar Phantom-Dependencies bereinigen, fertig.

Claude Code beschleunigt dabei genau die Schritte, die sonst Zeit kosten: Workspace-Konfiguration für Monorepos, CI-Anpassung und die Analyse von Phantom-Dependency-Fehlern nach der Migration. Wer Claude Code bereits einsetzt, kann pnpm innerhalb einer Session migrieren und konfigurieren — ohne Doku-Recherche, ohne Trial-and-Error.

• Claude Code Debugging — Stack Traces, Log-Analyse und Root-Cause-Suche mit Claude Code
• Claude Code für Unternehmen — Team-Workflows, Deployment und Zugriffskontrolle