Claude Code CLI: Die definitive technische Referenz
Aktualisiert am 12. Dezember 2025
Dezember 2025 Update: Claude Code unterstützt jetzt Enterprise-Engineering-Workflows mit agentischer Multi-Datei-Bearbeitung, MCP-Protokoll-Integration mit über 300 externen Diensten, spezialisierten Subagents für komplexe Aufgaben und einem Hooks-System für CI/CD-Automatisierung. Das Berechtigungssystem ermöglicht fein abgestufte Sicherheitskontrollen. Modellwechsel zwischen Haiku (schnell/günstig) und Opus (leistungsstark) optimiert Kosten-Leistungs-Verhältnisse.
Ich habe Monate damit verbracht, Claude Code in Produktions-Codebasen, CI/CD-Pipelines und Enterprise-Deployments an seine Grenzen zu bringen. Dieser Leitfaden destilliert diese Erfahrung in die umfassende Referenz, die ich mir zu Beginn gewünscht hätte. Er behandelt alles von der ersten Installation bis zu fortgeschrittenen Patterns, die die meisten Benutzer nie entdecken.
Claude Code ist keine Chat-Oberfläche, die zufällig etwas über Programmierung weiß. Es ist ein agentisches System, das Ihre Codebasis liest, Befehle ausführt, Dateien modifiziert, Git-Workflows verwaltet, sich mit externen Diensten verbindet und komplexe Aufgaben an spezialisierte Subagents delegiert – alles über eine Kommandozeilen-Schnittstelle, die sich in die tatsächliche Arbeitsweise von Entwicklern integriert.
Der Unterschied zwischen der gelegentlichen und der effektiven Nutzung von Claude Code liegt im Verständnis seiner Architektur: die Konfigurationshierarchie, die das Verhalten steuert, das Berechtigungssystem, das Operationen kontrolliert, das Hook-System, das deterministische Automatisierung ermöglicht, das MCP-Protokoll, das Fähigkeiten erweitert, und das Subagent-System, das komplexe mehrstufige Aufgaben bewältigt. Beherrschen Sie diese Systeme und Claude Code wird zum Kraftmultiplikator. Verpassen Sie sie und Sie lassen den größten Teil des Wertes ungenutzt.
Dieser Leitfaden setzt voraus, dass Sie mit Kommandozeilen-Tools vertraut sind und das vollständige Bild möchten. Jede Funktion ist mit tatsächlicher Syntax, echten Konfigurationsbeispielen und den Randfällen dokumentiert, die erfahrene Benutzer stolpern lassen. Ob Sie Ihr erstes Projekt einrichten oder über eine Enterprise-Engineering-Organisation deployen – die Informationen sind hier.
Wie Claude Code funktioniert: Das mentale Modell
Bevor Sie in die Funktionen eintauchen, verstehen Sie, wie die Architektur von Claude Code alles prägt, was Sie damit tun. Das System arbeitet in drei Schichten:
┌─────────────────────────────────────────────────────────┐
│ CLAUDE CODE SCHICHTEN │
├─────────────────────────────────────────────────────────┤
│ ERWEITERUNGSSCHICHT │
│ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │
│ │ MCP │ │ Hooks │ │ Skills │ │ Plugins │ │
│ └─────────┘ └─────────┘ └─────────┘ └─────────┘ │
│ Externe Tools, deterministische Automatisierung, │
│ Domänenexpertise, paketierte Erweiterungen │
├─────────────────────────────────────────────────────────┤
│ DELEGATIONSSCHICHT │
│ ┌─────────────────────────────────────────────────┐ │
│ │ Subagents (bis zu 10 parallel) │ │
│ │ Explore | Plan | General-purpose | Custom │ │
│ └─────────────────────────────────────────────────┘ │
│ Isolierte Kontexte für fokussierte Arbeit, │
│ gibt Zusammenfassungen zurück │
├─────────────────────────────────────────────────────────┤
│ KERNSCHICHT │
│ ┌─────────────────────────────────────────────────┐ │
│ │ Hauptkonversationskontext │ │
│ │ Tools: Read, Edit, Bash, Glob, Grep, etc. │ │
│ └─────────────────────────────────────────────────┘ │
│ Ihre primäre Interaktion; begrenzter Kontext; │
│ kostet Geld │
└─────────────────────────────────────────────────────────┘
Kernschicht: Ihre Hauptkonversation. Jede Nachricht, jedes Dateilesen und jede Tool-Ausgabe verbraucht Kontext aus einem gemeinsamen 200K-Token-Fenster (1M mit Premium). Wenn der Kontext voll ist, verliert Claude frühere Entscheidungen aus den Augen und die Qualität sinkt. Diese Schicht kostet Geld pro Token.
Delegationsschicht: Subagents starten mit sauberen Kontexten, erledigen fokussierte Arbeit und geben Zusammenfassungen zurück. Die Explorationsergebnisse blähen Ihre Hauptkonversation nicht auf – nur die Schlussfolgerungen kehren zurück. Verwenden Sie Haiku-Subagents für Exploration (günstig, schnell) und Sonnet für die Implementierung.
Erweiterungsschicht: MCP verbindet externe Dienste (Datenbanken, GitHub, Sentry). Hooks garantieren die Ausführung von Shell-Befehlen unabhängig vom Modellverhalten. Skills kodieren Domänenexpertise, die Claude automatisch anwendet. Plugins paketieren all dies zur Verteilung.
Die wichtigste Erkenntnis: Die meisten Benutzer arbeiten ausschließlich in der Kernschicht und beobachten, wie der Kontext aufbläht und die Kosten steigen. Power-User verlagern Exploration und spezialisierte Arbeit in die Delegationsschicht, halten die Erweiterungsschicht für ihren Workflow konfiguriert und verwenden die Kernschicht nur für Orchestrierung und finale Entscheidungen.
Inhaltsverzeichnis
- Installation und Authentifizierung
- Kern-Interaktionsmodi
- Konfigurationssystem im Detail
- Modellauswahl und -wechsel
- Berechtigungssystem und Sicherheit
- Hooks-System
- MCP (Model Context Protocol)
- Subagents und Aufgabendelegation
- Extended Thinking Modus
- Ausgabestile
- Slash-Befehle
- Skills
- Plugin-System
- Speicher und Kontextmanagement
- Bild- und Multimodale Eingabe
- Git-Integration und Workflows
- IDE-Integration
- Fortgeschrittene Nutzungsmuster
- Claude Code Remote
- Background Agents
- Kostenmanagement und Abrechnung
- Leistungsoptimierung
- Fehlerbehebung und Debugging
- Enterprise-Deployment
- Tastenkürzel-Referenz
- Best Practices
Installation und Authentifizierung
Systemanforderungen
Claude Code läuft auf macOS 10.15+, Ubuntu 20.04+/Debian 10+ und Windows 10+ über WSL oder Git Bash. Das System erfordert mindestens 4 GB RAM und eine aktive Internetverbindung. Shell-Kompatibilität funktioniert am besten mit Bash, Zsh oder Fish.
Für Windows funktionieren sowohl WSL 1 als auch WSL 2. Git Bash funktioniert ebenfalls, wenn Sie natives Windows bevorzugen. Alpine Linux und andere musl-basierte Systeme erfordern zusätzliche Pakete:
apk add libgcc libstdc++ ripgrep
export USE_BUILTIN_RIPGREP=0
Installationsmethoden
Native Installation (empfohlen)
Die native Binary bietet die sauberste Erfahrung ohne Node.js-Abhängigkeit:
# macOS und Linux
curl -fsSL https://claude.ai/install.sh | bash
# Homebrew-Alternative
brew install --cask claude-code
# Windows PowerShell
irm https://claude.ai/install.ps1 | iex
# Windows CMD
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
Für versionsspezifische Installation:
# Spezifische Version installieren
curl -fsSL https://claude.ai/install.sh | bash -s 1.0.58
# Neueste Version explizit installieren
curl -fsSL https://claude.ai/install.sh | bash -s latest
# Windows PowerShell - spezifische Version
& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 1.0.58
NPM-Installation
Für Umgebungen, in denen npm bevorzugt wird:
npm install -g @anthropic-ai/claude-code
Verwenden Sie niemals sudo bei der npm-Installation – es erzeugt Berechtigungsprobleme, die alles Nachfolgende verkomplizieren.
Migration von bestehender Installation
Wenn Sie eine ältere npm-basierte Installation haben, migrieren Sie zur nativen Binary:
claude install
Authentifizierungsoptionen
Claude Code unterstützt drei Authentifizierungspfade, jeweils mit unterschiedlichen Kompromissen:
Claude Console (API-Abrechnung)
Verbinden Sie sich direkt über console.anthropic.com mit der Anthropic-API. Erstellen Sie ein Konto, richten Sie die Abrechnung ein und authentifizieren Sie sich über die CLI. Dies bietet nutzungsbasierte Abrechnung mit vollem API-Zugang. Ein dedizierter "Claude Code"-Workspace wird automatisch erstellt – Sie können keine API-Schlüssel für diesen Workspace erstellen, aber Sie können die Nutzung überwachen.
Claude Pro- oder Max-Abonnement
Verwenden Sie Ihre claude.ai-Kontoanmeldedaten. Das Abonnement deckt sowohl die Web-Oberfläche als auch die CLI-Nutzung unter einem einzigen monatlichen Plan ab. Dies vereinfacht die Abrechnung für einzelne Benutzer, die vorhersehbare Kosten wünschen.
Enterprise-Plattformen
AWS Bedrock, Google Vertex AI und Microsoft Foundry bieten jeweils Enterprise-Grade-Zugang mit bestehenden Cloud-Abrechnungsbeziehungen:
# AWS Bedrock
export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION=us-east-1
export AWS_PROFILE=your-profile
# Google Vertex AI
export CLAUDE_CODE_USE_VERTEX=1
export CLOUD_ML_REGION=us-east5
export ANTHROPIC_VERTEX_PROJECT_ID=your-project
# Microsoft Foundry
export CLAUDE_CODE_USE_FOUNDRY=1
export ANTHROPIC_FOUNDRY_RESOURCE=your-resource-name
# Optional: API-Schlüssel-Auth (sonst wird Entra ID verwendet)
export ANTHROPIC_FOUNDRY_API_KEY=your-key
Für Enterprise-Deployments hinter Proxys oder über LLM-Gateways:
# Unternehmens-Proxy
export HTTPS_PROXY='https://proxy.example.com:8080'
# LLM-Gateway (native Auth überspringen)
export CLAUDE_CODE_USE_BEDROCK=1
export ANTHROPIC_BEDROCK_BASE_URL='https://your-gateway.com/bedrock'
export CLAUDE_CODE_SKIP_BEDROCK_AUTH=1
Verifizierung
claude doctor
Dies meldet Installationstyp, Version, Systemkonfiguration und erkannte Probleme.
Updates
Claude Code aktualisiert sich standardmäßig automatisch, prüft beim Start und periodisch während der Sitzungen. Updates werden im Hintergrund heruntergeladen und beim nächsten Start angewendet.
Auto-Updates deaktivieren:
export DISABLE_AUTOUPDATER=1
Oder in settings.json:
{
"env": {
"DISABLE_AUTOUPDATER": "1"
}
}
Manuelles Update:
claude update
Deinstallation
Native Installation (macOS/Linux/WSL):
rm -f ~/.local/bin/claude
rm -rf ~/.claude-code
Native Installation (Windows PowerShell):
Remove-Item -Path "$env:LOCALAPPDATA\Programs\claude-code" -Recurse -Force
Remove-Item -Path "$env:LOCALAPPDATA\Microsoft\WindowsApps\claude.exe" -Force
Konfiguration bereinigen (entfernt alle Einstellungen):
rm -rf ~/.claude
rm ~/.claude.json
rm -rf .claude
rm -f .mcp.json
Kern-Interaktionsmodi
Interaktives REPL
Starten Sie Claude Code ohne Argumente, um in die interaktive Read-Eval-Print-Schleife einzutreten:
cd your-project
claude
Das REPL erhält den Konversationskontext über mehrere Durchgänge hinweg. Geben Sie Anfragen direkt ein, erhalten Sie Antworten und fahren Sie fort, bis Sie mit /exit oder Ctrl+D beenden.
Starten Sie mit einem initialen Prompt, um die Sitzung zu fokussieren:
claude "erkläre den Authentifizierungsfluss in diesem Projekt"
Expertentipp: Das REPL erhält den Zustand über Kompaktierungsereignisse hinweg. Wenn der Kontext zu groß wird, fasst Claude automatisch ältere Konversationen zusammen, während wichtige Entscheidungen und Code-Snippets erhalten bleiben. Sie können dies manuell mit /compact auslösen oder benutzerdefinierte Anweisungen hinzufügen, was erhalten werden soll.
Nicht-interaktiver Modus
Der Print-Modus (-p) führt eine einzelne Anfrage aus und beendet sich:
# Direkte Anfrage
claude -p "liste alle TODO-Kommentare in diesem Projekt auf"
# Gepipte Eingabe verarbeiten
cat error.log | claude -p "identifiziere die Ursache dieser Fehler"
# Mit anderen Tools verketten
claude -p "generiere eine README" > README.md
Für strukturierte Ausgabe, die sich zum Parsen in Skripten eignet:
claude -p "zähle Zeilen nach Dateityp" --output-format json
Die JSON-Ausgabe enthält alles, was Sie für die Automatisierung benötigen:
{
"type": "result",
"subtype": "success",
"total_cost_usd": 0.0034,
"is_error": false,
"duration_ms": 2847,
"duration_api_ms": 1923,
"num_turns": 4,
"result": "Antworttext hier...",
"session_id": "abc-123-d
[Inhalt für Übersetzung gekürzt]
