Handwerkszeug

Terminal-Basics — sicher auf der Kommandozeile

Das Fundament unter allen KI-Agenten: genau so viel Terminal, dass du Tools installierst, startest und dich nie verläufst — für Linux, macOS & Windows, umschaltbar oben.

Worum geht's?

Claude Code, Codex, opencode, Hermes, OpenClaw — sie alle starten im Terminal. Wer sich dort wohlfühlt, installiert und bedient jeden Agenten souverän. Dieser kleine Kurs gibt dir die Grundlagen — und über den Plattform-Schalter oben siehst du jeden Befehl genau für dein System.

Linux und macOS sind sich sehr ähnlich (Unix); Windows nutzt PowerShell mit eigenen Befehlen. Der Schalter merkt sich deine Wahl.

⌨ Ein erster Blick

Ein Befehl, eine Ausgabe — so einfach fängt es an (funktioniert auf allen drei Systemen):

Terminal

🗺️ Die 6 Stufen

Gehört zum Handwerkszeug — wie Git. Beide liegen unter allen Agenten-Schulungen.

Stufe 1

Was ist das Terminal?

Ein Textfenster, in dem du dem Rechner Befehle tippst — schneller und automatisierbarer als Klicken.

1 Terminal, Shell, Prompt

Drei Wörter, eine Sache:

Terminal — das Fenster.
Shell — das Programm darin, das deine Befehle versteht (bash, zsh oder PowerShell).
Prompt — das Zeichen, das auf deine Eingabe wartet (z. B. $ oder >).

2 Welche Shell hast du?

Stell oben deine Plattform ein — der ganze Kurs passt sich an.

Linux: meist bash. Unix-Befehle wie ls, pwd, cp. Prompt endet oft auf $.

macOS: standardmäßig zsh — fast identisch zu Linux/bash. Gleiche Befehle (ls, pwd …), kleine Extras wie open . und brew.

Windows: PowerShell mit eigenen Befehlen (sog. Cmdlets, z. B. Get-ChildItem). Viele Unix-Namen gibt es als Alias (ls, cd). Prompt endet auf >.

WSL: Du willst lieber Linux unter Windows? Mit WSL (Windows-Subsystem für Linux) bekommst du ein echtes Ubuntu-Terminal — dann gilt der Linux-Tab.

3 Das Terminal in deiner IDE

Du brauchst kein Extra-Programm: VS Code, Cursor & Antigravity haben ein integriertes Terminal.

Öffnen: Strg/Cmd + ö bzw. Menü View → Terminal. Es startet automatisch im geöffneten Projektordner.

✓ Geschafft, wenn du …

… Terminal, Shell und Prompt unterscheiden kannst.

… weißt, welche Shell auf deinem System läuft.

… das Terminal in deiner IDE öffnen kannst.

Stufe 2

Navigieren

Wo bin ich — und wie komme ich dahin, wo mein Projekt liegt?

1 Die drei wichtigsten Befehle

„Wo bin ich?", „was liegt hier?", „geh dorthin." Mehr brauchst du fürs Navigieren kaum.

Terminal

$ pwd /home/max/projekte $ ls -la nordwerk-website daten.csv notizen.txt $ cd nordwerk-website

% pwd /Users/max/projekte % ls -la nordwerk-website daten.csv notizen.txt % cd nordwerk-website

> Get-Location C:\Users\max\projekte > Get-ChildItem nordwerk-website daten.csv notizen.txt > cd nordwerk-website

„Wo bin ich?" = · „Was liegt hier?" = · „Geh dorthin" = .

2 Pfade verstehen

. = aktueller Ordner, .. = eine Ebene höher ().
= dein Home-Ordner.
Absolut (von ganz oben) vs. relativ (vom aktuellen Ort): vs. nordwerk-website/img.

Tab-Vervollständigung: Tipp die ersten Buchstaben und drücke Tab — die Shell vervollständigt Namen. Spart Tippen und vermeidet Tippfehler. Auf allen drei Systemen.

