Claude Code Masterkurs – KI-gestuetztes Programmieren lernen mit Anthropics Coding-Agent

Installation & Setup

Level 1 | 20 Minuten

Claude Code auf macOS, Linux und Windows installieren

Lernziele

System Requirements

macOS Installation

Die Installation von Claude Code auf macOS ist in wenigen Minuten erledigt. Du brauchst nur zwei Voraussetzungen: Node.js in Version 18 oder höher und einen Terminal. Alles andere wird automatisch eingerichtet. Schritt 1 — Node.js installieren: Öffne deinen Terminal und prüfe ob Node.js installiert ist: 'node --version'. Wenn die Version 18 oder höher angezeigt wird, bist du bereit. Falls nicht, installiere Node.js über Homebrew ('brew install node') oder lade es direkt von nodejs.org herunter. Homebrew ist die empfohlene Methode für macOS — es hält Node.js automatisch aktuell. Schritt 2 — Claude Code installieren: Im Terminal eingeben: 'npm install -g @anthropic-ai/claude-code'. Das installiert Claude Code global auf deinem System. Der -g Flag bedeutet 'global' — du kannst Claude Code danach von jedem Verzeichnis aus aufrufen. Schritt 3 — Installation verifizieren: Tippe 'claude --version' in deinen Terminal. Wenn eine Versionsnummer angezeigt wird, war die Installation erfolgreich. Schritt 4 — Erster Start: Navigiere in ein Projektverzeichnis ('cd ~/mein-projekt') und starte Claude Code mit 'claude'. Beim ersten Start wirst du aufgefordert dich mit deinem Anthropic-Account zu authentifizieren — folge den Anweisungen im Terminal. Häufige Probleme und Lösungen: 'Permission denied' bei der Installation → Vermeide 'sudo npm install -g', nutze stattdessen einen Node Version Manager (nvm) der keine Root-Rechte braucht. 'command not found: claude' nach der Installation → Dein npm global bin Verzeichnis ist nicht im PATH. Führe 'npm config get prefix' aus und füge '/bin' zum PATH in deiner ~/.zshrc hinzu. Ein Tipp für fortgeschrittene Nutzer: Installiere nvm (Node Version Manager) um verschiedene Node.js Versionen parallel zu verwalten. Das ist besonders nützlich wenn verschiedene Projekte verschiedene Node-Versionen brauchen. Nach der Installation bist du bereit für den nächsten Schritt: Die Authentifizierung mit deinem API Key.

# Überprüfe Node.js Version
node --version  # Sollte >= v16.0.0 sein

# Installiere Claude Code global
npm install -g @anthropic-ai/claude-code

# Verifiziere Installation
claude --version

Option 2: Homebrew

# Homebrew tap hinzufügen
brew tap anthropics/claude

# Claude Code installieren
brew install claude-code

# Verifiziere Installation
claude --version

Linux Installation

# Node.js installieren (falls nicht vorhanden)
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

# Claude Code installieren
sudo npm install -g @anthropic-ai/claude-code

# Verifiziere Installation
claude --version
💡 Tipp für Linux Für bessere Performance, installiere auch build-essential: sudo apt-get install build-essential

Windows Installation

Die Installation von Claude Code auf Windows erfordert einen zusätzlichen Schritt: Das Windows Subsystem for Linux (WSL). Claude Code ist ein Linux/macOS-natives Tool und läuft auf Windows über WSL — eine von Microsoft entwickelte Kompatibilitätsschicht die eine vollwertige Linux-Umgebung direkt in Windows bereitstellt. Schritt 1 — WSL installieren: Öffne PowerShell als Administrator und führe 'wsl --install' aus. Das installiert WSL2 mit Ubuntu als Standard-Distribution. Nach der Installation musst du deinen Computer neu starten. Beim ersten Start von WSL wirst du aufgefordert einen Linux-Benutzernamen und ein Passwort zu erstellen. Schritt 2 — Node.js in WSL installieren: Öffne dein WSL Terminal (tippe 'wsl' in PowerShell oder starte Ubuntu aus dem Startmenü). Installiere Node.js über nvm (empfohlen): 'curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash'. Dann: 'nvm install --lts'. Verifiziere mit 'node --version'. Schritt 3 — Claude Code installieren: Im WSL Terminal: 'npm install -g @anthropic-ai/claude-code'. Verifiziere mit 'claude --version'. Schritt 4 — Projektverzeichnis einrichten: Deine Windows-Dateien sind in WSL unter /mnt/c/ erreichbar. Aber für die beste Performance solltest du deine Projekte im Linux-Dateisystem speichern (z.B. ~/projekte/). Dateizugriffe auf /mnt/c/ sind deutlich langsamer. Wichtig zu wissen: Claude Code läuft innerhalb der WSL-Umgebung. Das bedeutet alle Pfade und Befehle sind Linux-Pfade. Dein Editor (VS Code) kann mit der 'Remote - WSL' Extension nahtlos mit WSL-Projekten arbeiten — du merkst kaum einen Unterschied. Häufiges Problem: Wenn Claude Code nach dem Schließen des Terminals nicht mehr funktioniert, starte WSL mit 'wsl' in PowerShell. WSL muss aktiv laufen damit Claude Code funktioniert. Für Entwickler die Windows und Linux parallel nutzen: WSL2 bietet nahezu native Linux-Performance und ist die empfohlene Methode für die meisten Entwicklungstools die primär für Linux entwickelt werden.

