Claude Code CLI-Leitfaden: Installation, Konfiguration, Befehle und Umgebungsvariablen

TL;DR: Claude Code ist ein agentisches CLI, das Ihre Codebasis liest, Befehle ausführt und Dateien über ein mehrstufiges System aus Berechtigungen, hooks, MCP-Integrationen und subagents verändert. Beherrschen Sie fünf Kernsysteme – Konfiguration, Berechtigungen, hooks, MCP und subagents – und Sie erzielen eine Produktivität mit Hebelwirkung. Wählen Sie für jede Aufgabe die passende Modellklasse: Opus für komplexe Schlussfolgerungen, Sonnet für allgemeine Arbeiten und Haiku für schnelle Erkundungen. Wenn Qualität Ihre einzige Variable ist, können Sie auch durchgängig Opus verwenden. Nutzen Sie hooks und keine Prompts für alles, was ausnahmslos ausgeführt werden muss. Seit v2.1.197 (30. Juni 2026) ist Claude Sonnet 5 das Standardmodell in Claude Code – mit nativem 1M-Kontext und Aktionspreisen von 2/10 US-Dollar bis zum 31. August –, während Opus nur einen /model opus-Befehl entfernt ist (seit v2.1.219 verweist dieser Alias auf Claude Opus 5); mit v2.1.198 (1. Juli) werden subagents standardmäßig im Hintergrund ausgeführt, Claude in Chrome wird allgemein verfügbar, Hintergrundagenten können nach Abschluss von Codearbeiten in einem Worktree Commits erstellen, pushen und einen PR-Entwurf öffnen, und für Hintergrundsitzungen wird der Notification-hook (agent_needs_input/agent_completed) ausgelöst; v2.1.199 (2. Juli) lädt bis zu 5 gestapelte Slash-skill-Aufrufe und wiederholt bei Abonnenten vorübergehende 429-Fehler automatisch; v2.1.200 (3. Juli) benennt den Berechtigungsmodus default im gesamten CLI, in --help, VS Code und JetBrains in „Manual“ um (der Konfigurationswert bleibt unverändert, manual wird als Alias akzeptiert) und verhindert standardmäßig, dass AskUserQuestion-Dialoge automatisch fortgesetzt werden; v2.1.202 (6. Juli) ergänzt in /config eine Steuerung für die „Dynamic workflow size“ und setzt /review <pr> wieder auf eine schnelle Prüfung in einem Durchlauf zurück, während die Multi-Agenten-Prüfung zu /code-review <level> <pr#> wechselt; v2.1.203–205 (7.–9. Juli) härten den auto mode ab – Transkriptdateien sind gegen Manipulationen gesperrt, bei rm -rf mit einer nicht auflösbaren Variable wird zuerst nachgefragt und Benachrichtigungen zu Hintergrundaufgaben weisen darauf hin, dass keine menschliche Eingabe erfolgt ist (sodass erfundene Genehmigungen im Transkript keine Aktionen auslösen können) – und machen /doctor zu einer vollständigen Diagnose- und Reparaturprüfung (/checkup als Alias).^181182183 v2.1.217 (21. Juli) vollzog bei verschachtelten subagents eine Kehrtwende – subagents erzeugten standardmäßig keine eigenen subagents mehr (eine Standardeinstellung, die v2.1.219 nur drei Tage später erneut umkehrte, diesmal auf eine Tiefe von 3; siehe unten), standardmäßig werden höchstens 20 subagents gleichzeitig ausgeführt (CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS), und --max-budget-usd stoppt Hintergrund-subagents nun tatsächlich, sobald die Obergrenze erreicht ist.¹⁹⁴ v2.1.218 (22. Juli) verlagert /code-review in einen Hintergrund-subagent – Prüfungsarbeiten füllen Ihre Unterhaltung nicht mehr –, führt skills mit context: fork standardmäßig im Hintergrund aus (pro skill mit background: false deaktivierbar), startet /deep-research nur noch bei explizitem Aufruf, übergibt die Prüfungen auf gefährliche rm-Befehle, ein im Hintergrund ausgeführtes & und verdächtige Windows-Pfade an den Klassifikator des auto mode statt an Berechtigungsdialoge und verhindert, dass hooks aus dem Frontmatter von Agenten in nicht vertrauenswürdigen Ordnern ausgeführt werden.¹⁹⁵ v2.1.219 (24. Juli) macht Claude Opus 5 (claude-opus-5) zum standardmäßigen Opus-Modell – 1M-Kontext, maximal 128K Ausgabe, 5/25 US-Dollar pro MTok (identisch mit Opus 4.8), standardmäßig aktiviertes Thinking, effort standardmäßig auf high und Wissensstand Mai 2026 – und korrigiert zwei Sachverhalte, die frühere Versionen eingeführt hatten: Der fast mode gilt nun für Opus 5 und Opus 4.8 zu 10/50 US-Dollar pro MTok (das Zweifache des Grundpreises; Opus 4.7 wurde vollständig aus dem fast mode entfernt), und verschachtelte subagents sind standardmäßig wieder aktiviert, mit einer Tiefe von 3 (CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH=1 deaktiviert die Verschachtelung). Dieselbe Version ergänzt das hook-Ereignis DirectoryAdded, die Einstellung sandbox.network.strictAllowlist, einen Einstellungsschlüssel workflowSizeGuideline, wobei dynamische Workflows nun standardmäßig eine mittlere Größenrichtlinie verwenden (Ziel sind weniger als 15 Agenten), sowie die Weiterleitung verschachtelter subagents in stream-json. v2.1.220 (25. Juli) enthält ausschließlich Fehlerkorrekturen und Zuverlässigkeitsverbesserungen.^196197198 Seit v2.1.174–176 (12. Juni 2026) kann die Allowlist availableModels nun über die neue verwaltete Einstellung enforceAvailableModels auch das Default-Modell einschränken (Benutzer- und Projekteinstellungen können eine verwaltete Liste nicht erweitern), Sitzungstitel werden in der Sprache Ihrer Unterhaltung erzeugt (mit der Einstellung language können Sie eine Sprache festlegen), und neue Einstellungen für footerLinksRegexes und wheelScrollAccelerationEnabled, ein VSCode-Dialog zur /usage-Zuordnung sowie eine Korrektur, durch die if-Bedingungen von hooks mit Pfadmustern für Read/Edit/Write übereinstimmen, runden die Version ab.¹⁷² Seit v2.1.173 (11. Juni 2026) wird ein Fable-5-Modellname mit dem Suffix [1m] automatisch normalisiert beziehungsweise das Suffix entfernt – Fable 5 umfasst bereits standardmäßig einen 1M-Kontext, weshalb das Suffix unnötig ist (es war nur bei Opus/Sonnet von Bedeutung). Seit v2.1.172 (10. Juni 2026) konnten subagents rekursiv eigene subagents erzeugen, bis zu einer Tiefe von 5 Ebenen – eine Standardeinstellung, die bis v2.1.216 bestand und mit v2.1.217 deaktiviert wurde (siehe oben) –, Bedrock liest seine Region aus ~/.aws, wenn AWS_REGION nicht gesetzt ist (/status zeigt die Quelle an), /plugin ergänzt eine Suchleiste für den Marktplatz und die OTEL-Metrik claude_code.lines_of_code.count erhält ein Attribut namens model. Seit v2.1.170 (9. Juni 2026) lässt sich Claude Fable 5 – eine neue Modellklasse oberhalb von Opus – nach claude update über /model fable in Claude Code auswählen (sie unterstützt die vollständige effort-Skala von low bis max, Thinking kann jedoch nicht deaktiviert werden); Opus 4.8 bleibt der agentische Standard. Seit v2.1.169 (8. Juni 2026) startet --safe-mode (sowie CLAUDE_CODE_SAFE_MODE) zur Fehlerbehebung eine bereinigte Sitzung, in der sämtliche Anpassungen deaktiviert sind, /cd verschiebt eine Sitzung in ein neues Arbeitsverzeichnis, ohne den Prompt-Cache zu beeinträchtigen, und disableBundledSkills blendet die integrierten skills und Slash-Befehle für das Modell aus. Seit v2.1.166 (6. Juni 2026) verkettet eine Einstellung namens fallbackModel bis zu drei Ersatzmodelle, wenn das Primärmodell überlastet ist, der Glob "*" funktioniert in MCP-Ablehnungsregeln und MAX_THINKING_TOKENS=0 beziehungsweise --thinking disabled deaktivieren Thinking bei Modellen, die es standardmäßig verwenden, vollständig. Seit v2.1.154 (28. Mai 2026) ist Opus 4.8 der neue Standard, verwendet standardmäßig high effort und bietet die Stufe /effort xhigh, dynamische Workflows orchestrieren über /workflows Dutzende bis Hunderte Agenten im Hintergrund, der fast mode kostet mit Opus 4.8 für die 2,5-fache Geschwindigkeit das Zweifache des Standardpreises, der schlanke System-Prompt ist nun für alle Modelle außer Haiku/Sonnet/Opus 4.7 und älteren Versionen Standard, /simplify wurde auf eine reine Bereinigungsprüfung zurückgesetzt (getrennt von /code-review --fix), claude agents akzeptiert ! <command>, um Shell-Sitzungen im Hintergrund zu starten, plugins können defaultEnabled: false deklarieren, die Ausführung gestreamter Tools ist immer aktiviert und stdio-MCP-Server erhalten CLAUDE_CODE_SESSION_ID sowie CLAUDECODE=1 in ihrer Umgebung. v2.1.153 ergänzte skipLfs für plugin-Marktplätze, speicherte die Auswahl mit /model als Standard (drücken Sie s, um sie nur für die aktuelle Sitzung zu verwenden) und fügte COLUMNS/LINES zur Umgebung der Statuszeile hinzu. v2.1.152 führte /code-review --fix ein (wendet Ergebnisse auf den Arbeitsbaum an), ergänzte disallowed-tools im skill-Frontmatter und /reload-skills, fügte das neue hook-Ereignis MessageDisplay, die Ausgaben reloadSkills/sessionTitle des SessionStart-hooks, die verwaltete Einstellung pluginSuggestionMarketplaces und den Wechsel von --fallback-model während einer Sitzung hinzu und entfernte die Einwilligungspflicht für den auto mode.^{162 163 164 165 166 167 168 169 170 206 171}

Claude Code arbeitet als agentisches System, nicht als Chatoberfläche mit Programmierkenntnissen. Das CLI liest Ihre Codebasis, führt Befehle aus, verändert Dateien, verwaltet Git-Workflows, verbindet sich über MCP mit externen Diensten und delegiert komplexe Aufgaben an spezialisierte subagents. Alles läuft über eine Befehlszeilenschnittstelle, die sich in die tatsächliche Arbeitsweise von Entwicklern einfügt. Im Februar 2026 stammten 4 % der öffentlichen GitHub-Commits (etwa 135.000 pro Tag) von Claude Code – ein Wachstum um das 42.896-Fache in den 13 Monaten seit der Forschungsvorschau – und 90 % des eigenen Codes von Anthropic wurden durch KI geschrieben.¹⁰³

Der Unterschied zwischen einer gelegentlichen und einer effektiven Nutzung von Claude Code hängt von fünf Kernsystemen ab. Wenn Sie diese beherrschen, wird Claude Code zum Produktivitätsmultiplikator:

1. Konfigurationshierarchie: steuert das Verhalten
2. Berechtigungssystem: kontrolliert Vorgänge
3. Hook-System: ermöglicht deterministische Automatisierung
4. MCP-Protokoll: erweitert die Fähigkeiten
5. Subagent-System: übernimmt komplexe, mehrstufige Aufgaben

Wichtigste Erkenntnisse

• Fünf Systeme bestimmen Ihre Effektivität: Konfigurationshierarchie, Berechtigungen, hooks, MCP und subagents steuern alles – vom Verhalten bis zur Automatisierung.
• Verlagern Sie Arbeit in die Delegationsebene: subagents verhindern überladene Kontexte, indem sie Erkundungen in separaten, unbelasteten Kontextfenstern durchführen und lediglich Zusammenfassungen zurückgeben.
• Hooks garantieren die Ausführung, Prompts nicht: Nutzen Sie hooks für Linting, Formatierung und Sicherheitsprüfungen, die unabhängig vom Verhalten des Modells jedes Mal ausgeführt werden müssen.
• Die Abstufung nach Modellklassen spart Kosten, ohne die Qualität zu beeinträchtigen: Leiten Sie Erkundungsaufgaben von subagents an günstigere Modelle weiter und reservieren Sie Opus für echte architektonische Schlussfolgerungen – oder verwenden Sie durchgängig Opus, wenn Qualität Ihre einzige Variable ist.
• MCP verbindet Claude mit Ihrer Toolchain: Datenbanken, GitHub, Sentry und mehr als 3.000 Integrationen erweitern Claude über das Lesen von Dateien und Bash-Befehle hinaus.

Ich habe monatelang die Grenzen von Claude Code in produktiven Codebasen, CI/CD-Pipelines und Unternehmensbereitstellungen ausgelotet. Dieser Leitfaden verdichtet diese Erfahrung zu dem vollständigen Nachschlagewerk, das ich mir zu Beginn gewünscht hätte. Jede Funktion enthält die tatsächliche Syntax, echte Konfigurationsbeispiele und jene Grenzfälle, an denen selbst erfahrene Benutzer scheitern.

Wählen Sie Ihren Einstieg

So verwenden Sie diesen Leitfaden

Dieses Nachschlagewerk umfasst mehr als 5.000 Zeilen – Sie müssen es nicht von Anfang bis Ende lesen. Beginnen Sie an der Stelle, die Ihrem Erfahrungsstand entspricht:

Suchen Sie mit Strg+F beziehungsweise Cmd+F in Ihrem Browser nach bestimmten Flags, Befehlen oder Konfigurationsschlüsseln. Die Schnellreferenzkarte am Ende bietet eine übersichtliche Zusammenfassung aller wichtigen Befehle.

Verwandte ausführliche Artikel

Diese Blogbeiträge behandeln bestimmte Aspekte von Claude Code ausführlicher:

60-Sekunden-Schnellstart

Wenn Sie Claude Code einfach ausführen und eine Ausgabe sehen möchten, gehen Sie der Reihe nach so vor:

# 1. Install (pick one)
npm install -g @anthropic-ai/claude-code          # npm users
brew install anthropic/claude/claude              # macOS + Homebrew
curl -sL claude.ai/install.sh | sh                # native installer

# 2. Launch in any project directory
cd ~/your-project && claude

# 3. Authenticate (browser opens automatically on first run)
/login

# 4. Ask your first question
> What does this repo do? Read the key files and summarize.

Das war’s. Alles unterhalb dieses Abschnitts erklärt die Installationsoptionen ausführlicher, konfiguriert Berechtigungen und hooks, bindet MCP-Server ein und behandelt Enterprise-Deployment — aber nichts davon ist für den Einstieg erforderlich.

Voraussetzungen: Node 18+ ist nur für den älteren npm-Pfad erforderlich; der empfohlene native Installer hat keine Node-Abhängigkeit. macOS / Linux / Windows 10+ werden unterstützt. Eine Claude Pro-, Max-, Team- oder Enterprise-Subscription oder ein nutzungsbasiert abgerechneter Anthropic API-Key deckt die Nutzung ab. Plattformdetails, Fehlerbehebung und den nativen Binary-Pfad (Standard seit v2.1.113) finden Sie unter Wie installiere ich Claude Code?. Die Nachweise zur neuesten Version in diesem Guide wurden gegen v2.1.154 geprüft.²⁰⁶

Wie Claude Code funktioniert: Das mentale Modell

Bevor Sie in die Funktionen einsteigen, sollten Sie verstehen, wie die Architektur von Claude Code alles prägt, was Sie damit tun. Das System arbeitet in drei Schichten:

┌─────────────────────────────────────────────────────────┐
│                    CLAUDE CODE LAYERS                    │
├─────────────────────────────────────────────────────────┤
│  EXTENSION LAYER                                         │
│  ┌─────────┐  ┌─────────┐  ┌─────────┐  ┌─────────┐    │
│  │   MCP   │  │  Hooks  │  │ Skills  │  │ Plugins │    │
│  └─────────┘  └─────────┘  └─────────┘  └─────────┘    │
│  External tools, deterministic automation, domain       │
│  expertise, packaged extensions                          │
├─────────────────────────────────────────────────────────┤
│  DELEGATION LAYER                                        │
│  ┌─────────────────────────────────────────────────┐    │
│  │              Subagents (up to 10 parallel)       │    │
│  │   Explore | Plan | General-purpose | Custom      │    │
│  └─────────────────────────────────────────────────┘    │
│  Isolated contexts for focused work, returns summaries  │
├─────────────────────────────────────────────────────────┤
│  CORE LAYER                                              │
│  ┌─────────────────────────────────────────────────┐    │
│  │         Main Conversation Context                │    │
│  │   Tools: Read, Edit, Bash, Glob, Grep, etc.     │    │
│  └─────────────────────────────────────────────────┘    │
│  Your primary interaction; limited context; costs money │
└─────────────────────────────────────────────────────────┘

Core Layer: Ihre Hauptkonversation. Jede Nachricht, jeder Dateizugriff und jede Tool-Ausgabe verbraucht Kontext aus einem gemeinsamen Fenster (standardmäßig 200K Tokens⁹¹, 1M Tokens mit Opus 4.6 oder Modellen mit erweitertem Kontext). Wenn der Kontext voll ist, verliert Claude frühere Entscheidungen aus dem Blick, und die Qualität nimmt ab. Diese Schicht verursacht Kosten pro Token.

Delegation Layer: Subagents starten mit sauberen Kontexten, erledigen fokussierte Arbeit und geben Zusammenfassungen zurück. Die Explorationsergebnisse blähen Ihre Hauptkonversation nicht auf; nur die Schlussfolgerungen kommen zurück. Leiten Sie Subagents für Exploration an günstigere Modellstufen weiter, oder verwenden Sie durchgehend Ihr primäres Modell, wenn Qualität wichtiger ist als Kosten.

Extension Layer: MCP verbindet externe Dienste (Datenbanken, GitHub, Sentry). Hooks garantieren die Ausführung von Shell-Befehlen unabhängig vom Modellverhalten. Skills kodieren Domänenwissen, das Claude automatisch anwendet. Plugins bündeln all das für die Weitergabe.

Die zentrale Erkenntnis: Die meisten Benutzer arbeiten ausschließlich im Core Layer und sehen dabei zu, wie der Kontext anschwillt und die Kosten steigen. Power-User verlagern Exploration und spezialisierte Arbeit in den Delegation Layer, halten den Extension Layer für ihren Workflow konfiguriert und nutzen den Core Layer nur für Orchestrierung und finale Entscheidungen.

Inhaltsverzeichnis

1. Wie installiere ich Claude Code?
2. Schnellstart: Ihre erste Session
3. Zentrale Interaktionsmodi
4. Tiefgehender Einblick in das Konfigurationssystem
5. Welches Modell sollte ich wählen?
6. Was kostet Claude Code?
7. Entscheidungsframeworks
8. Wie funktioniert das Berechtigungssystem?
9. Wie funktionieren Hooks?
10. Was ist MCP (Model Context Protocol)?
11. Was sind Subagents?
12. Was ist der Extended Thinking Mode?
13. Output Styles
14. Slash Commands
15. Wie funktionieren Skills?
16. Plugin-System
17. Wie funktioniert Memory?
18. Bild- und multimodale Eingabe
19. Voice Mode
20. Wie funktioniert die Git-Integration?
21. Wie verwende ich Claude Code in meiner IDE?
22. Fortgeschrittene Nutzungsmuster
23. Remote & Background Agents [RESEARCH PREVIEW]
24. Claude in Chrome
25. Claude Code in Slack [RESEARCH PREVIEW]
26. Claude Code im Web [RESEARCH PREVIEW]
27. Performance-Optimierung
28. Wie debugge ich Probleme?
29. Enterprise-Deployment
30. Keyboard Shortcuts Reference
31. Best Practices
32. Workflow-Rezepte
33. Migration Guide
34. Zielgruppenspezifische Anleitung
35. Quick Reference Card
36. Changelog
37. References

