Bevor du mit Angular durchstarten kannst, benötigst du die richtige Entwicklungsumgebung. Dieser Artikel führt dich durch die Installation von Node.js, der Angular CLI und zeigt dir, wie du dein erstes, modernes Angular-Projekt (v21+) mit Standalone-Components erstellst.

01 · Abschnitt

Voraussetzungen: Node.js und npm

Angular wird nicht einfach als <script>-Tag in eine HTML-Datei eingebunden, sondern benötigt einen Build-Prozess. Dafür brauchst du Node.js und den dazugehörigen Paketmanager npm (Node Package Manager).

  1. Lade dir die aktuelle LTS-Version (Long Term Support) von Node.js herunter.
  2. Installiere das Paket.
  3. Öffne dein Terminal (Kommandozeile) und prüfe, ob die Installation erfolgreich war:
Bash Terminal 
# Prüft die Node-Version (sollte z.B. v20.x oder neuer sein)
node -v

# Prüft die npm-Version
npm -v
02 · Abschnitt

Die Angular CLI installieren

Die Angular CLI (Command Line Interface) ist das wichtigste Werkzeug in deinem Angular-Alltag. Sie generiert Projekte, Komponenten, Services und startet den lokalen Entwicklungsserver.

Um die CLI global auf deinem System zu installieren, führe folgenden Befehl aus:

Bash Terminal 
# -g steht für global, damit der Befehl 'ng' überall verfügbar ist
npm install -g @angular/cli

Prüfe danach, ob der Angular-Befehl (ng) funktioniert:

Bash Terminal 
ng version

Dieser Befehl zeigt dir ein schönes rotes Angular-Logo und die exakten Versionsnummern deiner CLI und von Node.js an.

03 · Abschnitt

Ein neues Projekt erstellen

Sobald die CLI installiert ist, kannst du dein Projektverzeichnis generieren lassen. Navigiere im Terminal in den Ordner, in dem dein Projekt liegen soll (z.B. cd Documents/Projekte), und führe aus:

Bash Terminal 
ng new my-angular-app

Die CLI stellt dir nun ein paar Fragen (die genauen Fragen können sich je nach Angular-Version leicht unterscheiden):

  1. Which stylesheet format would you like to use? -> CSS (oder SCSS, falls bevorzugt)
  2. Do you want to enable Server-Side Rendering (SSR) and Static Site Generation (SSG/Prerendering)? -> No (für den Anfang bauen wir eine reine Single-Page-Application)

Die CLI lädt nun alle Abhängigkeiten herunter und erstellt die Ordnerstruktur. Das kann eine bis zwei Minuten dauern.

04 · Abschnitt

Den Entwicklungsserver starten

Nachdem das Projekt erstellt wurde, wechselst du in den neuen Ordner und startest den Server.

Bash Terminal 
# 1. In den generierten Ordner wechseln
cd my-angular-app

# 2. Den lokalen Entwicklungsserver starten (-o öffnet direkt den Browser)
ng serve -o

Glückwunsch! Dein Browser sollte sich nun öffnen (http://localhost:4200/) und die Angular-Willkommensseite anzeigen. Wenn du jetzt Dateien im Ordner src/app/ änderst (z.B. die app.component.html), lädt der Browser automatisch neu.

05 · Abschnitt

Mögliche Stolperfallen

Zu alte Node-Version

Angular v21 verlangt mindestens Node.js 20.19.0. Wer noch auf Node 18 sitzt, bekommt beim ng new kryptische Fehler. Mit nvm lässt sich problemlos parallel eine aktuelle LTS installieren — empfohlen ist nvm install --lts.

Standalone ist Default — "--standalone" gibt es nicht mehr

Seit Angular v19 ist standalone: true Default und das Flag --standalone wurde entfernt. Wer wirklich noch ein klassisches NgModule-Setup will, muss explizit ng new my-app --no-standalone verwenden.

Globale CLI vs. npx

Statt npm install -g @angular/cli kann man die CLI auch projekt-lokal pinnen und über npx ng … aufrufen. Das vermeidet Versions-Drift zwischen mehreren Projekten und ist gerade in CI-Umgebungen oder bei nvm-Wechseln deutlich robuster.

PowerShell blockiert ng unter Windows

Frisch installiert wirft die PowerShell unter Windows oft den Fehler "running scripts is disabled". Abhilfe schafft einmalig Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned. Auf macOS/Linux liegt das Pendant meist in fehlenden Schreibrechten auf /usr/local/lib — hier hilft nvm statt sudo.

06 · Abschnitt

Weiterführende Ressourcen

Externe Quellen

/ Weiter

Zurück zu Grundlagen

Zur Übersicht