# Node.js Version checken
node --version

# Claude Code installieren
npm install -g @anthropic-ai/claude-code

# Verifiziere Installation
claude --version

Option 2: Chocolatey

# Chocolatey Package Manager installieren (falls nicht vorhanden)
Set-ExecutionPolicy Bypass -Scope Process -Force
[System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072
iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))

# Claude Code installieren
choco install claude-code

# Verifiziere Installation
claude --version

API Key Setup

Der API Key ist dein Zugangsschlüssel zur Claude API — ohne ihn kann Claude Code nicht mit den KI-Modellen kommunizieren. Es gibt zwei Authentifizierungswege: Die interaktive Anmeldung über den Browser (empfohlen für den Einstieg) oder die direkte API-Key-Konfiguration (empfohlen für fortgeschrittene Nutzung und Automatisierung). Weg 1 — Interaktive Anmeldung: Starte Claude Code mit 'claude' in deinem Terminal. Beim ersten Start öffnet sich automatisch ein Browser-Fenster zur Authentifizierung. Melde dich mit deinem Anthropic-Account an und bestätige die Berechtigung. Claude Code speichert die Session-Daten automatisch. Dieser Weg ist am einfachsten und funktioniert sofort — ideal für den Einstieg. Weg 2 — API Key direkt setzen: Erstelle einen API Key auf console.anthropic.com unter 'API Keys'. Kopiere den Key (er beginnt mit 'sk-ant-'). Setze ihn als Umgebungsvariable: 'export ANTHROPIC_API_KEY=sk-ant-dein-key' in deinem Terminal. Für permanente Konfiguration füge die Zeile zu deiner ~/.zshrc (macOS) oder ~/.bashrc (Linux/WSL) hinzu. Sicherheitsregeln für den API Key: Teile deinen Key NIEMALS mit anderen. Committe ihn NIEMALS in ein Git Repository. Speichere ihn NICHT in Dateien die nicht in der .gitignore stehen. Nutze Umgebungsvariablen oder einen Secrets Manager. Rotiere den Key regelmäßig (monatlich empfohlen). Kosten verstehen: Der API Key ist mit deinem Anthropic-Account verbunden und die Nutzung wird pro Token abgerechnet. Für den Einstieg bietet Anthropic ein kostenloses Guthaben. Danach zahlst du nach Verbrauch — typischerweise 2-5 USD pro Tag bei aktiver Nutzung. Alternative: Claude Max Subscription: Statt Pay-per-Token kannst du auch die Claude Max Subscription nutzen. Diese bietet ein monatliches Token-Kontingent zu einem Festpreis — ideal wenn du vorhersagbare Kosten bevorzugst. Nach dem API Key Setup bist du bereit Claude Code produktiv zu nutzen. Teste die Verbindung mit 'claude' und stelle eine einfache Frage — wenn eine Antwort kommt, funktioniert alles.

API Key konfigurieren:

# Methode 1: Environment Variable (temporär)
export ANTHROPIC_API_KEY="sk-ant-..."

# Methode 2: In Shell-Profile (persistent)
# macOS/Linux (~/.zshrc oder ~/.bashrc)
echo 'export ANTHROPIC_API_KEY="sk-ant-..."' >> ~/.zshrc
source ~/.zshrc

# Windows (PowerShell Profile)
# Öffne: notepad $PROFILE
# Füge hinzu: $env:ANTHROPIC_API_KEY = "sk-ant-..."

# Methode 3: Claude Config (empfohlen)
claude config set api-key sk-ant-...

Installations-Verifizierung

# Zeige Version
claude --version
# Output: claude-code v1.2.3

# Zeige verfügbare Modelle
claude models
# Output:
# Available models:
#   - claude-opus-4-5-20251101
#   - claude-sonnet-4-5-20250929
#   - claude-haiku-4-5-20251001

# Test API Connection
claude status
# Output:
# ✓ API Key configured
# ✓ Connection successful
# ✓ All systems operational

Erstes Projekt erstellen

# Erstelle neues Verzeichnis
mkdir my-first-claude-project
cd my-first-claude-project

# Initialisiere Projekt
claude init

# Output:
# ✓ Created CLAUDE.md
# ✓ Created .claudeignore
# ✓ Project initialized successfully!
🎉 Herzlichen Glückwunsch! Du hast Claude Code erfolgreich installiert und dein erstes Projekt erstellt. In der nächsten Lektion lernst du, wie du mit Claude interagierst!

Troubleshooting