Wie installiere ich Claude Code?

Systemanforderungen

Claude Code läuft auf macOS 13+, Ubuntu 20.04+/Debian 10+ und Windows 10+ (nativ oder WSL). Das System benötigt mindestens 4 GB RAM und eine aktive Internetverbindung.⁹² Die 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, falls 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

Plattform-Support-Matrix

Installation, Update, Deinstallation auf einen Blick

Scanbare Übersicht — jede Methode, jeder Befehl, Versionsprüfung auf einem Bildschirm. Die folgenden Unterabschnitte behandeln methodenspezifische Details und Fehlerbehebung.

Seit v2.1.113 spawnt das kanonische CLI ein natives Claude Code-Binary über eine plattformspezifische optionale Abhängigkeit anstelle des gebündelten JavaScript — verwenden Sie den nativen Installer für die getestete Distribution. Der npm-Pfad funktioniert weiterhin, erhält jedoch zuerst den Veraltungshinweis, der ursprünglich in v2.1.15 hinzugefügt wurde.

Installationsmethoden

Native Installation (empfohlen)

Das native Binary bietet die sauberste Erfahrung ohne Node.js-Abhängigkeit:

# macOS and 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:

# Install specific version
curl -fsSL https://claude.ai/install.sh | bash -s 1.0.58

# Install latest explicitly
curl -fsSL https://claude.ai/install.sh | bash -s latest

# Windows PowerShell - specific version
& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 1.0.58

NPM-Installation (veraltet)

Hinweis: Ab v2.1.15 zeigen npm-Installationen einen Veraltungshinweis an. Das native Binary ist nun die empfohlene Installationsmethode. Migrieren Sie mit claude install.

Für Legacy-Umgebungen, in denen npm noch benötigt wird:

npm install -g @anthropic-ai/claude-code

Verwenden Sie niemals sudo mit der npm-Installation. Dies erzeugt Berechtigungsprobleme, die alles Nachgelagerte verkomplizieren.

Migration von einer bestehenden Installation

Falls Sie eine ältere npm-basierte Installation haben, migrieren Sie zum nativen Binary:

claude install

Authentifizierungsoptionen

Claude Code unterstützt drei Authentifizierungspfade, jeder mit unterschiedlichen Kompromissen:

Claude Console (API-Abrechnung)

Verbinden Sie sich direkt mit Anthropics API über platform.claude.com (zuvor console.anthropic.com). Erstellen Sie ein Konto, richten Sie die Abrechnung ein und authentifizieren Sie sich über das CLI. Die Console bietet nutzungsbasierte Abrechnung mit vollständigem API-Zugriff. Ein dediziertes „Claude Code”-Workspace wird automatisch erstellt; Sie können keine API-Schlüssel für dieses 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 Weboberfläche als auch die CLI-Nutzung unter einem einzigen Monatsplan ab. Das Abonnement vereinfacht die Abrechnung für Einzelbenutzer, die vorhersehbare Kosten wünschen.

Enterprise-Plattformen

AWS Bedrock, Google Vertex AI und Microsoft Foundry bieten jeweils Enterprise-Zugriff mit bestehenden Cloud-Abrechnungsbeziehungen. Bedrock-Setup-Assistent (v2.1.92+): Ein interaktiver Assistent auf dem Anmeldebildschirm führt Sie durch die AWS-Authentifizierung, Regionsauswahl, Anmeldedatenüberprüfung und Modellfixierung.¹³⁷ Vertex AI-Setup-Assistent (v2.1.98+): Ein passender Assistent für Google Cloud, der durch GCP-Authentifizierung, Projekt- und Regionskonfiguration, Anmeldedatenüberprüfung und Modellfixierung führt.¹⁴² Vertex AI mTLS Workload Identity Federation (v2.1.121+): Vertex AI akzeptiert nun X.509-zertifikatbasierte Workload Identity Federation (mTLS Application Default Credentials) — kurzlebige GCP-Tokens, die aus einem Client-Zertifikat erzeugt werden, ohne dass ein Dienstkonto-JSON erforderlich ist.¹⁵⁴ OS-CA-Zertifikatsvertrauen (v2.1.101+): Enterprise-TLS-Proxys funktionieren nun standardmäßig — Claude Code vertraut dem Zertifikatspeicher des Betriebssystems. Setzen Sie CLAUDE_CODE_CERT_STORE=bundled, um nur gebündelte CAs zu verwenden.¹⁴³

# 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 key auth (otherwise uses Entra ID)
export ANTHROPIC_FOUNDRY_API_KEY=your-key

# Amazon Bedrock via Mantle (v2.1.94+)
export CLAUDE_CODE_USE_MANTLE=1

Für Enterprise-Deployments hinter Proxys oder über LLM-Gateways:

# Corporate proxy
export HTTPS_PROXY='https://proxy.example.com:8080'

# LLM gateway (skip native auth)
export CLAUDE_CODE_USE_BEDROCK=1
export ANTHROPIC_BEDROCK_BASE_URL='https://your-gateway.com/bedrock'
export CLAUDE_CODE_SKIP_BEDROCK_AUTH=1

Überprüfung

claude doctor

Der Befehl meldet den Installationstyp, die Version, die Systemkonfiguration und alle erkannten Probleme.

Authentifizierungsverwaltung (v2.1.41+)

Verwalten Sie die Authentifizierung, ohne den REPL zu betreten:⁹⁰

claude auth login          # Log in or switch accounts
claude auth status         # Check current auth state (account, plan, expiry)
claude auth logout         # Clear stored credentials

Üblicher Workflow zum Wechseln zwischen Konten oder Organisationen:

claude auth logout && claude auth login

Siehe auch: Wie debugge ich Probleme? zur Fehlerbehebung bei Authentifizierungsfehlern.

Updates

Claude Code aktualisiert sich standardmäßig automatisch, prüft beim Start und periodisch während 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

Saubere Konfiguration (entfernt alle Einstellungen):

rm -rf ~/.claude
rm ~/.claude.json
rm -rf .claude
rm -f .mcp.json

Schnellstart: Ihre erste Sitzung

1. Installieren und starten:

claude                           # Launch in current directory

2. Zu einem Projekt navigieren:

cd ~/my-project && claude        # Or launch from any git repo

3. Claude mit einer Aufgabe beauftragen:

> "Explain the architecture of this project"
> "Find all TODO comments and create a summary"
> "Add input validation to the signup form"

4. Während Ihrer Sitzung Tastenkürzel verwenden:

/cost                            # Check token usage and cost
/compact                         # Free up context when it gets large
Alt+T                            # Toggle extended thinking for hard problems
Ctrl+C                           # Cancel current response

5. Später fortfahren:

claude -c                        # Resume your most recent session
claude --resume                  # Pick from session list

Expertentipp: Erstellen Sie im Stammverzeichnis Ihres Projekts eine CLAUDE.md-Datei mit Build-Befehlen, Programmierkonventionen und Hinweisen zur Architektur. Claude liest sie in jeder Sitzung – damit erzielen Sie mit einer einzigen Maßnahme die größte Qualitätssteigerung.

Zentrale Interaktionsmodi

Interaktive REPL

Starten Sie Claude Code ohne Argumente, um die interaktive Read-Eval-Print-Schleife aufzurufen:

cd your-project
claude

Die REPL behält den Gesprächskontext über mehrere Interaktionen hinweg bei. Geben Sie Anfragen direkt ein, erhalten Sie Antworten und fahren Sie fort, bis Sie die REPL mit /exit oder Ctrl+D beenden.

Beginnen Sie mit einem initialen Prompt, um die Sitzung gezielt auszurichten:

claude "explain the authentication flow in this project"

Expertentipp: Die REPL behält ihren Zustand auch über Komprimierungsvorgänge hinweg bei. Wird der Kontext zu umfangreich, fasst Claude ältere Gesprächsteile automatisch zusammen und bewahrt dabei wichtige Entscheidungen und Codeausschnitte. Sie können dies mit /compact manuell auslösen oder benutzerdefinierte Anweisungen dazu hinzufügen, was beibehalten werden soll.

Nicht interaktiver Modus

Der Print-Modus (-p) führt eine einzelne Anfrage aus und wird anschließend beendet:

# Direct query
claude -p "list all TODO comments in this project"

# Process piped input
cat error.log | claude -p "identify the root cause of these failures"

# Chain with other tools
claude -p "generate a README" > README.md

Für strukturierte Ausgaben, die sich zur Verarbeitung in Skripten eignen:

claude -p "count lines by file type" --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": "Response text here...",
  "session_id": "abc-123-def"
}

Für die Echtzeitverarbeitung von Streaming-Ausgaben:

claude -p "build the application" --output-format stream-json | while read line; do
  echo "$line" | jq -r 'select(.result) | .result'
done

Optionen für das Ausgabeformat:

Subagent-Text in stream-json (v2.1.211+): Standardmäßig enthält die stream-json-Ausgabe nur die Ereignisse der Hauptsitzung – innerhalb von subagents ausgeführte Arbeit wird als Zusammenfassung ausgegeben. Mit dem Flag --forward-subagent-text (oder CLAUDE_CODE_FORWARD_SUBAGENT_TEXT=1) werden auch Text- und Gedankenausgaben von subagents an den Stream weitergeleitet. Dadurch können Harnesses und Log-Pipelines delegierte Arbeit während ihrer Ausführung beobachten, statt nur den abschließenden Bericht zu sehen.¹⁸⁸

Verschachtelte subagents werden nun ebenfalls weitergeleitet (v2.1.219). Ursprünglich wurden nur subagents der Tiefe 1 ausgegeben. Subagents, die in Tiefe 2 oder tiefer erzeugt werden, erscheinen nun ebenfalls im weitergeleiteten Stream. Jeder Eintrag ist dabei über die tool_use-ID des Agent-Aufrufs gekennzeichnet, der ihn erzeugt hat. So kann eine Pipeline den Delegationsbaum rekonstruieren, statt lediglich eine flache Textliste zu erhalten. Dies ergänzt unmittelbar die in derselben Version wiederhergestellte standardmäßige Erzeugung verschachtelter subagents bis Tiefe 3: Ohne diese Weiterleitung wären 2 der 3 Ebenen unsichtbar geblieben.¹⁹⁶

Exit-Codes:

Steuerung des agentischen Verhaltens im -p-Modus:

# Limit autonomous turns (prevents runaway loops)
claude -p "refactor the auth module" --max-turns 10

# Allow specific tools without prompting
claude -p "fix lint errors" --allowedTools "Edit,Bash(npm run lint)"

# Use with a specific model
claude -p "explain this code" --model claude-sonnet-4-5-20250929

# Bare mode: skip hooks, LSP, plugin sync, skill walks (v2.1.81+)
claude -p "count files" --bare

# Channel permission relay: send approval prompts to Telegram/Discord (v2.1.81+)
claude --channels

CI/CD-Integrationsmuster:

# In a GitHub Action or CI pipeline
result=$(claude -p "review this diff for security issues" --output-format json 2>/dev/null)
is_error=$(echo "$result" | jq -r '.is_error')
if [ "$is_error" = "true" ]; then
  echo "Review failed"
  exit 1
fi
echo "$result" | jq -r '.result'

Sitzungsverwaltung

Sitzungen speichern den Gesprächsverlauf, damit Sie ihn später fortsetzen können. Für komplexe Arbeiten über mehrere Sitzungen hinweg ist diese Sitzungspersistenz unverzichtbar:

# Continue most recent session
claude -c

# Continue with additional prompt
claude -c -p "now add error handling"

# Resume specific session by ID
claude -r "abc123" "implement the remaining tests"

# Fork a session for parallel exploration
claude -r "base-session" --fork-session "try a different approach"

Mit PRs verknüpfte Sitzungen (v2.1.27+, erweitert ab v2.1.119): Starten Sie eine Sitzung, die mit einem bestimmten Pull Request oder Merge Request verknüpft ist. Seit v2.1.119 akzeptiert --from-pr neben github.com auch GitLab-MR-, Bitbucket-PR- und GitHub-Enterprise-PR-URLs:⁷⁴¹⁵²

claude --from-pr 123                                                # GitHub PR number (assumes current repo's remote)
claude --from-pr https://github.com/org/repo/pull/123               # GitHub URL
claude --from-pr https://gitlab.com/org/repo/-/merge_requests/45    # GitLab MR (v2.1.119+)
claude --from-pr https://bitbucket.org/org/repo/pull-requests/67    # Bitbucket PR (v2.1.119+)
claude --from-pr https://ghe.example.com/org/repo/pull/89           # GitHub Enterprise (v2.1.119+)

Sitzungen werden außerdem automatisch mit PRs verknüpft, wenn Sie diese während einer Sitzung über gh pr create erstellen. Dadurch können Sie die Arbeit an einem bestimmten PR später problemlos fortsetzen. Das PR-Badge in der Fußzeile kann über die Einstellung prUrlTemplate auf eine benutzerdefinierte Code-Review-URL verweisen (v2.1.119+) – praktisch, wenn Ihr Team von PRs aus auf ein separates Review-Tool verlinkt.¹⁵²

/resume akzeptiert PR-URLs (v2.1.122+). Wenn Sie eine PR-URL in das Suchfeld von /resume einfügen, wird nun die Sitzung gefunden, in der dieser PR ursprünglich erstellt wurde. Dies funktioniert mit github.com, GitHub Enterprise, gitlab.com (einschließlich selbst gehostetem GitLab) und bitbucket.org.¹⁵⁴

Benannte Sitzungen: Benennen Sie Sitzungen beim Start oder während einer Sitzung:

# Name session at startup (v2.1.76+)
claude -n "auth-refactor"                  # --name flag sets display name[^125]

# Name current session
> /rename auth-refactor

# Resume by name or number
> /resume 1                    # Resume first session
> /resume auth-refactor        # Resume by name
claude --resume auth-refactor  # Resume from terminal
claude -r 3                    # Resume by number from terminal

# Fork for parallel exploration
claude --resume auth-refactor --fork-session

Hinweis: --session-id erfordert eine gültige UUID (z. B. 550e8400-e29b-41d4-a716-446655440000). Verwenden Sie für menschenlesbare Sitzungsnamen stattdessen /rename und --resume.

/fork erzeugt eine Hintergrundsitzung; /subtask ist der sitzungsinterne Fork (v2.1.212). Der Befehl /fork kopiert die aktuelle Unterhaltung nun in eine neue Hintergrundsitzung. Diese erhält einen eigenen Eintrag in claude agents, sodass Sie die Kopie eine Alternative untersuchen lassen können, während Ihre Hauptsitzung weiterläuft. Das bisherige Verhalten – das Forken innerhalb der aktuellen Sitzung – steht unter dem neuen Namen /subtask weiterhin zur Verfügung.¹⁸⁹ Seit v2.1.214 meldet eine als Fork gestartete Sitzung für den SessionStart-hook die Quelle "fork" (zuvor "resume"), sodass nach Quellen filternde hooks zwischen beiden unterscheiden können.¹⁹⁰ v2.1.216 verkürzt die Bestätigung von /fork auf eine Zeile, in der der Name der neuen Sitzung und ihre claude attach-ID angezeigt werden.¹⁹²

Claude Code speichert Sitzungen als JSONL-Transkripte. Bei der Agent-Ausführung werden eindeutige agentId-Werte vergeben und die Transkripte als agent-{agentId}.jsonl gespeichert. Beim Fortsetzen bleibt der vollständige Kontext vorheriger Unterhaltungen erhalten.

Plan-Modus

Der Plan-Modus beschränkt Claude auf schreibgeschützte Erkundungen – keine Dateiänderungen, keine Bash-Ausführung und keine destruktiven Aktionen. Claude entwirft einen Implementierungsansatz, schreibt ihn in eine Plandatei und wartet auf Ihre Genehmigung, bevor etwas ausgeführt wird.

Plan-Modus aufrufen:

# Cycle through modes during a session
Shift+Tab           # Cycles: normal → plan → auto-accept

# Or use the /plan command with an optional description (v2.1.72+)
/plan                                     # Enter plan mode
/plan refactor the auth module            # Enter plan mode with a description

# Or ask Claude directly
"Plan how to refactor the auth module"   # Claude may enter plan mode automatically

Funktionsweise:

1. Claude wechselt in den Plan-Modus (bei komplexen Aufgaben automatisch oder über Shift+Tab)
2. Untersucht die Codebasis mit schreibgeschützten Tools: Read, Glob, Grep, WebSearch, WebFetch
3. Schreibt einen Plan nach .claude/plans/{session-slug}.md
4. Beendet den Plan-Modus mit ExitPlanMode und legt Ihnen den Plan zur Prüfung vor
5. Sie genehmigen den Plan, fordern Änderungen an oder lehnen ihn ab

Im Plan-Modus verfügbare Tools: Read, Glob, Grep, LS, WebSearch, WebFetch, AskUserQuestion. Bearbeitungs-Tools (Edit, Write, Bash, NotebookEdit) sind gesperrt.

Nach der Plangenehmigung (v2.1.32+): Claude bietet 3 Optionen: - „Ja, Kontext löschen und Änderungen automatisch akzeptieren“ (Shift+Tab) – beginnt mit vollständigem Kontext für den Plan von vorn - „Ja, und Änderungen manuell genehmigen“ – behält den Kontext bei; Sie genehmigen jede Änderung - „Ja, Änderungen automatisch akzeptieren“ – behält den Kontext bei; Claude führt Änderungen ohne einzelne Genehmigung aus

Das automatische Löschen des Kontexts bei der Genehmigung ist der empfohlene Arbeitsablauf. Dadurch erhält der Plan ein frisches Kontextfenster, was die Einhaltung des Plans erheblich verbessert – Claude bleibt länger auf Kurs, ohne durch die bisherige Unterhaltung beeinflusst zu werden.

Wann Sie den Plan-Modus verwenden sollten: - Implementierung neuer Funktionen mit Architekturentscheidungen - Refaktorierungen über mehrere Dateien hinweg, bei denen Sie den Ansatz zuerst prüfen möchten - Unvertraute Codebasen, bei denen die Erkundung vor der Änderung erfolgen sollte - Alle Aufgaben, für die mehrere sinnvolle Ansätze existieren und Sie mitentscheiden möchten

Expertentipp: Je mehr Zeit Sie im Plan-Modus verbringen, desto wahrscheinlicher wird Claude die Implementierung erfolgreich abschließen. Der Plan-Modus ermöglicht praktisch risikofreie Erkundungen – ohne riskante Tool-Aufrufe und vergebliche Änderungen. Nutzen Sie ihn großzügig.

Screenreader-Modus (v2.1.208)

Claude Code verfügt über einen eigenen Screenreader-Modus, der die Terminal-Benutzeroberfläche an Hilfstechnologien anpasst. Sie können ihn auf 3 Arten aktivieren:¹⁸⁶

# Flag at launch
claude --ax-screen-reader

# Environment variable
export CLAUDE_AX_SCREEN_READER=1

# Or persistently in settings.json
{ "axScreenReader": true }

Anthropic beschreibt den Modus und seine Interaktionsmuster auf einer neuen Seite zur Barrierefreiheit in der offiziellen Dokumentation.¹⁸⁶

Ausführlicher Einblick in das Konfigurationssystem

Claude Code verwendet ein mehrstufiges Konfigurationssystem. Die Hierarchie zu verstehen, ist unerlässlich, da höhere Ebenen niedrigere überschreiben und Unternehmenseinstellungen überhaupt nicht umgangen werden können.

Konfigurationshierarchie

Expertentipp: Verwenden Sie .claude/settings.local.json für persönliche Einstellungen in geteilten Projekten und fügen Sie die Datei zu .gitignore hinzu. Nutzen Sie .claude/settings.json für teamweite Konfigurationen, die in die Versionsverwaltung eingecheckt werden.

Konfiguration über den Prompt festlegen: /config key=value (v2.1.181)