✓ Geschafft, wenn du …

… deinen aktuellen Ordner anzeigen und den Inhalt auflisten kannst.

… mit cd in einen Ordner und mit cd .. zurück wechselst.

… ., .. und ~ erklären kannst und Tab nutzt.

Stufe 3

Dateien & Ordner

Anlegen, ansehen, kopieren, verschieben, löschen — die tägliche Datei-Arbeit.

1 Anlegen & ansehen

Terminal

$ mkdir berichte $ touch berichte/mai.txt $ cat berichte/mai.txt

% mkdir berichte % touch berichte/mai.txt % cat berichte/mai.txt

> mkdir berichte > New-Item berichte\mai.txt > Get-Content berichte\mai.txt

Ordner anlegen = · Datei anlegen = · Inhalt zeigen = .

2 Kopieren, verschieben, löschen

Gleiche Idee, je nach Shell anderer Befehl:

Kopieren =
Verschieben/Umbenennen =
Löschen = · Ordner =

Achtung beim Löschen: Im Terminal gibt es keinen Papierkorb — gelöscht ist gelöscht. Erst den Befehl lesen, dann Enter. Besonders bei rm -r / Remove-Item -Recurse.

✓ Geschafft, wenn du …

… Ordner & Dateien anlegen und Inhalte anzeigen kannst.

… kopieren, verschieben und löschen kannst.

… weißt, warum Löschen im Terminal endgültig ist.

Stufe 4

Befehle, Flags & Pakete

Wie ein Befehl aufgebaut ist — und wie du neue Programme installierst.

1 Anatomie eines Befehls

Fast jeder Befehl folgt demselben Muster:

npminstall-g@anthropic-ai/claude-code

● Befehl (Programm)● Unterbefehl● Option/Flag● Argument

Im Zweifel: <befehl> --help zeigt, was geht; <befehl> --version zeigt die Version. (Funktioniert bei fast allen CLI-Tools, plattformübergreifend.)

2 Pakete installieren (Node & npm)

Die Agenten werden meist per npm installiert — das ist auf allen Systemen identisch.

Terminal — npm (überall gleich)

› node --version v24.x › npm install -g @anthropic-ai/claude-code added 1 package ✓

Node selbst installierst du je nach System unterschiedlich: .

npm hakt? Es gibt Alternativen. npm i -g macht manchmal Ärger (Rechte, PATH, falsche Node-Version). Dann:

Nur testen? npx <paket> — einmal ausführen, ohne global zu installieren.
Andere Manager (gleiche Registry, oft robuster): pnpm add -g … · bun add -g … · Yarn.
OS-Paketmanager: .
Ohne npm: das offizielle Install-Skript des Tools (curl … | bash bzw. Windows irm … | iex) — lädt ein fertiges Binary.
Python-Tools isoliert: pipx install ….
Ursache der meisten npm-Probleme beheben: Node über einen Versionsmanager installieren (fnm, nvm, Volta) — kein sudo, sauberer PATH.

3 „command not found"?

Heißt: die Shell findet das Programm nicht im PATH (Liste der Such-Ordner). Meist hilft: Terminal neu öffnen (nach Installation), Tippfehler prüfen, oder ob das Tool wirklich installiert ist. PATH ansehen: .

✓ Geschafft, wenn du …

… Befehl, Flag und Argument auseinanderhalten kannst.

… --help/--version und npm install -g nutzt.

… weißt, was „command not found" bedeutet (PATH).

Stufe 5 · Brücke

Einen Agenten starten

Jetzt zahlt sich alles aus: in den Projektordner, installieren, starten, lospromten.

1 Der typische Ablauf

Terminal

In deiner IDE den Projektordner öffnen (das Terminal startet dort).
Tool einmalig installieren (z. B. npm install -g @anthropic-ai/claude-code).
Mit dem Befehl starten (claude, codex, opencode …) und lospromten.

Mehr dazu in den Agenten-Schulungen: Claude Code · Codex · opencode — oder die persönlichen Agenten Hermes · OpenClaw.

