Claude Code ist Anthropics terminalbasierter KI-Coding-Agent. Er liest Ihre Codebasis, bearbeitet echte Dateien, führt Shell-Befehle aus und verwaltet git – alles über die Befehlszeile. Keine Browser-Tabs, kein Copy-Paste.
Diese Anleitung deckt alle Installationsmethoden (nativ, npm, Homebrew), Authentifizierung, Konfiguration und – entscheidend – was nach der Installation zu tun ist, um Claude Code von einem Coding-Assistenten in einen vollständigen multimodalen Agenten mit Bildgenerierung, Video, Websuche und Cloud-Speicher zu verwandeln.
Voraussetzungen
Stellen Sie vor der Installation sicher, dass Sie Folgendes haben:
- Betriebssystem: macOS 13+ (Ventura), Ubuntu 20.04+ / Debian 10+ oder Windows 10 (1809+) mit WSL
- RAM: Mindestens 4 GB, 8 GB empfohlen für größere Codebasen
- Internetverbindung: Die gesamte KI-Verarbeitung läuft auf der Cloud-Infrastruktur von Anthropic – ohne Verbindung kein Claude Code
- Anthropic-Konto: Claude Pro (20 $/Monat), Max (100–200 $/Monat), Teams, Enterprise oder Console (API)-Konto. Der kostenlose Claude.ai-Plan enthält Claude Code nicht. Einen Vergleich der Tarife finden Sie in unserem Claude Code Preisvergleich.
- Terminal: Bash, Zsh oder PowerShell
- Node.js 18+: Nur für die npm-Installationsmethode erforderlich
Keine GPU erforderlich. Ihr Rechner führt einen schlanken CLI-Client aus; alle KI-Berechnungen finden serverseitig statt.
Schritt 1: Node.js installieren (nur npm-Methode)
Wenn Sie den nativen Installer verwenden möchten – was nun Anthropics empfohlener Weg ist – können Sie diesen Schritt vollständig überspringen. Der native Installer hat null Abhängigkeiten.
Für npm-Nutzer: Prüfen Sie Ihre Node-Version:
node --version
Zeigt die Ausgabe v18.0.0 oder höher, fahren Sie mit Schritt 2 fort. Andernfalls installieren Sie über nvm (Node Version Manager), um Berechtigungsprobleme zu vermeiden:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
Schließen Sie das Terminal und öffnen Sie es erneut, dann:
nvm install 22
nvm use 22
node --version # Should show v22.x.x
Node.js 22 ist das aktuelle LTS-Release und funktioniert problemlos mit Claude Code.
Schritt 2: Claude Code installieren
Drei Installationsmethoden stehen zur Auswahl. Wählen Sie eine.
Option A: Nativer Installer (Empfohlen)
Null Abhängigkeiten. Automatische Updates im Hintergrund. Das ist, was Anthropic primär testet und unterstützt.
macOS und Linux:
curl -fsSL https://claude.ai/install.sh | bash
Windows (PowerShell, als Administrator ausführen):
irm https://claude.ai/install.ps1 | iex
Der Installer legt das claude-Binary in Ihrem PATH ab und konfiguriert automatische Updates. Unter einer Minute, von Anfang bis Ende.
Option B: Homebrew (macOS / Linux)
brew install --cask claude-code
Ein Vorbehalt: Homebrew-Installationen aktualisieren sich nicht automatisch. Führen Sie brew upgrade claude-code regelmäßig aus.
Option C: npm
npm install -g @anthropic-ai/claude-code
Verwenden Sie kein sudo. Bei EACCES-Berechtigungsfehlern ist die Lösung nvm – nicht npm als Root ausführen. Root-eigene npm-Verzeichnisse verursachen Kaskaden-Berechtigungsprobleme.
Überprüfung
Bestätigen Sie, dass die Installation funktioniert hat:
claude --version
Für eine vollständige Umgebungsdiagnose:
claude doctor
Schritt 3: Authentifizieren
claude
Beim ersten Start öffnet Claude Code Ihren Browser für die OAuth-Authentifizierung. Melden Sie sich bei Ihrem Anthropic-Konto an, autorisieren Sie die CLI, und Sie sind verbunden.
Authentifizierungsoptionen
Browser-OAuth (Standard): Ideal für persönliche Rechner. Funktioniert mit Pro-, Max-, Teams- und Enterprise-Konten. Nach der Autorisierung wird ein Sitzungstoken lokal gespeichert.
API-Schlüssel (CI/CD und headless): Für Server, Container oder Pipelines, wo kein Browser verfügbar ist:
export ANTHROPIC_API_KEY=sk-ant-your-key-here
claude
Generieren Sie Ihren Schlüssel unter console.anthropic.com. Die API-Nutzung wird pro Token nach Anthropics Standardtarifen abgerechnet. Eine vollständige Übersicht zu Abonnement- vs. API-Abrechnung finden Sie in unserem Claude Code Preisleitfaden.
Welches Abrechnungsmodell? Abonnements (Pro/Max) sind einfacher für den täglichen Gebrauch und enthalten Claude Code in Ihrem Monatsplan. API-Abrechnung gibt Ihnen granulare Kontrolle für variable oder automatisierte Workloads.
Schritt 4: Ihre erste Claude Code-Sitzung
Navigieren Sie zu einem beliebigen Projektverzeichnis:
cd ~/my-project
claude
Claude Code liest Ihre Projektstruktur und startet eine interaktive REPL. Beginnen Sie mit etwas Risikoarmem:
> Explain the architecture of this project
Es scannt Ihre Dateien, identifiziert den Stack und gibt Ihnen eine strukturelle Zusammenfassung. Dann probieren Sie etwas mit echten Konsequenzen:
> Add input validation to the user registration form
Claude Code identifiziert die relevanten Dateien, schlägt Änderungen vor und wartet auf Ihre Bestätigung. Sie prüfen jede Änderung in einer Diff-Ansicht, bevor Sie sie akzeptieren – Dateien werden nicht blindlings überschrieben.
Für einmalige Aufgaben ohne Eingabe des interaktiven Modus verwenden Sie das -p-Flag (print):
claude -p "Write unit tests for the auth module"
Führt die Aufgabe aus, gibt das Ergebnis aus und beendet sich. Ideal für Scripting und CI/CD-Pipelines.
Schritt 5: Claude Code konfigurieren
Modellauswahl
Claude Code verwendet standardmäßig das neueste verfügbare Modell. Überschreiben Sie es:
# Standardmodell festlegen
claude config set model claude-opus-4-7
# Oder für eine einzelne Sitzung
claude --model claude-sonnet-4-6
Berechtigungen
Claude Code fragt vor dem Schreiben von Dateien oder Ausführen von Befehlen nach Bestätigung. Wenn Sie ihm bei einem bestimmten Projekt vertrauen:
claude config set permissions.auto-accept-edits true
Nützlich für Geschwindigkeit. Weniger nützlich bei der Arbeit an Produktionscode. Für einen tiefen Einblick in alle Berechtigungsmodi, Unteragenten und Hooks lesen Sie unseren Leitfaden zu erweiterten Claude Code-Funktionen.
Projektweite Einstellungen
Erstellen Sie .claude/settings.json in Ihrem Projektstamm für teamweite Konfiguration (diese Datei committen):
{
"permissions": {
"allow": ["read", "write", "shell"],
"deny": ["shell:rm -rf *"]
},
"model": "claude-sonnet-4-6",
"environment": {
"NODE_ENV": "development"
}
}
Für persönliche Overrides, die nicht committet werden sollen, verwenden Sie .claude/settings.local.json.
CLAUDE.md
Die wirkungsvollste Konfiguration. Erstellen Sie eine CLAUDE.md-Datei in Ihrem Projektstamm, um Claude dauerhaften Kontext zu geben: Build-Befehle, Code-Konventionen, Architekturentscheidungen. Führen Sie /init in Claude Code aus, um eine automatisch zu generieren, und passen Sie sie dann an.
Eine gute CLAUDE.md ist prägnant – streben Sie 50–100 Zeilen an. Fragen Sie sich bei jeder Zeile: „Würde das Entfernen dazu führen, dass Claude einen Fehler macht?" Wenn nicht, streichen Sie es.
Plattformspezifische Anweisungen
macOS
Sowohl Apple Silicon (M1–M4) als auch Intel-Macs werden unterstützt. Der native Installer ist der sauberste Weg:
curl -fsSL https://claude.ai/install.sh | bash
Linux
Funktioniert auf Ubuntu 20.04+, Debian 10+ und den meisten modernen Distributionen. Gleicher nativer Installer wie macOS. Auf älteren Distributionen: npm mit nvm verwenden.
Windows
Option 1: Nativer PowerShell-Installer
irm https://claude.ai/install.ps1 | iex
Option 2: WSL (für volle Linux-Kompatibilität empfohlen)
wsl --install
# Neustart, dann im WSL-Terminal:
curl -fsSL https://claude.ai/install.sh | bash
Docker
FROM node:22-alpine
RUN npm install -g @anthropic-ai/claude-code
Übergeben Sie den API-Schlüssel zur Laufzeit als Umgebungsvariable – backen Sie ihn nicht in das Image.
CI/CD (GitHub Actions Beispiel)
- name: AI Code Review
run: |
npx @anthropic-ai/claude-code -p "Review this PR for bugs" --output-format json
env:
ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
IDE-Integration
Claude Code ist terminal-first, aber IDE-Plugins bieten native Diff-Ansicht.
VS Code: Installieren Sie „Claude Code" aus dem Extensions-Panel oder:
code --install-extension anthropic.claude-code
JetBrains: Einstellungen → Plugins → Marketplace → „Claude Code" suchen → Installieren. Änderungen erscheinen im nativen Diff-Viewer der IDE.
Über die Installation hinaus: Claude Code Agentenfähigkeiten verleihen
Hier hören die meisten Setup-Anleitungen auf. Claude Code ist installiert, authentifiziert, läuft – aber auf das beschränkt, was der Basis-CLI bietet: Dateibearbeitung, Shell-Befehle, Git-Operationen.
Was Claude Code von Haus aus nicht kann:
- Bilder generieren oder Fotos bearbeiten
- Videos erstellen oder analysieren
- Das Live-Web durchsuchen
- Dateien in Cloud-Speicher speichern und abrufen
- Inhalte im Web veröffentlichen
Diese Fähigkeiten erfordern MCP-Server (Model Context Protocol). MCP ist der offene Standard, der es KI-Agenten ermöglicht, sich mit externen Tools zu verbinden. Claude Code unterstützt MCP nativ – Sie konfigurieren Server, und Claude kann sie direkt aufrufen. Den vollständigen Überblick finden Sie in unserem Leitfaden zum Hinzufügen von Fähigkeiten zu Claude Code mit MCP.
Der schnelle Weg: AnyCap Agent CLI
Statt einzelne MCP-Server nacheinander zu konfigurieren, können Sie Claude Code mit einer einzigen CLI eine vollständige Suite von Agentenfähigkeiten geben:
npx -y skills add anycap-ai/anycap -a claude-code
Dies installiert AnyCaps Agent-Capability-Runtime und gibt Claude Code Zugang zu:
| Fähigkeit | Was es tut | Beispiel |
|---|---|---|
| Bildgenerierung | Bilder aus Textprompts erstellen und bearbeiten | „Erstelle ein Hero-Bild für die Landingpage" |
| Videogenerierung | Videos aus Text oder Bildern produzieren | „Erstelle einen Produkt-Demo-Walkthrough" |
| Websuche | Das Live-Internet durchsuchen und crawlen | „Recherchiere die neuesten API-Änderungen" |
| Cloud-Speicher | Dateien hochladen, teilen und abrufen | „Projektressourcen speichern und Share-Links generieren" |
| Web-Veröffentlichung | Inhalte im Web bereitstellen | „Das Changelog als Webseite veröffentlichen" |
Eine CLI. Ein Authentifizierungsfluss. Alle Fähigkeiten. Sie müssen keine separaten API-Schlüssel für Bildgenerierung, Video, Suche und Speicher verwalten – AnyCap erledigt das alles über eine einzige Installation. Für einen detaillierten Blick auf die MCP-Integration, einschließlich manueller Serverkonfigurationsoptionen, lesen Sie unseren MCP-Fähigkeitenleitfaden.
Manuelle MCP-Konfiguration
Wenn Sie MCP-Server lieber einzeln konfigurieren möchten, fügen Sie sie zu .mcp.json in Ihrem Projektstamm hinzu:
{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"]
},
"postgres": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-postgres"]
}
}
}
Oder fügen Sie sie interaktiv hinzu:
claude mcp add github -- npx -y @modelcontextprotocol/server-github
claude mcp list
claude mcp get github
Fehlerbehebung
| Problem | Lösung |
|---|---|
| „command not found: claude" | Neues Terminal-Fenster öffnen. Wenn das nicht hilft, Installer erneut ausführen oder PATH prüfen. |
| Node.js zu alt | nvm install 22 && nvm use 22 |
| npm EACCES-Fehler | Niemals sudo verwenden. Stattdessen nvm nutzen. |
| Browser öffnet sich nicht für Authentifizierung | API-Schlüssel verwenden: export ANTHROPIC_API_KEY=sk-ant-... |
| Netzwerkfehler während der Installation | Proxy-Einstellungen prüfen. npm-Registry setzen: npm config set registry https://registry.npmjs.org/ |
| Claude Code läuft langsam | Netzwerklatenz zur Anthropic-API. status.anthropic.com prüfen. VPN trennen, falls aktiv. |
Führen Sie claude doctor aus, bevor Sie Zeit für manuelles Debugging aufwenden – es erkennt die meisten Konfigurationsprobleme automatisch.
Claude Code aktuell halten
Nativer Installer: Updates erfolgen automatisch. Keine Aktion erforderlich. Version prüfen mit claude --version.
npm: npm update -g @anthropic-ai/claude-code
Homebrew: brew upgrade claude-code
Nächste Schritte
Claude Code ist installiert. So geht es weiter:
- CLAUDE.md generieren — Führen Sie
/initin Claude Code aus, um dauerhaften Projektkontext zu hinterlegen. - Agentenfähigkeiten hinzufügen — Installieren Sie AnyCap, um Claude Code Bildgenerierung, Video, Suche und Speicher zu geben. Lesen Sie unseren MCP-Fähigkeitenleitfaden.
- Eine echte Aufgabe ausprobieren — Wählen Sie etwas, wofür Sie normalerweise 20 Minuten brauchen, und schauen Sie, wie Claude damit umgeht.
Verwandte Artikel
- Claude Code vs. Cursor: Welcher KI-Coding-Agent gewinnt 2026? — Terminalnativer Agent vs. IDE-Fork. Vergleich von Autonomie, Kontextverarbeitung, Preisgestaltung, echten Aufgaben und wann man welchen einsetzt.
- Erweiterte Claude Code-Funktionen: Unteragenten, Auto-Approve & Bash-Modus — Unteragenten für Parallelverarbeitung, Auto-Approve für schnellere Workflows und Bash-Ausführung für vollständigen Shell-Zugriff meistern.
- So fügen Sie Claude Code mit MCP Agentenfähigkeiten hinzu — Schritt-für-Schritt-MCP-Konfigurationsleitfaden plus AnyCaps Ein-Befehl-Schnellpfad für Bildgenerierung, Video, Websuche und Cloud-Speicher.
- Claude Code Preise & Pläne im Vergleich — Vollständige Aufschlüsselung von Pro (20 $/Monat), Max (100–200 $/Monat), Teams, Enterprise und API-Abrechnung.
- Claude Code Rate-Limits & Token-Limits erklärt — Praktische Strategien, um produktiv zu bleiben und Rate-Limits sowie Sitzungsobergrenzen zu vermeiden.
Claude Code ist der schnellste Weg, KI in Ihren Entwicklungs-Workflow zu integrieren, ohne Tools zu wechseln. Einmal eingerichtet, ist der Unterschied sofort spürbar.