Seit v2.1.181 können Sie mit /config key=value jede Einstellung direkt im Prompt festlegen – beispielsweise /config thinking=false –, ohne die interaktive /config-Benutzeroberfläche zu öffnen. Dies funktioniert in interaktiven, -p- und Remote-Control-Sitzungen. /config --help (v2.1.183) führt die verfügbaren Kurzschlüssel auf. Mit v2.1.183 wurde außerdem die interaktive /config-Benutzeroberfläche geändert: Sowohl die Eingabetaste als auch die Leertaste schalten die ausgewählte Einstellung um, während Esc speichert und die Oberfläche schließt; zuvor wurden Änderungen dadurch verworfen.¹⁷⁴

Vollständige settings.json-Referenz

Eine vollständige Konfiguration mit allen wichtigen Optionen:

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "model": "claude-sonnet-4-5-20250929",
  "permissions": {
    "allow": [
      "Read",
      "Glob",
      "Grep",
      "Bash(npm run:*)",
      "Bash(git:*)",
      "Bash(make:*)",
      "Edit(src/**)",
      "mcp__github"
    ],
    "deny": [
      "Read(.env*)",
      "Read(secrets/**)",
      "Bash(rm -rf:*)",
      "Bash(sudo:*)",
      "Edit(package-lock.json)",
      "Edit(.git/**)"
    ],
    "ask": [
      "WebFetch",
      "Bash(curl:*)",
      "Bash(docker:*)"
    ],
    "additionalDirectories": [
      "../shared-lib",
      "../docs"
    ],
    "defaultMode": "acceptEdits"
  },
  "env": {
    "NODE_ENV": "development",
    "DEBUG": "app:*"
  },
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "npx prettier --write \"$FILE_PATH\""
          }
        ]
      }
    ]
  },
  "sandbox": {
    "enabled": false,
    "autoAllowBashIfSandboxed": true,
    "excludedCommands": ["git", "docker"]
  },
  "statusLine": {
    "type": "command",
    "command": "~/.claude/statusline.sh"
  },
  "includeCoAuthoredBy": true,
  "cleanupPeriodDays": 30,
  "outputStyle": "Explanatory",
  "language": "en",
  "respectGitignore": true,
  "showTurnDuration": true,
  "plansDirectory": ".claude/plans",
  "spinnerVerbs": ["Thinking", "Processing", "Analyzing"],
  "spinnerTipsOverride": {
    "tips": ["Custom tip 1", "Custom tip 2"],
    "excludeDefault": true
  },
  "skillOverrides": {
    "legacy-skill": "off",
    "manual-only-skill": "user-invocable-only",
    "compact-skill": "name-only"
  },
  "includeGitInstructions": false,
  "modelOverrides": {
    "bedrock": "us.anthropic.claude-opus-4-6-20260312-v1:0",
    "vertex": "claude-opus-4-6@20260312",
    "foundry": "anthropic.claude-opus-4-6"
  },
  "autoMemoryDirectory": ".claude/memory",
  "sandbox": {
    "enableWeakerNetworkIsolation": true
  }
}

skillOverrides ist nützlich, wenn ein Team über eine umfangreiche skill-Bibliothek verfügt, die Laufzeitverfügbarkeit aber stärker einschränken möchte. Verwenden Sie off, um einen skill sowohl vor dem Modell als auch in der Slash-Auswahl auszublenden, user-invocable-only, um ihn weiterhin namentlich aufrufbar zu halten, ihn jedoch aus der Modellauswahl zu entfernen, und name-only, um nur den Namen des skills ohne seine vollständige Beschreibung anzuzeigen.¹⁵⁶

Neuere Einstellungen (v2.1.174–176):

• availableModels / enforceAvailableModels (verwaltet, v2.1.175+): Die Zulassungsliste availableModels beschränkt, welche Modelle eine Sitzung auswählen kann. Mit enforceAvailableModels: true gilt die Zulassungsliste auch für das Standardmodell: Würde die Standardeinstellung zu einem unzulässigen Modell führen, wird stattdessen das erste zugelassene Modell verwendet. Zudem können Benutzer- oder Projekteinstellungen eine verwaltete availableModels-Liste nicht mehr erweitern. Eine ergänzende Korrektur (v2.1.176) schließt die Lücke, durch die eine Alias-Auswahl über ANTHROPIC_DEFAULT_*_MODEL auf ein gesperrtes Modell umgeleitet werden konnte. /fast verweigert nun außerdem den Wechsel zu einem Modell außerhalb der Zulassungsliste.¹⁷² Seit v2.1.187 können Organisationen Modellbeschränkungen direkt für die /model-Auswahl, --model, /model und ANTHROPIC_MODEL durchsetzen. Bei Auswahl eines eingeschränkten Modells erscheint die Meldung „durch die Einstellungen Ihrer Organisation eingeschränkt“.¹⁷⁶
• language (Überarbeitung in v2.1.176): Neben der Antwortsprache werden Sitzungstitel nun standardmäßig in der Sprache Ihrer Unterhaltung erstellt. Legen Sie mit language eine bestimmte Sprache für Titel fest.¹⁷²
• footerLinksRegexes (v2.1.176): Über reguläre Ausdrücke abgeglichene Link-Badges in der Fußzeile, die über Benutzer- oder verwaltete Einstellungen konfiguriert werden können.¹⁷²
• wheelScrollAccelerationEnabled (v2.1.174): Setzen Sie den Wert auf false, um die Beschleunigung beim Scrollen mit dem Mausrad im Vollbildmodus zu deaktivieren.¹⁷²

Neuere Einstellungen (v2.1.207–v2.1.212):

• vimInsertModeRemaps (v2.1.208): Benutzerdefinierte Tastenzuordnungen für den vim-Einfügemodus – das klassische Beispiel ist die Zuordnung von jj zu Escape (siehe Vim-Modus).¹⁸⁶
• axScreenReader (v2.1.208): Aktiviert den Screenreader-Modus dauerhaft (siehe Screenreader-Modus).¹⁸⁶
• processWrapper (v2.1.208): Leitet jeden Prozess, den Claude Code für sich selbst startet, über eine Wrapper-Programmdatei – entwickelt für Unternehmens-Launcher (siehe Unternehmens-Launcher).¹⁸⁶
• autoMode-Quellenbeschränkung (v2.1.207): Die Einstellung autoMode wird nicht mehr aus .claude/settings.local.json eines Repositorys gelesen. Konfigurieren Sie sie stattdessen in ~/.claude/settings.json. Dadurch wird verhindert, dass ein geklontes Repository eine Auto-Mode-Konfiguration mitliefert.¹⁸⁵

Neuere Einstellungen (v2.1.217):

• emojiCompletionEnabled (v2.1.217): Autovervollständigung von Emoji-Kurzcodes in der Prompt-Eingabe – geben Sie :heart: ein, um ❤️ einzufügen, oder einen unvollständigen Ausdruck wie :hea, um Vorschläge zu erhalten. Standardmäßig aktiviert; setzen Sie den Wert zum Deaktivieren auf false.¹⁹⁴

Neuere Einstellungen (v2.1.219):

• sandbox.network.strictAllowlist (v2.1.219): Verweigert Hosts, die nicht auf der Zulassungsliste stehen, bei Sandbox-Befehlen ohne Nachfrage, statt einen Berechtigungsdialog anzuzeigen. Siehe Sandbox-Modus.¹⁹⁶
• workflowSizeGuideline (v2.1.219): Legt den beratenden Richtwert für die Größe dynamischer Workflows über eine beliebige Einstellungsdatei – für Benutzer, Projekte oder verwaltete Umgebungen – fest, statt ausschließlich über /config. Für dynamische Workflows gilt standardmäßig der Richtwert mittel („weniger als 15 Agenten anstreben“). Die entsprechende /config-Zeile wird ausgeblendet, solange eine Einstellungsdatei den Wert vorgibt. Es handelt sich um eine Empfehlung, nicht um eine erzwungene Obergrenze. Siehe subagents.¹⁹⁶

Referenz der Umgebungsvariablen

Authentifizierung und API:

ANTHROPIC_API_KEY=sk-ant-...                    # Direct API authentication
ANTHROPIC_AUTH_TOKEN=token                      # Custom authorization header
ANTHROPIC_CUSTOM_HEADERS="X-Key: val"           # Additional request headers

Modellkonfiguration:

ANTHROPIC_MODEL=claude-opus-4-7                 # Override default model (Apr 16, 2026)
ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-4-7    # Opus 4.7 (Max/Team Premium default)
ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-4-6
ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5-20251001
CLAUDE_CODE_SUBAGENT_MODEL=sonnet               # Model for subagents
CLAUDE_CODE_WORKFLOWS=1                         # Enable Workflow tool for deterministic multi-agent orchestration (v2.1.147+)
MAX_THINKING_TOKENS=10000                       # (Opus 4.6 and Sonnet 4.6 only — removed in Opus 4.7)
CLAUDE_CODE_MAX_OUTPUT_TOKENS=4000              # Limit output length
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1          # Enable agent teams (v2.1.32+)

Cloud-Anbieter-Konfiguration:

CLAUDE_CODE_USE_BEDROCK=1                       # Use AWS Bedrock
CLAUDE_CODE_USE_VERTEX=1                        # Use Google Vertex AI
CLAUDE_CODE_USE_FOUNDRY=1                       # Use Microsoft Foundry
ANTHROPIC_BEDROCK_BASE_URL=https://...          # Custom Bedrock endpoint
ANTHROPIC_BEDROCK_SERVICE_TIER=priority         # Bedrock service tier (v2.1.122+): 'default', 'flex', or 'priority'; sent as X-Amzn-Bedrock-Service-Tier header[^162]
CLAUDE_CODE_SKIP_BEDROCK_AUTH=1                 # Skip Bedrock auth (for gateways)
CLAUDE_CODE_SKIP_VERTEX_AUTH=1                  # Skip Vertex auth
AWS_BEARER_TOKEN_BEDROCK=token                  # Bedrock bearer token
VERTEX_REGION_CLAUDE_3_7_SONNET=us-west1        # Override Vertex region
CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1    # Opt in gateway /v1/models discovery for /model picker (v2.1.129+)[^164]

Verhaltenssteuerung:

DISABLE_AUTOUPDATER=1                           # Prevent automatic background updates
DISABLE_UPDATES=1                               # Block ALL update paths including manual `claude update` (v2.1.118+, stricter than DISABLE_AUTOUPDATER)[^160]
CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1       # Homebrew/WinGet installs run package-manager upgrade in background, then prompt restart (v2.1.129+)[^164]
DISABLE_TELEMETRY=1                             # Opt out of usage telemetry
DISABLE_ERROR_REPORTING=1                       # Disable Sentry
DISABLE_BUG_COMMAND=1                           # Disable /bug command
DISABLE_COST_WARNINGS=1                         # Hide cost warnings
DISABLE_PROMPT_CACHING=1                        # Disable prompt caching globally
DISABLE_PROMPT_CACHING_SONNET=1                 # Disable for Sonnet only
DISABLE_PROMPT_CACHING_OPUS=1                   # Disable for Opus only
DISABLE_NON_ESSENTIAL_MODEL_CALLS=1             # Skip non-critical API calls
ENABLE_PROMPT_CACHING_1H=1                      # Opt into 1-hour prompt cache TTL (v2.1.108+, API/Bedrock/Vertex/Foundry)
ENABLE_PROMPT_CACHING_1H_BEDROCK=1              # Deprecated alias for the above; v2.1.108+ still honors it on Bedrock but logs a deprecation notice
FORCE_PROMPT_CACHING_5M=1                       # Force 5-minute cache TTL (v2.1.108+)
ENABLE_TOOL_SEARCH=true                         # Re-enable tool search on Vertex AI (disabled by default v2.1.119+ to avoid unsupported beta header). Valid values: true, false, auto, auto:N[^160]
CLAUDE_CODE_HIDE_CWD=1                          # Hide the working directory in the startup logo (v2.1.119+)[^160]
CLAUDE_CODE_FORK_SUBAGENT=1                     # Enable forked subagents on external builds (v2.1.117+)[^160]
CLAUDE_CODE_FORCE_SYNC_OUTPUT=1                 # Force synchronized terminal output when auto-detection misses it, such as Emacs eat (v2.1.129+)[^164]
CLAUDE_CODE_SESSION_ID=...                      # Read-only: present in the Bash tool subprocess; matches the session_id passed to hooks (v2.1.132+)[^168]
CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1          # Skip the fullscreen alternate-screen renderer; keep the conversation in the terminal's native scrollback (v2.1.132+)[^168]
CLAUDE_EFFORT=...                               # Read-only: current effort level inside hooks and Bash tool subprocess (v2.1.133+)[^169]
CLAUDE_CODE_FORWARD_SUBAGENT_TEXT=1             # Include subagent text + thinking in stream-json output; pairs with --forward-subagent-text (v2.1.211+). Covers depth-2+ nested subagents as of v2.1.219[^205][^213]
CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION=200    # Per-session WebSearch cap (default 200; v2.1.212+)[^206]
CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION=200       # Per-session subagent-spawn cap (default 200; /clear resets the budget; v2.1.212+)[^206]
CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS=20         # Cap on concurrently-RUNNING subagents (default 20; distinct from the per-session total above; v2.1.217+)[^211]
CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH=3          # Nested subagent spawn depth. Default 3 as of v2.1.219; set 1 to disable nesting. Default history: 5 (v2.1.172–v2.1.216) → 1 (v2.1.217) → 3 (v2.1.219). Set it explicitly[^211][^213]

Tool-Konfiguration:

BASH_DEFAULT_TIMEOUT_MS=30000                   # Bash command timeout (30s)
BASH_MAX_TIMEOUT_MS=600000                      # Maximum bash timeout (10min)
BASH_MAX_OUTPUT_LENGTH=50000                    # Bash output limit
CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR=1     # Reset CWD after each bash
MCP_TIMEOUT=5000                                # MCP server startup timeout
MCP_TOOL_TIMEOUT=30000                          # MCP tool execution timeout
MAX_MCP_OUTPUT_TOKENS=25000                     # MCP output limit
CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS=120000       # Threshold before a long MCP tool call moves to the background (default 2 min; v2.1.212+)[^206]
SLASH_COMMAND_TOOL_CHAR_BUDGET=15000            # Slash command context limit

Netzwerk und Proxy:

HTTP_PROXY=http://proxy:8080                    # HTTP proxy
HTTPS_PROXY=https://proxy:8080                  # HTTPS proxy
NO_PROXY=localhost,example.com                  # Bypass proxy for domains
CLAUDE_CODE_CLIENT_CERT=/path/to/cert           # mTLS certificate
CLAUDE_CODE_CLIENT_KEY=/path/to/key             # mTLS private key
CLAUDE_CODE_CLIENT_KEY_PASSPHRASE=pass          # mTLS passphrase

Benutzeroberfläche und Terminal:

CLAUDE_CODE_DISABLE_TERMINAL_TITLE=1            # Don't update terminal title
CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL=1             # Skip IDE extension install
CLAUDE_CODE_SHELL=/bin/zsh                      # Override shell detection
USE_BUILTIN_RIPGREP=1                           # Use included ripgrep (default)
CLAUDE_CONFIG_DIR=~/.myconfig                   # Custom config directory
IS_DEMO=1                                       # Hide sensitive UI elements[^37]
CLAUDE_CODE_DISABLE_BACKGROUND_TASKS=1          # Disable background tasks and Ctrl+B[^46]
CLAUDE_CODE_TMPDIR=/path/to/tmp                 # Override temp directory[^50]
CLAUDE_CODE_DISABLE_1M_CONTEXT=1               # Disable 1M context window (use standard 200K)[^103]
CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS=120000       # Plugin marketplace git timeout (default 120s, was 30s)[^105]
CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS=1        # Remove built-in commit/PR instructions[^117]
CLAUDE_CODE_DISABLE_CRON=1                    # Stop scheduled cron jobs mid-session[^121]
CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS=30000 # SessionEnd hooks timeout (default varies)[^123]
CLAUDE_CODE_USE_POWERSHELL_TOOL=1             # Enable Windows PowerShell tool on Linux/macOS (requires pwsh on PATH; v2.1.111+)[^153]
CLAUDE_CODE_DISABLE_MOUSE_CLICKS=1           # Disable mouse click/drag/hover in fullscreen mode; wheel scroll still works (v2.1.195+)[^196]
CLAUDE_ENABLE_STREAM_WATCHDOG=0              # Disable the streaming idle watchdog (on by default for all providers since v2.1.196: aborts+retries after 5 min of silence)[^198]
CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP=1 # Turn off automatic memory-pressure reaping of idle background shell commands (v2.1.193+)[^196]
CLAUDE_CODE_ENABLE_AWAY_SUMMARY=1             # Force Session Recap when telemetry disabled (v2.1.108+)[^153]
CLAUDE_AX_SCREEN_READER=1                     # Enable screen reader mode; same as --ax-screen-reader or "axScreenReader": true (v2.1.208+)[^203]
OTEL_LOG_RAW_API_BODIES=1                     # Emit full API request/response bodies as OTel log events (v2.1.111+)[^153]
TRACEPARENT=00-...                            # W3C Trace Context parent (v2.1.110+, SDK/headless)[^153]
TRACESTATE=vendor=value                       # W3C Trace Context state (v2.1.110+, SDK/headless)[^153]

OpenTelemetry-Exporter und Zugriffskontrolle für sensible Felder:²⁰⁷

OTEL_LOGS_EXPORTER=none                       # OTel logs exporter (supports 'none' for disable; v2.1.85 fixed crash)
OTEL_METRICS_EXPORTER=none                    # OTel metrics exporter (supports 'none'; v2.1.85 fixed crash)
OTEL_TRACES_EXPORTER=none                     # OTel traces exporter (supports 'none'; v2.1.85 fixed crash)
OTEL_LOG_TOOL_CONTENT=1                       # Opt in to emitting tool content in OTel spans (v2.1.101+, sensitive by default)
OTEL_LOG_TOOL_DETAILS=1                       # Opt in to tool_parameters in OTel tool_result events (v2.1.85+)
OTEL_LOG_USER_PROMPTS=1                       # Opt in to emitting user prompts in OTel traces (v2.1.101+, sensitive by default)
OTEL_LOG_ASSISTANT_RESPONSES=0                # Gate the claude_code.assistant_response log event holding the model's response text (v2.1.193+)
CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH=60000     # Truncation limit for OTel content attributes (default 60 KB; v2.1.214+)[^207]
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1    # Disable release-notes fetch (v2.0.17+); v2.1.110 also stopped the auto-title Haiku request in headless/SDK when set

Attribute für LLM-Anfrage-Spans ab v2.1.121: stop_reason, gen_ai.response.finish_reasons und user_system_prompt werden nun für LLM-Anfrage-Spans ausgegeben. Da user_system_prompt personenbezogene Daten enthalten kann, ist die Ausgabe durch OTEL_LOG_USER_PROMPTS=1 geschützt.¹⁵⁴

Änderungen auf Ereignisebene ab v2.1.122: Numerische Attribute der Log-Ereignisse api_request und api_error werden nun als Zahlen statt als Zeichenfolgen ausgegeben. Dies behebt Probleme mit nachgelagerten OTel-Kollektoren, die das Schema strikt typisiert haben. Das neue Log-Ereignis claude_code.at_mention wird ausgelöst, wenn Claude Code eine @-Erwähnung auflöst.¹⁵⁴

Log-Ereignis claude_code.assistant_response ab v2.1.193: Claude Code kann den vollständigen Antworttext des Modells als OTel-Log-Ereignis ausgeben, gesteuert durch OTEL_LOG_ASSISTANT_RESPONSES. Bei dieser Zugriffskontrolle gibt es einen wichtigen Fallstrick bei Upgrades: Ist OTEL_LOG_ASSISTANT_RESPONSES nicht gesetzt, übernimmt es den Wert von OTEL_LOG_USER_PROMPTS. Jede Bereitstellung, die bereits Prompt-Inhalte protokolliert, empfängt nach dem Upgrade somit auch die Antwortinhalte des Assistenten. Setzen Sie OTEL_LOG_ASSISTANT_RESPONSES=0, damit die Telemetrie weiterhin ausschließlich Prompts erfasst.¹⁷⁹