2 Drei Lebensretter

⛔

Abbrechen

Strg/Ctrl + C stoppt einen laufenden Befehl.

⬆️

Verlauf

Pfeil ↑ holt vorherige Befehle zurück — kein Neutippen.

🧹

Aufräumen

Bildschirm leeren: .

✓ Geschafft, wenn du …

… den Ablauf „Ordner → installieren → starten" beherrschst.

… einen Befehl mit Strg/Ctrl + C abbrechen kannst.

… den Verlauf (↑) und clear nutzt.

Stufe 6

Sicher & souverän

Das Terminal ist mächtig — ein paar Gewohnheiten halten dich auf der sicheren Seite.

1 Erst lesen, dann Enter

Gefährliche Befehle: rm -rf … bzw. Remove-Item -Recurse -Force … löschen unwiderruflich ganze Bäume. Lies genau, was hinter dem Befehl steht, bevor du bestätigst.

2 Befehle aus dem Internet

Installations-Einzeiler wie curl … | bash führen fremden Code aus. Nutze sie nur von vertrauenswürdigen Quellen (offizielle Doku) — und schau dir das Skript im Zweifel vorher an.

3 Rechte & Secrets

Erhöhte Rechte () nur, wenn wirklich nötig.
Keine Passwörter/Tokens direkt in Befehle tippen — sie landen im Verlauf. Lieber über Umgebungsvariablen/Dateien.

4 Hilfe finden

<befehl> --help · · und natürlich: frag einen KI-Agenten („Was macht dieser Befehl?"). Sicherheit fürs Bauen mit KI vertieft die Git-Schulung.

✓ Geschafft, wenn du …

… gefährliche Befehle erkennst und vor Enter prüfst.

… curl | bash & erhöhte Rechte bewusst einsetzt.

… weißt, wie du Hilfe zu einem Befehl bekommst.

Bonus

Cheat-Sheet

Befehls-Übersetzung bash/zsh ⟷ PowerShell — zum Vergleichen & Ausdrucken.

Aufgabe	Linux / macOS (bash/zsh)	Windows (PowerShell)
Aktueller Ordner	`pwd`	`Get-Location` (`pwd`)
Inhalt auflisten	`ls -la`	`Get-ChildItem` (`ls`)
Ordner wechseln	`cd ordner`	`cd ordner`
Ordner anlegen	`mkdir name`	`mkdir name`
Datei anlegen	`touch datei`	`New-Item datei`
Datei anzeigen	`cat datei`	`Get-Content datei` (`cat`)
Kopieren	`cp a b`	`Copy-Item a b` (`cp`)
Verschieben	`mv a b`	`Move-Item a b` (`mv`)
Löschen	`rm datei` · `rm -r ordner`	`Remove-Item datei` · `-Recurse`
Bildschirm leeren	`clear`	`Clear-Host` (`cls`)
PATH ansehen	`echo $PATH`	`$env:PATH`
Hilfe	`man befehl` · `--help`	`Get-Help befehl` · `--help`
Abbrechen	`Strg/Ctrl + C` — überall gleich
Paket installieren	`npm install -g <paket>` — überall gleich

Lernkontrolle

Quiz

8 Fragen quer durch die Stufen. Ab 6 richtigen Antworten schaltest du dein Zertifikat frei.

Frage 1 von 8

…

Abschluss

Dein Zertifikat

Glückwunsch! Trage deinen Namen ein und drucke das Zertifikat (oder speichere als PDF).

Dein Name (erscheint auf dem Zertifikat):

FL

Florian Ludwig

AI Consultant · Kutzschbach INNOVATIONS

Zertifikat

Terminal-Basics

Hiermit wird bestätigt, dass

Dein Name hier

den Workshop „Terminal-Basics — sicher auf der Kommandozeile" erfolgreich abgeschlossen hat.

—Datum

★GEPRÜFT

Florian LudwigAI Consultant · Kutzschbach INNOVATIONS