Telemetrie-Erweiterungen in v2.1.214: OTel-Log-Ereignisse enthalten nun die Attribute message.uuid, client_request_id und tool_source, um Nachrichten korrelieren und die Herkunft von Tools nachvollziehen zu können. Die subagentStatusLine-Nutzlast enthält den Reasoning-Aufwand des subagents, sodass benutzerdefinierte Statuszeilen Modell und Aufwand gemeinsam darstellen können. Außerdem konfiguriert die neue Umgebungsvariable CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH die Begrenzung von OTel-Inhaltsattributen auf 60 KB.¹⁹⁰

API- / Modellsteuerung:²⁰⁷

CLAUDE_CODE_EXTRA_BODY='{...}'                # Inject extra body fields into API calls; v2.1.113 fixed 400 errors with output_config.effort on Vertex/subagent calls
CLAUDE_CODE_MAX_CONTEXT_TOKENS=200000         # Override max context tokens (pre-existing var; v2.1.98 fixed handling of DISABLE_COMPACT when both are set)
CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS=25000 # Override default token limit for file read operations (v2.1.0+)
CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK=1   # Do not fall back to non-streaming API on streaming failures (v2.1.83+)
ANTHROPIC_BETAS=beta1,beta2                   # Enable beta API headers; v2.1.78 fixed silent ignore on Haiku models
ANTHROPIC_SMALL_FAST_MODEL=arn:...            # Fast model ID (Bedrock ARN supported; v0.2.125 stopped escaping slashes in ARN)

Plugins / MCP:²⁰⁷

CLAUDE_CODE_PLUGIN_CACHE_DIR=~/.claude/plugins # Plugin cache directory (v2.1.72 fixed literal '~' dir on some shells)
CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE=1 # Preserve plugin marketplace cache when git pull fails (offline-friendly; v2.1.90+)
CLAUDE_CODE_MCP_SERVER_NAME=server1           # Passed to MCP headersHelper scripts so one helper can serve multiple servers (v2.1.85+)
CLAUDE_CODE_MCP_SERVER_URL=https://...        # Passed to MCP headersHelper scripts alongside the name (v2.1.85+)

Shell / IDE:²⁰⁷

CLAUDE_CODE_SHELL_PREFIX="time "              # Wrap every Claude-invoked shell command with a prefix (v1.0.61+)
CLAUDE_CODE_GIT_BASH_PATH=C:\Program\ Files\Git\bin\bash.exe  # Custom Git Bash path on Windows (v2.1.98+)
CLAUDE_CODE_EXIT_AFTER_STOP_DELAY=60000       # SDK: exit after N ms idle (v2.0.35+)
CLAUDE_CODE_AUTO_CONNECT_IDE=false            # Disable IDE auto-connection (v1.0.61+)

Unternehmen / Authentifizierung:²⁰⁷

CLAUDE_CODE_PROXY_RESOLVES_HOSTS=1            # Opt into proxy-side DNS resolution (v2.0.55 moved this from default-on to opt-in)
CLAUDE_CODE_API_KEY_HELPER_TTL_MS=300000      # TTL for dynamically generated API keys via apiKeyHelper (apiKeyHelper refresh added v0.2.74 with 5-min default; env var added v0.2.117)
CLAUDE_CODE_PROCESS_WRAPPER=/path/to/wrapper  # Route all Claude Code self-spawned processes through a wrapper executable; same as the processWrapper setting (v2.1.208+)[^203]

skill-Variablen (v2.1.69+):

${CLAUDE_SKILL_DIR}                            # Self-reference for skills to locate their own directory[^117]

SDK-Aufruferidentität (v2.1.51+):

CLAUDE_CODE_ACCOUNT_UUID=uuid                  # Provide account UUID synchronously for SDK callers
CLAUDE_CODE_USER_EMAIL=user@example.com        # Provide user email for SDK callers
CLAUDE_CODE_ORGANIZATION_UUID=uuid             # Provide organization UUID for SDK callers

Fehlerbehebung:

ANTHROPIC_LOG=debug                             # Enable API request logging

Welches Modell sollte ich wählen?

Die Wahl des richtigen Modells für die jeweilige Aufgabe wirkt sich erheblich auf Kosten und Qualität aus. Claude Code ermöglicht einen flexiblen Modellwechsel auf mehreren Ebenen.

Verfügbare Modelle

Zwei Breaking Changes beim Umstieg eines Harness von Opus 4.8 auf Opus 5:¹⁹⁷

1. Thinking ist standardmäßig aktiviert. Bei Opus 4.8 wurde eine Anfrage ohne thinking-Feld ohne Thinking ausgeführt; bei Opus 5 wird dieselbe Anfrage mit adaptivem Thinking ausgeführt. max_tokens bleibt eine feste Obergrenze für die gesamte Ausgabe — Thinking plus Antworttext. Prüfen Sie daher bei allen Workloads, die bisher ohne Thinking ausgeführt wurden, den verfügbaren Spielraum erneut. Übergeben Sie thinking: {type: "disabled"}, um das bisherige Verhalten wiederherzustellen; beachten Sie dabei den nächsten Punkt.
2. Bei deaktiviertem Thinking ist der Aufwand auf high begrenzt. Die Kombination aus thinking: {type: "disabled"} und dem Aufwand xhigh oder max führt zu einem 400-Fehler. Die Prüfung erfolgt für jede Anfrage einzeln — wird der Aufwand bei deaktiviertem Thinking auf xhigh erhöht, wird die Anfrage selbst dann abgelehnt, wenn frühere Nachrichten derselben Unterhaltung akzeptiert wurden.

Speziell in Claude Code gilt: effort ist bei Opus 5 standardmäßig auf high gesetzt (wie auch bei der Claude API), und die vollständige Abstufung steht zur Verfügung — low, medium, high, xhigh, max. Anthropic empfiehlt in den eigenen Migrationshinweisen, den Aufwand max zu testen, wenn die Leistungsfähigkeit wichtiger als der Token-Verbrauch ist. Der Fast Mode deckt Opus 5 zu $10/$50 pro MTok ab (siehe Fast Mode).¹⁹⁷¹⁹⁸

Claude Fable 5 (9. Juni 2026): Eine neue Modellklasse über Opus — das leistungsstärkste und intelligenteste Modell von Anthropic, das bei nahezu jedem getesteten Benchmark dem aktuellen Stand der Technik entspricht und darauf ausgelegt ist, über Millionen von Kontext-Tokens hinweg kohärent zu bleiben. Fable 5 ist das für den allgemeinen Einsatz abgesicherte Frontier-Modell der „Mythos-Klasse“: Es enthält Sicherheitsklassifikatoren, die bei Anfragen zu Cyber-, Biochemie- und Modelldestillationsthemen auf Opus 4.8 zurückfallen (Claude Mythos 5 ist dasselbe Modell ohne diese Schutzmechanismen für autorisierte Forscher). Mit v2.1.170 (9. Juni 2026) wurde es in Claude Code auswählbar — führen Sie claude update und anschließend /model fable aus (der kurze Alias; auch /model claude-fable-5 und der Alias best wählen es aus) — und wird bis zum 22. Juni 2026 schrittweise für Abonnementtarife eingeführt. Modell-ID: claude-fable-5. Fable 5 enthält standardmäßig ein 1M-Kontextfenster, sodass das Suffix [1m] nicht erforderlich ist — und seit v2.1.173 (11. Juni 2026) wird der Modellname claude-fable-5[1m] automatisch zu claude-fable-5 normalisiert beziehungsweise das Suffix entfernt (es war nur bei Opus/Sonnet relevant, wo 1M erst durch [1m] freigeschaltet wird); maximal 128K Ausgabe. Der Preis beträgt $10/MTok für Eingaben und $50/MTok für Ausgaben — ungefähr das Doppelte von Opus 4.8. Setzen Sie es daher nur für wirklich anspruchsvolle Schlussfolgerungen ein, nicht für Routineänderungen. Es verwendet dieselbe Anfrageoberfläche wie Opus 4.8 (ausschließlich adaptives Thinking; temperature/top_p/top_k und budget_tokens wurden entfernt), jedoch mit einer neuen Besonderheit: Ein explizites thinking: {type: "disabled"} führt zu einem 400-Fehler. Lassen Sie den Parameter thinking vollständig weg, um die Anfrage ohne Thinking auszuführen.²⁰⁰

Speziell in Claude Code gilt: Fable 5 unterstützt genau wie Opus 5 die vollständige Aufwandsskala (low/medium/high/xhigh/max, standardmäßig high). Thinking kann bei Fable 5 nicht deaktiviert werden — der Thinking-Umschalter der Sitzung, die Einstellung alwaysThinkingEnabled und MAX_THINKING_TOKENS=0 bleiben allesamt wirkungslos; das Modell führt stets adaptives Reasoning aus. Eine vollständige Konfigurationsoberfläche für die fable-Familie entspricht den Opus-Optionen: ANTHROPIC_DEFAULT_FABLE_MODEL legt das Modell fest, auf das der Alias fable verweist (nützlich bei Bedrock/Vertex/Foundry), DISABLE_PROMPT_CACHING_FABLE nimmt Fable vom Prompt-Caching aus, und auf den Enterprise-Gateways erfolgt ein automatischer, inhaltsbasierter Fallback. /model opus wählt jetzt Opus 5 aus (standardmäßig mit hohem Aufwand, /effort xhigh für die anspruchsvollsten Aufgaben), und Sonnet 5 ist seit v2.1.197 die sofort einsatzbereite Standardeinstellung; wählen Sie Fable 5 gezielt über /model fable, wenn Sie die absolut höchste Leistungsfähigkeit benötigen.²⁰⁰¹⁹⁷

Opus 4.7 (16. April 2026): Das Spitzenmodell der vorherigen Generation ist weiterhin vollständig verfügbar. 1M-Token-Kontextfenster zum Standardpreis — kein Aufpreis für langen Kontext. Maximal 128K Ausgabe, ausschließlich adaptives Thinking (erweitertes Thinking wurde entfernt) sowie die neue Aufwandsstufe xhigh, die als Ausgangspunkt für Programmier- und agentische Workloads empfohlen wird.¹⁴⁵ Verlässlicher Wissensstichtag: Januar 2026. Stichtag der Trainingsdaten: Januar 2026. Modell-ID: claude-opus-4-7. Die Preise entsprechen mit $5/$25 pro MTok denen von Opus 4.6; hinzu kommen $6.25 für das Schreiben eines 5-Minuten-Caches, $10 für das Schreiben eines 1-Stunden-Caches und $0.50 pro MTok für Cache-Lesevorgänge.¹⁴⁴ Opus 4.7 löst auf SWE-Bench dreimal so viele Produktionsaufgaben wie Opus 4.6, erreicht 70 % auf CursorBench (gegenüber 58 % bei 4.6) und steigert die Lösungsquote im internen Programmierbenchmark von Anthropic mit 93 Aufgaben um 13 %.¹⁴⁴ Es verwendet einen neuen Tokenizer — rechnen Sie für denselben Text mit ungefähr 1- bis 1,35-mal so vielen Tokens und erhöhen Sie den Spielraum bei max_tokens sowie die Schwellenwerte für die Komprimierung.¹⁴⁵ Vision unterstützt Bilder mit bis zu 2.576 px beziehungsweise 3,75 MP und 1:1-Pixelkoordinaten.¹⁴⁵

Programmierbenchmarks von Opus 4.7 (April 2026):¹⁵¹

Standardmodell nach Tarif (Claude Code):¹⁴⁷

Breaking Changes in der Messages API bei Opus 4.7 (für Aufrufer sichtbar):¹⁴⁵ - Extended Thinking budget_tokens wurde entfernt. Verwenden Sie stattdessen thinking: {type: "adaptive"}. Adaptive Thinking ist standardmäßig deaktiviert; Anfragen ohne thinking-Feld werden ohne Thinking ausgeführt. - Wenn Sie temperature, top_p oder top_k auf einen vom Standard abweichenden Wert setzen, wird HTTP 400 zurückgegeben. Lassen Sie diese Parameter weg und steuern Sie das Modell über den Prompt. - Thinking-Inhalte werden standardmäßig nicht in Antworten ausgegeben. Setzen Sie thinking.display: "summarized", um sichtbare Schlussfolgerungen wiederherzustellen (erforderlich, wenn Ihr Produkt Thinking an Benutzer streamt).

Mit Task-Budgets (Beta-Header task-budgets-2026-03-13) können Sie dem Modell über output_config.task_budget ein Token-Ziel für einen vollständigen agentischen Durchlauf vorgeben; das Minimum beträgt 20K Token.¹⁴⁵

Opus 4.6 (Legacy): Weiterhin unter claude-opus-4-6 mit 1M Kontext und einer maximalen Ausgabe von 128K verfügbar. Für besseres agentisches Coding sollten Sie eine Migration zu Opus 4.7 erwägen. Opus 4.6 erschien ursprünglich am 5. Februar 2026.⁷⁹¹⁴⁴ Seit v2.1.117 (22. April 2026) verwenden Pro- und Max-Abonnenten bei Opus 4.6 und Sonnet 4.6 standardmäßig den Effort high (zuvor medium); Opus 4.7 bleibt auf xhigh. Diese Änderung stellte die Leistungsfähigkeit nach der im Postmortem vom 23. April dokumentierten Effort-Abstufung vom 4. März bis zum 7. April wieder her.¹⁵²¹⁵³

Sonnet 5 (30. Juni 2026): Die aktuelle Sonnet-Stufe, positioniert als „beste Kombination aus Geschwindigkeit und Intelligenz“. Laut Anthropic liegt seine Leistung nahe an Opus 4.8, allerdings zu niedrigeren Preisen. Gegenüber Sonnet 4.6 stellt es bei agentischem Schlussfolgern, Tool-Nutzung, Coding und Wissensarbeit eine deutliche Verbesserung dar. Zugleich weist es insgesamt weniger unerwünschte Verhaltensweisen und wesentlich schwächere Fähigkeiten im Bereich Cybersicherheit als die Opus-Modelle auf – jener Sicherheitskompromiss, durch den es ohne Exportkontrollsperren veröffentlicht werden konnte. Modell-ID: claude-sonnet-5 (datumsunabhängiger, fixierter Snapshot). 1M-Token-Kontextfenster, maximale Ausgabe von 128K (bis zu 300K über die Batches API mit dem Beta-Header output-300k-2026-03-24), ausschließlich Adaptive Thinking. Verlässlicher Wissensstichtag: Januar 2026. Preis: $3/$15 pro MTok Eingabe/Ausgabe, mit Einführungspreisen von $2/$10 bis zum 31. August 2026 – rund 40 % weniger als die $5/$25 von Opus 4.8. In Claude Code ist der Parameter effort bei Sonnet 5 standardmäßig auf high gesetzt (legen Sie ihn ausdrücklich fest, um dies zu ändern). Wählen Sie das Modell mit /model sonnet (oder /model claude-sonnet-5) aus.¹⁸⁰ Seit v2.1.197 (30. Juni 2026) ist Sonnet 5 in Claude Code das Standardmodell für neue Sitzungen und ersetzt Opus 4.8 als sofort einsatzbereite Vorauswahl; Opus bleibt weiterhin uneingeschränkt auswählbar.¹⁸¹

Sonnet 4.6 (17. Februar 2026, inzwischen durch Sonnet 5 abgelöst): Ausgewogenes Modell; ersetzte Sonnet 4.5 als Standard in claude.ai und Claude Cowork.⁹³ Gleicher Preis wie Sonnet 4.5 ($3/$15 pro MTok). Verbesserte agentische Suchleistung bei geringerem Token-Verbrauch. Unterstützt Extended Thinking, Adaptive Thinking und ein 1M-Token-Kontextfenster (Beta). Maximale Ausgabe von 64K (Obergrenze von 128K in v2.1.77).¹¹⁹ Wissensstichtag: August 2025 (verlässlich), Januar 2026 (Trainingsdaten). Modell-ID: claude-sonnet-4-6.

Claude Mythos Preview (7. April 2026): Ein Frontier-Modell als Forschungsvorschau für defensive Cybersicherheitsarbeit, angeboten im Rahmen von Project Glasswing.¹³⁹ Nur auf Einladung und nicht allgemein verfügbar. Anthropic beschreibt Opus 4.7 in Cyberdimensionen bewusst als weniger leistungsfähig als Mythos – ein Sicherheitskompromiss – und hat unter https://claude.com/form/cyber-use-case ein Cyber Verification Program für seriöse Sicherheitsforscher eingerichtet, die erweiterten Zugriff benötigen.¹⁴⁶

Warum diese Preisunterschiede wichtig sind: Eine typische Coding-Sitzung verbraucht 50K–200K Eingabe-Token und 10K–50K Ausgabe-Token. Mit Haiku kostet das $0.10–$0.45 pro Sitzung. Mit Opus kostet dieselbe Sitzung $0.50–$2.25 und damit das Fünffache. Setzen Sie Opus nur für wirklich schwierige Probleme ein.¹

Wann Sie welches Modell verwenden sollten

Haiku: Verwenden Sie es für subagents, die Erkundungen, einfache Dateisuchen oder schnelle Fragen bearbeiten. Es ist etwa fünfmal günstiger als Opus und antwortet schneller. Ideal für Hintergrundaufgaben, die kein tiefgehendes Schlussfolgern erfordern.

Sonnet: Das Arbeitspferd für die tägliche Entwicklung, wenn die Kosten eine Rolle spielen. Bewältigt die meisten Coding-Aufgaben: Funktionen implementieren, Fehler beheben, Tests schreiben und Code-Reviews durchführen. Sonnet 4.6 bietet gegenüber Sonnet 4.5 eine verbesserte agentische Suche und höhere Token-Effizienz sowie Unterstützung für Adaptive Thinking und ein 1M-Kontextfenster zum Standardpreis.⁹³ Seit Opus 4.7 (16. April 2026) verwendet Claude Code Opus nur bei Max- und Team-Premium-Tarifen als Standard; bei Pro, Team Standard, Enterprise und API bleibt Sonnet 4.6 das Standardmodell, bis Enterprise und API am 23. April 2026 auf Opus 4.7 umgestellt werden.¹⁴⁷ Nutzen Sie Sonnet, wenn Sie günstigere Token, geringere Latenz oder eine wirtschaftlichere Nutzung von subagents benötigen.

Opus: Seit dem 16. April 2026 die Flaggschiff-Stufe und das Standardmodell bei Max- und Team-Premium-Tarifen.¹⁴⁴¹⁴⁷ Setzen Sie die kostspieligere Schlussfolgerungsleistung dort ein, wo sie sich auszahlt: bei Architekturentscheidungen, anspruchsvoller Fehlerdiagnose, dem Verständnis komplexer Systeme, Sicherheitsanalysen und langfristiger agentischer Arbeit. Opus 4.7 löst auf SWE-Bench dreimal so viele Produktionsaufgaben wie Opus 4.6, erreicht 70 % auf CursorBench (gegenüber 58 %) und steigert die Lösungsquote in einem internen Coding-Benchmark mit 93 Aufgaben um 13 %.¹⁴⁴ Claude Code verwendet bei Opus 4.7 standardmäßig den Effort xhigh, der sich über /effort anpassen lässt (ab v2.1.111).¹⁴⁶¹⁴⁷ Auto Mode ist für Max-Abonnenten bei Opus 4.7 über die Anthropic API verfügbar, ohne dass --enable-auto-mode erforderlich ist; bei anderen Tarifen und Anbietern hängt die Verfügbarkeit vom jeweiligen Tarif und von administrativen Einstellungen ab.¹⁴⁶ 1M Kontext zum Standardpreis – ohne Langkontextaufschlag. Wissenswerte Verhaltensänderungen: Opus 4.7 befolgt Anweisungen wörtlicher, passt die Antwortlänge an die Komplexität der Aufgabe an, führt standardmäßig weniger subagents aus und verwendet einen direkteren Ton mit weniger bestätigungsorientierten Formulierungen. Falls Ihre Prompts Hilfskonstruktionen enthalten, die Zwischenmeldungen zum Fortschritt oder zusätzliche Überprüfungen erzwingen, versuchen Sie, diese zu entfernen.¹⁴⁵

Opusplan: Ein Hybridmodus, der Opus für die Planung nutzt, bei der die Qualität des Schlussfolgerns am wichtigsten ist, und Sonnet für die Ausführung, bei der Geschwindigkeit zählt. Hervorragend für komplexe Refactorings, wenn Sie den bestmöglichen Plan wünschen, aber nicht für jede einzelne Änderung Schlussfolgerungsleistung auf Opus-Niveau benötigen.

Modelle wechseln

Während einer Sitzung:

> /model opus
> /model sonnet
> /model haiku

Beim Start:

claude --model opus

Über die Umgebung:

export ANTHROPIC_MODEL=opus

In settings.json:

{
  "model": "claude-sonnet-4-5-20250929"
}

Speziell für subagents:

export CLAUDE_CODE_SUBAGENT_MODEL=haiku

Fallback-Modellkette (ab v2.1.166): Mit der Einstellung fallbackModel lassen sich bis zu drei Fallback-Modelle konfigurieren, die der Reihe nach ausprobiert werden, wenn das primäre Modell überlastet oder nicht verfügbar ist. Das Flag --fallback-model (zuvor nur für einen Wechsel während einer Sitzung vorgesehen) gilt nun bereits ab dem Start auch für interaktive Sitzungen.²⁰²

{
  "model": "claude-opus-4-8",
  "fallbackModel": ["claude-sonnet-4-6", "claude-haiku-4-5"]
}

Wenn die API einen unerwarteten, nicht wiederholbaren Fehler zurückgibt, wiederholt Claude Code den Durchlauf nun außerdem einmal mit dem Fallback-Modell, bevor der Fehler angezeigt wird. So wird ein vorübergehendes Problem des primären Modells kontrolliert abgefangen, statt den Durchlauf abzubrechen.²⁰²

Seit v2.1.178 berücksichtigt auch die Kompaktierung die Fallback-Kette: Ist das primäre Modell während der Kompaktierung überlastet oder nicht verfügbar, greift der Kompaktierungsschritt auf die konfigurierte Kette aus fallbackModel/--fallback-model zurück, statt den Durchlauf abzubrechen. Bei einem langen autonomen Lauf schließt dies die Lücke, durch die eine ansonsten wiederherstellbare Kompaktierung die Sitzung bei einem vorübergehenden Modellfehler beenden konnte.¹⁷³

Erweiterter Kontext

Aktivieren Sie für große Codebasen oder lange Sitzungen den 1M-Token-Kontext:

claude --model sonnet[1m]
claude --model opus[1m]           # Opus 4.7 with 1M context

Oder innerhalb einer Sitzung:

> /model sonnet[1m]
> /model opus[1m]

Opus 4.7, Opus 4.6 und Sonnet 4.6 enthalten alle das vollständige 1M-Token-Kontextfenster zum Standardpreis – ohne Langkontextaufschlag.¹⁴⁸ Eine Anfrage mit 900K Token wird zum gleichen Preis pro Token abgerechnet wie eine Anfrage mit 9K Token. Rabatte für Prompt-Caching und Batch-Verarbeitung gelten zu den Standardtarifen für das gesamte Kontextfenster.

Bei Max-, Team- und Enterprise-Abonnements ist Opus mit 1M Kontext automatisch enthalten – das Suffix [1m] ist nicht erforderlich (seit v2.1.75 vom 13. März 2026 standardmäßig aktiviert).¹¹⁷¹⁴⁷ Bei Pro ist der 1M-Kontext über zusätzliche Nutzung zugänglich. Benutzer von API und nutzungsbasierter Abrechnung haben zum standardmäßigen Token-Preis vollständigen Zugriff auf 1M Kontext.¹⁴⁷

Um 1M-Kontextvarianten in der Modellauswahl zu deaktivieren, setzen Sie CLAUDE_CODE_DISABLE_1M_CONTEXT=1.

Aktuelles Modell prüfen

> /status

Der Befehl zeigt das aktuelle Modell, Kontoinformationen, angewendete Einstellungen und weitere Sitzungsdaten an. Bezeichnungen in der Modellauswahl (v2.1.51+): Die /model-Auswahl zeigt für angeheftete Versionen jetzt verständliche Bezeichnungen (z. B. „Sonnet 4.6“) anstelle der internen Modell-IDs sowie Upgrade-Hinweise, wenn neuere Versionen verfügbar sind.⁹⁸ v2.1.219 korrigiert die Darstellung der zusammengeführten Opus-Zeile als schlichtes „Opus“ statt „Opus (1M context)“ und beschränkt die Hervorhebung einer Neuerscheinung auf den Namen des neuesten Modells. Damit kennzeichnet die Hervorhebung die tatsächlich veröffentlichte Neuerung und nicht einen willkürlichen Ausschnitt der Liste.¹⁹⁶

Fast Mode (v2.1.36+)

Fast Mode liefert deutlich schneller Ausgaben vom selben Modell; es wird nicht zu einem günstigeren Modell gewechselt. Während einer Sitzung können Sie den Modus mit /fast umschalten.⁸⁶

> /fast            # Toggle fast mode on/off

Unterstützte Modelle (Stand v2.1.219): Fast Mode gilt für Claude Opus 5 und Claude Opus 4.8. Mit v2.1.219 wurde Opus 4.7 aus Fast Mode entfernt; für Sonnet, Haiku oder Fable war die Funktion nie verfügbar. Sie bleibt eine Forschungsvorschau, die ausschließlich über die Claude API (einschließlich Claude Managed Agents) verfügbar ist – nicht über Amazon Bedrock, Google Cloud, Microsoft Foundry oder Claude Platform on AWS. Der Zugriff ist beschränkt: Wenden Sie sich an Ihren Account Manager oder tragen Sie sich in die Warteliste ein.¹⁹⁶¹⁹⁸

Preise (Fast Mode für Opus 5 / Opus 4.8):¹⁹⁸

Die Opus-4.7-Falle (v2.1.219). Nicht unterstützte Modelle verhalten sich unterschiedlich. Eine Anfrage an claude-opus-4-7 mit speed: "fast" gibt jetzt einen Fehler zurück – sie wechselt nicht stillschweigend zur Standardgeschwindigkeit. Opus 4.6 bildet die Ausnahme, derentwegen Sie diesen Unterschied kennen sollten: Das Modell akzeptiert speed: "fast", läuft dennoch mit Standardgeschwindigkeit, wird zu Standardtarifen abgerechnet und meldet usage.speed: "standard". Wenn Ihr Harness auf 4.7 festgelegt war und darauf vertraute, dass Fast-Mode-Anfragen stillschweigend auf die Standardgeschwindigkeit zurückfallen, schlagen sie nun vollständig fehl; stellen Sie die angeheftete Version auf Opus 5 oder 4.8 um.¹⁹⁸

Wann Sie Fast Mode verwenden sollten: - Bei schnellen Iterationen an kleinen Änderungen, wenn die Latenz den Engpass darstellt - Beim Erzeugen von Tests, Boilerplate oder repetitivem Code, wenn Geschwindigkeit wichtiger als Kosten ist - Beim sequenziellen Abarbeiten einer Liste ähnlicher Aufgaben

Wann Sie Fast Mode NICHT verwenden sollten: - Bei lang laufenden agentenbasierten Aufgaben (die Kosten verdoppeln sich weiterhin über den gesamten Lauf) - Bei der Arbeit von subagents im Hintergrund (niemand wartet auf die Ausgabe) - Bei Sitzungen mit knappem Budget

Fast Mode umfasst das vollständige 1M-Kontextfenster (v2.1.50+). Für den gesamten Kontext gilt ein einheitlicher Multiplikator, auch bei Anfragen mit mehr als 200K Eingabetoken – ohne zusätzlichen Aufpreis für lange Kontexte. Dieser Multiplikator kommt zusätzlich zu den Multiplikatoren für Prompt-Caching und Datenresidenz hinzu.⁹⁶¹⁹⁸

Betriebshinweise. Fast Mode hat ein eigenes, von den standardmäßigen Opus-Limits getrenntes Ratenlimit. Wird es überschritten, erhalten Sie eine 429-Antwort mit retry-after (die Antwortheader anthropic-fast-*-tokens-* geben die verbleibende Kapazität an). Ein Wechsel zwischen Fast Mode und Standardmodus macht den Prompt-Cache ungültig – Anfragen mit unterschiedlichen Geschwindigkeiten teilen keine zwischengespeicherten Präfixe. Wenn Sie /fast während einer Sitzung umschalten, führt dies daher zu einem Cache-Fehlschlag. Fast Mode ist weder mit der Batch API noch mit einer Priority-Tier-Zusage verfügbar.¹⁹⁸

Expertentipp: Fast Mode lässt sich nicht mit opusplan kombinieren (opusplan verwendet bereits eine Mischung aus Opus und Sonnet; Fast Mode wirkt sich nur auf den Opus-Abschnitt aus). Verwenden Sie ihn, wenn die Latenz wichtiger als die Kosten ist, und deaktivieren Sie ihn für autonome oder Batch-Aufgaben. /fast erfordert zusätzliche Nutzungskapazität; Team-/Enterprise-Administratoren müssen die Funktion gegebenenfalls zuerst aktivieren (Korrektur in v2.1.37). Mit CLAUDE_CODE_DISABLE_FAST_MODE=1 können Sie sie vollständig deaktivieren. Seit v2.1.218 weist Claude Code darauf hin, wenn ein Modellwechsel über /config model=<x> oder Remote Control den Fast-Mode-Status ändert. In v2.1.219 wurde zudem behoben, dass Remote-Control-Clients nach einem Wechsel, einer erneuten Verbindung oder einer fehlgeschlagenen Organisationsprüfung einen veralteten Fast-Mode-Status beibehielten.^86149195196

Effort Control (v2.1.111+, Opus 4.7)

Opus 4.7 führt eine neue Effort-Einstellung ein, mit der Sie das Verhältnis zwischen Geschwindigkeit und Intelligenz abstimmen können. Verwenden Sie während einer Sitzung /effort:

> /effort              # opens an interactive slider (arrow keys + Enter)
> /effort xhigh        # set directly

Auto Mode für Max (v2.1.111+)

Auto Mode – ein sichererer Ersatz für --dangerously-skip-permissions – steht Max-Abonnenten mit Opus 4.7 über die Anthropic API ohne --enable-auto-mode zur Verfügung.¹⁴⁶ Vor jeder Ausführung prüft ein Sonnet-4.6-Klassifikator, ob die jeweilige Aktion der Absicht entspricht und sicher ist. Hinweis (v2.1.111+): Das Flag --enable-auto-mode wurde entfernt; starten Sie eine Sitzung stattdessen mit --permission-mode auto im Auto Mode. Auto Mode ist für Pro nicht verfügbar; laut der Dokumentation zu Berechtigungsmodi von Anthropic ist er über die Anthropic API standardmäßig direkt verfügbar. Bedrock/Vertex/Foundry (v2.1.158+): Für Opus 4.7 und Opus 4.8 wurde Auto Mode auf diesen Gateways mit CLAUDE_CODE_ENABLE_AUTO_MODE=1 als Opt-in verfügbar.²⁰⁵ Seit v2.1.207 ist dieses Opt-in nicht mehr erforderlich: Auto Mode funktioniert auf AWS Bedrock, Google Vertex AI und Microsoft Foundry ohne CLAUDE_CODE_ENABLE_AUTO_MODE. Administratoren, die ihn deaktivieren möchten, verwenden dafür die verwaltete Einstellung disableAutoMode. Mit derselben Version verwenden Bedrock, Vertex AI und Claude Platform on AWS standardmäßig Claude Opus 4.8. Außerdem wird die Einstellung autoMode nicht mehr aus .claude/settings.local.json eines Repositorys gelesen – konfigurieren Sie Auto-Mode-Regeln stattdessen in ~/.claude/settings.json.¹⁸⁵

Benutzerdefinierte Regeln, ohne die Standardregeln zu verlieren (v2.1.118+). In früheren Versionen galt für autoMode.allow, autoMode.soft_deny und autoMode.environment ein Entweder-oder-Prinzip: Wenn Sie eine eigene Liste definierten, gingen die integrierten Sicherheitsregeln verloren. Der Sentinel $defaults löst dieses Problem – er wird genau an der von Ihnen angegebenen Position inline zur integrierten Liste erweitert, sodass Sie Ihre eigenen Regeln davor und danach anordnen können:¹⁵²

// .claude/settings.json
{
  "autoMode": {
    "allow": [
      "Bash(npm test:*)",        // your additions, prepended
      "$defaults",                // built-in allow list inserted here
      "Bash(git push:origin/feature/*)"  // appended after
    ]
  }
}

Opt-in für „Nicht erneut fragen“ (v2.1.118+). Die Opt-in-Abfrage für Auto Mode bietet jetzt die Option „Nicht erneut fragen“. Bei häufiger Nutzung können Sie den Erklärungshinweis damit unterdrücken, ohne ein Flag skripten zu müssen.¹⁵²

Schutzmechanismen für destruktive Befehle (v2.1.183). Auto Mode blockiert nun eine Reihe irreversibler Befehle vollständig, sofern Sie diese in der Sitzung nicht ausdrücklich angefordert haben: destruktive Git-Operationen (git reset --hard, git checkout -- ., git clean -fd, git stash drop), wenn Sie nicht darum gebeten haben, lokale Änderungen zu verwerfen; git commit --amend, wenn der Commit in dieser Sitzung nicht vom Agenten erstellt wurde; sowie den Abbau von Infrastruktur (terraform destroy, pulumi destroy, cdk destroy), sofern Sie nicht den konkreten Stack genannt haben. Dadurch wird der Wirkungsbereich des Klassifikators gezielt bei Operationen eingeschränkt, die unbemerkt Arbeit vernichten oder Umgebungen abbauen können. Der Agent kann sie weiterhin ausführen, allerdings nur auf Ihre ausdrückliche Anweisung und nicht aus eigener Initiative.¹⁷⁴

Jeden Shell-Befehl klassifizieren (v2.1.193). Standardmäßig prüft der Auto-Mode-Klassifikator nur Shell-Befehle, die Mustern für die Ausführung beliebigen Codes entsprechen; Routinebefehle überspringen diese Prüfung. Mit der neuen Einstellung autoMode.classifyAllShell werden stattdessen alle Bash-/PowerShell-Befehle durch den Klassifikator geleitet. Dadurch entsteht eine geringfügige zusätzliche Latenz, dafür erhalten Sie ein engeres Sicherheitsnetz, wenn jeder Shell-Aufruf geprüft werden soll. Dieselbe Version zeigt außerdem Gründe für Ablehnungen durch Auto Mode im Transkript, in der Ablehnungsbenachrichtigung und unter den letzten Ablehnungen in /permissions an. Bei einem blockierten Befehl wird nun also erklärt, warum er blockiert wurde.¹⁷⁹ Drei weitere Härtungsregeln (v2.1.205). Der Auto-Modus verhindert jetzt Manipulationen an Sitzungstranskriptdateien – selbst der Audit-Trail ist für den Agenten tabu. Außerdem fragt er nach, bevor er rm -rf mit einer Variablen ausführt, die sich aus dem Kontext nicht auflösen lässt. Damit wird die Klasse von Unfällen mit rm -rf $DIR und unbekanntem $DIR verhindert. Benachrichtigungen zu Hintergrundaufgaben weisen nun ausdrücklich darauf hin, dass keine menschliche Eingabe erfolgt ist. So kann eine erfundene Zeile wie „Benutzer hat zugestimmt“ innerhalb eines Transkripts nicht als tatsächlich erteilte Genehmigung ausgegeben und anschließend umgesetzt werden.¹⁸³ Die dritte Regel ist ein Schutz vor Prompt-Injection, den Sie verinnerlichen sollten: Eine Genehmigung muss über den Genehmigungskanal eingehen, und der Harness macht diese Voraussetzung jetzt ausdrücklich deutlich.

Befehlssubstitutionen können keine Katastrophe verbergen (v2.1.208). Bei katastrophalen Löschvorgängen wie rm -rf ~ wird nun auch dann nachgefragt, wenn sie in $(...), Backticks oder einer Prozesssubstitution (<(...)) verborgen sind – und die Abfrage erfolgt sogar im --dangerously-skip-permissions- und Auto-Modus. Ein destruktiver Befehl lässt sich nicht mehr durch das Einbetten in eine Substitution am Sicherheitsnetz vorbeischmuggeln.¹⁸⁶

Status des Auto-Modus zurücksetzen: claude auto-mode reset (v2.1.212). Mit einem neuen Unterbefehl können Sie den Status Ihres Auto-Modus über das Terminal zurücksetzen. Übergeben Sie --yes, um die Bestätigungsabfrage zu überspringen:¹⁸⁹

claude auto-mode reset          # Confirmation prompt
claude auto-mode reset --yes    # Skip confirmation (scripts)

Weniger Dialoge bei gleicher Prüfungstiefe (v2.1.218). Drei Prüfungen, die den Auto-Modus bisher mit einem Berechtigungsdialog unterbrochen haben – gefährliches rm, Hintergrundausführung mit & und verdächtige Windows-Pfade –, tun dies nicht mehr. Stattdessen entscheidet der Klassifikator des Auto-Modus, sodass die Sicherheitsprüfung weiterhin stattfindet, ohne Sie bei jedem Treffer einzubeziehen. Dieselbe Version erweitert dieses Verhalten auf den Planmodus mit Auto: Bash-Befehle, deren ausschließlichen Lesezugriff der statische Analysator nicht nachweisen kann, lösen keine Abfrage mehr aus. Anstatt auf einen Dialog zurückzufallen, überlässt das System die Beurteilung dem Klassifikator.¹⁹⁵

Neue Befehle in v2.1.105–v2.1.114¹⁴⁶¹⁵⁰

Push-Benachrichtigungen (v2.1.110+)

Wenn Remote Control mit aktivierter Option „Push, wenn Claude entscheidet“ konfiguriert ist, kann Claude jetzt nach eigenem Ermessen über ein neues Push-Benachrichtigungstool mobile Push-Benachrichtigungen senden. Dies ergänzt die vorhandene Remote-Control-Oberfläche für Mobilgeräte und das Web.¹⁴⁶ /context, /exit und /reload-plugins funktionieren nun ebenfalls in Remote-Control-Clients.

Windows-PowerShell-Tool (v2.1.111+, Einführung)

Claude Code führt schrittweise ein natives Windows-PowerShell-Tool ein. Unter Linux/macOS aktivieren Sie es mit CLAUDE_CODE_USE_POWERSHELL_TOOL=1 (erfordert pwsh in PATH). Unter Windows steuert dieselbe Variable während der Einführung die Aktivierung beziehungsweise Deaktivierung.¹⁴⁶

Automatische Genehmigung im Berechtigungsmodus (v2.1.119+). Befehle des PowerShell-Tools können im Berechtigungsmodus nun ebenso automatisch genehmigt werden wie Bash-Befehle. Zulassungsregeln wie PowerShell(Get-*:*) sowie die vorhandene Mustersyntax umgehen bei schreibgeschützten Vorgängen jetzt die Abfrage. Damit entspricht die Bedienung für Administratoren dem Komfort, den Teams bereits unter Linux/macOS erhalten.¹⁵²

Weniger Berechtigungsabfragen: schreibgeschütztes Bash (v2.1.111+)

Schreibgeschützte Bash-Muster mit Glob-Argumenten (z. B. ls *.ts, cat src/*.md) sowie Befehle, die mit cd <project-dir> && beginnen, lösen keine Berechtigungsabfrage mehr aus.¹⁴⁶ In Kombination mit /less-permission-prompts sind im Arbeitsalltag deutlich weniger Unterbrechungen zu erwarten.

Verteiltes Tracing (v2.1.110+)

SDK und Headless-Sitzungen lesen nun TRACEPARENT und TRACESTATE aus der Umgebung, wodurch Claude Code-Ausführungen mit verteilten Traces verknüpft werden. Verwenden Sie zusätzlich OTEL_LOG_RAW_API_BODIES=1 (v2.1.111+), um für das Debugging vollständige API-Anfrage- und Antwortinhalte als OpenTelemetry-Protokollereignisse auszugeben.¹⁴⁶

Native Binärdistribution (v2.1.113+)¹⁵⁰

v2.1.113 ändert, wie CLI gestartet wird: claude startet nun über eine optionale, plattformspezifische Abhängigkeit eine native Claude Code-Binärdatei, anstatt das gebündelte JavaScript auszuführen. Die Installations- und Aktualisierungsbefehle bleiben unverändert, und Teams müssen ihre Einführungsskripte nicht anpassen.

Tastenkürzel des Prompt-Editors (v2.1.113+)¹⁵⁰

Der Prompt-Editor erhält eine Navigation im Readline-Stil für mehrzeilige Eingaben sowie das Scrollen des Ansichtsbereichs im Vollbildmodus:

Zeitüberschreitung bei blockierten subagents (v2.1.113+)¹⁵⁰

subagents, deren Ausführung mitten im Stream ins Stocken gerät, schlagen nun nach 10 Minuten mit einer eindeutigen Fehlermeldung fehl, anstatt lautlos zu hängen. Verwenden Sie zusätzlich CLAUDE_STREAM_IDLE_TIMEOUT_MS (v2.1.84+), um festgefahrene Prozesse bei streamenden APIs umfassender abzudecken.

Stabilitätskorrektur in v2.1.114¹⁵⁰

v2.1.114 (18. April 2026) enthält eine einzelne Korrektur: Der Berechtigungsdialog konnte abstürzen, wenn ein Teammitglied aus Agent Teams eine Tool-Berechtigung anforderte. Führen Sie ein Upgrade durch, wenn Sie Agent Teams verwenden.

Was kostet Claude Code?

Für die nachhaltige Nutzung von Claude Code ist es unerlässlich, die Kosten zu verstehen und zu kontrollieren. Informationen zu den Modellfunktionen finden Sie außerdem unter Modellauswahl und zur Wahl des passenden Modells für die jeweilige Aufgabe unter Entscheidungsrahmen.

Kosten anzeigen

> /cost

Ausgabe:

Total cost:            $0.55
Total duration (API):  6m 19.7s
Total duration (wall): 6h 33m 10.2s
Total code changes:    247 lines added, 89 lines removed

Abonnementbenutzer sehen unter /cost eine Aufschlüsselung nach Modell und Cache-Treffern. Daraus geht genau hervor, welche Modelle Tokens verbraucht haben und wie viel aus dem Cache bereitgestellt wurde (ab v2.1.92).¹³⁷

Abonnementpläne

Ratenbegrenzungen (August 2025): Anthropic führte wöchentliche Ratenbegrenzungen für zahlende Abonnenten ein. Max-Abonnenten können über die Ratenbegrenzung hinaus zusätzliche Nutzung zu den regulären API-Tarifen erwerben.¹⁴

Verdopplung der Ratenbegrenzungen (6. Mai 2026): Während der Veranstaltung Code with Claude SF verdoppelte Anthropic die fünfstündigen Ratenbegrenzungen von Claude Code für Pro-, Max-, Team- und platzbasierte Enterprise-Pläne, hob die Reduzierung zu Spitzenzeiten für Pro- und Max-Konten auf und erhöhte die API-Ratenbegrenzungen für Claude-Opus-Modelle „beträchtlich“. Als Kapazitätsreserve dient die Vereinbarung für SpaceX Colossus 1: „mehr als 300 Megawatt neue Kapazität (über 220.000 NVIDIA GPUs) innerhalb eines Monats“.¹⁵⁷

API-Tokenpreise (April 2026)¹¹⁴⁴

Für Benutzer mit API-Abrechnung gelten folgende Preise je Million Tokens:

Preise für 1M Kontext (April 2026): Opus 4.7, Opus 4.6, Sonnet 4.6 und Mythos Preview enthalten jeweils 1M zu den regulären Preisen pro MTok – ohne Langkontextaufschlag.¹⁴⁸ Diese Vereinheitlichung erfolgte erst kürzlich. Ältere Hinweise, nach denen für Opus 4.6 oder Sonnet 4.6 bei mehr als 200K Eingabe-Tokens das 2-Fache für die Eingabe bzw. das 1,5-Fache für die Ausgabe anfällt, sind daher nicht mehr aktuell. Für ältere Modelle bis einschließlich Opus 4.5 gelten weiterhin deren ursprüngliche Preisstrukturen.

Preise für Datenresidenz: Wenn Sie mit inference_geo ausschließlich US-Inferenz festlegen, werden sämtliche Tokenpreise einschließlich Cache-Lese- und -Schreibvorgängen mit dem Faktor 1,1 multipliziert (Modelle ab Opus 4.6).¹⁴⁸

Prompt-Caching senkt die Kosten für wiederholte Eingaben erheblich: Cache-Schreibvorgänge kosten das 1,25-Fache des Grundpreises (5-Minuten-Cache) bzw. das 2-Fache (1-Stunden-Cache), Cache-Lesevorgänge dagegen nur das 0,1-Fache – eine Ersparnis von 90 %. Bei RAG-Systemen und Code-Assistenten mit wiederkehrendem Kontext lassen sich die Kosten durch Caching um 88–95 % senken.

Batch-API bietet für nicht dringende Aufgaben wie nächtliche Testsuiten bei einer Bearbeitungszeit von 24 Stunden einen Rabatt von 50 %.

Richtlinie für mehrere Konten⁵²

Dürfen Sie mehrere Claude-Konten haben? Ja, sofern berechtigte Anwendungsfälle vorliegen. Anthropic gestattet ausdrücklich mehrere Konten, wenn diese unterschiedlichen Zwecken dienen.

Zulässige Fälle:

Technische Beschränkungen: - Mit derselben Telefonnummer können bis zu 3 Konten verifiziert werden - Mehrere kostenpflichtige Abonnements über dieselbe IP-Adresse bzw. dasselbe Netzwerk werden ausdrücklich unterstützt - Die Konten sind vollständig voneinander getrennt; Chats oder Projekte lassen sich nicht zwischen ihnen übertragen

Unzulässige Fälle (gemäß der Nutzungsrichtlinie): - Das Erstellen von Konten, um nach einer Sperrung Sperren zu umgehen - Die Koordination böswilliger Aktivitäten über mehrere Konten hinweg, um einer Erkennung zu entgehen - Die Verwendung mehrerer Konten, um Ratenbegrenzungen oder Guthaben des kostenlosen Tarifs zu umgehen

Hinweis aus der Praxis: Im Januar 2026 wurden 22 Max-Konten des Power-Users Jeffrey Emanuel (@doodlestein) automatisch markiert und vorübergehend gesperrt. Der Anthropic-Mitarbeiter Thariq (@trq212) hob die Sperre innerhalb von 4 Stunden auf, nachdem er die berechtigte Nutzung bestätigt hatte. Wenn Sie Claude Code sowohl für berufliche als auch für private Projekte intensiv über mehrere Konten hinweg nutzen, ist der Dienst genau dafür ausgelegt. Versuchen Sie jedoch nicht, das System auszutricksen.

Im Zweifelsfall: Wenden Sie sich an den Anthropic Support, um sich Ihre konkrete Konfiguration schriftlich bestätigen zu lassen.

Kostenfaktoren

Praxisnahe Kostenbeispiele

Spartipp: Wenn Sie Haiku für explorative subagents und Sonnet für die Implementierung einsetzen, sinken die Kosten gegenüber der ausschließlichen Verwendung von Sonnet in der Regel um 40–50 %.

Kostenmanagement für Teams

Empfohlene TPM/RPM nach Teamgröße:

Verdeckte Tool-Gebühren

Zusätzlich zu den Tokenpreisen fallen für einige Tools gesonderte Gebühren an:⁹

In Agentenschleifen summieren sich diese Kosten. Ein Debugging-Zyklus mit 100 Iterationen und Bash verursacht allein durch den Mehraufwand rund 24.500 zusätzliche Eingabe-Tokens.

Strategien zur Kostensenkung

1. Verwenden Sie Haiku für subagents: Für die meisten explorativen Aufgaben ist Sonnet nicht erforderlich
2. Aktivieren Sie Prompt-Caching: Es ist standardmäßig aktiviert; vergewissern Sie sich jedoch, dass es nicht deaktiviert wurde
3. Begrenzen Sie die maximale Anzahl an Durchläufen: claude --max-turns 5 verhindert ausufernde Konversationen
4. Legen Sie eine Kostenobergrenze fest: claude --max-budget-usd 5 beendet die Sitzung zwingend, sobald die Ausgabenobergrenze erreicht ist. Seit v2.1.217 gilt diese Grenze auch für subagents im Hintergrund: Sobald sie erreicht ist, werden neue Starts abgelehnt und laufende Hintergrund-Agenten angehalten (zuvor fielen Hintergrund-Agenten nicht unter das Budget)¹⁹⁴
5. Verwenden Sie den Planungsmodus für explorative Aufgaben: Keine Ausführung = keine versehentlichen kostspieligen Operationen
6. Komprimieren Sie proaktiv: Weniger Kontext = weniger Tokens
7. Begrenzen Sie die Ausgabe: export CLAUDE_CODE_MAX_OUTPUT_TOKENS=2000
8. Verwenden Sie Batch-API für nicht dringende Arbeiten: 50 % Rabatt auf Eingabe- und Ausgabe-Tokens

Nutzung überwachen

• Claude Console: platform.claude.com (erfordert die Rolle Admin oder Billing)
• Arbeitsbereichslimits: Legen Sie Ausgabenbegrenzungen pro Arbeitsbereich fest
• Bedrock/Vertex: Verwenden Sie die native Kostenüberwachung der Cloud-Plattform
• LiteLLM: Für eine detaillierte benutzerbezogene Nachverfolgung bei Drittanbietern

Token-Nutzung im Hintergrund

Einige Vorgänge verbrauchen im Hintergrund Tokens: - Zusammenfassung von Konversationen für /resume - Die Befehle /cost und /status - Automatische Komprimierung

In der Regel weniger als $0.04 pro Sitzung.

Claude Code Analytics API (Team/Enterprise)⁴⁶

Über die Admin-API können Sie programmgesteuert auf die Nutzungsanalysen und Produktivitätskennzahlen Ihrer Organisation für Claude Code zugreifen.

Endpunkt: GET /v1/organizations/usage_report/claude_code

Voraussetzungen: - Admin-API-Schlüssel (sk-ant-admin...) - Team- oder Enterprise-Plan - Rolle Admin, Billing oder Developer

Verfügbare Kennzahlen:

Beispielanfrage:

curl "https://api.anthropic.com/v1/organizations/usage_report/claude_code?starting_at=2026-01-15" \
  -H "x-api-key: sk-ant-admin..." \
  -H "anthropic-version: 2023-06-01"

Anwendungsfälle: - Analyse der Entwicklerproduktivität (Sitzungen, Commits, PRs) - Kennzahlen zur Tool-Nutzung (Akzeptanz-/Ablehnungsraten für Edit, Write usw.) - Kostenverfolgung und -zuordnung über Teams hinweg - ROI-Begründung für KI-Programmierwerkzeuge

Hinweis: Die Daten erscheinen innerhalb von 1 Stunde nach Abschluss der Aktivität. Zur Gewährleistung konsistenter Antworten werden nur Daten berücksichtigt, die älter als 1 Stunde sind.

Entscheidungsrahmen

Die Funktionen zu kennen, reicht nicht aus. Sie müssen wissen, wann Sie welche einsetzen sollten. Diese Entscheidungsbäume machen aus Wissen konkretes Handeln.

Welches Modell sollte ich verwenden?

START → Is the task simple? (file search, quick question, formatting)
         │
         ├── YES → Use Haiku
         │         Cost: ~$0.03/task
         │         Speed: Fastest
         │
         └── NO → Does it require deep reasoning?
                  (architecture, complex debugging, security analysis)
                  │
                  ├── YES → Use Opus 4.7 (xhigh effort default)
                  │         Cost: ~$2.00/task
                  │         Quality: Highest (1M context at standard price, adaptive reasoning)
                  │
                  └── NO → Use Sonnet
                           Cost: ~$0.75/task
                           Balance: Best overall when cost matters

Faustregel: Opus 4.7 ist die Standardeinstellung für Max und Team Premium. Bei Pro/Team Standard/Enterprise/API ist Sonnet 4.6 die Standardeinstellung (Enterprise + Anthropic API wechseln am 23. April 2026 zu Opus 4.7).¹⁴⁷ Verwenden Sie für subagents Haiku. Wechseln Sie zu Opus, wenn die Antwort von Sonnet oberflächlich wirkt. Mit agent teams (v2.1.32+) kann Opus mehrere agents koordinieren, die parallel an unterschiedlichen Teilaufgaben arbeiten.⁷⁹

Command, skill, subagent oder agent team?

Do you want explicit control over when it runs?
│
├── YES → Use Slash Command
│         Example: /deploy, /test, /security-review
│         You invoke it. You control timing.
│
└── NO → Should the expertise apply automatically based on context?
         │
         ├── YES → Use Skill
         │         Example: Security patterns, domain rules, code standards
         │         Claude recognizes context and applies expertise.
         │
         └── NO → Does the work need isolated context?
                  │
                  ├── YES → Is there one subtask or many parallel subtasks?
                  │         │
                  │         ├── ONE → Use Subagent (Task tool)
                  │         │         Example: Deep exploration, parallel analysis
                  │         │         Prevents context bloat in main conversation.
                  │         │
                  │         └── MANY → Use Agent Team (v2.1.32+)
                  │                   Example: 5 agents reviewing different modules simultaneously
                  │                   Opus coordinates; each agent works independently.
                  │
                  └── NO → Just prompt directly
                           Not everything needs abstraction.

Hook oder Prompt?

Must the action ALWAYS happen, regardless of Claude's judgment?
│
├── YES → Use Hook (deterministic)
│         Examples:
│         - Format code after every edit
│         - Log all bash commands
│         - Block access to .env files
│         Claude cannot skip, forget, or decide otherwise.
│
└── NO → Use Prompt (probabilistic)
         Examples:
         - "Consider adding tests"
         - "Think about edge cases"
         - "Review for security if relevant"
         Claude decides based on context.

Wann sollte Extended Thinking verwendet werden?

Is this a genuinely hard problem?
│
├── Architectural decision with many tradeoffs → YES, use thinking
├── Complex debugging with unclear root cause → YES, use thinking
├── Security analysis requiring careful reasoning → YES, use thinking
├── Understanding unfamiliar codebase → YES, use thinking
│
├── Routine bug fix → NO, skip thinking
├── Simple refactoring → NO, skip thinking
├── Code formatting → NO, skip thinking
└── Quick questions → NO, skip thinking

Aktivieren oder deaktivieren Sie es während der Sitzung mit Alt+T. Höhere Thinking-Budgets verursachen höhere Kosten; beginnen Sie mit dem Minimum und erhöhen Sie es nur, wenn die Antworten übereilt wirken.

Adaptives Thinking von Opus 4.6: Opus 4.6 passt die Thinking-Tiefe automatisch an die Komplexität des Problems an. Bei den meisten Aufgaben ist keine explizite Steuerung des Thinking-Budgets erforderlich — Opus skaliert bei schwierigen Problemen hoch und bleibt bei einfachen Aufgaben schnell. Das manuelle Umschalten von Thinking ist vor allem bei Sonnet sinnvoll, wenn Sie eine tiefergehende Analyse erzwingen möchten.

Welche Ausführungsumgebung?

Where should this work happen?
│
├── Requires YOUR local files and tools
│   │
│   ├── Interactive, iterative work → Main REPL session
│   ├── One-shot scripted task → claude -p "prompt" (print mode)
│   ├── CI/CD automation → claude -p --json (non-interactive + structured output)
│   └── Parallel isolated tasks → Subagents via Task tool
│
├── Requires SOMEONE ELSE'S environment
│   │
│   └── Remote codebase or server → Background agent (cloud)
│
└── Doesn't require any environment
    │
    ├── Research or analysis → Subagent with Explore type
    └── Web content extraction → WebFetch / WebSearch tools

Agent teams, subagents oder parallele Sitzungen

Do you need multiple agents working on related subtasks?
│
├── YES → Are the subtasks independent (no shared state)?
│         │
│         ├── YES → Can they share the same codebase?
│         │         │
│         │         ├── YES → Use Agent Team (v2.1.32+)
│         │         │         Opus coordinates. Agents share repo access.
│         │         │         Example: "Review auth, API, and DB modules in parallel"
│         │         │
│         │         └── NO → Use Parallel Sessions (separate terminals)
│         │                  Each has its own working directory.
│         │                  Example: "Fix repo-A and repo-B simultaneously"
│         │
│         └── NO → Use Sequential Subagents
│                  Results from one feed into the next.
│                  Example: "Explore → Plan → Implement"
│
└── NO → Use Single Subagent or Main REPL

Welcher Hook-Typ?

What kind of automation do you need?
│
├── Run a shell command at a specific event?
│   │
│   └── Use Command Hook
│       Trigger: PreToolUse, PostToolUse, Notification, Stop, SubagentStop
│       Example: "Run prettier after every file edit"
│       Config: hooks.PostToolUse[].command = "prettier --write $FILE"
│
├── Modify Claude's system prompt based on context?
│   │
│   └── Use Prompt Hook (v2.1.35+)
│       Trigger: Same events
│       Example: "Inject project rules when working in /src/auth/"
│       Config: hooks.PreToolUse[].prompt = "When editing auth files..."
│
└── Have Claude make a judgment call before proceeding?
    │
    └── Use Agent Hook (v2.1.35+)
        Trigger: Same events
        Example: "Evaluate if this bash command is safe before running"
        Config: hooks.PreToolUse[].agent = { prompt: "Is this safe?" }

Wann sollte /fast verwendet werden?

Is response speed more important than depth right now?
│
├── YES → Use /fast   (Opus 5 or Opus 4.8 only, v2.1.219+)
│         Same model, ~2.5× output speed at 2× price
│         Good for: quick questions, simple edits, code explanations,
│                   file searches, formatting tasks
│
└── NO → Stay in normal mode
         Good for: architecture decisions, complex debugging,
                   security reviews, multi-file refactors,
                   anything requiring deep reasoning

/fast schaltet den Fast Mode für die aktuelle Sitzung ein oder aus. Dabei kommt dasselbe Modell zum Einsatz — Opus 5 oder Opus 4.8, die beiden einzigen Modelle, die den Fast Mode ab v2.1.219 unterstützen — jedoch mit optimierter Ausgabegeschwindigkeit. Es erfolgt KEIN Wechsel zu einem günstigeren Modell, und mit 10/50 US-Dollar pro MTok ist der Modus auch nicht günstiger.¹⁹⁶¹⁹⁸

Wie funktioniert das Berechtigungssystem?

Das Berechtigungssystem von Claude Code ermöglicht eine präzise Steuerung darüber, welche Vorgänge ausgeführt werden dürfen. Wer es versteht, kann sowohl die Sicherheit als auch die Effizienz des Arbeitsablaufs verbessern. Unter Unternehmensweite Bereitstellung finden Sie außerdem verwaltete Einstellungen, mit denen sich Berechtigungen unternehmensweit durchsetzen lassen.

Berechtigungsstufen

Schreibgeschützte Tools (automatisch genehmigt): - Read – Dateiinhalte lesen - Glob – Dateien anhand eines Musters suchen - Grep – Dateiinhalte durchsuchen - WebSearch – Das Web durchsuchen - LSP – Codeintelligenz (Zur Definition springen, Referenzen suchen, Hover-Dokumentation)¹⁸

Funktionen des LSP-Tools (ab v2.0.74): Das LSP-Tool bietet eine IDE-ähnliche Codeintelligenz: - Zur Definition springen: Zu der Stelle springen, an der ein Symbol definiert ist - Referenzen suchen: Alle Verwendungen eines Symbols in der gesamten Codebasis auflisten - Hover-Dokumentation: Typinformationen und Dokumentation zu jedem Symbol abrufen - Funktioniert mit TypeScript, Python, Go, Rust und weiteren Sprachen mit LSP-Unterstützung - Erfordert einen verfügbaren Sprachserver, der üblicherweise zusammen mit Ihrer Toolchain installiert wird

Änderungs-Tools (Genehmigung erforderlich): - Edit – Vorhandene Dateien ändern - Write – Neue Dateien erstellen - Bash – Shell-Befehle ausführen - WebFetch – Inhalte einer URL abrufen - NotebookEdit – Jupyter-Notebooks ändern

Wenn ein Änderungs-Tool zum ersten Mal ausgeführt wird, fordert Claude Code eine Genehmigung an. Sofern nicht ausdrücklich anders konfiguriert, gelten Genehmigungen für die gesamte Sitzung.

EndConversation-Tool (v2.1.214). Claude Code verfügt nun über dieselbe Möglichkeit zum Beenden einer Unterhaltung, die Claude auf claude.ai bereits seit 2025 besitzt: In seltenen Fällen mit äußerst missbräuchlichen Eingaben oder wiederholten Jailbreak-Versuchen kann Claude die Sitzung über das integrierte EndConversation-Tool vollständig beenden. Dabei handelt es sich um eine Maßnahme zur Missbrauchsresistenz und zum Wohlergehen des Modells, nicht um eine Workflow-Funktion – in normalen Entwicklungssitzungen wird sie nie ausgelöst.¹⁹⁰¹⁹³

Berechtigungsmodi

Der Modus default wird seit v2.1.200 als „Manual“ bezeichnet. Die Umbenennung betrifft CLI, --help, VS Code und JetBrains; der Konfigurationswert hat sich nicht geändert, sodass "defaultMode": "default" weiterhin funktioniert und --permission-mode manual sowie "defaultMode": "manual" nun als Aliasse akzeptiert werden. Das Verhalten ist identisch – bei der ersten Verwendung jedes Tools wird nachgefragt. Lediglich die Bezeichnung vermittelt nicht mehr fälschlicherweise, dies sei „der Modus, den Sie standardmäßig erhalten“, obwohl es sich tatsächlich um den Modus mit manueller Genehmigung handelt. In derselben Version werden AskUserQuestion-Dialoge standardmäßig nicht mehr automatisch fortgesetzt. Ein subagent, der eine Frage stellt, wartet nun auf Ihre Antwort, statt nach einem Timeout fortzufahren; über /config können Sie wieder einen Inaktivitäts-Timeout aktivieren.

Bei Konfigurationsdateien zur Codeausführung wird nun auch unter acceptEdits nachgefragt (v2.1.160). acceptEdits genehmigt gewöhnliche Änderungen automatisch, hält seit v2.1.160 jedoch an und fragt nach, bevor Dateien geschrieben werden, die eine unbemerkte Befehlsausführung ermöglichen können: Shell-Startdateien (.zshenv, .zlogin, .bash_login), ~/.config/git/ und Konfigurationen von Build-Tools (.npmrc, .yarnrc*, bunfig.toml, .bazelrc, .pre-commit-config.yaml, .devcontainer/ und ähnliche). Der Grund: Eine Änderung an einer dieser Dateien macht die nächste Shell, Installation oder den nächsten Commit zu einem möglichen Ausführungsvektor. Deshalb greift selbst in einem Modus für vertrauenswürdige Projekte, der sonst Änderungen durchwinkt, bewusst eine zusätzliche Schranke. Dahinter steht dasselbe Bedrohungsmodell wie bei den vorhandenen Schreibschutzmaßnahmen für .claude/, .git/ und .vscode/, erweitert auf die größere Klasse von Dateien, bei denen aus einer Änderung eine Ausführung werden kann.²⁰⁴

Auto Mode (ab v2.1.85): Ein sichererer Ersatz für --dangerously-skip-permissions. Ein separates Klassifikationsmodell (Sonnet 4.6) prüft jede Aktion vor der Ausführung darauf, ob sie der Absicht des Benutzers entspricht und sicher ist.¹²⁴

Funktionsweise: - Schreibgeschützte Aktionen und Dateiänderungen im Arbeitsverzeichnis werden automatisch genehmigt - Benutzerdefinierte Zulassungs- und Ablehnungsregeln werden zuerst ausgewertet - Alles Weitere wird dem Klassifikationsmodell zur Bewertung übergeben - Wird eine Aktion blockiert, versucht Claude automatisch einen alternativen Ansatz

Standardmäßig automatisch blockiert werden: curl | bash, Force-Pushes auf main, Produktivbereitstellungen und -migrationen, massenhafte Löschvorgänge in der Cloud, IAM- und Berechtigungsänderungen sowie das externe Versenden vertraulicher Daten.¹²⁵

Sicherungsschalter: Nach 3 aufeinanderfolgenden oder insgesamt 20 Blockierungen in einer Sitzung wird wieder auf manuelle Nachfragen umgeschaltet.¹²⁵

# Enable at startup
claude --enable-auto-mode

# Or cycle into it during a session
Shift+Tab  # Cycles through: Manual (aka default) → acceptEdits → auto → plan

Verfügbarkeit: zunächst für Benutzer des Team-Tarifs, anschließend für Enterprise und API. Erfordert Sonnet 4.6 oder Opus 4.6.¹²⁴

YOLO Mode (ab v2.0.68): Verwenden Sie für einen vollständig autonomen Betrieb ohne Sicherheitsklassifikationsmodell das Flag --dangerously-skip-permissions. Dieses Flag stimmt allem zu: Dateiänderungen, Bash-Befehlen und sämtlichen Tool-Aufrufen. Das Wort „dangerous“ steht dort mit Absicht. Für die meisten Anwendungsfälle ist Auto Mode die empfohlene Alternative.⁵⁴

claude --dangerously-skip-permissions

Modus über CLI festlegen:

claude --permission-mode auto  # or acceptEdits, plan, bypassPermissions

Während der Sitzung umschalten:

Shift+Tab  # Cycles through modes

In settings.json:

{
  "permissions": {
    "defaultMode": "acceptEdits"
  }
}

Syntax der Berechtigungsregeln

Präzise Regeln steuern bestimmte Vorgänge. Die Regeln werden der Reihe nach ausgewertet: Der erste Treffer entscheidet.

Muster für Bash-Befehle:

{
  "allow": [
    "Bash(npm run build)",
    "Bash(npm run test:*)",
    "Bash(git commit:*)",
    "Bash(make:*)"
  ],
  "deny": [
    "Bash(rm -rf:*)",
    "Bash(sudo:*)",
    "Bash(curl|wget:*)"
  ]
}

Das Sternchen ermöglicht einen Präfixabgleich: Bash(npm run test:*) erlaubt npm run test, npm run test:unit und npm run test:integration.

Wichtige Einschränkung: Bash-Muster gleichen nur Präfixe ab, keine regulären Ausdrücke. Ein Muster wie Bash(curl http:*) stimmt nicht mit curl -X GET http://... überein, da die Optionen vor der URL stehen. Um einen Befehl zuverlässig zu blockieren, lehnen Sie ihn vollständig ab: Bash(curl:*).

Muster für Dateivorgänge:

{
  "allow": [
    "Edit(src/**)",
    "Read(docs/**)"
  ],
  "deny": [
    "Read(.env*)",
    "Read(secrets/**)",
    "Edit(.git/**)",
    "Edit(node_modules/**)"
  ]
}

Pfadsyntax: - Relative Pfade: Edit(src/**) – relativ zum Arbeitsverzeichnis - Absolute Pfade ausgehend von der Einstellungsdatei: Edit(/build/**) – relativ zum Speicherort der Einstellungsdatei - Tatsächlich absolute Pfade: Edit(//tmp/**) – beginnen mit // - Home-Verzeichnis: Read(~/.zshrc)

Einstufige Zulassungsregeln des Typs dir/** stimmen nun nur noch mit <cwd>/dir überein (v2.1.214) – prüfen Sie Ihre bestehenden Regeln. Vor v2.1.214 genehmigte eine Zulassungsregel wie Edit(src/**) automatisch Schreibvorgänge in jedem Verzeichnis namens src an beliebiger Stelle im Verzeichnisbaum – etwa vendor/src/, packages/foo/src/ und alle weiteren. Nun stimmt sie nur noch mit dem Verzeichnis src direkt unterhalb des Arbeitsverzeichnisses überein. Wenn Sie auf das frühere Verhalten mit beliebiger Verzeichnistiefe angewiesen sind, schreiben Sie die Regel als Edit(**/src/**) um. Für deny- und ask-Regeln bleibt der Abgleich in beliebiger Tiefe bestehen – die Änderung schränkt nur ein, was automatisch genehmigt wird, niemals das, was blockiert wird. Wenn eine Regel nach dem Upgrade stillschweigend nicht mehr greift, erscheinen neue Berechtigungsabfragen statt einer Fehlermeldung. Prüfen Sie deshalb alle Zulassungsregeln in einstufiger Form. Hook-if:-Bedingungen erhielten in dieser Version dieselbe Begrenzung auf das aktuelle Arbeitsverzeichnis (siehe Matcher).¹⁹⁰

Verwenden Sie Edit(path)/Read(path) und nicht Write(path)/NotebookEdit(path)/Glob(path) (v2.1.210). Claude Code zeigt nun beim Start eine Warnung für Berechtigungsregeln an, die mit Write(path), NotebookEdit(path) oder Glob(path) formuliert wurden. Die kanonischen Formen sind die beiden Regelfamilien, die den Dateizugriff tatsächlich steuern: Edit(path) deckt alle Tools zum Schreiben von Dateien ab, einschließlich Write und NotebookEdit; Read(path) deckt alle Tools zum Lesen von Dateien ab, einschließlich Glob. Migrieren Sie bestehende Regeln, um die Warnung zu beseitigen und die Absicht eindeutig auszudrücken.¹⁸⁷

„Always allow“ speichert am Repository-Stamm (v2.1.211). Berechtigungsregeln, die über die Option „Always allow“ in der Abfrage erstellt werden, werden nun am Repository-Stamm statt im aktuellen Worktree gespeichert. Dadurch bleibt eine in einem Worktree erteilte Genehmigung sitzungsübergreifend und in sämtlichen Worktrees dieses Repositorys bestehen – derselbe Befehl muss nicht mehr in jedem parallelen Checkout erneut genehmigt werden.¹⁸⁸

Tool-Muster für MCP:

{
  "allow": [
    "mcp__github",
    "mcp__database__query",
    "mcp__myserver__*"
  ],
  "deny": [
    "mcp__dangerous_server",
    "mcp__untrusted__*"
  ]
}

Mit der Wildcard-Syntax mcp__server__* können Sie alle Tools eines bestimmten MCP-Servers zulassen oder ablehnen.³² Die Wildcard-Syntax eignet sich dazu, schnell alle Tools vertrauenswürdiger Server zu aktivieren oder vollständige Server aus nicht vertrauenswürdigen Quellen zu blockieren.

Seit v2.1.166 akzeptieren Ablehnungsregeln auch einen Glob an der Position des Tool-Namens: Ein allein stehendes "*" im Feld für den Tool-Namen lehnt alle Tools ab. So können Sie zunächst alles blockieren und anschließend eine eng begrenzte Auswahl wieder zulassen. Zulassungsregeln weisen Globs außerhalb von MCP dagegen zurück – eine entsprechend pauschale Freigabe aller Tools ist nicht möglich, wodurch die Standardhaltung restriktiv bleibt.²⁰²

Abgleich auf Parameterebene – Tool(param:value) (v2.1.178):

Über den Tool-Namen hinaus kann eine Regel auch die Eingabeparameter eines Tools abgleichen, wobei * als Wildcard für den Wert dient:

{
  "deny": [
    "Agent(model:opus)"
  ]
}

Agent(model:opus) blockiert jeden subagent, der in der Opus-Stufe gestartet wird – der Start selbst wird abgelehnt, nicht lediglich im Prompt darum gebeten, Opus zu vermeiden. Dadurch wird die Berechtigungssteuerung von der Frage „Welches Tool?“ auf „Wie wird es aufgerufen?“ erweitert, und zwar als deterministische Regel statt als Anweisung auf Prompt-Ebene. Dies ergänzt die verwaltete Einstellung enforceAvailableModels: Die Zulassungsliste legt fest, welche Modellstufen für die Sitzung verfügbar sind, während Tool(model:...)-Regeln bestimmen, wie subagents darauf zugreifen dürfen.¹⁷³

Seit v2.1.186 werden diese Agent(...)-Regeln auch bei benannten Starts von subagents durchgesetzt: Agent(agent_type)-Ablehnungsregeln und Agent(x,y)-Beschränkungen für zulässige Typen gelten nun, wenn ein bestimmter benannter Agent gestartet wird – über einen Workflow, --agents oder ein Agententeam – und nicht mehr nur für anonyme Starts im Task-Stil. Der Start wird unmittelbar blockiert. Damit ist eine Lücke geschlossen, durch die ein benannter Agent eine für ihn vorgesehene Einschränkung umgehen konnte.¹⁷⁵

WebFetch-Muster:

{
  "allow": [
    "WebFetch(domain:github.com)",
    "WebFetch(domain:api.example.com)"
  ]
}

Zusätzliche Verzeichnisse

Erweitern Sie den Zugriff von Claude über das aktuelle Projekt hinaus:

{
  "permissions": {
    "additionalDirectories": [
      "../shared-lib",
      "../docs",
      "~/reference-projects/design-system"
    ]
  }
}

Zusätzliche Verzeichnisse sind für Monorepos unverzichtbar oder wenn Claude auf Code in benachbarten Verzeichnissen zugreifen muss.

Sandbox-Modus

Dateisystem- und Netzwerkisolierung aktivieren:

> /sandbox

Oder in den Einstellungen konfigurieren:

{
  "sandbox": {
    "enabled": true,
    "autoAllowBashIfSandboxed": true,
    "excludedCommands": ["git", "docker"],
    "network": {
      "allowUnixSockets": ["~/.ssh/agent-socket"],
      "allowLocalBinding": true,
      "deniedDomains": ["pastebin.com", "transfer.sh", "0x0.st"]
    }
  }
}

Seit v2.1.187 verhindert die Einstellung sandbox.credentials, dass in der Sandbox ausgeführte Befehle Anmeldedatendateien und geheime Umgebungsvariablen lesen – eine zusätzliche Schutzschicht gegen den Abfluss von Geheimnissen durch einen Sandbox-Befehl.¹⁷⁶

Seit v2.1.216 überspringt die Einstellung sandbox.filesystem.disabled die Dateisystemisolierung, während die Kontrolle ausgehender Netzwerkverbindungen bestehen bleibt. Das ist hilfreich, wenn die Dateisystembeschränkung ein Build-Tool beeinträchtigt, Sie aber weiterhin die Domain-Zulassungsliste für ausgehenden Datenverkehr durchsetzen möchten.¹⁹²

Seit v2.1.219 lehnt die Einstellung sandbox.network.strictAllowlist Hosts, die nicht auf der Zulassungsliste stehen, ohne Nachfrage vollständig ab. Standardmäßig löst ein Sandbox-Befehl, der einen Host außerhalb von allowedDomains kontaktiert, eine Berechtigungsabfrage aus. Bei aktiviertem strictAllowlist wird die Verbindung stattdessen schlicht verweigert. Diese Einstellung eignet sich für unbeaufsichtigte Ausführungen – CI, Hintergrund-Agenten und nächtliche Schleifen –, bei denen eine unbeantwortete Abfrage zum Stillstand führt und „Fragen Sie mich bei unerwartetem ausgehendem Datenverkehr“ ohnehin die falsche Richtlinie wäre. Damit ist das Netzwerk-Trio vollständig: allowedDomains legt fest, was erlaubt ist, deniedDomains (siehe unten) nimmt Ausnahmen aus einer weit gefassten Zulassung heraus und strictAllowlist bestimmt, ob für alles andere nachgefragt wird oder die Verbindung fehlschlägt.¹⁹⁶

In der Sandbox: - Ist der Dateisystemzugriff auf das Projektverzeichnis beschränkt - Wird der Netzwerkzugriff kontrolliert - Sind bestimmte Befehle von den Sandbox-Beschränkungen ausgenommen - Werden Bash-Befehle automatisch zugelassen, wenn autoAllowBashIfSandboxed auf true gesetzt ist

Expertentipp: Der Sandbox-Modus eignet sich hervorragend, um Claude auf nicht vertrauenswürdigen Codebasen auszuführen. Aktivieren Sie ihn, wenn Sie unbekannte Projekte untersuchen oder eine zusätzliche Schutzschicht wünschen. Interne Tests von Anthropic ergaben, dass die Sandbox die Zahl der Berechtigungsabfragen um 84 % reduziert.³⁸ Für die Dateisystem- und Netzwerkisolierung verwendet die Sandbox Mechanismen auf Betriebssystemebene (macOS seatbelt, Linux bubblewrap), sodass selbst eine erfolgreiche Prompt Injection vollständig eingegrenzt bleibt. Anthropic hat die Sandbox-Laufzeit als Open Source veröffentlicht, damit Teams eigene Agenten entwickeln können.⁸²

Sicherheitshinweise (ab v2.1.34): Befehle, die über sandbox.excludedCommands oder dangerouslyDisableSandbox von der Sandbox ausgenommen waren, konnten zuvor bei aktiviertem autoAllowBashIfSandboxed die Bash-Berechtigungsregel für Nachfragen umgehen; dies wurde in v2.1.34 behoben.⁸⁷ Seit v2.1.38 sind Schreibvorgänge in .claude/skills im Sandbox-Modus blockiert, damit Prompt Injection keine skill-Definitionen verändern kann.⁸⁸ v2.1.77 ergänzt die Dateisystemeinstellung allowRead für die Sandbox, mit der sich der Lesezugriff innerhalb von denyRead-Bereichen wieder zulassen lässt. Das ist hilfreich, wenn Sie den größten Teil eines Verzeichnisbaums blockieren, aber bestimmte Unterverzeichnisse freigeben möchten.¹¹⁹

Ausnahme für Agentenkonfigurationen unter .claude/ (ab v2.1.121): --dangerously-skip-permissions fragt bei Schreibvorgängen in .claude/skills/, .claude/agents/ und .claude/commands/ nicht mehr nach.¹⁵⁴

Auflösung verschachtelter .claude/-Verzeichnisse (v2.1.178): skills in verschachtelten .claude/skills-Verzeichnissen werden nun automatisch geladen, wenn Sie an Dateien unterhalb des jeweiligen Verzeichnisses arbeiten, und nicht mehr nur vom Repository-Stamm. Bei einem Namenskonflikt ist der verschachtelte skill als <dir>:<name> adressierbar, sodass beide verfügbar bleiben. Die übrigen Projektbereiche werden auf dieselbe Weise aufgelöst: Wenn Namen von Agenten, Workflows oder Ausgabestilen in verschachtelten .claude/-Verzeichnissen miteinander kollidieren, gewinnt der Eintrag, der dem Arbeitsverzeichnis am nächsten liegt. Beim Speichern eines Workflows im Projektbereich wird das nächstgelegene vorhandene .claude/workflows/ verwendet. In einem Monorepo oder einem Repository aus mehreren Repositorys ermöglicht dies paketbezogene Tools, die sich kontextabhängig aktivieren, statt einer einzigen flachen globalen Oberfläche.¹⁷³

Benutzerdefinierte Pfade für bubblewrap und socat (ab v2.1.133): Mit den verwalteten Einstellungen sandbox.bwrapPath und sandbox.socatPath können Administratoren Linux-/WSL-Bereitstellungen auf nicht standardmäßige Speicherorte der Binärdateien bubblewrap und socat verweisen. Das ist hilfreich, wenn Distributionen diese Tools außerhalb von $PATH installieren oder das Unternehmen gehärtete Builds bereitstellt.¹⁶⁰

Sicherheitshärtung in v2.1.113:¹⁵⁰

• sandbox.network.deniedDomains blockiert bestimmte Hosts selbst dann, wenn ein weiter gefasster allowedDomains-Platzhalter sie andernfalls zulassen würde. Mit der Blockierliste können Sie Pastebins, Dateiablagen oder bekanntermaßen schädliche Hosts sperren, ohne Ihre gesamte Zulassungsrichtlinie neu formulieren zu müssen. Kombinieren Sie sie mit sandbox.network.strictAllowlist (v2.1.219, siehe oben), wenn alles außerhalb der Zulassungsliste ohne Nachfrage abgelehnt werden soll.
• Ablehnungsregeln für Wrapper-Befehle. Bash-Ablehnungsregeln erkennen nun Befehle, die in env, sudo, watch, ionice, setsid und ähnliche Ausführungs-Wrapper eingebettet sind. Regeln wie Bash(rm:*) erfassen nun env rm -rf, sudo rm -rf und verwandte Umgehungsmuster.
• Bash(find:*)-Zulassungsregeln genehmigen find -exec oder find -delete nicht mehr automatisch. Diese Flags führen Befehle aus beziehungsweise löschen Dateien, weshalb Claude Code sie nun über den normalen Berechtigungsweg leitet.
• Löschschutz unter macOS. Bash(rm:*)-Zulassungsregeln behandeln /private/etc, /private/var, /private/tmp und /private/home nun als gefährliche Löschziele. /var, /etc und /tmp sind symbolische Links in /private/, weshalb die bisherige Regelform die kanonischen Ziele nicht erfasste.

Fail-Closed-Härtung der Berechtigungen in v2.1.214:¹⁹⁰

In einer einzigen Version wurden mehrere Lücken bei der Berechtigungsprüfung geschlossen, konsequent nach dem Fail-Closed-Prinzip: Wenn die Analyse keine Gewissheit bietet, wird nachgefragt.

• Umgehung unter Windows PowerShell 5.1 behoben. Befehle, die in PowerShell-5.1-Sitzungen ausgeführt wurden, konnten zuvor die Berechtigungsprüfung umgehen.
• Bash-Dateideskriptorumleitungen verhalten sich nun fail-closed. Umleitungsformen, die Bash anders als die Berechtigungsanalyse interpretiert, lösen nun eine Nachfrage aus, statt ausgeführt zu werden.
• Bei Befehlen mit mehr als 10.000 Zeichen wird immer nachgefragt. Sehr lange Befehle wurden zuvor fehlerhaft beurteilt; nun werden sie niemals automatisch ausgeführt.
• zsh-Indizes und -Modifikatoren in [[ ]] lösen Nachfragen aus. Variablenindizes und -modifikatoren innerhalb von [[ ]]-Vergleichen wurden als wirkungsloser Text behandelt. Da sie Code ausführen können, ist nun eine Genehmigung erforderlich.
• Unsichere Varianten von help/man werden nicht mehr automatisch genehmigt. Bestimmte Aufrufe konnten unter dem Deckmantel des Lesens von Dokumentation unsichere Optionen, Befehlssubstitutionen oder Pfade mit Backslashes ausführen.
• Reihenfolge von Abfragen in Remotesitzungen. Berechtigungsabfragen in Remotesitzungen können nicht mehr fortgesetzt werden, bevor der lokale Bestätigungsdialog abgeschlossen ist.
• Flags zur Umleitung des docker-Daemons lösen eine Nachfrage aus. docker-Befehle, einschließlich des Podman-docker-Shims, mit --url, --connection, --identity oder dem Remote-Modus von Podman wurden zuvor ohne Nachfrage ausgeführt. Diese Flags richten den Befehl jedoch auf einen völlig anderen Daemon.
• file verliert seine automatische Freigabe als schreibgeschützter Befehl, wenn ein Schreibziel angegeben wird. Für file -m/--magic-file und -f/--files-from ist nun eine Berechtigung erforderlich, statt sie automatisch als schreibgeschützt zuzulassen.

Wie funktionieren Hooks?

Hooks führen an bestimmten Punkten im Workflow von Claude Code deterministische Shell-Befehle aus. Anders als bei der Aufforderung an Claude, Aktionen auszuführen, garantieren Hooks die Ausführung unabhängig vom Verhalten des Modells. Sie sind unverzichtbar, um Teamstandards durchzusetzen und wiederkehrende Aufgaben zu automatisieren. Unter Entscheidungsgrundlagen finden Sie den Entscheidungsbaum „Welcher Hook-Typ?“, der Befehls-, Prompt- und Agent-Hooks abdeckt.

Warum Hooks statt Prompts: Wenn Sie Claude anweisen, „nach dem Bearbeiten von Dateien immer Prettier auszuführen“, funktioniert das manchmal. Claude könnte es jedoch vergessen, Geschwindigkeit priorisieren oder entscheiden, die Änderung sei „zu klein“. Hooks garantieren die Ausführung: Jeder Einsatz von Edit oder Write löst ausnahmslos und jedes Mal Ihren Formatierer aus. Bei Compliance, Sicherheit und Teamstandards ist Determinismus zuverlässiger als Wahrscheinlichkeit.⁴

Verfügbare Ereignisse

source-Werte von SessionStart. Die Eingabe des SessionStart-Hooks enthält ein source-Feld, das angibt, wie die Sitzung begonnen hat: "startup", "resume", "clear" oder "compact". Seit v2.1.214 meldet eine Sitzung, die als Fork beginnt, source: "fork" statt "resume" — das Hook-seitige Gegenstück zur Änderung von /fork zu Hintergrundausführung in v2.1.212. Wenn ein SessionStart-Hook anhand von source verzweigt, etwa um Kontext nur bei "resume" erneut einzuspeisen, erweitern Sie seine Trefferliste auch um "fork".¹⁹⁰

Hook-Konfiguration

Definieren Sie Hooks in settings.json oder einer eigenen hooks.json:

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "npx prettier --write \"$FILE_PATH\""
          }
        ]
      }
    ],
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": ".claude/hooks/validate-bash.sh"
          }
        ]
      }
    ],
    "UserPromptSubmit": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": ".claude/hooks/inject-context.sh"
          }
        ]
      }
    ]
  }
}

Matcher

Das Feld matcher bestimmt, welche Tools einen Hook auslösen:

{"matcher": "*"}              // Match all tools
{"matcher": "Bash"}           // Match Bash only
{"matcher": "Edit|Write"}     // Match Edit or Write
{"matcher": "mcp__github"}    // Match MCP server tools
{"matcher": ""}               // Match for events without tools (like UserPromptSubmit)

Verwenden Sie |, um mehrere Tools abzugleichen (Edit|Write). Seit v2.1.191 werden auch durch Kommas getrennte Matcher (z. B. Bash,PowerShell) korrekt ausgelöst — frühere Versionen ignorierten sie stillschweigend, sodass ein Hook mit einem Komma-Matcher nie ausgeführt wurde.¹⁷⁸ Seit v2.1.195 werden Matcher mit Bezeichnern, die Bindestriche enthalten (z. B. code-reviewer, mcp__brave-search), exakt abgeglichen, statt versehentlich Teilzeichenfolgen abzugleichen. Dadurch wird ein Matcher nicht mehr bei unbeabsichtigten Tools ausgelöst, die lediglich die Zeichenfolge enthalten. Um jedes Tool eines MCP-Servers mit Bindestrich abzugleichen, verwenden Sie ein explizites Muster wie mcp__brave-search__.*.¹⁷⁹

Hook-Pfadbedingungen mit if: beziehen sich seit v2.1.214 auf das aktuelle Arbeitsverzeichnis. Dieselbe Änderung der Segmentbegrenzung, die Berechtigungsregeln betraf (siehe Syntax der Berechtigungsregeln), gilt auch für if:-Bedingungen von Hooks: Eine Bedingung wie dir/** stimmt jetzt nur mit <cwd>/dir überein, nicht mehr mit jedem dir/ im Verzeichnisbaum. Verwenden Sie **/dir/**, wenn Sie wieder einen Abgleich in beliebiger Tiefe wünschen.¹⁹⁰

Ein-/Ausgabeprotokoll für Hooks

Hooks empfangen JSON über stdin:

{
  "tool_name": "Bash",
  "tool_input": {
    "command": "npm test",
    "description": "Run test suite"
  },
  "session_id": "abc-123"
}

Anreicherung von Hook-Ereignissen (v2.1.69+): Alle Hook-Ereignisse enthalten nun die Felder agent_id und agent_type, wenn sie von einem Subagent oder einer --agent-Sitzung ausgelöst werden, sowie ein worktree-Feld in Hook-Befehlen der Statuszeile.¹¹⁰

Stop-/SubagentStop-Hooks (v2.1.47+) empfangen ein zusätzliches Feld last_assistant_message, das den Text der abschließenden Antwort von Claude enthält. Dadurch können Hooks die Ausgabe prüfen, ohne Transkriptdateien analysieren zu müssen:

{
  "session_id": "abc-123",
  "last_assistant_message": "I've completed the refactoring. Here's what changed..."
}

Sanftes Feedback ohne Blockierung (v2.1.163+): Stop- und SubagentStop-Hooks können in ihrer JSON-Ausgabe hookSpecificOutput.additionalContext zurückgeben, um Claude Feedback zu übermitteln und den Turn fortzusetzen, ohne dass die Antwort als Hook-Fehler gekennzeichnet wird. Zuvor bestand die einzige echte Einflussmöglichkeit eines Stop-Hooks in der Blockierung per Exit-Code 2, die als Fehler erscheint und auf die Obergrenze aufeinanderfolgender Blockierungen angerechnet wird. additionalContext ergänzt einen Steuerungskanal für Hinweise im Sinne von „Das haben Sie übersehen, fahren Sie fort“, der nicht gegen die Schleife arbeitet.²⁰³

Exit-Codes steuern das Verhalten: - 0: Erfolg: Der Vorgang wird fortgesetzt. Stdout wird im ausführlichen Modus angezeigt (Ctrl+O). Bei UserPromptSubmit und SessionStart wird Stdout dem Kontext hinzugefügt. - 2: Blockierender Fehler: Der Vorgang wird angehalten. Stderr wird zur Fehlermeldung, die an Claude zurückgegeben wird. - 1, 3 usw.: Nicht blockierender Fehler: Der Vorgang wird fortgesetzt. Stderr wird im ausführlichen Modus als Warnung angezeigt.

Für eine erweiterte Steuerung können Hooks JSON ausgeben:

{
  "decision": "allow",
  "message": "Command validated and modified",
  "modifications": {
    "tool_input": {
      "command": "npm test -- --coverage"
    }
  }
}

Entscheidungssteuerung für PreToolUse (bevorzugtes Format): PreToolUse-Hooks verwenden hookSpecificOutput für eine differenziertere Steuerung: drei Ergebnisse (zulassen/ablehnen/nachfragen) sowie die Möglichkeit, die Tool-Eingabe zu ändern und Kontext einzuspeisen:⁸⁹

{
  "hookSpecificOutput": {
    "hookEventName": "PreToolUse",
    "permissionDecision": "allow",
    "permissionDecisionReason": "Command validated and modified",
    "updatedInput": {
      "command": "npm test -- --coverage --ci"
    },
    "additionalContext": "Note: This database has a 5-second query timeout."
  }
}

Hinweis: Die Felder decision und reason auf oberster Ebene sind für PreToolUse veraltet. Verwenden Sie stattdessen hookSpecificOutput.permissionDecision und hookSpecificOutput.permissionDecisionReason. Andere Ereignisse (PostToolUse, Stop usw.) verwenden weiterhin decision auf oberster Ebene.⁸⁹

Sitzungstitel über UserPromptSubmit (v2.1.94+): UserPromptSubmit-Hooks können den Sitzungstitel über hookSpecificOutput.sessionTitle festlegen.¹⁴⁰

Asynchrone Hooks (Januar 2026)

Hooks können jetzt im Hintergrund ausgeführt werden, ohne die Ausführung von Claude Code zu blockieren. Fügen Sie Ihrer Hook-Konfiguration async: true hinzu:⁸¹

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": ".claude/hooks/notify-slack.sh",
            "async": true
          }
        ]
      }
    ]
  }
}

Wann Sie asynchrone Hooks verwenden sollten: - Benachrichtigungen (Slack, E-Mail, Pushover), die die Sitzung nicht verlangsamen sollen - Protokollierung und Telemetrie, die im Hintergrund ausgeführt werden können - Unkritische Nachverarbeitung (Analysen, Sicherungen)

Wann Sie asynchrone Hooks NICHT verwenden sollten: - Formatierung (muss vor der nächsten Bearbeitung abgeschlossen sein) - Validierung (muss bei einem Fehler blockieren) - Jeder Hook, der die Tool-Eingabe oder -Ausgabe ändern muss

Prompt-basierte und Agent-basierte Hooks (v2.1.32+)

Neben Shell-Befehl-Hooks (type: "command") unterstützt Claude Code zwei LLM-gestützte Hook-Typen, die Bedingungen mithilfe von KI-Schlussfolgerungen statt Skripten auswerten.⁸⁹

Prompt-Hooks (type: "prompt") senden einen Prompt für einen einzelnen Turn an ein schnelles Claude-Modell. Das Modell gibt zum Zulassen { "ok": true } oder zum Blockieren { "ok": false, "reason": "..." } zurück:

{
  "hooks": {
    "Stop": [
      {
        "hooks": [
          {
            "type": "prompt",
            "prompt": "Evaluate if Claude should stop: $ARGUMENTS. Check if all requested tasks are complete and tests pass.",
            "timeout": 30
          }
        ]
      }
    ]
  }
}

HTTP-Hooks (type: "http") senden die JSON-Eingabe des Ereignisses als POST-Anfrage an eine URL und empfangen JSON zurück. Verwenden Sie diese für Webhooks, externe Benachrichtigungsdienste oder API-basierte Validierungen (v2.1.63+):¹⁰⁴

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "http",
            "url": "https://api.example.com/notify",
            "headers": {
              "Authorization": "Bearer $MY_TOKEN"
            },
            "allowedEnvVars": ["MY_TOKEN"]
          }
        ]
      }
    ]
  }
}

HTTP-Hooks verwenden dasselbe Entscheidungsformat wie Befehls-Hooks: Sie geben JSON mit decision und reason zurück. Wenn Sandboxing aktiviert ist, werden sie über den Netzwerk-Proxy der Sandbox geleitet. Für die Ereignisse SessionStart/Setup werden sie nicht unterstützt.

Agent-Hooks (type: "agent") starten einen Subagent mit Tool-Zugriff (Read, Grep, Glob) für mehrstufige Prüfungen. Verwenden Sie diese, wenn für die Prüfung tatsächliche Dateien oder Testausgaben untersucht werden müssen:

{
  "hooks": {
    "Stop": [
      {
        "hooks": [
          {
            "type": "agent",
            "prompt": "Verify all unit tests pass. Run the test suite and check results. $ARGUMENTS",
            "timeout": 120
          }
        ]
      }
    ]
  }
}

Verwenden Sie $ARGUMENTS als Platzhalter für die JSON-Eingabe des Hooks. Beide Typen unterstützen die Felder model (standardmäßig das schnelle Modell) und timeout. Unterstützte Ereignisse: PreToolUse, PostToolUse, PostToolUseFailure, PermissionRequest, UserPromptSubmit, Stop, SubagentStop, TaskCompleted. TeammateIdle unterstützt keine Prompt-/Agent-Hooks.

MCP-Tool-Hooks (v2.1.118+)

Hooks können jetzt über type: "mcp_tool" direkt ein MCP-Tool aufrufen, sodass kein Bash-Unterprozess mehr als Wrapper für den Server erforderlich ist.¹⁵²

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit",
        "hooks": [
          {
            "type": "mcp_tool",
            "server": "linear",
            "tool": "create_comment",
            "input": {"issue_id": "ENG-123", "body": "Auto-updated by Claude Code"}
          }
        ]
      }
    ]
  }
}

Dies lässt sich gut mit den bereits von Benutzern konfigurierten MCP-Servern kombinieren: Jedes über /mcp erreichbare Tool kann von einem Hook aufgerufen werden.

duration_ms in PostToolUse-Hooks (v2.1.119+)

Die Eingaben von PostToolUse- und PostToolUseFailure-Hooks enthalten jetzt duration_ms, also die Ausführungszeit des Tools ohne Berechtigungsabfragen und PreToolUse-Hooks.¹⁵² Dies ist nützlich für die Erkennung langsamer Tools, Audit-Protokolle und Latenzmetriken pro Tool:

# Stderr-flagged warning when an Edit takes more than 10 seconds
DUR=$(jq -r '.duration_ms')
if [ "$DUR" -gt 10000 ]; then
  echo "[slow-edit] ${DUR}ms — investigate $TOOL_INPUT_FILE_PATH" >&2
fi

updatedToolOutput für alle Tools (v2.1.121+)

In v2.1.118 erhielten MCP-Tool-Hooks die Möglichkeit, die Tool-Ausgabe über hookSpecificOutput.updatedToolOutput zu ersetzen. Seit v2.1.121 funktioniert dasselbe Feld für jeden PostToolUse-Hook — integrierte Tools (Bash, Read, Edit, Glob, Grep usw.), Subagent-Tools und MCP-Tools. Anwendungsfälle sind das Entfernen vertraulicher Inhalte aus beliebigen Tool-Ausgaben, das Normalisieren der Struktur für nachgelagerte Verbraucher und das Einspeisen von Metadaten, bevor der Agent das Ergebnis liest.¹⁵⁴

Hook-Umgebungsvariablen

Hooks haben Zugriff auf Umgebungsvariablen, um Pfade aufzulösen:⁸⁹

Umgebungsvariablen aus SessionStart dauerhaft speichern:

#!/bin/bash
if [ -n "$CLAUDE_ENV_FILE" ]; then
  echo 'export NODE_ENV=production' >> "$CLAUDE_ENV_FILE"
fi
exit 0

Sicherheit von HTTP-Hooks (v2.1.51+): HTTP-Hooks, die Umgebungsvariablen in Header interpolieren, benötigen jetzt eine explizite allowedEnvVars-Liste. Dies verhindert das Ausschleusen beliebiger Umgebungsvariablen über Header-Werte. Wenn Sandboxing aktiviert ist, werden HTTP-Hooks zudem über den Netzwerk-Proxy der Sandbox geleitet, wodurch die Domain-Zulassungsliste durchgesetzt wird. Für die Ereignisse SessionStart/Setup werden HTTP-Hooks nicht unterstützt.⁹⁸

{
  "hooks": {
    "PostToolUse": [{
      "hooks": [{
        "type": "command",
        "command": "curl -H 'Authorization: Bearer $MY_TOKEN' https://api.example.com/notify",
        "allowedEnvVars": ["MY_TOKEN"]
      }]
    }]
  }
}

Vertrauensstellung des Hook-Arbeitsbereichs (v2.1.51+): Die Hook-Befehle statusLine und fileSuggestion erfordern jetzt im interaktiven Modus die Bestätigung der Vertrauensstellung des Arbeitsbereichs, wodurch ein potenzieller Sicherheitsvektor geschlossen wird.⁹⁸

Praktische Hook-Beispiele

TypeScript-Dateien nach der Bearbeitung automatisch formatieren:

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "bash -c '[[ \"$FILE_PATH\" == *.ts ]] && npx prettier --write \"$FILE_PATH\" || true'"
          }
        ]
      }
    ]
  }
}

Alle Bash-Befehle protokollieren:

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "jq -r '.tool_input.command' >> ~/.claude/bash-history.log"
          }
        ]
      }
    ]
  }
}

Zugriff auf vertrauliche Dateien blockieren:

#!/bin/bash
# .claude/hooks/protect-files.sh
data=$(cat)
path=$(echo "$data" | jq -r '.tool_input.file_path // empty')

if [[ "$path" == *".env"* ]] || [[ "$path" == *"secrets/"* ]] || [[ "$path" == *".pem"* ]]; then
  echo "Blocked: Cannot access sensitive file $path" >&2
  exit 2  # Exit 2 = block the tool call. Exit 1 = non-blocking error (hook failure only).
fi
exit 0