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

Kurzfassung: Claude Code ist eine agentische CLI, die Ihre Codebasis liest, Befehle ausführt und Dateien bearbeitet. Gesteuert wird sie durch fünf Systeme: Konfiguration, Berechtigungen, hooks, MCP und subagents. Verwenden Sie hooks statt Prompts für alles, was jedes Mal ausgeführt werden muss.

Aktueller Stand (CLI v2.1.292, 6. Oktober 2026; npm latest und next sind 2.1.292, stable ist 2.1.285):²³⁴

• Standardmodell: Claude Opus 5.5 (claude-opus-5-5) für Pro, Max, Team, Enterprise und die Anthropic API sowie auf der Claude Platform bei AWS, Amazon Bedrock und der Agent Platform von Google Cloud. Microsoft Foundry bildet die Ausnahme: Dort ist Sonnet 4.5 voreingestellt und der Alias opus bezeichnet Opus 4.6.²²¹
• Opus 5.5 im Überblick: 4/20 US-Dollar pro Million Tokens mit Cache-Lesezugriffen für 0,20 US-Dollar, standardmäßig 1 Million Kontext auf der Anthropic API und seit v2.1.287 auch auf Bedrock, Agent Platform und Foundry, standardmäßig medium als Rechenaufwand sowie ein Denkprozess, der sich nicht deaktivieren lässt. Im Fast mode kostet die Nutzung 8/40 US-Dollar. Sonnet 5.5 (2/10 US-Dollar; seit v2.1.284 sonnet auf der Anthropic API) ist die günstigere Wahl, wenn eine Aufgabe kein Opus erfordert.^{220222223228232}
• Auto mode ist für interaktive Terminal- und VS-Code-Sitzungen bei allen Tarifen und Anbietern der anfängliche Berechtigungsmodus (v2.1.283–284), während claude -p und Agent-SDK-Sitzungen im Manual mode starten, sofern nicht --permission-mode auto übergeben wird (v2.1.302 nahm den mit v2.1.285 eingeführten automatischen Start bei Drittanbietern und deaktivierter Telemetrie wieder zurück).²⁷⁵ Die Sicherheitsprüfungen laufen für Enterprise- und Claude-API-Konten, auf der Claude Platform bei AWS, Bedrock, Agent Platform und Foundry sowie über Gateways kostenlos auf dem Server; als Ausweichlösung dienen kostenpflichtige lokale Prüfungen.^{219227228229230}
• AGENTS.md: Seit v2.1.277 wird AGENTS.md als Projektanweisung gelesen, wenn ein Projekt keine CLAUDE.md enthält. Ausgenommen sind Umgebungen, in denen keine Funktionskennzeichnungen abgerufen werden (etwa Bedrock), sowie die erste Sitzung nach einer Installation oder einem Upgrade.²¹⁹²²³

Die Versionshistorie finden Sie im Änderungsprotokoll.

Claude Code arbeitet als agentisches System, nicht als Chatoberfläche mit Programmierkenntnissen. Die CLI liest Ihre Codebasis, führt Befehle aus, verändert Dateien, verwaltet Git-Workflows, stellt über MCP Verbindungen zu externen Diensten her 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 42.896-faches Wachstum innerhalb von 13 Monaten seit der Forschungsvorschau – und 90 % des eigenen Codes von Anthropic wurden von KI geschrieben.¹⁰³

Der Unterschied zwischen gelegentlicher und effektiver Nutzung von Claude Code hängt von fünf Kernsystemen ab. Beherrschen Sie diese, wird Claude Code zum Kraftmultiplikator:

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 auf die Delegationsebene: subagents verhindern eine Überfrachtung des Kontexts, indem sie Untersuchungen in sauberen Kontextfenstern isolieren und nur Zusammenfassungen zurückgeben.
• Hooks garantieren die Ausführung, Prompts nicht: Verwenden Sie hooks für Linting, Formatierung und Sicherheitsprüfungen, die unabhängig vom Modellverhalten jedes Mal ausgeführt werden müssen.
• Eine abgestufte Modellwahl spart Kosten, ohne die Qualität zu beeinträchtigen: Lassen Sie subagents mit günstigeren Modellen recherchieren und reservieren Sie Opus für echte Architekturüberlegungen – oder vereinheitlichen Sie alles auf 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 die Ausführung von Bash-Befehlen hinaus.

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

Wählen Sie Ihren Weg

So verwenden Sie diesen Leitfaden

Dies ist ein Nachschlagewerk mit mehr als 5.000 Zeilen – Sie müssen es nicht von Anfang bis Ende lesen. Beginnen Sie dort, wo es Ihrem Erfahrungsstand entspricht:

Suchen Sie mit Strg+F bzw. Cmd+F in Ihrem Browser nach bestimmten Flags, Befehlen oder Konfigurationsschlüsseln. Die Kurzübersicht am Ende fasst alle wichtigen Befehle übersichtlich zusammen.

Weiterführende Artikel

Diese Blogbeiträge behandeln einzelne Aspekte von Claude Code ausführlich:

60-Sekunden-Schnellstart

Wenn Sie Claude Code einfach nur ausführen und die Ausgabe sehen möchten, gehen Sie in dieser Reihenfolge 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 erläutert die Installationsoptionen ausführlicher, konfiguriert Berechtigungen und hooks, bindet MCP-Server an und behandelt die unternehmensweite Bereitstellung — für den Einstieg ist davon jedoch nichts erforderlich.

Voraussetzungen: Node 22+ wird nur für den veralteten npm-Installationsweg benötigt (mit v2.1.198 von Version 18 angehoben; in der aktuellen Installationsdokumentation steht „Node.js 22 or later“, überprüft am 7. August 2026); das empfohlene native Installationsprogramm benötigt Node nicht. Unterstützt werden macOS / Linux / Windows 10+. Die Nutzung ist entweder durch ein Claude-Abonnement vom Typ Pro, Max, Team oder Enterprise oder durch einen nutzungsabhängig abgerechneten Anthropic API-Schlüssel abgedeckt. Plattformspezifische Hinweise, Informationen zur Fehlerbehebung und den nativen Binärinstallationsweg (seit v2.1.113 Standard) finden Sie unter Wie installiere ich Claude Code?. Die Nachweise zur neuesten Version werden in diesem Leitfaden für jede Veröffentlichung aktualisiert; den aktuellen Überprüfungsstand finden Sie im neuesten Eintrag des Changelogs.²⁶⁷

Funktionsweise von Claude Code: Das mentale Modell

Bevor Sie sich mit den Funktionen befassen, sollten Sie verstehen, wie die Architektur von Claude Code Ihre gesamte Arbeit damit prägt. Das System arbeitet auf drei Ebenen:

┌─────────────────────────────────────────────────────────┐
│                    CLAUDE CODE LAYERS                    │
├─────────────────────────────────────────────────────────┤
│  EXTENSION LAYER                                         │
│  ┌─────────┐  ┌─────────┐  ┌─────────┐  ┌─────────┐    │
│  │   MCP   │  │  Hooks  │  │ Skills  │  │ Plugins │    │
│  └─────────┘  └─────────┘  └─────────┘  └─────────┘    │
│  External tools, deterministic automation, domain       │
│  expertise, packaged extensions                          │
├─────────────────────────────────────────────────────────┤
│  DELEGATION LAYER                                        │
│  ┌─────────────────────────────────────────────────┐    │
│  │           Subagents (20 concurrent default)      │    │
│  │   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 │
└─────────────────────────────────────────────────────────┘

Kernebene: Ihre Hauptkonversation. Jede Nachricht, jeder Dateilesevorgang und jede Tool-Ausgabe beansprucht Kontext aus einem gemeinsamen Fenster (standardmäßig 200K Tokens⁹¹, 1M Tokens mit Opus 4.6 oder Modellen mit erweitertem Kontext). Sobald der Kontext ausgeschöpft ist, verliert Claude frühere Entscheidungen aus dem Blick, und die Qualität nimmt ab. Auf dieser Ebene entstehen Kosten pro Token.

Delegationsebene: Subagents starten mit einem leeren Kontext, erledigen gezielte Aufgaben und geben Zusammenfassungen zurück. Die Ergebnisse der Erkundung blähen Ihre Hauptkonversation nicht auf; zurückgegeben werden nur die Schlussfolgerungen. Weisen Sie Subagents für Erkundungsaufgaben günstigeren Modellstufen zu, oder verwenden Sie durchgehend Ihr primäres Modell, wenn Ihnen Qualität wichtiger als Kosten ist.

Erweiterungsebene: MCP verbindet externe Dienste (Datenbanken, GitHub, Sentry). Hooks gewährleisten die Ausführung von Shell-Befehlen unabhängig vom Verhalten des Modells. Skills bilden Fachwissen ab, das Claude automatisch anwendet. Plugins bündeln all diese Elemente für die Verteilung.

Die zentrale Erkenntnis: Die meisten Benutzer arbeiten ausschließlich auf der Kernebene und sehen dabei zu, wie der Kontext anwächst und die Kosten steigen. Erfahrene Benutzer verlagern Erkundungen und spezialisierte Aufgaben auf die Delegationsebene, konfigurieren die Erweiterungsebene passend zu ihrem Arbeitsablauf und nutzen die Kernebene nur zur Orchestrierung und für abschließende Entscheidungen.

Inhaltsverzeichnis

1. Wie installiere ich Claude Code?
2. Schnellstart: Ihre erste Sitzung
3. Grundlegende Interaktionsmodi
4. Das Konfigurationssystem im Detail
5. Welches Modell sollte ich wählen?
6. Was kostet Claude Code?
7. Entscheidungsrahmen
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. Ausgabestile
14. Slash Commands
15. Wie funktionieren Skills?
16. Plugin-System
17. Wie funktioniert der Speicher?
18. Bild- und multimodale Eingabe
19. Sprachmodus
20. Wie funktioniert die Git-Integration?
21. Wie verwende ich Claude Code in meiner IDE?
22. Fortgeschrittene Nutzungsmuster
23. Remote- und Hintergrund-Agenten [FORSCHUNGSVORSCHAU]
24. Claude in Chrome
25. Claude Code in Slack [FORSCHUNGSVORSCHAU]
26. Claude Code im Web [FORSCHUNGSVORSCHAU]
27. Claude in Microsoft 365 (Mai 2026)
28. Leistungsoptimierung
29. Wie behebe ich Probleme?
30. Unternehmensweite Bereitstellung
31. Referenz der Tastenkombinationen
32. Bewährte Vorgehensweisen
33. Arbeitsablaufrezepte
34. Migrationsleitfaden
35. Zielgruppenspezifische Hinweise
36. Schnellreferenz
37. Changelog
38. Quellen

Wie installiere ich Claude Code?

Systemanforderungen

Claude Code läuft unter 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 beste Shell-Kompatibilität bieten Bash, Zsh und Fish.

Unter Windows funktionieren sowohl WSL 1 als auch WSL 2. Wenn Sie natives Windows bevorzugen, können Sie auch Git Bash verwenden. Alpine Linux und andere musl-basierte Systeme benötigen zusätzliche Pakete:

apk add libgcc libstdc++ ripgrep
export USE_BUILTIN_RIPGREP=0

Plattformunterstützung

Installation, Aktualisierung und Deinstallation auf einen Blick

Übersicht zum schnellen Nachschlagen — alle Methoden, alle Befehle und die Versionsprüfung auf einen Blick. Die folgenden Unterabschnitte behandeln die Einzelheiten und Fehlerbehebung für jede Methode.

Seit v2.1.113 startet die kanonische CLI über eine optionale plattformspezifische Abhängigkeit eine native Claude Code-Binärdatei anstelle des mitgelieferten JavaScript — verwenden Sie für die getestete Distribution den nativen Installer. Der npm-Weg funktioniert weiterhin, zeigt jedoch den bereits in v2.1.15 eingeführten Hinweis zur Einstellung zuerst an.

Installationsmethoden

Native Installation (empfohlen)

Die native Binärdatei bietet ohne Node.js-Abhängigkeit die reibungsloseste Benutzererfahrung:

# 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 die Installation einer bestimmten Version:

# 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

Eine Version sollten Sie hinter einem Proxy oder Gateway niemals anheften: 2.1.275. In diesem Build schlägt jede Anfrage mit 400 ... Input tag 'advisor_20260301' fehl, wenn ANTHROPIC_BASE_URL auf einen Proxy oder ein Gateway verweist; 2.1.276 behebt diese Regression.²¹⁸

NPM-Installation (nicht mehr empfohlen)

Hinweis: Seit v2.1.15 zeigen npm-Installationen einen Hinweis zur Einstellung an. Die native Binärdatei ist inzwischen die empfohlene Installationsmethode. Migrieren Sie mit claude install.

Für ältere Umgebungen, in denen npm weiterhin benötigt wird:

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

Verwenden Sie bei der npm-Installation niemals sudo. Dadurch entstehen Berechtigungsprobleme, die alle nachfolgenden Schritte erschweren.

Migration einer vorhandenen Installation

Wenn Sie eine ältere npm-basierte Installation verwenden, migrieren Sie zur nativen Binärdatei:

claude install

Authentifizierungsoptionen

Claude Code unterstützt drei Authentifizierungswege mit jeweils unterschiedlichen Vor- und Nachteilen:

Claude Console (API-Abrechnung)

Stellen Sie über platform.claude.com (zuvor console.anthropic.com) eine direkte Verbindung zur API von Anthropic her. Erstellen Sie ein Konto, richten Sie die Abrechnung ein und authentifizieren Sie sich über die CLI. Die Console bietet eine nutzungsbasierte Abrechnung mit vollständigem API-Zugriff. Ein eigener „Claude Code“-Workspace wird automatisch erstellt; Sie können für diesen Workspace keine API-Schlüssel erstellen, aber die Nutzung überwachen. Seit v2.1.243 bietet /login → Anthropic Console neben der Erstellung eines API-Schlüssels auch den schlüssellosen Weg „Mit Ihrem Console-Konto anmelden“ (empfohlen). Dadurch können sich Organisationen, die keine API-Schlüssel zulassen, dennoch mit ihren Console-Zugangsdaten anmelden.²⁵⁰

Claude Pro- oder Max-Abonnement

Verwenden Sie die Zugangsdaten Ihres claude.ai-Kontos. Das Abonnement deckt sowohl die Weboberfläche als auch die Nutzung der CLI in einem einzigen Monatstarif ab. Für einzelne Benutzer, die planbare Kosten wünschen, vereinfacht das Abonnement die Abrechnung.

Unternehmensplattformen

AWS Bedrock, Google Vertex AI und Microsoft Foundry bieten jeweils unternehmensgerechten Zugriff über bestehende Cloud-Abrechnungsbeziehungen. Einrichtungsassistent für Bedrock (v2.1.92+): Ein interaktiver Assistent auf dem Anmeldebildschirm führt Sie durch die AWS-Authentifizierung, Regionsauswahl, Überprüfung der Zugangsdaten und Modellanheftung.¹³⁷ Einrichtungsassistent für Vertex AI (v2.1.98+): Ein entsprechender Assistent für Google Cloud führt Sie durch die GCP-Authentifizierung, Projekt- und Regionskonfiguration, Überprüfung der Zugangsdaten und Modellanheftung.¹⁴² Vertex AI mTLS Workload Identity Federation (v2.1.121+): Vertex AI akzeptiert nun die auf X.509-Zertifikaten basierende Workload Identity Federation (mTLS Application Default Credentials) — kurzlebige GCP-Token, die aus einem Clientzertifikat ausgestellt werden, ohne dass ein JSON für ein Dienstkonto erforderlich ist.¹⁵⁴ Vertrauen in CA-Zertifikate des Betriebssystems (v2.1.101+): TLS-Proxys in Unternehmen funktionieren nun standardmäßig — Claude Code vertraut dem Zertifikatspeicher des Betriebssystems. Legen Sie CLAUDE_CODE_CERT_STORE=bundled fest, um ausschließlich die mitgelieferten 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 Unternehmensbereitstellungen 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

Gateway-Hinweis-Header (v2.1.273): Claude Code kann Anfrage-Header hinzufügen, anhand derer ein LLM-Gateway Anfragen weiterleiten und beobachten kann: x-claude-code-request-class, x-claude-code-agent-type, x-claude-code-prev-tool-durations, x-claude-code-compaction, x-claude-code-context-compacted und seit v2.1.283 x-claude-code-prompt-id, eine zufällige UUID, die von allen Anfragen für eine einzelne Benutzereingabe einschließlich subagent-Durchläufen gemeinsam verwendet wird.²¹⁷²²⁶ Bei Verwendung einer benutzerdefinierten Basis-URL oder eines Drittanbieters wie Bedrock bleiben die Header deaktiviert, bis Sie CLAUDE_CODE_GATEWAY_HINT_HEADERS=1 festlegen. In der Dokumentation zum Gateway-Protokoll steht außerdem, dass sie bei einer direkten Verbindung zur API von Anthropic standardmäßig gesendet werden und CLAUDE_CODE_GATEWAY_HINT_HEADERS=0 sie für jede Verbindung deaktiviert.²²⁷

Überprüfung

claude doctor

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

Authentifizierungsverwaltung (v2.1.41+)

Verwalten Sie die Authentifizierung, ohne die REPL aufzurufen:⁹⁰

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

Seit v2.1.268 enthält claude auth status --json das Feld configDirectory — also das Konfigurationsverzeichnis, aus dem die CLI tatsächlich liest. Das ist hilfreich, wenn die Indirektion über CLAUDE_CONFIG_DIR dies unklar macht.²¹⁶

Seit v2.1.273 fordert die Anmeldung mit einem Claude-Konto auch Zugriff auf Ihre claude.ai plugins an.²¹⁷

Seit v2.1.286 meldet claude auth status den gespeicherten API-Schlüssel einer Console-Anmeldung als api_key statt als claude.ai.²³¹

Typischer Arbeitsablauf zum Wechseln zwischen Konten oder Organisationen:

claude auth logout && claude auth login

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

Aktualisierungen

Claude Code wird standardmäßig automatisch aktualisiert. Dabei wird beim Start und regelmäßig während Sitzungen nach Aktualisierungen gesucht. Aktualisierungen werden im Hintergrund heruntergeladen und beim nächsten Start angewendet.

Automatische Aktualisierungen deaktivieren:

export DISABLE_AUTOUPDATER=1

Oder in settings.json:

{
  "env": {
    "DISABLE_AUTOUPDATER": "1"
  }
}

Manuelle Aktualisierung:

claude update

Deinstallation

Native Installation (macOS/Linux/WSL):

rm -f ~/.local/bin/claude
rm -rf ~/.claude-code

Native Installation (Windows PowerShell):

Remove-Item -Path "$env:LOCALAPPDATA\Programs\claude-code" -Recurse -Force
Remove-Item -Path "$env:LOCALAPPDATA\Microsoft\WindowsApps\claude.exe" -Force

Konfiguration bereinigen (entfernt alle Einstellungen):

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

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 Sitzung mit /exit oder Ctrl+D beenden.

Beginnen Sie mit einem ersten Prompt, um die Sitzung thematisch auszurichten:

claude "explain the authentication flow in this project"

Expertentipp: Die REPL behält ihren Zustand auch bei Komprimierungsvorgängen 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 eigene Anweisungen dazu hinzufügen, welche Inhalte erhalten bleiben sollen.

Nicht interaktiver Modus

Der Ausgabemodus (-p) führt eine einzelne Anfrage aus und beendet sich anschließend:

# 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 gestreamter 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 erledigte Arbeit erscheint als Zusammenfassung. Der Flag --forward-subagent-text (oder CLAUDE_CODE_FORWARD_SUBAGENT_TEXT=1) leitet auch Text- und Denkprozessausgaben von subagents an den Stream weiter. Dadurch können Testumgebungen und Protokollierungspipelines delegierte Arbeit während ihrer Ausführung beobachten, anstatt nur den Abschlussbericht zu sehen.¹⁸⁸

Auch verschachtelte subagents werden jetzt weitergeleitet (v2.1.219). Ursprünglich wurden nur subagents auf Tiefe 1 ausgegeben. Auf Tiefe 2 und tiefer gestartete subagents erscheinen nun ebenfalls im weitergeleiteten Stream. Jeder Eintrag wird dabei über die tool_use-ID des Agent-Aufrufs identifiziert, durch den er gestartet wurde. So kann eine Pipeline den Delegationsbaum rekonstruieren, statt lediglich eine flache Textliste zu sehen. Dies ergänzt direkt die in derselben Version wiederhergestellte standardmäßige Verschachtelungstiefe 3: Ohne diese Änderung wären 2 der 3 Ebenen unsichtbar geblieben.¹⁹⁶

Im Hintergrund ausgeführte subagents verstummen nicht mehr (v2.1.273): In SDK- und stream-json-Ausgaben gingen die verbleibenden Nachrichten und der Abschlussbericht eines subagents nicht mehr verloren, nachdem dieser während der Ausführung in den Hintergrund verschoben wurde, beispielsweise durch CLAUDE_AUTO_BACKGROUND_TASKS.²¹⁷

Eine hängende -p-Ausführung meldet jetzt einen Fehler (v2.1.277): claude -p- und Agent-SDK-Sitzungen konnten bei einem internen Fehler zuvor ohne Ergebnis hängen bleiben – der denkbar schlechteste Fehlermodus für eine Pipeline, da nur ein externer Timeout die Ausführung beendet. Jetzt melden sie den Fehler und werden mit Code 1 beendet, sodass die nachfolgende Exit-Code-Tabelle wieder den vollständigen Vertrag abbildet. Dieselbe Version sorgt außerdem dafür, dass Headless-Sitzungen ihre Kosten- und Nutzungssummen beim Beenden speichern: Bei einer Headless-Fortsetzung (claude -p --resume, SDK, Neuladen eines VS Code-Erweiterungsfensters) beginnen die Sitzungssummen nicht mehr bei null. Dadurch werden die Kosten über fortgesetzte Headless-Ausführungen hinweg nicht länger zu niedrig erfasst.²¹⁹

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-5

# Bare mode: skip hooks, LSP, plugin sync, skill walks (v2.1.81+); only CLI-named MCP servers (v2.1.286)
claude -p "count files" --bare

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

# Restricted mode for eval harnesses and shared machines (v2.1.248+)
claude --restricted -p "query" --tools "Read,Grep,Glob"

# Unattended hosts: deny anything that would prompt (v2.1.259+)
claude -p "run the nightly checks" --permission-prompts none

Eingeschränkter Modus (v2.1.248+): --restricted (oder CLAUDE_CODE_RESTRICTED=1) ist für Evaluierungsumgebungen vorgesehen, die claude auf einem gemeinsam genutzten Rechner ausführen. Der Modus entfernt die integrierten Tools zum Ausführen von Befehlen oder Code sowie WebFetch, sofern Sie diese nicht einzeln unter --tools angeben – die Voreinstellung default zählt nicht. Außerdem beschränkt er die integrierten Datei-Tools auf die Arbeitsverzeichnisse, lädt ausschließlich verwaltete Einstellungen und --settings (Einstellungsdateien auf Benutzer-, Projekt- und lokaler Ebene werden ignoriert), verweigert bypassPermissions und verhindert das Erstellen von Cloud-Sitzungen.²⁰⁶²⁰⁹

--permission-prompts none (v2.1.259): die Ergänzung für unbeaufsichtigte Hosts. Alles, was eine Berechtigungsabfrage auslösen würde, wird automatisch abgelehnt. Gleichzeitig trifft der aktive Berechtigungsmodus – einschließlich des automatischen Modus – weiterhin jede Entscheidung, die ohne Ihre Mitwirkung möglich ist. Verwechseln Sie dies nicht mit --permission-prompt-tool, das Abfragen an ein MCP-Tool delegiert, anstatt sie abzulehnen. Die CLI-Referenz führt den neuen Flag noch nicht auf; maßgeblich ist das CHANGELOG.²¹¹

cd bleibt in nicht interaktiven Sitzungen über mehrere Interaktionen hinweg erhalten (v2.1.265): Mit stream-json-Eingaben versorgte -p-Sitzungen, Agent-SDK-Sitzungen und Cloud-Sitzungen setzen das Arbeitsverzeichnis der Shell nicht mehr bei jeder neuen Benutzernachricht zurück – ein cd in einer Interaktion gilt nun auch in der nächsten.²¹⁵

--system-prompt-snapshot off (v2.1.267): Standardmäßig verwendet ein Gespräch bei jeder Anfrage seinen aufgezeichneten System-Prompt erneut. Mit diesem Flag wird der System-Prompt stattdessen für jede Anfrage neu erzeugt. Das ist die passende Einstellung für die iterative Überarbeitung von Prompt-Texten, bei der jede Ausführung Ihre neueste Änderung übernehmen soll, geht jedoch zulasten der Stabilität des Prompt-Caches, die der Snapshot gewährleisten soll.²¹⁶

--bare hält seine Beschränkungen ein (v2.1.286): --bare verbindet jetzt ausschließlich die in der Befehlszeile genannten MCP-Server, sendet dem Modell keine Systemerinnerungen und startet keine Hintergrundaufgaben. Ein Shell-Befehl, der seinen Timeout erreicht, wird beendet, statt in den Hintergrund verschoben zu werden. Laut Headless-Dokumentation galten diese Beschränkungen vor v2.1.286 nur teilweise; für skriptgesteuerte und SDK-Aufrufe wird --bare empfohlen.²³¹²³³

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 bewahren den Gesprächsverlauf auf, damit Sie ihn später fortsetzen können. Für komplexe Arbeiten über mehrere Sitzungen hinweg ist diese Persistenz unerlässlich:

# 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"

# Open the Claude desktop app on this directory, or on a session (v2.1.285)
claude --desktop
claude --desktop --continue

Eine laufende Sitzung mit /cd verschieben (v2.1.169+; sofortige Konfigurationsübernahme seit v2.1.246): /cd path ändert das Arbeitsverzeichnis, ohne den Prompt-Cache zu unterbrechen. Seit v2.1.246 werden die Projekteinstellungen, hooks, .mcp.json-Server (nach der üblichen Berechtigungsabfrage), skills und agents des neuen Verzeichnisses unmittelbar nach dem Wechsel wirksam, statt erst nach --resume.²⁶²²⁴⁹

Mit PRs verknüpfte Sitzungen (v2.1.27+, erweitert ab v2.1.119): Starten Sie eine Sitzung, die mit einem bestimmten Pull- oder Merge-Request verknüpft ist. Seit v2.1.119 akzeptiert --from-pr zusätzlich zu 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 unkompliziert fortsetzen. Das PR-Badge in der Fußzeile kann über die Einstellung prUrlTemplate (v2.1.119+) auf eine benutzerdefinierte Code-Review-URL verweisen – nützlich, wenn Ihr Team von PRs aus ein separates Review-Tool aufruft.¹⁵²

/resume akzeptiert PR-URLs (v2.1.122+). Wenn Sie eine PR-URL in das /resume-Suchfeld 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 laufenden 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). Für menschenlesbare Sitzungsnamen verwenden Sie stattdessen /rename und --resume.

/fork startet eine Hintergrundsitzung; /subtask ist der sitzungsinterne Fork (v2.1.212). Der Befehl /fork kopiert das aktuelle Gespräch nun in eine neue Hintergrundsitzung. Diese erhält eine eigene Zeile in claude agents, sodass Sie die Kopie eine Alternative untersuchen lassen können, während Ihre Hauptsitzung weiterläuft. Das bisherige Verhalten – ein Fork innerhalb der aktuellen Sitzung – besteht unter dem neuen Namen /subtask fort.¹⁸⁹ Seit v2.1.214 meldet eine als Fork gestartete Sitzung für den SessionStart hook die Quelle "fork" (zuvor "resume"), sodass hooks mit Quellenabgleich zwischen beiden unterscheiden können.¹⁹⁰ v2.1.216 verkürzt die /fork-Bestätigung auf eine Zeile mit dem Namen der neuen Sitzung und ihrer claude attach-ID.¹⁹² Seit v2.1.221 erstellt eine geforkte Sitzung ihren eigenen Worktree, statt im Checkout der ursprünglichen Sitzung zu arbeiten. Der Fork, der eine Alternative untersucht, kann daher nicht mehr mit den nicht committeten Dateien der Hauptsitzung kollidieren – bislang war dies der kritische Nachteil beim Auslagern einer Kopie für Experimente.¹⁹⁹ Mit v2.1.232 wird Forking auch für subagents zum Standard: Ein subagent vom Typ subagent_type: "fork" übernimmt das vollständige Gespräch und den Prompt-Cache. Zudem werden in interaktiven Sitzungen gestartete agents, die keine Teammitglieder sind, nun standardmäßig im Hintergrund ausgeführt.²⁵⁵

Claude Code speichert Sitzungen als JSONL-Transkripte. Bei der Agent-Ausführung werden eindeutige agentId-Werte vergeben; die zugehörigen Transkripte werden als agent-{agentId}.jsonl gespeichert. Beim Fortsetzen bleibt der vollständige Kontext früherer Gespräche erhalten.

Plan-Modus

Der Plan-Modus beschränkt Claude auf schreibgeschützte Erkundung – 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 drei Optionen: - „Ja, Kontext löschen und Änderungen automatisch akzeptieren“ (Shift+Tab) – beginnt mit einem neuen, vollständig für den Plan verfügbaren Kontext - „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 Einzelgenehmigung aus

Das automatische Löschen des Kontexts bei der Genehmigung ist der empfohlene Arbeitsablauf. Dadurch erhält der Plan ein frisches Kontextfenster, was die Plantreue deutlich verbessert – Claude bleibt länger auf Kurs, ohne dass ältere Gesprächsinhalte stören.

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 - Unbekannte Codebasen, bei denen die Erkundung vor der Änderung erfolgen sollte - Aufgaben mit mehreren gültigen Lösungsansätzen, zu denen Sie sich einbringen möchten

Expertentipp: Je mehr Zeit Sie im Plan-Modus investieren, desto wahrscheinlicher gelingt Claude die Implementierung. Der Plan-Modus ermöglicht praktisch risikofreie Erkundung – ohne riskante Tool-Aufrufe oder vergeudete Änderungen. Nutzen Sie ihn großzügig.

Screenreader-Modus (v2.1.208)

Claude Code enthält einen speziellen Screenreader-Modus, der die Terminaloberfläche für assistive Technologien 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 dokumentiert den Modus und seine Interaktionsmuster auf einer neuen Seite zur Barrierefreiheit in der offiziellen Dokumentation.¹⁸⁶

Keine Pause mehr vor jeder Zeile (v2.1.287): Im Screenreader-Modus werden neue oder geänderte Zeilen jetzt ausgegeben, ohne dass der Cursor zuvor am Zeilenanfang pausiert. CLAUDE_AX_PREPARK_MS legt diese Pause in Millisekunden fest; der Standardwert ist nun 0 (zuvor 50). Mit CLAUDE_AX_PREPARK_MS=50 können Sie sie wiederherstellen. Dieselbe Version behebt mehrere Probleme mit Screenreadern, darunter einen von der eingegebenen Zeichenfolge entfernt stehenden Cursor in Suchfeldern sowie fehlende geänderte Zeilen in Abfragen zur Änderungsgenehmigung.²³²²³³

Konfigurationssystem im Detail

Claude Code verwendet ein mehrschichtiges Konfigurationssystem. Die Hierarchie zu verstehen ist unerlässlich, denn höhere Ebenen überschreiben niedrigere, und Enterprise-Einstellungen lassen sich überhaupt nicht umgehen.

Konfigurationshierarchie

Einstellungen direkt im Prompt setzen: /config key=value (v2.1.181)

Seit v2.1.181 setzt /config key=value jede beliebige Einstellung direkt aus dem Prompt heraus, etwa /config thinking=false, ohne die interaktive /config-Oberfläche zu öffnen. Das funktioniert in interaktiven, -p- und Remote-Control-Sitzungen. /config --help (v2.1.183) listet die verfügbaren Kurzschlüssel auf. Mit v2.1.183 wurde zudem die interaktive /config-Oberfläche geändert: Enter und Leertaste schalten nun beide die ausgewählte Einstellung um, und Esc speichert und schließt (zuvor wurden die Änderungen verworfen).¹⁷⁴

Vollständige settings.json-Referenz

Eine vollständige Konfiguration, die alle wichtigen Optionen zeigt:

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "model": "claude-sonnet-5",
  "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": "jq -r '.tool_input.file_path' | xargs npx prettier --write"
          }
        ]
      }
    ]
  },
  "sandbox": {
    "enabled": false,
    "autoAllowBashIfSandboxed": true,
    "excludedCommands": ["git", "docker"]
  },
  "statusLine": {
    "type": "command",
    "command": "~/.claude/statusline.sh"
  },
  "cleanupPeriodDays": 30,
  "outputStyle": "Explanatory",
  "language": "en",
  "respectGitignore": true,
  "showTurnDuration": true,
  "plansDirectory": ".claude/plans",
  "spinnerVerbs": ["Thinking", "Processing", "Analyzing"],
  "spinnerTipsOverride": {
    "label": "Team tips",
    "tips": [
      "Custom tip 1",
      {"id": "tip-2", "text": "Custom tip 2", "cooldownSessions": 5, "priority": 1}
    ],
    "tipsFile": "~/.claude/team-tips.json",
    "excludeDefault": true
  },
  "skillOverrides": {
    "legacy-skill": "off",
    "manual-only-skill": "user-invocable-only",
    "compact-skill": "name-only"
  },
  "includeGitInstructions": false,
  "modelOverrides": {
    "claude-opus-5-5": "arn:aws:bedrock:us-east-2:123456789012:application-inference-profile/opus-prod",
    "claude-sonnet-5": "arn:aws:bedrock:us-east-2:123456789012:application-inference-profile/sonnet-prod"
  },
  "autoMemoryDirectory": ".claude/memory",
  "sandbox": {
    "enableWeakerNetworkIsolation": true
  }
}

skillOverrides ist nützlich, wenn ein Team eine große Skill-Bibliothek hat, deren Sichtbarkeit zur Laufzeit aber enger begrenzen möchte. Mit off blenden Sie einen Skill sowohl für das Modell als auch in der Slash-Auswahl aus, mit user-invocable-only bleibt er per Name aufrufbar, wird aber aus der Modellauswahl entfernt, und mit name-only bleibt nur der Skill-Name ohne seine vollständige Beschreibung sichtbar.¹⁵⁶

Neuere Einstellungen (v2.1.174–176):

• availableModels / enforceAvailableModels (verwaltet, ab v2.1.175): Die Allowlist availableModels schränkt ein, welche Modelle eine Sitzung auswählen kann. Mit enforceAvailableModels: true gilt die Allowlist auch für das Default-Modell: Ein Default, das auf ein nicht zugelassenes Modell auflösen würde, fällt auf das erste zugelassene Modell zurück, und Benutzer- oder Projekteinstellungen können eine verwaltete availableModels-Liste nicht mehr erweitern. Eine begleitende Korrektur (v2.1.176) schließt die Lücke, durch die eine Alias-Auswahl über ANTHROPIC_DEFAULT_*_MODEL auf ein gesperrtes Modell umleiten konnte, und /fast verweigert nun das Umschalten auf ein Modell außerhalb der Allowlist.¹⁷² Seit v2.1.187 können Organisationen Modellbeschränkungen direkt über die /model-Auswahl, --model, /model und ANTHROPIC_MODEL durchsetzen. Wer ein gesperrtes Modell auswählt, erhält die Meldung „restricted by your organization’s settings“.¹⁷⁶
• language (Verfeinerung in v2.1.176): Neben der Antwortsprache werden Sitzungstitel nun standardmäßig in der Sprache Ihrer Unterhaltung erzeugt. Setzen Sie language, um eine bestimmte Sprache für Titel festzulegen.¹⁷²
• footerLinksRegexes (v2.1.176): Per Regex zugeordnete Link-Badges in der Fußzeile, konfigurierbar über Benutzer- oder verwaltete Einstellungen.¹⁷²
• wheelScrollAccelerationEnabled (v2.1.174): Setzen Sie diesen Wert auf false, um die Scrollbeschleunigung des Mausrads im Vollbildmodus zu deaktivieren.¹⁷²

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

• vimInsertModeRemaps (v2.1.208): Eigene Tastenbelegungen für den Vim-Einfügemodus. Das klassische Beispiel ist, jj auf Escape zu legen (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, durch eine Wrapper-Programmdatei. Gedacht ist das für Unternehmens-Launcher (siehe Unternehmens-Launcher).¹⁸⁶
• Quellenbeschränkung für autoMode (v2.1.207): Die Einstellung autoMode wird nicht mehr aus der .claude/settings.local.json eines Repositorys gelesen. Konfigurieren Sie sie stattdessen in ~/.claude/settings.json. Damit ist der Weg versperrt, über den ein geklontes Repository eine Auto-Mode-Konfiguration mitliefern konnte.¹⁸⁵

Neuere Einstellungen (v2.1.217):

• emojiCompletionEnabled (v2.1.217): Autovervollständigung von Emoji-Kurzcodes in der Prompt-Eingabe. Tippen Sie :heart:, um ❤️ einzufügen, oder einen Teil wie :hea, um Vorschläge zu erhalten. Standardmäßig aktiviert; setzen Sie den Wert auf false, um die Funktion zu deaktivieren.¹⁹⁴

Neuere Einstellungen (v2.1.219):

• sandbox.network.strictAllowlist (v2.1.219): Blockiert nicht freigegebene Hosts für Befehle in der Sandbox ohne Rückfrage, statt einen Berechtigungsdialog anzuzeigen. Siehe Sandbox-Modus.¹⁹⁶
• workflowSizeGuideline (v2.1.219): Legt die empfohlene Größenrichtlinie für Dynamic Workflows in jeder beliebigen Einstellungsdatei fest (Benutzer, Projekt oder verwaltet), nicht mehr nur über /config. Dynamic Workflows verwenden standardmäßig die Richtlinie medium („aim for fewer than 15 agents“). Die /config-Zeile blendet sich aus, solange eine Einstellungsdatei den Wert vorgibt. Es handelt sich um eine Empfehlung, keine erzwungene Obergrenze. Siehe Subagents.¹⁹⁶

Neuere Einstellungen (v2.1.242–243):

• modelPicker (Benutzer oder verwaltet, ab v2.1.242): Stellt die /model-Auswahl als geordnete, beschriftete Modellliste zusammen. Erwartet wird ein Objekt mit einem options-Array und einem optionalen Boolean replaceBuiltInOptions. Jede Zeile im Array enthält ein Pflichtfeld model sowie optional label und description. model wird wörtlich übernommen, daher funktionieren Aliasse, Anthropic-IDs und Bedrock/Vertex/Foundry/Gateway-IDs gleichermaßen. Bei false (Standard) werden die Zeilen hinter den eingebauten Modellen angehängt, bei true zeigt die Auswahl nur Ihre Zeilen, Default und das Modell, mit dem die Sitzung bereits läuft. Claude Code liest den Schlüssel aus verwalteten Einstellungen, --settings und Benutzereinstellungen und ignoriert ihn in Projekt- und lokalen Einstellungen. Ein geklontes Repository kann die Auswahl also nicht umbeschriften. Die höchste Quelle, die den Schlüssel setzt, liefert die gesamte Liste. Eine availableModels-Allowlist gilt weiterhin für jede Zeile, und ein Label ändert nur die Anzeige in der Auswahl, nicht das tatsächlich verwendete Modell.²⁵⁰²⁴⁸
• promptCacheTtl / subagentPromptCacheTtl (beliebige Datei, ab v2.1.242): "5m" oder "1h" pro Request-Bucket. So können Benutzer mit API-Schlüssel oder Cloud-Anbietern den Cache für die Hauptunterhaltung eine Stunde lang halten, während Subagents bei fünf Minuten bleiben. Siehe Caching-Strategien.²⁵⁰²⁴⁸
• modelPricing (verwaltet, ab v2.1.243): Die vertraglich vereinbarten Preise pro Modell und der Rabattfaktor einer Organisation. /cost, die Statuszeile und die Kostenangaben in der Telemetrie verwenden diese Werte statt der Listenpreise. Siehe Kosten anzeigen.²⁵⁰

Neuere Einstellungen (v2.1.247): - feedbackDrafts (v2.1.247): steuert das neue SendFeedback-Tool: Läuft in einer Sitzung etwas schief, kann Claude einen Feedback-Bericht entwerfen, den Sie über /feedback prüfen und absenden. Mit dieser Einstellung lässt sich das Entwerfen abschalten. Siehe die Zeile zu /feedback unter Slash Commands.²⁴⁵ - Erweiterte Form von spinnerTipsOverride (v2.1.247): Tipp-Einträge können neben einfachen Strings nun auch {id, text, cooldownSessions, priority}-Objekte sein. Zudem erhält das Objekt die Schlüssel tipsFile und label, sodass Organisationen eigene Tipps neben den integrierten rotieren lassen können (das obige Beispiel zeigt die erweiterte Form). Die Einstellungsreferenz dokumentiert die neuen Schlüssel inzwischen.²⁴⁵²²⁷

Neuere Einstellungen (v2.1.248–251):

• desktopSessionCleanupPeriodDays (v2.1.248): begrenzt, wie lange vom Desktop geschriebene Sitzungen von der Transkript-Bereinigung ausgenommen bleiben. Wichtiger als der Regler selbst ist der Fix, mit dem er kam: Claude-Desktop- und Cowork-Sitzungen verschwanden früher nach cleanupPeriodDays (Standard 30 Tage); die Bereinigung behält sie nun, solange sie in der App vorhanden sind, es sei denn, eine Organisationsrichtlinie regelt die Aufbewahrung.²⁰⁶
• Einschränkungen für Projekt-env (v2.1.251): Ein env-Block in einer projektweiten .claude/settings.json kann CLAUDE_CONFIG_DIR, CLAUDE_CODE_TMPDIR oder TMPDIR/TMP/TEMP nicht mehr setzen. Legen Sie diese stattdessen in Ihrer Shell, in den Benutzer- oder in den verwalteten Einstellungen fest. So kann ein geklontes Repository nicht umleiten, wohin Claude Code seine Konfigurations- und temporären Dateien schreibt.²⁰⁶

Neuere Einstellungen (v2.1.257-259):

• timeFormat / timeZone (v2.1.257): steuern, wie Claude Code Uhrzeiten darstellt: die Abschlussuhr am Ende eines Turns und die Zeitstempel im Transkript. timeFormat akzeptiert 12 Stunden, 24 Stunden, 24 Stunden UTC oder ein explizites strftime-Muster; timeZone benennt die Zeitzone.²¹¹ Die Einstellungsreferenz dokumentiert inzwischen beide Schlüssel.²²⁷
• permissions.blockReadsOutsideWorkingDirectories (v2.1.257): verweigert Dateilesezugriffe außerhalb der Arbeitsverzeichnisse der Sitzung grundsätzlich. Ohne diese Einstellung fragt der Auto-Modus jetzt einmal vor dem ersten solchen Lesezugriff der Sitzung nach (siehe Auto Mode).²¹¹ v2.1.273 schließt zwei Lücken: Ein Bash-Befehl, den die Prüfung nicht vollständig analysieren kann, löst eine Rückfrage aus, statt die Prüfung zu überspringen, und ein von den Einstellungen eines Repositorys gewähltes Memory-Verzeichnis wird unter dieser Einstellung weder geladen, abgerufen noch indexiert.²¹⁷
• managedMcpServers / managedSourcesBehavior: Schlüssel im verwalteten Bereich, behandelt unter Enterprise Deployment: Organisationen, die allen Benutzern MCP-Server bereitstellen (v2.1.259), und das optionale Zusammenführen über verwaltete Quellen hinweg (verfeinert in v2.1.257).²¹¹²⁴⁴

Neuere Einstellungen (v2.1.261):

• bashOutputMaxChars / taskOutputMaxChars (v2.1.261): erhöhen, wie viel Befehlsausgabe (bzw. Ausgabe von Hintergrund-Tasks) Claude inline erhält, bevor der Rest in einer Datei gespeichert wird, bis zu 128K Zeichen. Das ist ein anderer Mechanismus als die Umgebungsvariable BASH_MAX_OUTPUT_LENGTH, die das Rücklesefenster aus der Ausgabedatei des Befehls festlegt (standardmäßig 30.000 Zeichen, höchstens 150.000): Diese Schlüssel regeln die Schwelle zwischen Inline-Ausgabe und gespeicherter Datei. Jenseits davon landet die Ausgabe in einer Datei, die Claude bei Bedarf lesen kann, statt abgeschnitten zu werden.²¹⁴ Seit v2.1.265 hat auch die gespeicherte Seite eine Obergrenze: Auf die Festplatte geschriebene Tool-Ergebnisse sind auf 1 GB begrenzt, und die Vorschau in der Unterhaltung weist darauf hin, wenn eine gespeicherte Datei gekürzt wurde.²¹⁵ Die Task-Hälfte wurde in v2.1.277 außer Dienst gestellt: Das veraltete TaskOutput-Tool wurde entfernt – Claude liest die Ausgabedatei eines Hintergrund-Tasks stattdessen mit Read –, und taskOutputMaxChars sowie TASK_MAX_OUTPUT_LENGTH haben keinerlei Wirkung mehr. bashOutputMaxChars ist davon nicht betroffen.²¹⁹

Neuere Einstellungen (v2.1.267-269):

• maxEffortLevel (v2.1.267): begrenzt die Effort-Stufe, die Benutzer wählen können – global oder pro Modell unter modelSettings – und gilt bei jedem Anbieter, einschließlich Bedrock, Vertex und Foundry. Stufen unterhalb der Grenze bleiben wählbar; die administrative Ergänzung zu /effort.²¹⁶
• advisorModel: das gespeicherte Advisor-Modell (fable, opus, sonnet oder eine vollständige ID), das /advisor in die Benutzereinstellungen schreibt; --advisor überschreibt es für eine Sitzung, und CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1 schaltet das Tool ab. Siehe The Advisor Tool.²⁷⁴
• sandbox.allowNestedUserNamespaces (v2.1.305): erlaubt Befehlen in der Sandbox unter Linux und WSL2, User Namespaces anzulegen (Chromium, rootless podman). Da sie damit die Dateischutzmechanismen der Sandbox umgehen können, wird die Einstellung nur aus Benutzer- oder verwalteten Einstellungen gelesen. Siehe Sandbox Mode.²⁷⁸²⁷⁹
• bashEditDiffEnabled (v2.1.269): Übernimmt das Bash-Tool eine Dateiänderung, enthält das Tool-Ergebnis einen Diff der vom Befehl geänderten Dateien, sodass die Unterhaltung zeigt, was eine Bearbeitung im Stil von sed tatsächlich bewirkt hat.²¹⁶

Neuere Einstellungen (v2.1.275):

• syncClaudeAiSkills / syncClaudeAiPlugins (v2.1.275): Die in Ihrem claude.ai-Konto aktivierten Skills und Plugins werden nun in Terminal-Sitzungen synchronisiert, die mit diesem Konto angemeldet sind. Setzen Sie einen der beiden Schlüssel auf false, damit Terminal-Sitzungen ausschließlich lokale Skills und Plugins verwenden. Siehe Skills und Plugin System.²¹⁸

Neuere Einstellungen (v2.1.282-283):

• maxProseWidth (v2.1.282): begrenzt, wie breit der Fließtext von Claude in einem breiten Terminal läuft. Absätze, Überschriften, Listen und Blockzitate werden innerhalb dieser Spaltenzahl umbrochen, während Tabellen und Codeblöcke die volle Breite behalten. Der Wert ist eine ganze Spaltenzahl, mindestens 40.²²⁵²²⁷
• deniedModels / availableModelsMatch (verwaltet, v2.1.283): deniedModels sperrt bestimmte Modelle, selbst wenn availableModels sie zulässt. Ein Familien-Alias wie "opus" sperrt die gesamte Familie, und "claude-opus-5" sperrt auch Opus 5.5 (schreiben Sie "claude-opus-5-0", um nur Opus 5 zu sperren). Standardmäßig erlaubt ein availableModels-Eintrag wie "claude-opus-5" auch spätere Versionen, die darauf aufbauen; mit availableModelsMatch: "exact" erlaubt jeder Eintrag nur die Version, die er nennt, sodass ein neues Release gesperrt bleibt, bis Sie es aufführen. Claude Code liest beide Schlüssel ausschließlich aus verwalteten Einstellungen.²²⁶²²⁷
• allowClaudeInChromeWithManagedMcp (verwaltet, v2.1.282): erlaubt claude --chrome neben einer exklusiven managed-mcp.json; die Fehlermeldung bei blockiertem Chrome nennt nun den Schlüssel.²²⁵ Die Einstellungsreferenz dokumentiert ihn inzwischen: Der Schlüssel wird nur aus den eigenen verwalteten Einstellungen des Geräts gelesen, und ein deniedMcpServers-Eintrag für claude-in-chrome sperrt den Server weiterhin.²³³

Neuere Einstellungen (v2.1.285):

• allowedProviders (verwaltet, v2.1.285): schränkt ein, welche API-Anbieter ein Rechner nutzen darf: die Anthropic API, einen benutzerdefinierten Endpunkt, Bedrock, Mantle, Vertex AI, Foundry, Claude Platform on AWS oder ein Cloud-Gateway.²²⁹ Die Einstellungsreferenz dokumentiert den Schlüssel; eine Liste aus den eigenen Admin-Quellen des Rechners gilt weiter, wenn auch serververwaltete Einstellungen eine liefern, sodass eine Sitzung nur Anbieter nutzen darf, die auf beiden Listen stehen.²³³

Einstellungen nachschlagen: die meistgesuchten Flags

Wenn Sie hier nach einer bestimmten Einstellung suchen, finden Sie sie in diesem Kurzindex. Jeder Eintrag nennt das Release, mit dem er erschienen ist, und gegebenenfalls den Bereich, dem er gehört:

Wo finden Sie die offizielle Dokumentation zu jedem Thema?

Dieser Guide ist ein Praxishandbuch, keine maßgebliche Referenz. Wenn Sie die kanonische Seite von Anthropic zu einem Subsystem benötigen, finden Sie hier die offiziellen Fundstellen (jeder Abschnitt dieses Guides verlinkt zusätzlich auf seine eigene):

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; credential/org/routing/API-behavior headers set from managed or project settings require approval (v2.1.251)[^238]

Modellkonfiguration:

ANTHROPIC_MODEL=claude-opus-4-7                 # Override default model (Apr 16, 2026)
ANTHROPIC_DEFAULT_MODEL=claude-opus-5-5         # Model new sessions START on; a /model pick overrides + persists (v2.1.236)
ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5    # What the `opus` alias resolves to (Opus 5.5 since v2.1.280; Opus 5 v2.1.219-278)
ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-4-6
ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5-20251001  # pin the haiku alias; on the Anthropic API it resolves to Haiku 5.5 (claude-haiku-5-5) as of v2.1.293[^274][^275]
CLAUDE_CODE_SUBAGENT_MODEL=sonnet               # Default model for subagents; an agent's model: field and per-spawn picks win (v2.1.251 demoted it from override to default)[^238]
CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1             # Turn the advisor tool off: /advisor becomes unavailable, advisorModel is ignored, --advisor is accepted but does nothing[^282]
CLAUDE_CODE_SUBAGENT_MODEL_FORCE=1              # Force every subagent onto CLAUDE_CODE_SUBAGENT_MODEL (or the main model), ignoring agent-definition and per-spawn overrides -- the pre-v2.1.251 behavior, opt-in (v2.1.257)[^243]
CLAUDE_CODE_DISABLE_WORKFLOWS=1                 # Turn dynamic workflows off for one session; same effect as "disableWorkflows": true, and whichever of the two turned them off, the other cannot turn them back on. Workflows are on by default except on Pro, where "enableWorkflows": true (the Dynamic workflows row in /config) turns them on; the v2.1.147 opt-in CLAUDE_CODE_WORKFLOWS=1 no longer appears in the env-vars reference[^291]
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_MAX_TURNS=10                        # Cap agentic turns when no --max-turns is passed; the flag wins when both are set, and a value that is not a positive integer is rejected at startup[^291]
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1          # Enable agent teams (v2.1.32+)

Konfiguration des Cloud-Anbieters:

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
VERTEX_REGION_CLAUDE_HAIKU_5_5=us-east5          # Vertex region for Claude Haiku 5.5 (v2.1.293+)[^276]
CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1    # Opt in gateway /v1/models discovery for /model picker (v2.1.129+)[^164]
CLAUDE_CODE_GATEWAY_MODEL_DISCOVERY_TIMEOUT_MS=3000  # Extend the LLM gateway /v1/models discovery timeout (default 3s; v2.1.269+)[^252]
CLAUDE_CODE_GATEWAY_HINT_HEADERS=1              # Send the x-claude-code-* hint headers (request-class, agent-type, prev-tool-durations, compaction, context-compacted, and prompt-id from v2.1.283) through a gateway or third-party provider; a direct Anthropic API connection sends them by default, and =0 stops them everywhere (v2.1.273+)[^253][^262][^263]
CLAUDE_CODE_AUTO_MODE_SERVER=0                  # Opt out of the server-side auto-mode checks, the default since v2.1.278 for Enterprise and Claude API accounts, Claude Platform on AWS, Bedrock, Agent Platform, Foundry, and gateways (not charged when the server performs them; =1 was the v2.1.273-277 opt-in); also applies on a direct Anthropic API connection since v2.1.281, where server-side is the default with telemetry off since v2.1.282; the docs call it temporary[^253][^255][^259][^260][^261]
CLAUDE_CODE_AUTO_MODE_MODEL=claude-sonnet-5-5   # Model the client-side auto mode classifier uses; no effect on server-side auto mode (v2.1.302+)[^283]

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
CLAUDE_CODE_DISABLE_WEB_FETCH=1                 # Turn off the WebFetch tool; WebSearch stays available (v2.1.285+)[^265][^269]
CLAUDE_CODE_DISABLE_ARTIFACT=1                  # Turn the Artifact tool off for one session; while it is set, no settings file turns artifacts back on[^291]
CLAUDE_CODE_ARTIFACT_AUTO_OPEN=0                # Do not open the browser when a new artifact is published[^291]
CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES=2      # Cap re-sends of a non-streaming fallback request that timed out (v2.1.285+)[^265]
CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS=5000 # Starting delay of the exponential backoff between retries of a 529 overloaded request, default 500; whole milliseconds from 500 to 32000; no effect with CLAUDE_CODE_RETRY_WATCHDOG=1 or in fast mode (v2.1.292+)[^272][^276]
CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS=60000 # Ceiling of that backoff, default 32000 ms (v2.1.296+; in the env-vars docs since October 14)[^274][^280]
CLAUDE_CODE_RETRY_WATCHDOG=1                     # Unattended sessions: retry 429 and 529 capacity errors indefinitely, backing off up to 5 minutes or until the limit resets (v2.1.186+)[^276]
CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS=1800000   # Cap, per request, on how long the watchdog waits out 429 and 529 errors; unset means no limit (v2.1.295+)[^274][^276]
CLAUDE_CODE_RETRY_WATCHDOG_MAX_USAGE_LIMIT_WAIT_MS=3600000 # Under the watchdog, end a request at a usage limit that resets further away than this instead of waiting it out (v2.1.301+)[^283]
CLAUDE_CODE_RETRY_WATCHDOG_USAGE_LIMIT_RECHECK_MS=60000 # Minimum interval between checks that a usage limit was lifted before its reset, while the watchdog waits on it (v2.1.305+)[^286][^287]
CLAUDE_CODE_RESTRICTED=1                        # Restricted mode: no command/code tools or WebFetch unless named in --tools; only managed settings load (v2.1.248+)[^238]
CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT=1      # Keep the dangerous-rm prompt waiting in auto mode and --dangerously-skip-permissions instead of denying after 2 minutes (v2.1.281+)[^260]
CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT=1    # Skip the prompt for a recursive rm whose target is only command-substitution output, such as rm -rf "$(pwd)" (v2.1.281+)[^260]
CLAUDE_CODE_STRICT_INLINE_SHELL_RM_PROMPT=1     # Keep prompting for an rm built at run time inside a shell -c script Claude Code cannot read; such scripts no longer prompt by default (v2.1.299+; release-notes only as of 2026-10-14)[^279][^280]
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+)
CLAUDE_CODE_PROMPT_CACHE_TTL=1h                 # Main-conversation cache TTL, 5m or 1h; beats the promptCacheTtl setting (v2.1.242+)[^234]
CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL=5m        # TTL for subagents, workflows, forks, compaction, titles; beats subagentPromptCacheTtl (v2.1.242+)[^234]
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=0                     # Turn fork subagents off; on by default in the terminal and, since v2.1.302, in claude -p, the Agent SDK, the desktop app, and VS Code (=1 was the external-build opt-in from v2.1.117; claude mcp serve never offers them)[^160][^283]
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+). Since v2.1.290 an interactive session's budget refills instead of ending at 200 (next line); the env-vars docs, fetched Oct 6, still describe the 200 cap[^206][^271][^273]
CLAUDE_CODE_WEB_SEARCH_REFILLS_PER_HOUR=100     # WebSearch budget refill rate: 100 calls/hour by default in an interactive session, 0 (off) in a non-interactive one (v2.1.290+)[^271][^276]
CLAUDE_CODE_DISABLE_ATTACHMENTS=1               # Send @-mentions as plain text instead of expanding file content; a repo's .claude/settings.json or settings.local.json can no longer set it (v2.1.290)[^271][^273]
CLAUDE_CODE_DISABLE_FILE_MENTIONS=1             # Hand Claude the path of an @ mention to read with its file tools, not the file's contents, so PreToolUse hooks see the read; ignored in project and local settings (v2.1.299+)[^279][^280]
CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS=900000        # WebFetch per-URL session cache TTL (default 15 min; v2.1.233+)[^226]
CLAUDE_CODE_WEBFETCH_DEADLINE_MS=300000         # WebFetch hard deadline: a server that never finishes its response fails the fetch after 300s by default; 0 disables (v2.1.268+)[^252]
CLAUDE_CODE_PROJECT_DIR_NAME=myproj             # Short name for the per-project transcript directory, for hosts that give each session its own config dir (v2.1.234+)[^227]
CLAUDE_CODE_GOAL_CHECKIN_MINUTES=30             # How long background tasks may keep a /goal waiting before Claude checks in on them; 0 disables (v2.1.234+)[^227]
CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION=200       # Per-session subagent-spawn cap (default 200 in v2.1.212–223; the default cap was REMOVED in v2.1.224 — set this to reimpose one)[^206][^218]
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_WORKFLOW_PREFIX_STAGGER_MS=0        # Disable the v2.1.229 workflow fan-out stagger (same-prefix sibling agents launch staggered so they read the cached prompt prefix instead of re-paying it)[^224]
CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS=64   # Raise the Workflow tool's per-run concurrent agent limit, 1-256, for inference-bound fan-outs (v2.1.269+)[^252]
CLAUDE_CODE_WORKFLOW_SUBAGENT_MODEL=sonnet         # Run every workflow agent on one model while other subagents keep theirs (v2.1.296; release-notes only as of 2026-10-14)[^274][^280]
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                    # Read-back window from the Bash working output file (default 30,000 chars, hard ceiling 150,000)
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_MAX_MCP_DESCRIPTION_LENGTH=8192     # Override the cap on MCP tool descriptions and server instructions, every server in the session: 4,096 chars since v2.1.296, 2,048 in v2.1.280-295; Anthropic's first-party servers at api.anthropic.com are uncut since v2.1.299[^279][^256][^274]
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]
CLAUDE_CODE_MCP_STARTUP_WAIT_MS=10000           # Bound how long the FIRST non-interactive turn waits for still-connecting MCP servers; 0 = don't wait (v2.1.274+)[^254]
CLAUDE_CODE_TOOL_MEMORY_LIMIT=4096              # Opt-in Linux memory cgroup (MB) for Bash tool commands — a runaway build can't stall the session (v2.1.233+)[^226]
CLAUDE_CODE_ENABLE_TODO_TOOLS=1                 # Offer the TodoWrite/TaskCreate-family tools on models outside v2.1.268's allowlist (Claude 3.x, Opus 4.0-4.7, Sonnet 4.0-4.6, Haiku 4.5); elsewhere they are off unless set (first turned off on newer models in v2.1.233)[^226][^252]
SLASH_COMMAND_TOOL_CHAR_BUDGET=15000            # Slash command context limit

Zeitlimit für Hintergrundbefehle (v2.1.285, in v2.1.288 eingeschränkt): Bash- und PowerShell-Befehle im Hintergrund werden nach Ablauf eines Zeitlimits beendet. Maßgeblich ist ihr timeout beim Start mit run_in_background (Standard 30 Minuten, maximal 2 Stunden), und Claude wird benachrichtigt, sobald ein solcher Befehl beendet wird.²²⁹ Seit v2.1.288 greift das Limit nur noch in unbeaufsichtigten Sitzungen (-p, das Agent SDK, CI- und Cloud-Sitzungen). In Terminal-, Desktop-App- und VS-Code-Sitzungen gilt für Hintergrundbefehle kein Limit. Die Tool-Referenz bestätigt das: „Before v2.1.288, it applied in every session.“²³⁴²³⁷

Netzwerk und Proxy:

HTTP_PROXY=http://proxy:8080                    # HTTP proxy
HTTPS_PROXY=https://proxy:8080                  # HTTPS proxy
CLAUDE_CODE_GZIP_REQUEST_BODIES=0              # Turn off gzip compression of large request bodies sent to api.anthropic.com, on even with telemetry off since v2.1.300[^281][^282]
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; not settable from project-settings env (v2.1.251)[^238]
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; not settable from project-settings env, nor are TMPDIR/TMP/TEMP (v2.1.251)[^50][^238]
CLAUDE_CODE_DISABLE_1M_CONTEXT=1               # Hold ALL native-1M models to 200K via auto-compaction (v2.1.223 widened scope); also the opt-out for the v2.1.287 1M default on Bedrock/Vertex/Foundry/Claude apps gateway[^103][^217][^268]
CLAUDE_CODE_AUTO_COMPACT_WINDOW=200k           # Auto-compact window, 100000 to 1000000 tokens; k and M suffixes since v2.1.304 (200k had set a 100K window), out-of-range values warn[^286][^287]
CLAUDE_CODE_DISABLE_ULTRAREVIEW_TRUST_CHECK=1  # Let claude ultrareview run in a folder you have not trusted where it cannot ask, such as CI; environment only, not a settings env block (v2.1.309+)[^286][^287]
CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS=150000     # Context size at which idle compaction applies, default 200000; values below 100000 are raised to 100000; "idleCompaction": false in settings.json turns the feature off (v2.1.299; the docs date both to v2.1.290+)[^279][^280]
CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT=1  # Let unrecognized model IDs exceed the assumed context window (v2.1.223)[^217]
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_CODE_BG_TASKS_REPORT_RUNNING=0         # Restore pre-v2.1.269 behavior: remote/headless sessions may report "waiting for your input" while background agents still run[^252]
CLAUDE_AX_SCREEN_READER=1                     # Enable screen reader mode; same as --ax-screen-reader or "axScreenReader": true (v2.1.208+)[^203]
CLAUDE_AX_PREPARK_MS=50                       # Screen reader mode: pause before writing a changed line; default 0 since v2.1.287 (was 50)[^268][^269]
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 Freigabe sensibler 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+); as of v2.1.273 also puts real agent, skill, plugin, and MCP server names on cost and token metrics[^253]
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+)
OTEL_METRICS_INCLUDE_REPOSITORY=1             # Tag OTel metrics and events with vcs.* repository attributes; with OTEL_LOG_TOOL_DETAILS, commit events carry vcs.ref.head.* (v2.1.269+)[^252]
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; v2.1.290 also skips the startup connection warm-up[^271]
CLAUDE_CODE_ATTRIBUTION_HEADER=0              # Omit the system-prompt attribution block; behind a Claude apps gateway, set it in the env of the gateway's code or cli policy (v2.1.299+)[^279][^280]

Projekteinstellungen können Telemetrie nicht einschalten (v2.1.282): Projekt- und lokale Einstellungsdateien ignorieren jetzt die OpenTelemetry-Variablen, die den Export einschalten, seinen Endpunkt festlegen oder Inhalte erfassen, etwa CLAUDE_CODE_ENABLE_TELEMETRY, die OTEL_*_EXPORTER-Selektoren und OTEL_LOG_*. Werte, die etwas ausschalten (none für einen Exporter-Selektor, 0 für ein Inhalts-Flag), gelten aus diesen Dateien weiterhin. Alles Übrige setzen Sie in Ihrer Shell, in den Benutzereinstellungen oder in den verwalteten Einstellungen. Eine interaktive Sitzung zeigt beim Start einen Hinweis, wenn eine Projektdatei eine dieser Variablen setzt, und /status sowie claude doctor listen die ignorierten Namen auf; -p- und Agent-SDK-Sitzungen zeigen keinen Hinweis. Prüfen Sie deshalb nach dem Upgrade, ob Ihr Collector weiterhin Daten empfängt.²²⁵²²⁷

Span-Attribute für LLM-Anfragen ab v2.1.121: stop_reason, gen_ai.response.finish_reasons und user_system_prompt werden jetzt auf LLM-Anfrage-Spans ausgegeben. user_system_prompt ist hinter OTEL_LOG_USER_PROMPTS=1 geschaltet, da es personenbezogene Daten enthalten kann.¹⁵⁴

Änderungen auf Event-Ebene ab v2.1.122: Numerische Attribute der Log-Events api_request und api_error werden jetzt als Zahlen ausgegeben (bisher als Strings). Das behebt Probleme bei nachgelagerten OTel-Collectors, die das Schema strikt typisieren. Das neue Log-Event claude_code.at_mention wird ausgelöst, wenn Claude Code eine @-Erwähnung auflöst.¹⁵⁴

Attribute in v2.1.300: api_request-Events teilen Cache-Schreibvorgänge in cache_creation_5m_tokens und cache_creation_1h_tokens auf; Trace-Spans tragen Attribute der GenAI-Semantic-Conventions (gen_ai.provider.name, gen_ai.conversation.id, gen_ai.tool.name, error.type); user_prompt-Events und Interaktions-Spans erfassen den Prompt in der Form, in die ihn der prompt.submit-Hook eines Mods umgeschrieben hat; und tool_result-Events tragen nach git commit -q in Reftable-Repositorys git_commit_id.²⁷³

Attribute in v2.1.301 und v2.1.302: tool_decision-Events tragen classifier_verdict und permission_mode, sodass sich eine Entscheidung des Auto-Mode-Classifiers von einer Berechtigungsregel unterscheiden lässt, und mit OTEL_LOG_TOOL_DETAILS=1 außerdem classifier_category, das die eingebaute Regel benennt, auf die eine Classifier-Blockierung zutraf (v2.1.301). v2.1.302 füllt classifier_category für die meisten Classifier-Blockierungen, bei denen es bisher fehlte, und behält tool_use_id, tool_source und tool_parameters auf dem Event, wenn OTEL_LOGRECORD_ATTRIBUTE_COUNT_LIMIT niedrig ist. Die Monitoring-Dokumentation führt die drei Attribute noch nicht auf.²⁷⁵²⁷⁶

Event in v2.1.307: claude_code.safety_event wird für jeden Tool-Aufruf ausgelöst, den eine Berechtigungsregel, der Auto-Mode, eine Sicherheitsprüfung, ein Hook oder die Sandbox gestoppt, mit einer Rückfrage versehen oder zurückgeschickt hat; tool_use_id ist dabei enthalten, außer bei Events am Ende eines Turns. Die Monitoring-Dokumentation führt das Event auf und listet inzwischen auch classifier_verdict (ab v2.1.301).²⁷⁸²⁷⁹

Log-Event claude_code.assistant_response ab v2.1.193: Claude Code kann den vollständigen Antworttext des Modells als OTel-Log-Event ausgeben, gesteuert über OTEL_LOG_ASSISTANT_RESPONSES. Diese Steuerung birgt einen Fallstrick beim Upgrade, den Sie kennen sollten: Ist OTEL_LOG_ASSISTANT_RESPONSES nicht gesetzt, folgt es OTEL_LOG_USER_PROMPTS. Jedes Deployment, das bereits Prompt-Inhalte protokolliert, empfängt nach dem Upgrade also auch die Inhalte der Assistant-Antworten. Setzen Sie OTEL_LOG_ASSISTANT_RESPONSES=0, wenn die Telemetrie weiterhin nur Prompts erfassen soll.¹⁷⁹

Telemetrie-Erweiterungen in v2.1.214: OTel-Log-Events tragen jetzt die Attribute message.uuid, client_request_id und tool_source für die Korrelation auf Nachrichtenebene und die Herkunft von Tools; die subagentStatusLine-Payload enthält den Reasoning-Effort des Subagents, sodass benutzerdefinierte Statuszeilen Modell und Effort gemeinsam anzeigen können; und die neue Umgebungsvariable CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH konfiguriert das Kürzungslimit von 60 KB für OTel-Inhaltsattribute.¹⁹⁰

Gateway-Telemetrie in v2.1.265: Sitzungen über das Claude-Apps-Gateway exportieren OpenTelemetry jetzt direkt an einen Collector, wenn die verwalteten Einstellungen des Gateways einen in OTEL_EXPORTER_OTLP_ENDPOINT benennen, statt über das Relay des Gateways zu laufen; Sitzungen ohne benannten Collector nutzen weiterhin das Relay. Dasselbe Release ergänzt user.email und user.groups in der Telemetrie, die Claude Desktop und Cowork über ein Claude-Apps-Gateway senden – passend zu Terminal-Sitzungen.²¹⁵

Hook-Telemetrie in v2.1.280: Das OTel-Event hook_execution_complete trägt jetzt die Größen der Hook-Ausgaben und die Anzahl übergroßer Ausgaben, die in eine Datei gespeichert wurden.²²⁰

prompt_text in v2.1.287: Das user_prompt-Event trägt jetzt prompt_text, eine Kopie von prompt für Backends, die Schlüssel mit Punkten verschachteln. Wo Ihre Pipeline prompt verwirft oder maskiert, sollten Sie mit prompt_text ebenso verfahren.²³²

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+); a Read call with allow_large can pass it when the context has room (v2.1.296+)[^274][^276]
CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK=1   # Do not fall back to non-streaming API on streaming failures (v2.1.83+)
CLAUDE_CODE_DISABLE_STRUCTURED_OUTPUTS=1      # Stop sending structured outputs, for Mantle or gateways that reject them; session titles, memory recall, and prompt hooks failed there before (v2.1.288+)[^270][^273]
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+)
MCP_SDK_GENERATION=v1                         # Opt out of the v2 MCP client; v2.1.274 made v2 the default on the last holdouts (Bedrock/Vertex/Foundry + telemetry-disabled installs)[^254]
MCP_PROTOCOL_NEGOTIATION=legacy               # Opt out of MCP 2026-07-28 protocol negotiation: with direct HTTP servers (default everywhere as of v2.1.274) and, since v2.1.292, with local (stdio) servers on every install, Bedrock, Vertex, and Foundry included and, since v2.1.299, with cloud session and Remote Control connectors[^279][^254][^272]

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+)

Enterprise / 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 (ab v2.1.69):

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

Aufruferidentität bei SDK (ab 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

Debugging:

ANTHROPIC_LOG=debug                             # Enable API request logging

Welches Modell sollte ich wählen?

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

Verfügbare Modelle

Claude Sonnet 5.5 (28. September 2026): Das Standardmodell für Sonnet auf der Anthropic API seit v2.1.284, das über den Alias sonnet ausgewählt wird; das Standardmodell in allen Tarifen bleibt Opus 5.5. Modell-ID: claude-sonnet-5-5 (Bedrock: anthropic.claude-sonnet-5-5). $2/MTok Eingabe, $10/MTok Ausgabe, wie bei Sonnet 5, mit Cache-Lesezugriffen zu $0,10/MTok (laut Preisseite das 0,05-Fache des Eingabepreises, derselbe Satz wie bei Opus 5.5; v2.1.296 korrigiert die eigenen Kostenangaben von Claude Code, die zuvor $0,20 angesetzt hatten). Kontextfenster mit 1 Mio. Tokens, maximal 128.000 Ausgabetokens (bis zu 300.000 auf der Batches API mit dem Beta-Header output-300k-2026-03-24). Verlässlicher Wissensstand: Juni 2026, wie bei Opus 5.5 und Fable 5.1. Abschaltung frühestens am 28. September 2027. In Claude Code ist effort bei Sonnet 5.5 standardmäßig auf medium eingestellt (der eigene Standardwert der Claude API ist high), und das Denken lässt sich nicht deaktivieren. Inhaltsabhängiger Modellwechsel: Eine als Cybersicherheitsanfrage gekennzeichnete Anfrage wird erneut mit Sonnet 5 ausgeführt; eine als Biologieanfrage gekennzeichnete Anfrage wird abgelehnt, da Sonnet 5.5 kein Ausweichmodell für Biologie hat. Erfordert Claude Code v2.1.284 oder neuer; wenn Sie bei Sonnet 5 bleiben möchten, legen Sie ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5 fest.²²⁸²³⁰

Die Modellseite nennt fünf inkompatible Änderungen bei der Umstellung von API-Code von Sonnet 5: Vorgelagertes Denken wird mit between_tools deaktiviert, erzwungene Tool-Nutzung führt zu einem Fehler, Denkblöcke sind an das Modell und die Konversation gebunden, computer_20251124 wird auf der Claude API und Google Cloud nicht akzeptiert, und das Advisor-Tool lehnt Opus 4.8, Opus 4.7 und Sonnet 5 als Berater ab. Auch Text zwischen Tool-Aufrufen wird in thinking-Blöcken zurückgegeben. Eine Oberfläche, die diesen Text streamt, zeigt deshalb nichts mehr an, bis sie einen display-Wert setzt, der die Textausgabe ermöglicht.²³⁰

Claude Opus 5.5 (22. September 2026): Das neue Standardmodell für Opus in Claude Code seit v2.1.280 – und laut der Tarifübersicht in der Dokumentation zur Modellkonfiguration das Standardmodell in jedem Tarif und bei jedem Erstanbieter: Pro, Max, Team, Enterprise, die Anthropic API, Claude Platform on AWS, Amazon Bedrock und Google Clouds Agent Platform (Microsoft Foundry bleibt bei Sonnet 4.5, und der dortige Alias opus verweist auf Opus 4.6). Dieselbe Version stellt den Standard für Pro und Team Standard von Sonnet auf Opus um, „entsprechend Max, Team Premium und Enterprise“ – damit endet die tarifabhängige Aufteilung, die seit dem Wechsel der Premiumstufe zu Opus bestanden hatte. Modell-ID: claude-opus-5-5 (Bedrock: anthropic.claude-opus-5-5) – ein festgelegter Snapshot ohne Datum, nach demselben Schema wie claude-opus-5. Die Preise sinken unter die von Opus 5: $4/MTok Eingabe, $20/MTok Ausgabe (Opus 5: $5/$25), mit Cache-Lesezugriffen zu $0,20/MTok – 5 % des Eingabepreises, die Hälfte der üblichen 10 % (nur Fable 5.1 und Mythos 5.1 liegen mit 2,5 % darunter). Kontextfenster mit 1 Mio. Tokens, maximal 128.000 Ausgabetokens (bis zu 300.000 auf der Batches API mit dem Beta-Header output-300k-2026-03-24). Adaptives, dauerhaft aktives Denken – die Modellübersicht führt es mit derselben Bezeichnung „Adaptiv (immer aktiv)“ wie Fable; bei Opus 5 war das Denken standardmäßig aktiviert, ließ sich aber deaktivieren. effort ist standardmäßig auf medium eingestellt (bei Opus 5 war der Standardwert high), und v2.1.280 passt die Übernahmeregel entsprechend an: Eine Aufwandsstufe, die gespeichert wurde, bevor /effort modellspezifisch wurde, gilt nicht mehr für neu veröffentlichte Modelle wie Opus 5.5 – das Modell startet mit seinem eigenen Standardwert, bis Sie eine Stufe auswählen. Verlässlicher Wissensstand: Juni 2026 (Trainingsdaten ebenfalls Juni 2026), damit liegt es gemeinsam mit Fable 5.1 unter allen aktuellen Modellen auf dem neuesten Stand. Abschaltung frühestens am 22. September 2027. Erfordert Claude Code v2.1.280 oder neuer.²²⁰²²¹

Inkompatible Änderungen bei der Umstellung Ihres API-Codes von Opus 5 auf Opus 5.5:²²²

1. Das Denken lässt sich nicht deaktivieren. thinking: {type: "disabled"} und thinking: {type: "enabled", budget_tokens: N} geben beide einen 400-Fehler zurück. Entfernen Sie das Feld thinking und wählen Sie stattdessen eine Aufwandsstufe.
2. Erzwungene Tool-Nutzung führt zu einem Fehler. tool_choice akzeptiert nur auto und none; any und tool geben einen 400-Fehler zurück, auch am Endpunkt zur Tokenzählung. Verwenden Sie auto mit strikter Tool-Nutzung oder strukturierten Ausgaben.
3. Denkblöcke sind an das Modell gebunden. Ein Router oder Ausweichmechanismus, der eine Konversation von Opus 5.5 auf ein anderes Modell umstellt, führt die betreffenden Gesprächsschritte ohne die Denkblöcke von Opus 5.5 aus (Fable 5.1 und Mythos 5.1 auf der Claude API bilden die Ausnahme).
4. computer_20251124 wird auf der Claude API und Google Cloud abgelehnt. Deklarieren Sie stattdessen das Toolset computer_toolset_20260801; Bedrock behält das ältere Tool bei. Eine weitere Änderung lässt zwar keine Anfrage scheitern, verändert aber die Struktur der Antwort: Text, den das Modell zwischen Tool-Aufrufen schreibt, wird in thinking-Blöcken zurückgegeben, die bei der Standardeinstellung für display leer sind. Eine Oberfläche, die diese Begleittexte streamt, bleibt stumm, bis sie display: "updates" (Beta) oder "summarized" setzt.²²²

Inhaltsabhängiger Modellwechsel in Claude Code. Opus 5.5 arbeitet mit Sicherheitsklassifikatoren, die vor allem Inhalte aus Biologie und Cybersicherheit markieren. Markiert einer davon eine Anfrage, führt Claude Code sie mit einem anderen Modell erneut aus und zeigt einen Hinweis an: Bei biologischen Inhalten geht die Anfrage an Opus 5, bei Cybersicherheitsinhalten an Opus 4.8. Die Sitzung bleibt beim Ausweichmodell, bis Sie mit /model zurückwechseln. Deaktivieren Sie Modell wechseln, wenn eine Nachricht markiert wird in /config (switchModelsOnFlag: false), wenn Sie stattdessen bei jedem Wechsel gefragt werden möchten.²²³ Seit v2.1.287 bleibt beim Wechsel Ihre aktuelle Effort-Stufe erhalten, statt den Standardwert des Ausweichmodells zu übernehmen. Eine Sitzung mit dem Opus-5.5-Standard medium bleibt auf Opus 4.8 also bei medium, obwohl dort standardmäßig high gilt.²³²²³³

Claude Opus 5 (Juli 2026; vorherige Opus-Modellstufe): Die Opus-Modellstufe und das Modell, auf das der Alias opus ab v2.1.219 (24. Juli 2026) verwies, bis v2.1.280 Opus 5.5 zum Opus-Standardmodell machte; die folgende Beschreibung gibt den Stand zur Einführung im Juli 2026 wieder. Anthropic beschreibt es als direkt austauschbares Upgrade für Opus 4.8: unverändert 5 $/MTok Eingabe und 25 $/MTok Ausgabe, „deutlich verbesserte Leistung bei gleichen Kosten“ und bei maximalem Reasoning im Durchschnitt etwa 26 % weniger Tokens als Opus 4.8. Es war das Standardmodell in Claude Max und das leistungsfähigste Modell in Claude Pro. Modell-ID: claude-opus-5 — ein festgeschriebener Snapshot ohne Datumsangabe, nach demselben Schema wie claude-opus-4-8 und claude-sonnet-5, kein Verweis auf eine laufend aktualisierte Version. Kontextfenster mit 1 Mio. Tokens (kein Beta-Header, unverändert gegenüber Opus 4.8), maximal 128.000 Ausgabe-Tokens (bis zu 300.000 über die Batches API mit dem Beta-Header output-300k-2026-03-24). Ausschließlich adaptives Thinking — erweitertes Thinking mit thinking.type: "enabled" wird nicht unterstützt. Verlässlicher Wissensstand: Mai 2026 (Trainingsdaten ebenfalls bis Mai 2026) – von seiner Einführung bis zum Erscheinen von Fable 5.1 am 1. September 2026 (Wissensstand Juni 2026) der aktuellste Wissensstand aller verfügbaren Claude-Modelle.²⁴¹ Mit der Einführung von Opus 5 wandert Opus 4.8 in der Dokumentation in die Tabelle „Legacy models“, neben 4.7 und 4.6 — weiterhin verfügbar, aber nicht mehr als Standard empfohlen.¹⁹⁷

Zwei inkompatible Änderungen beim Umstieg eines Harness von Opus 4.8 auf Opus 5:¹⁹⁷

1. Thinking ist standardmäßig aktiviert. Unter Opus 4.8 wurde eine Anfrage ohne thinking-Feld ohne Thinking ausgeführt; unter Opus 5 läuft dieselbe Anfrage mit adaptivem Thinking. max_tokens bleibt eine feste Obergrenze für die gesamte Ausgabe — Thinking plus Antworttext. Prüfen Sie deshalb bei allen Workloads, die bisher ohne Thinking liefen, erneut den verfügbaren Spielraum. Übergeben Sie thinking: {type: "disabled"}, um das bisherige Verhalten wiederherzustellen; dabei gilt die Einschränkung im nächsten Punkt.
2. Thinking lässt sich nur bis zur Effort-Stufe high deaktivieren. thinking: {type: "disabled"} in Kombination mit der Effort-Stufe xhigh oder max führt zu einem 400-Fehler. Die Prüfung erfolgt für jede Anfrage einzeln — eine Erhöhung auf xhigh bei deaktiviertem Thinking wird auch dann abgelehnt, wenn frühere Dialogschritte in derselben Unterhaltung akzeptiert wurden.

Speziell in Claude Code gilt: effort steht bei Opus 5 standardmäßig auf high (wie auch in der Claude API), und alle Stufen sind verfügbar — low, medium, high, xhigh, max. Anthropic empfiehlt in der eigenen Migrationsanleitung, die Effort-Stufe max dort zu testen, wo Leistungsfähigkeit wichtiger ist als der Tokenverbrauch. Der Schnellmodus unterstützt Opus 5 zu 10 $/50 $ pro MTok (siehe Schnellmodus).¹⁹⁷¹⁹⁸

Claude Fable 5.1 (1. September 2026): Das neue Spitzenmodell der Fable-Modellstufe und seit v2.1.257 das Modell, auf das der Alias fable verweist (sofern ANTHROPIC_DEFAULT_FABLE_MODEL kein anderes festlegt); best bedeutet jetzt „das neueste Fable-Modell, das Ihnen zur Verfügung steht“. Die Mindestversion bedarf einer Erläuterung: Laut Dokumentation zur Modellkonfiguration wurde der Alias in v2.1.255 umgestellt, und laut Modellseite „erfordert“ Fable 5.1 „Claude Code v2.1.255 oder neuer“. Die Versionen 2.1.253–256 wurden jedoch nie auf npm veröffentlicht – v2.1.257 (1. September) ist die erste installierbare Version mit dieser Unterstützung. Modell-ID: claude-fable-5-1 (Bedrock: anthropic.claude-fable-5-1). Gleiche Modellstufe und gleicher Preis pro Token wie Fable 5 – 10 $/MTok Eingabe, 50 $/MTok Ausgabe, 1 Mio. Tokens Kontext, maximal 128.000 Ausgabe-Tokens, adaptives, stets aktiviertes Thinking, effort standardmäßig auf high – mit einer Preisänderung, die für lange agentische Sitzungen relevant ist: Cache-Lesezugriffe kosten 0,25 $/MTok, also das 0,025-Fache des Eingabepreises (2,5 %) statt der üblichen 10 %; dieser Preis gilt nur für Fable 5.1 und Mythos 5.1. Für Cache-Schreibzugriffe gelten weiterhin die Standardpreise (12,50 $ für 5 Minuten, 20 $ für 1 Stunde). Verlässlicher Wissensstand: Juni 2026 (Trainingsdaten ebenfalls bis Juni 2026) – der aktuellste Wissensstand aller verfügbaren Claude-Modelle; Opus 5.5 zog am 22. September 2026 mit demselben Wissensstand nach, Sonnet 5.5 am 28. September. Die Außerbetriebnahme erfolgt frühestens am 1. September 2027. Seit v2.1.301 versuchen fable und best es einmal mit dem vorherigen Fable-Modell erneut, wenn das neueste Fable-Modell Ihrer Organisation nicht zur Verfügung steht, statt einen Fehler auszugeben.²⁷⁵

Drei inkompatible Änderungen gegenüber Fable 5: Erzwungene Tool-Nutzung führt zu einem Fehler, frühere Modelle können seine Thinking-Blöcke nicht lesen, und das Bearbeiten früherer Dialogschritte macht Thinking-Blöcke ungültig. Fünf Ergänzungen: Effort pro Nachricht (Beta), auf einen Dialogschritt begrenzte Systemnachrichten (Beta), Fortschrittsmeldungen zwischen Tool-Aufrufen (display: "updates", Beta), günstigere Cache-Lesezugriffe und Herkunftsnachweise für Inhalte. Claude Mythos 5.1 ist dasselbe Modell mit denselben Spezifikationen, ausschließlich auf Einladung über Project Glasswing verfügbar. Mit der Einführung wandert Fable 5 in der Dokumentation in die Tabelle „Legacy models“, neben Opus 4.8/4.7/4.6/4.5 und Sonnet 4.6/4.5.

Eine Gateway-Einschränkung aus den Versionshinweisen: In Gateway-Sitzungen der Claude-Apps verweisen fable und best vorerst weiterhin auf Fable 5 – ein noch nicht für 5.1 konfiguriertes Gateway lehnt es ab. Wählen Sie dort deshalb Fable 5.1 ausdrücklich über /model aus. Beachten Sie, dass die /model-Auswahl Fable 5.1 vor v2.1.260 nicht aufführte; für die ausdrückliche Auswahl musste daher der vollständige Befehl /model claude-fable-5-1 eingegeben werden (siehe die Korrekturen zur Einführung weiter unten). Standardmodelle der Abonnements bei der Einführung: Opus 5 in den Premium-Abonnements, Sonnet 5 in Pro und Team Standard – abgelöst durch Opus 5.5 als Standard in allen Abonnements mit v2.1.280 (22. September 2026).^211241242221

Korrekturen zur Einführung von Fable 5.1 (v2.1.260, 3. September): Die erste Version nach der Einführung behebt vier Probleme. Die /model-Auswahl zeigt Fable 5.1 jetzt für Organisationen an, die es nutzen können – zuvor wurde das Modell nur akzeptiert, wenn es vollständig als /model claude-fable-5-1 eingegeben wurde. Prompt-Caching bei Fable 5.1 erfasst jetzt auch Kontext, der nach Tool-Ergebnissen angehängt wird. Dieser wurde zuvor bei jedem Dialogschritt mit Tool-Aufruf erneut als nicht gecachte Eingabe gesendet – und schmälerte damit unbemerkt die Kostenvorteile der Cache-Lesezugriffe zum 0,025-fachen Preis, gerade in den langen agentischen Sitzungen, für die sie gedacht sind. Eine Änderung von /effort während der Sitzung macht den Prompt-Cache nicht mehr ungültig. Außerdem berücksichtigen Agenten mit model: fable jetzt das [1m]-Tag bei einer über ANTHROPIC_DEFAULT_FABLE_MODEL festgelegten Modellversion, statt unbemerkt mit einem Kontextfenster von 200.000 Tokens zu laufen.²¹²

Claude Fable 5 (9. Juni 2026; seit 1. September 2026 als Legacy eingestuft): Eine neue Modellstufe oberhalb von Opus — das leistungsfähigste und intelligenteste Modell von Anthropic, führend in nahezu jedem Benchmark, in dem es getestet wurde, und darauf ausgelegt, über Millionen von Kontext-Tokens hinweg kohärent zu bleiben. Fable 5 ist das für den allgemeinen Einsatz abgesicherte Spitzenmodell der „Mythos-Klasse“: Es wird mit Sicherheitsklassifikatoren ausgeliefert, die bei Anfragen zu Cybersicherheit, Biochemie und Modelldestillation auf Opus 4.8 ausweichen (Claude Mythos 5 ist dasselbe Modell, bei dem diese Schutzmaßnahmen für autorisierte Forschende aufgehoben sind). In Claude Code wurde es mit v2.1.170 (9. Juni 2026) auswählbar — führen Sie claude update und anschließend /model fable aus (den kurzen Alias, der seit v2.1.257 auf Fable 5.1 verweist – Fable 5 wählen Sie heute mit /model claude-fable-5 aus). Die Einführung in den Abonnements wurde bis zum 22. Juni 2026 abgeschlossen. Modell-ID: claude-fable-5. Fable 5 bietet standardmäßig ein Kontextfenster mit 1 Mio. Tokens, daher ist das Suffix [1m] überflüssig — und seit v2.1.173 (11. Juni 2026) wird der Modellname claude-fable-5[1m] automatisch zu claude-fable-5 normalisiert, indem das Suffix entfernt wird (es war von Anfang an nur bei Opus/Sonnet relevant, wo 1 Mio. Tokens Kontext über [1m] freigeschaltet werden); maximal 128.000 Ausgabe-Tokens. Die Preise liegen bei 10 $/MTok Eingabe und 50 $/MTok Ausgabe — etwa doppelt so hoch wie bei Opus 4.8. Setzen Sie es deshalb gezielt für anspruchsvolle Denkaufgaben ein, nicht für Routineänderungen. Es unterstützt dieselben Anfrageparameter wie Opus 4.8 (nur adaptives Thinking; temperature/top_p/top_k und budget_tokens wurden entfernt), mit einer neuen Besonderheit: Ein explizites thinking: {type: "disabled"} führt zu einem 400-Fehler. Lassen Sie den Parameter thinking deshalb vollständig weg, um das Modell ohne Thinking auszuführen.²⁶¹ Speziell in Claude Code: Fable 5 unterstützt wie Opus 5 die gesamte Skala für den Denkaufwand (low/medium/high/xhigh/max, standardmäßig high). Thinking lässt sich bei Fable 5 nicht deaktivieren — weder der Thinking-Schalter der Sitzung noch die Einstellung alwaysThinkingEnabled oder MAX_THINKING_TOKENS=0 haben eine Wirkung; das Modell denkt immer adaptiv. Für die fable-Familie stehen dieselben Konfigurationsmöglichkeiten wie für Opus bereit: ANTHROPIC_DEFAULT_FABLE_MODEL legt fest, auf welches Modell der Alias fable verweist (nützlich auf Bedrock/Vertex/Foundry), DISABLE_PROMPT_CACHING_FABLE deaktiviert das Prompt-Caching für Fable, und auf den Enterprise-Gateways greift ein inhaltsbasierter automatischer Fallback. /model opus wählt jetzt Opus 5.5 aus (v2.1.280; standardmäßig Denkaufwand medium, /effort xhigh für die schwierigsten Aufgaben), und das voreingestellte Modell richtet sich nicht mehr nach Ihrem Tarif – Opus 5.5 ist in jedem von Anthropic betriebenen Tarif der Standard, mit Ausnahme von Microsoft Foundry; wählen Sie mit /model fable gezielt die Fable-Stufe, wenn Sie die höchstmögliche Leistung möchten – seit v2.1.257 bedeutet das Fable 5.1.^{261197207242220221}

Opus 4.7 (16. April 2026): Das Spitzenmodell der vorherigen Generation ist weiterhin uneingeschränkt verfügbar. Kontextfenster mit 1 Mio. Tokens zu Standardpreisen — ohne Aufpreis für lange Kontexte. Maximale Ausgabe von 128.000 Tokens, ausschließlich adaptives Thinking (erweitertes Thinking wurde entfernt) und die neue Denkaufwandsstufe xhigh, die als Ausgangspunkt für Programmieraufgaben und agentische Workloads empfohlen wird.¹⁴⁵ Verlässlicher Wissensstand: Januar 2026. Stichtag der Trainingsdaten: Januar 2026. Modell-ID: claude-opus-4-7. Die Preise entsprechen mit 5 $/25 $ pro Mio. Tokens denen von Opus 4.6; Cache-Schreibvorgänge kosten 6,25 $ bei 5 Minuten und 10 $ bei 1 Stunde Speicherdauer, Cache-Lesevorgänge 0,50 $ pro Mio. Tokens.¹⁴⁴ Opus 4.7 löst auf SWE-Bench dreimal so viele Aufgaben aus dem Produktiveinsatz wie Opus 4.6, erreicht auf CursorBench 70 % (gegenüber 58 % bei 4.6) und steigert die Lösungsquote im internen Programmierbenchmark von Anthropic mit 93 Aufgaben um 13 %.¹⁴⁴ Das Modell verwendet einen neuen Tokenizer — rechnen Sie beim gleichen Text mit etwa der 1- bis 1,35-fachen Tokenanzahl; erhöhen Sie den Spielraum bei max_tokens und passen Sie die Schwellenwerte für die Kontextkomprimierung an.¹⁴⁵ Die Bildverarbeitung unterstützt Bilder mit bis zu 2.576 px / 3,75 MP und Pixelkoordinaten im Verhältnis 1:1.¹⁴⁵

Programmierbenchmarks für Opus 4.7 (April 2026):¹⁵¹

Standardmodell nach Tarif (Claude Code):²⁰⁷²²¹

Seit v2.1.280 (22. September 2026) gibt es keine Unterscheidung nach Tarif mehr: In jedem von Anthropic betriebenen Tarif und bei jedem Erstanbieter ist Opus 5.5 das Standardmodell; die einzige verbleibende Ausnahme ist Microsoft Foundry. Die bisher entscheidende Frage – „Welchen Tarif nutze ich?“ – ändert die Antwort nicht mehr.

Inkompatible Änderungen an der Messages API in Opus 4.7 (für aufrufende Anwendungen sichtbar):¹⁴⁵

• budget_tokens für erweitertes Thinking wurde entfernt. Verwenden Sie stattdessen thinking: {type: "adaptive"}. Adaptives Thinking ist standardmäßig deaktiviert; Anfragen ohne das Feld thinking werden ohne Thinking ausgeführt.
• Wenn Sie temperature, top_p oder top_k auf einen anderen Wert als den Standardwert setzen, wird HTTP 400 zurückgegeben. Lassen Sie diese Parameter weg und steuern Sie das Modell über Prompts.
• Thinking-Inhalte werden standardmäßig nicht in Antworten ausgegeben. Setzen Sie thinking.display: "summarized", um die Überlegungen wieder sichtbar zu machen (erforderlich, wenn Ihr Produkt Thinking-Inhalte an Benutzer streamt).

Mit Aufgabenbudgets (Beta-Header task-budgets-2026-03-13) können Sie dem Modell über output_config.task_budget einen Tokenzielwert für einen vollständigen agentischen Ablauf vorgeben; mindestens 20.000 Tokens.¹⁴⁵

Opus 4.6 (ältere Version): Weiterhin unter claude-opus-4-6 mit einem Kontextfenster von 1 Mio. Tokens und einer maximalen Ausgabe von 128.000 Tokens verfügbar. Für bessere Ergebnisse beim agentischen Programmieren sollten Sie einen Wechsel zu Opus 4.7 erwägen. Opus 4.6 wurde ursprünglich am 5. Februar 2026 veröffentlicht.⁷⁹¹⁴⁴ Seit v2.1.117 (22. April 2026) gilt für Pro- und Max-Abonnenten bei Opus 4.6 und Sonnet 4.6 standardmäßig der Denkaufwand high (zuvor medium); Opus 4.7 bleibt bei xhigh. Diese Änderung stellte die Leistungsfähigkeit nach der Absenkung des Denkaufwands vom 4. März bis zum 7. April wieder her, die in der Fehleranalyse vom 23. April dokumentiert wurde.¹⁵²¹⁵³

Sonnet 5 (30. Juni 2026; vorherige Sonnet-Stufe): Dieses Modell wählte der Alias sonnet auf der Anthropic API ab v2.1.197 aus, bis v2.1.284 ihn auf Sonnet 5.5 umstellte. Bei der Veröffentlichung positionierte Anthropic es als „die beste Kombination aus Geschwindigkeit und Intelligenz“. Laut Anthropic liegt seine Leistung nahe an Opus 4.8, bei niedrigeren Preisen. Bei agentischem Schlussfolgern, Werkzeugeinsatz, Programmierung und Wissensarbeit verbessert es sich deutlich gegenüber Sonnet 4.6 — zugleich zeigt es insgesamt seltener unerwünschtes Verhalten und deutlich geringere Fähigkeiten im Bereich Cybersicherheit als die Opus-Modelle (die Sicherheitsabwägung, die eine Veröffentlichung ohne Exportkontrollsperren ermöglichte). Modell-ID: claude-sonnet-5 (festgelegter Snapshot ohne Datumsangabe). Kontextfenster mit 1 Mio. Tokens, maximale Ausgabe von 128.000 Tokens (bis zu 300.000 über die Batches API mit dem Beta-Header output-300k-2026-03-24), ausschließlich adaptives Thinking. Verlässlicher Wissensstand: Januar 2026. Preis: 2 $/10 $ pro Mio. Eingabe-/Ausgabetokens, inzwischen der reguläre Listenpreis. Anthropic kündigte bei der Veröffentlichung 2 $/10 $ als Einführungspreis bis zum 31. August 2026 an und behielt ihn anschließend bei: Auf der Preisseite steht, dass die für den 1. September geplante Erhöhung auf 3 $/15 $ „nicht stattfinden wird“. Mit v2.1.243 wurden die /model-Auswahl und der mitgelieferte claude-api-skill aktualisiert, sodass 2 $/10 $ als Listenpreis statt als zeitlich begrenztes Angebot angezeigt werden.²⁵¹ Das liegt 50 % unter den 4 $/20 $ von Opus 5.5 (und 60 % unter den 5 $/25 $, die Opus 5 kostete). In Claude Code ist der Parameter effort bei Sonnet 5 standardmäßig auf high gesetzt (setzen Sie ihn explizit, um dies zu ändern). Wählen Sie das Modell mit /model claude-sonnet-5 aus.¹⁸⁰²³⁰

Mit v2.1.197 (30. Juni 2026) wurde Sonnet 5 damals zum Standardmodell in Claude Code für neue Sitzungen und blieb der Standard für die Tarife Pro und Team Standard, bis v2.1.280 diese Tarife auf Opus umstellte, am 22. September 2026. Sonnet 5 ist in Claude Code in keinem Tarif mehr das Standardmodell, und seit v2.1.284 wählt /model sonnet auf der Anthropic API stattdessen Sonnet 5.5 aus; mit /model claude-sonnet-5 oder ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5 bleiben Sie bei Sonnet 5. Siehe die Tariftabelle oben.^{181207220221228}

Sonnet 4.6 (17. Februar 2026, inzwischen durch Sonnet 5 abgelöst): Ausgewogenes Modell; ersetzte Sonnet 4.5 als Standard auf claude.ai und in Claude Cowork.⁹³ Gleiche Preise wie Sonnet 4.5 (3 $/15 $ pro Mio. Tokens). Verbesserte Leistung bei der agentischen Suche bei geringerem Tokenverbrauch. Unterstützt erweitertes Thinking, adaptives Thinking und ein Kontextfenster mit 1 Mio. Tokens (Beta). Maximale Ausgabe von 64.000 Tokens (Obergrenze von 128.000 in v2.1.77).¹¹⁹ Wissensstand: 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, das im Rahmen von Project Glasswing angeboten wird.¹³⁹ Nur auf Einladung; nicht allgemein verfügbar. Anthropic beschreibt Opus 4.7 im Bereich Cybersicherheit als bewusst weniger leistungsfähig als Mythos — ein Kompromiss zugunsten der Sicherheit — und hat unter https://claude.com/form/cyber-use-case ein Cyber Verification Program für seriöse Sicherheitsforscher eingerichtet, die erweiterte Zugriffsrechte benötigen.¹⁴⁶

Warum diese Preisunterschiede relevant sind: Eine typische Programmiersitzung verbraucht 50.000–200.000 Eingabetokens und 10.000–50.000 Ausgabetokens. Bei Haiku 5.5 entspricht das zu den Tarifen für Prompts mit bis zu 100.000 Tokens etwa 0,01–0,05 $ pro Sitzung. Mit Opus 5.5 zu 4 $/20 $ kostet dieselbe Sitzung 0,40–1,80 $, also etwa das 40-Fache (vor Rabatten durch Prompt-Caching). Verwenden Sie Sonnet oder Haiku, wenn eine Aufgabe Opus nicht erfordert.¹²²²

Wann Sie welches Modell verwenden sollten

Haiku: Verwenden Sie es für subagents, die Code erkunden, einfache Dateisuchen durchführen oder kurze Fragen beantworten. Zu den Tarifen für Prompts mit bis zu 100.000 Tokens kostet es etwa ein Vierzigstel von Opus 5.5 (bei Prompts mit über 100.000 Tokens ein Achtel) und antwortet schneller. Ideal für Hintergrundaufgaben, bei denen Sie keine tiefgehenden Schlussfolgerungen benötigen.

Sonnet: Das Arbeitspferd für die tägliche Entwicklung, wenn die Kosten zählen – Sonnet 5.5 seit v2.1.284 über die Anthropic API, zu denselben 2 $/10 $ wie Sonnet 5²²⁸ – und seit v2.1.280 Pro und Team Standard auf Opus umgestellt hat, in keinem Tarif mehr das Standardmodell (natives Kontextfenster mit 1 Mio. Tokens, regulärer Listenpreis von 2 $/10 $ pro Million Tokens; die für den 1. September geplante Preiserhöhung wurde abgesagt).^181251207220 Das ist die entscheidende Änderung: Sonnet ist jetzt ein Modell, das Sie gezielt auswählen, und dafür spricht die Rechnung – halb so hohe Kosten pro Token wie bei Opus 5.5, bei demselben Kontextfenster mit 1 Mio. Tokens. Es bewältigt die meisten Programmieraufgaben: Funktionen implementieren, Fehler beheben, Tests schreiben und Code prüfen. Historischer Rückblick: Lange wurde berichtet – auch hier –, dass v2.1.197 (30. Juni 2026) Sonnet 5 überall zum Standard gemacht habe. Laut der tarifbezogenen Darstellung in der Dokumentation zur Modellkonfiguration verwies die Standardeinstellung für Premium/API jedoch bereits ab v2.1.154 auf Opus 4.8 und ab v2.1.219 auf Opus 5. „Überall“ bedeutete also tatsächlich nur die Standardtarife – und selbst dort beendete v2.1.280 diese Voreinstellung. Bis einschließlich Juni 2026 nahm Sonnet 4.6 die Sonnet-Rolle ein.^93147207221 Verwenden Sie Sonnet, wenn Sie günstigere Tokens, kürzere Antwortzeiten oder einen wirtschaftlicheren Einsatz von subagents benötigen.

Opus: Die Modellklasse für tiefgehendes Schlussfolgern — seit v2.1.280 wählt der Alias opus Claude Opus 5.5 aus (4 $/20 $ pro Million Tokens, Kontextfenster mit 1 Mio. Tokens, effort standardmäßig auf medium), und seit dieser Version starten auch alle Tarife mit Opus. Die Entscheidung lautet daher, wann Sie zu einem anderen Modell wechseln: Bleiben Sie bei Opus für Architekturentscheidungen, schwierige Fehlersuche, das Verständnis komplexer Systeme, Sicherheitsanalysen und langfristige agentische Aufgaben. Wechseln Sie mit /model sonnet, wenn eine Aufgabe so routinemäßig ist, dass der halbe Tokenpreis mehr zählt als die zusätzliche Denkleistung.²²⁰²²¹ (Von v2.1.219 bis v2.1.278 verwies der Alias opus auf Opus 5 zu 5 $/25 $.)¹⁹⁷ Der Rest dieses Absatzes beschreibt Opus 4.7 bei seiner Einführung am 16. April 2026 und bleibt als historischer Rückblick erhalten.¹⁴⁴¹⁴⁷ Opus 4.7 löst auf SWE-Bench dreimal so viele Aufgaben aus der Praxis wie Opus 4.6, erzielt auf CursorBench 70 % (gegenüber 58 %) und verbessert die Lösungsquote in einem internen Programmierbenchmark mit 93 Aufgaben um 13 %.¹⁴⁴ Claude Code verwendet bei Opus 4.7 standardmäßig die Denkintensität xhigh, die sich über /effort anpassen lässt (v2.1.111+).¹⁴⁶¹⁴⁷ Auto Mode steht Max-Abonnenten mit Opus 4.7 über die Anthropic API zur Verfügung, ohne dass --enable-auto-mode erforderlich ist; bei anderen Tarifen und Anbietern hängt die Verfügbarkeit vom Tarif und den Administratoreinstellungen ab.¹⁴⁶ Kontextfenster mit 1 Mio. Tokens zum Standardpreis — ohne Aufpreis für lange Kontexte. Wissenswerte Verhaltensänderungen: Opus 4.7 befolgt Anweisungen wörtlicher, passt die Antwortlänge an die Aufgabenkomplexität an, setzt standardmäßig weniger subagents ein und verwendet einen direkteren Ton mit weniger bestätigenden Formulierungen. Falls Ihre Prompts zusätzliche Anweisungen enthalten, um Zwischenmeldungen zum Fortschritt oder erneute Prüfungen zu erzwingen, versuchen Sie es ohne diese Zusätze.¹⁴⁵

Opusplan: Ein Hybridmodus, der Opus für die Planung einsetzt (wo die Qualität des Schlussfolgerns am wichtigsten ist) und Sonnet für die Ausführung (wo Geschwindigkeit zählt). Hervorragend für komplexe Refaktorierungen, bei denen Sie den bestmöglichen Plan wünschen, aber nicht für jede einzelne Änderung die Denkleistung von Opus benötigen.

Modelle wechseln

Während einer Sitzung:

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

Beim Start:

claude --model opus

Über Umgebungsvariablen:

export ANTHROPIC_MODEL=opus

In settings.json:

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

Die Modellauswahl selbst anpassen (modelPicker, v2.1.242+): In einer Benutzerdatei oder einer zentral verwalteten Einstellungsdatei können Sie festlegen, welche Modelle /model anbietet — in Ihrer Reihenfolge und mit Ihren Bezeichnungen. Damit sind Sie nicht mehr auf die integrierte Auswahlliste beschränkt. Jeder Eintrag nennt ein model (jede von --model akzeptierte Schreibweise, einschließlich Vertex- und Bedrock-IDs) und optional ein label sowie eine description; setzen Sie replaceBuiltInOptions auf true, um nur diese Einträge sowie Standard und das aktuelle Modell der Sitzung anzuzeigen. Projekt- und lokale Einstellungen werden für diesen Schlüssel ignoriert; eine availableModels-Positivliste filtert die Einträge weiterhin. Claude Code entfernt Einträge für Modelle, die es nicht bereitstellen kann, zeigt noch nicht auswählbare Einträge ausgegraut mit einer Begründung an und greift auf die integrierte Auswahlliste zurück, falls kein Eintrag übrig bleibt.²⁵⁰²⁴⁸

{
  "modelPicker": {
    "options": [
      { "model": "us.anthropic.claude-opus-4-8", "label": "Opus (production)" },
      {
        "model": "us.anthropic.claude-sonnet-4-6",
        "label": "Sonnet (production)",
        "description": "Day-to-day work"
      }
    ]
  }
}

Speziell für subagents:

export CLAUDE_CODE_SUBAGENT_MODEL=haiku

Seit v2.1.251 legt CLAUDE_CODE_SUBAGENT_MODEL das Standardmodell für subagents fest, statt sämtliche anderen Angaben zu überschreiben: model: in einer Agentendefinition und ein beim jeweiligen Start ausdrücklich angegebenes Modell haben Vorrang.²⁰⁶ Seit v2.1.257 lässt sich mit CLAUDE_CODE_SUBAGENT_MODEL_FORCE das frühere Verhalten wieder aktivieren: Es wendet CLAUDE_CODE_SUBAGENT_MODEL (oder, falls nicht gesetzt, das Modell des Hauptgesprächs) auf alle subagents an und ignoriert sowohl die Modellauswahl beim jeweiligen Start als auch model: in Agentendefinitionen.²¹¹

Kette von Ausweichmodellen (v2.1.166+): Mit der Einstellung fallbackModel konfigurieren Sie bis zu drei Ausweichmodelle, die der Reihe nach ausprobiert werden, wenn das primäre Modell überlastet oder nicht verfügbar ist. Das Flag --fallback-model (zuvor nur zum Wechseln während einer Sitzung) gilt nun auch für interaktive Sitzungen ab dem Start.²⁶³

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

Wenn die API einen unerwarteten Fehler zurückgibt, der keinen erneuten Versuch zulässt, versucht Claude Code den Gesprächsschritt jetzt dennoch einmal mit dem Ausweichmodell, bevor es den Fehler anzeigt. So wird ein vorübergehendes Problem des primären Modells abgefangen, statt den Gesprächsschritt abzubrechen.²⁶³ Seit v2.1.286 versucht Claude Code es einmal mit dem vorherigen Modell derselben Modellklasse, wenn die Anthropic API das Modell ablehnt, auf das Ihre Standardeinstellung oder ein Alias verweist, statt bei jedem Gesprächsschritt zu scheitern. Wiederholungsversuche aufgrund einer Ablehnung oder über --fallback-model laufen mit Standardgeschwindigkeit, wenn das Ausweichmodell den schnellen Modus nicht unterstützt.²³¹

Seit v2.1.178 berücksichtigt auch die Kontextkomprimierung die Kette von Ausweichmodellen — wenn das primäre Modell während der Komprimierung überlastet oder nicht verfügbar ist, greift der Komprimierungsschritt auf die über fallbackModel/--fallback-model konfigurierte Kette zurück, statt den Gesprächsschritt scheitern zu lassen. Bei langen autonomen Durchläufen schließt dies eine Lücke: Zuvor konnte ein vorübergehender Modellfehler während einer ansonsten fortsetzbaren Komprimierung die Sitzung abbrechen.¹⁷³

Erweiterter Kontext

Aktivieren Sie für große Codebasen oder lange Sitzungen ein Kontextfenster mit 1 Mio. Tokens:

claude --model sonnet[1m]
claude --model opus[1m]           # 1M for a model that reaches it only through [1m], such as Opus 4.6

Oder innerhalb einer Sitzung:

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

Wo das Suffix relevant ist (Oktober 2026): Über die Anthropic API verwenden Fable 5.1, Fable 5, Sonnet 5.5, Sonnet 5 sowie Opus 4.7 und neuere Versionen (einschließlich Opus 5.5) in jedem Tarif das Kontextfenster mit 1 Mio. Tokens; [1m] ändert dort also nichts. Seit v2.1.287 gilt dasselbe für Amazon Bedrock, die Agent Platform von Google Cloud, Microsoft Foundry und das Apps-Gateway von Claude: Opus 4.7 und neuere Versionen sowie Fable verwenden standardmäßig das Kontextfenster mit 1 Mio. Tokens ohne das Suffix [1m]; mit CLAUDE_CODE_DISABLE_1M_CONTEXT=1 bleiben sie auf 200.000 Tokens begrenzt. Vor v2.1.287 liefen Opus 4.8 und neuere Versionen bei diesen Anbietern mit 200.000 Tokens, sofern die in ANTHROPIC_DEFAULT_OPUS_MODEL festgelegte Modell-ID nicht [1m] enthielt. Die am 1. Oktober abgerufenen Dokumentationsseiten zu Bedrock und Agent Platform beschreiben das Suffix weiterhin als Möglichkeit, dort 1 Mio. Tokens zu erhalten. Sonnet 5 bietet bei jedem Anbieter 1 Mio. Tokens. Für Opus 4.6 und Sonnet 4.6 bleibt das Suffix relevant: Sie erreichen 1 Mio. Tokens nur über ihre [1m]-Variante.^223232233

Opus 4.7, Opus 4.6 und Sonnet 4.6 bieten alle das vollständige Kontextfenster mit 1 Mio. Tokens zum Standardpreis — ohne Aufpreis für lange Kontexte.¹⁴⁸ Eine Anfrage mit 900.000 Tokens wird zum selben Preis pro Token abgerechnet wie eine Anfrage mit 9.000 Tokens. Rabatte für Prompt-Caching und Stapelverarbeitung gelten zu den üblichen Sätzen über das gesamte Kontextfenster hinweg. Der Zugriff auf die [1m]-Varianten hängt vom Tarif ab: Opus 4.6 mit 1M Kontext ist in Max, Team und Enterprise enthalten. Sonnet 4.6 mit 1M Kontext erfordert in jedem Abonnement, einschließlich Max, Nutzungsguthaben.²³³ (Opus mit 1M wurde in v2.1.75 am 13. März 2026 zum Standard für Max, Team und Enterprise.)¹¹⁷¹⁴⁷ Benutzer von API und nutzungsbasierter Abrechnung haben vollen 1M-Zugriff zu den regulären Tokenpreisen.¹⁴⁷

Um 1M-Kontextvarianten in der Modellauswahl zu deaktivieren, setzen Sie CLAUDE_CODE_DISABLE_1M_CONTEXT=1. Seit v2.1.223 hat sich die Reichweite dieser Variable geändert: Sie begrenzt jedes Modell mit einem nativen 1M-Fenster durch automatische Komprimierung auf 200K — nicht mehr nur eine feste Liste bekannter Varianten. Beim Start erscheint eine Warnung, wenn die automatische Komprimierung die Sitzung tatsächlich nicht auf 200K begrenzt. Wenn Sie diese Variable für eine Modellfamilie gesetzt haben, um die Kosten planbar zu halten, gilt sie nun auch für neue 1M-Modelle ab deren Veröffentlichung, statt unbemerkt ihre Wirkung zu verlieren. Seit derselben Version hält die automatische Komprimierung auch Sitzungen mit unbekannten Modell-IDs innerhalb des angenommenen Kontextfensters, statt sie darüber hinaus wachsen zu lassen; CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT=1 stellt das alte Verhalten für Gateways wieder her, die benutzerdefinierte IDs mit tatsächlich größeren Fenstern registrieren.²⁰⁰ Seit v2.1.287 begrenzen Sie mit dieser Variable außerdem Opus 4.7 und neuer sowie Fable auf Bedrock, Vertex, Foundry und dem Claude-Apps-Gateway auf 200K, nachdem dort 1M zum Standard wurde.²³²

Seit v2.1.247 nutzt die automatische Komprimierung bei Sonnet 5 standardmäßig den vollen 1M-Kontext: Sitzungen mit dem 1M-Fenster werden nun bei etwa 967K Tokens automatisch komprimiert statt bei etwa 934K.²⁴⁵ v2.1.260 erweitert die automatische Komprimierung nahe der Grenze auf die übrigen 1M-Modelle: Auch Opus- und Fable-Sitzungen werden nun erst kurz vor der Grenze von 1M Tokens komprimiert. Zudem bricht die Komprimierung zur Wiederherstellung bei sehr großen Kontexten nicht mehr nach 10 Minuten wegen Zeitüberschreitung ab.²¹²

Benutzerdefinierte Basis-URLs erhalten das 1M-Fenster (v2.1.285). Sitzungen über eine benutzerdefinierte ANTHROPIC_BASE_URL nutzen jetzt das 1M-Kontextfenster der Modelle, die eines besitzen (Opus 4.7 und neuer, Sonnet 5 und neuer, Fable). Falls Ihr Gateway auf 200K begrenzt ist, führen Sie /autocompact 200k aus.²²⁹²³³

Seit v2.1.271 behält --resume das [1m]-Fenster bei: Wenn Sie eine Sitzung fortsetzen, deren Modellfamilie vom konfigurierten Standardmodell abweicht, entfällt das Suffix [1m] nicht mehr.²¹⁶

v2.1.273 behebt einen Fehler, durch den die Kontextanzeige und die automatische Komprimierung Gesprächsrunden mit dem Advisor-Tool mit ungefähr dem Doppelten ihrer tatsächlichen Kontextgröße anrechneten – dadurch wurde die automatische Komprimierung bereits bei etwa der Hälfte des tatsächlichen Fensters ausgelöst.²¹⁷

Aktuelles Modell prüfen

> /status

Der Befehl zeigt das aktuelle Modell, Kontoinformationen, angewendete Einstellungen und weitere Angaben zum Sitzungsstatus an.

Beschriftungen in der Modellauswahl (v2.1.51+): Die Auswahl über /model zeigt für festgelegte Versionen jetzt lesbare Bezeichnungen (z. B. „Sonnet 4.6“) statt unverarbeiteter Modell-IDs an, ergänzt um Aktualisierungshinweise, wenn neuere Versionen verfügbar sind.⁹⁸ v2.1.219 behebt die Darstellung der zusammengeführten Opus-Zeile als schlichtes „Opus“ statt „Opus (1M Kontext)“ und beschränkt die Hervorhebung neuer Veröffentlichungen auf den Namen des neuesten Modells. Damit kennzeichnet sie das tatsächlich veröffentlichte Modell statt eines beliebigen Teils der Liste.¹⁹⁶ v2.1.283 entfernt „(1M Kontext)“ aus der Opus-Zeile und dem Namen des Standardmodells, wenn Opus bereits ein 1M-Kontextfenster hat; das Fenster selbst bleibt unverändert.²²⁶

Schnellmodus (v2.1.36+)

Der Schnellmodus liefert deutlich schnellere Ausgaben vom selben Modell; er wechselt nicht zu einem günstigeren Modell. Sie können ihn während einer Sitzung mit /fast ein- und ausschalten.⁸⁶

> /fast            # Toggle fast mode on/off

Welche Modelle (Stand v2.1.280): Der Schnellmodus gilt für Claude Opus 5.5, Opus 5 und Opus 4.8. Seit v2.1.280 ist Opus 5.5 das Standardmodell für den Schnellmodus (ab v2.1.219 war es Opus 5). Mit v2.1.219 wurde Opus 4.7 aus dem Schnellmodus 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 auf Amazon Bedrock, Google Cloud, Microsoft Foundry oder Claude Platform on AWS. Der Zugang ist beschränkt: Wenden Sie sich an Ihre Kontobetreuung oder tragen Sie sich in die Warteliste ein.^196198223

Remote-Sitzungen (v2.1.271): Der Schnellmodus ist jetzt auch in Claude Code-Remote-Sitzungen verfügbar – in Cloud-Sitzungen und auf selbst gehosteten Runnern. Es gilt die Schnellmoduseinstellung des Hosts, oder Sie geben /fast direkt in der Sitzung ein; beides funktioniert nur, wenn Ihre Organisation den Schnellmodus erlaubt. Dieselbe Version behebt einen Fehler bei /fast off: Der Befehl schaltet den Schnellmodus jetzt aus, statt „Schnellmodus nicht verfügbar“ zu melden, wenn die Organisation den Schnellmodus deaktiviert hat.²¹⁶

Preise (Schnellmodus):^198222223

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 fällt nicht stillschweigend auf die Standardgeschwindigkeit zurück. Opus 4.6 bildet eine Ausnahme, die Sie kennen sollten: Es akzeptiert speed: "fast", läuft trotzdem mit Standardgeschwindigkeit, rechnet zu Standardpreisen ab und meldet usage.speed: "standard". Wenn Ihre Ausführungsumgebung auf 4.7 festgelegt war und sich darauf verließ, dass Anfragen im Schnellmodus stillschweigend auf Standardgeschwindigkeit zurückfallen, schlagen diese nun vollständig fehl; ändern Sie die festgelegte Version auf Opus 5.5, Opus 5 oder Opus 4.8.¹⁹⁸

Wann Sie den Schnellmodus verwenden sollten: - Bei schnellen Iterationen kleiner Änderungen, wenn die Latenz den Engpass bildet - Beim Generieren von Tests, Standardcode oder sich wiederholendem Code, wenn Geschwindigkeit wichtiger ist als Kosten - Beim schrittweisen Abarbeiten einer Liste ähnlicher Aufgaben

Wann Sie den Schnellmodus NICHT verwenden sollten: - Bei lang laufenden agentischen Aufgaben (die Kosten verdoppeln sich weiterhin über den gesamten Durchlauf) - Bei Hintergrundarbeit durch subagents (niemand wartet auf die Ausgabe) - Bei Sitzungen mit knappem Budget

Der Schnellmodus umfasst das volle 1M-Kontextfenster (v2.1.50+). Für den gesamten Kontext gilt ein einheitlicher Preismultiplikator, auch bei Anfragen mit mehr als 200K Eingabetokens — ohne zusätzlichen Aufpreis für lange Kontexte. Er wird zusätzlich zu den Multiplikatoren für Prompt-Caching und Datenresidenz angewendet.⁹⁶¹⁹⁸

Hinweise zum Betrieb. Der Schnellmodus hat ein eigenes Ratenlimit, unabhängig von den Standardlimits für Opus. Wird es überschritten, erhalten Sie einen 429 mit retry-after (die Antwortheader anthropic-fast-*-tokens-* geben die verbleibende Kapazität an). Der Wechsel zwischen Schnell- und Standardmodus macht den Prompt-Cache ungültig — Anfragen mit unterschiedlichen Geschwindigkeiten teilen keine zwischengespeicherten Präfixe. Wenn Sie /fast mitten in einer Sitzung umschalten, führt das daher zu einem Cache-Miss. Der Schnellmodus ist weder mit der Batch API noch mit einer Priority-Tier-Abnahmevereinbarung verfügbar.¹⁹⁸

Expertentipp: Der Schnellmodus lässt sich nicht sinnvoll mit opusplan kombinieren (opusplan mischt bereits Opus und Sonnet; der Schnellmodus wirkt sich nur auf den Opus-Anteil aus). Verwenden Sie ihn, wenn Latenz wichtiger ist als Kosten, und deaktivieren Sie ihn für autonome Aufgaben oder Stapelverarbeitung. /fast erfordert zusätzliche Nutzung; Administratoren von Team/Enterprise müssen diese gegebenenfalls zuerst aktivieren (Fehlerbehebung in v2.1.37). Mit CLAUDE_CODE_DISABLE_FAST_MODE=1 deaktivieren Sie ihn vollständig. Seit v2.1.218 meldet Claude Code, wenn ein Modellwechsel über /config model=<x> oder Remote Control den Status Ihres Schnellmodus ändert. v2.1.219 behob außerdem einen Fehler, durch den Remote-Control-Clients nach einem Wechsel, einer erneuten Verbindung oder einer fehlgeschlagenen Organisationsprüfung einen veralteten Schnellmodusstatus beibehielten.^86149195196

Das Advisor-Tool (experimentell)

Mit dem Advisor-Tool kann Claude in entscheidenden Momenten einer Aufgabe ein zweites, meist leistungsfähigeres Modell hinzuziehen: bevor es sich auf einen Ansatz festlegt, wenn ein Fehler wiederholt auftritt oder bevor es die Arbeit für abgeschlossen erklärt. Der Advisor läuft serverseitig als Server-Tool auf der Infrastruktur von Anthropic, erhält die vollständige Unterhaltung einschließlich aller Toolaufrufe und Ergebnisse und gibt Empfehlungen zurück, die Claude vor dem Fortfahren umsetzt. Claude entscheidet, wann es den Advisor aufruft; Sie können in einem Prompt um eine Rücksprache bitten, doch es gibt keine Einstellung, die Aufrufe begrenzt oder erzwingt. Das Tool ist experimentell, steht über die Anthropic API für Konten mit Abonnement und Konten mit API-Abrechnung zur Verfügung und ist seit v2.1.300 auf Claude Platform on AWS verfügbar (die Dokumentationsseite führt diese Plattform weiterhin als nicht unterstützt auf). Bei der Nutzung über ein Gateway muss die Anfrage die Anthropic API unverändert erreichen. Außerdem müssen Feature-Flags abgerufen werden können, weshalb eine Variable wie DISABLE_TELEMETRY das Tool deaktiviert hält.²⁷³²⁷⁴ Aktivierung. Dafür gibt es drei Möglichkeiten: /advisor <model> während einer Sitzung speichert die Auswahl unter advisorModel in Ihren Benutzereinstellungen (ein bloßes /advisor öffnet im Terminal eine Auswahlliste und zeigt in -p-, SDK-, Desktop- und Remote Control-Sitzungen den aktuellen Advisor an; dort funktioniert die Textform seit v2.1.260; /advisor off deaktiviert ihn); "advisorModel": "opus" in einer Einstellungsdatei; oder claude --advisor <model> für eine einzelne Sitzung. Dieses Flag wird von --help nicht aufgeführt, hat Vorrang vor der Einstellung und beendet das Programm beim Start, wenn die Modellkombination ungültig ist. Als Aliasse stehen fable, opus und sonnet zur Verfügung; alternativ können Sie eine vollständige Modell-ID angeben. CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1 entfernt den Befehl, ignoriert die Einstellung und lässt das Flag wirkungslos werden.²⁷⁴

Modellkombinationen, Kosten und Anzeige. Ein Advisor muss mindestens auf derselben Rangstufe wie das Hauptmodell stehen: Opus 4.7 und 4.8 akzeptieren Fable, Opus 4.7 oder neuer sowie Sonnet 5.5 (seit v2.1.287); Sonnet 5.5 akzeptiert Fable, Opus 5 oder neuer sowie Sonnet 5.5; Opus 5 und 5.5 akzeptieren Fable und Opus 5 oder neuer; Fable 5.1 akzeptiert ausschließlich Fable 5.1; Haiku 4.5 kann den Advisor aufrufen, aber selbst keiner sein. Ein Advisor, der unter dem Hauptmodell rangiert, wird nicht eingebunden; eine Benachrichtigung weist darauf hin. Lehnt die API einen Advisor ab, wird er für den Rest der Unterhaltung ohne Hinweis entfernt. subagents übernehmen den Advisor unter derselben Prüfung der Modellkombination; eine availableModels-Freigabeliste wird berücksichtigt. Jeder Aufruf wird zu den Eingabe- und Ausgabetarifen des Advisor-Modells abgerechnet oder auf die Tariflimits angerechnet. Eine Ausnahme bildet ein Fable-Advisor: Bei Tarifen, in denen Fable über Nutzungsguthaben abgerechnet wird, gilt dies nach der einmaligen Zustimmung über /model fable auch für den Advisor. Beim Ein- oder Ausschalten des Advisors bleibt der Prompt-Cache des Hauptmodells erhalten; das eigene Einlesen der Unterhaltung durch den Advisor wird nie zwischengespeichert. Im Gesprächsprotokoll meldet eine Advising-Zeile „Geprüft“, „Abgelehnt“ oder „Nicht verfügbar“; Ctrl+O zeigt die Empfehlungen an. Mods sehen Advisor-Aufrufe als serverToolUses auf turn.step (v2.1.290).²⁷⁴

Aufwandssteuerung (v2.1.111+, Opus 4.7)

Opus 4.7 führt einen neuen Aufwandsregler ein, mit dem 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

Modellspezifische Speicherung (v2.1.251+): /effort speichert Ihre Standardaufwandsstufe jetzt für jedes Modell einzeln, sodass beim Modellwechsel jedes Modell seine eigene Einstellung behält – wenn Sie bei Opus gewöhnlich xhigh verwenden, wird diese Einstellung nicht mehr auf Haiku übertragen (CHANGELOG: „/effort wurde so geändert, dass Ihre Standardaufwandsstufe pro Modell gespeichert wird und jedes Modell beim Wechsel seine eigene Einstellung behält“). Die Ausnahme für max, das nur für die jeweilige Sitzung gilt, bleibt bestehen.²⁰⁶ Tastenbelegung des Reglers in v2.1.284: Mit den Aktionen effortSlider:decreaseEffort, increaseEffort und toggleUltracode können Sie die Pfeiltasten und die Tab-Taste des Reglers in keybindings.json neu belegen.²²⁸ v2.1.257 verfeinert beide Regler: /effort akzeptiert wie /model ein s für eine Auswahl, die nur für die aktuelle Sitzung gilt. Auch das Flag --effort ist jetzt auf die Sitzung beschränkt: Es hebt die Bindung an die Standardaufwandsstufe eines neuen Modells nur für diese Sitzung auf, statt dauerhaft (laut CLI-Referenz „überschreibt“ es den Standard „für diese Sitzung und wird nicht dauerhaft gespeichert“).²¹¹²⁴³

Automatikmodus bei Max (v2.1.111+)

Der Automatikmodus ist der integrierte Berechtigungsmodus beim Start interaktiver Terminal- und VS Code-Sitzungen bei allen Tarifen und Anbietern (v2.1.283–284). Von v2.1.285 bis zur Rücknahme in v2.1.302 galt dies außerdem für claude -p und Python Agent SDK-Sitzungen bei Drittanbietern oder deaktivierter Telemetrie; bei Pro, Max und Team war er bereits seit dem 14. August 2026 der Standard (angekündigt am 7. August). Die Studienzahlen aus der Ankündigung, Möglichkeiten zur Deaktivierung und die Sitzungen, die weiterhin im manuellen Modus starten, finden Sie unter Berechtigungsmodi.^{203226227228229}

Ein separates Klassifikatormodell, seit v2.1.210 Claude Sonnet 5, prüft jede Aktion vor der Ausführung darauf, ob sie Ihrer Absicht entspricht und sicher ist.¹⁸⁷ Mit --permission-mode auto starten Sie eine Sitzung im Automatikmodus; v2.1.111 hat das alte Flag --enable-auto-mode entfernt.

So wurde die Verfügbarkeit erweitert:

• Deaktivieren: Mit CLAUDE_CODE_AUTO_MODE_SERVER=0 bleibt der lokale Klassifikator aktiv, dessen Anfragen auf die Nutzung angerechnet werden; 1 aktiviert die Serverprüfungen. Vor v2.1.281 wurde die Variable bei einer direkten Anthropic-API-Verbindung nicht ausgewertet. Seit v2.1.281 gilt sie auch dort, und die Abrechnungsdokumentation zum automatischen Modus weist inzwischen darauf hin, dass bei einer direkten Verbindung mindestens v2.1.281 erforderlich ist.²²⁴²²⁷ Laut Dokumentation ist die Variable vorübergehend. Auch CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 unterbindet die Serverprüfungen, sofern die Variable nicht gesetzt ist.
• Wenn die Serverprüfungen eine Sitzung nicht erreichen können: Meist liegt es an einem Gateway oder Proxy, das bzw. der das Anfragefeld safeguards entfernt, safeguard_results aus Antworten streicht oder Tool-Aufruf-IDs umschreibt. Claude Code zeigt einmalig einen Hinweis an („Diese Sitzung ist nicht geeignet“), nennt das Gateway, sofern es erkannt wird, und verwendet für den Rest der Sitzung eigene, kostenpflichtige Klassifikatoranfragen. Im Modus -p wird der Hinweis auf stderr ausgegeben; die Ausgabe im Format stream-json enthält eine system-Warnung. In Pro-, Max- und Team-Sitzungen erscheint er nie. Auf einem Gateway lässt sich das Problem beheben, indem Anfragefelder und Antwortschlüssel unverändert durchgereicht werden.
• Eine Sitzung prüfen: /status zeigt die Zeile Auto mode server an. Dort steht Enabled, solange die Serverprüfungen über die Aktionen der Sitzung entscheiden, und Disabled, sobald auf den lokalen Klassifikator zurückgegriffen wurde.²¹⁹

Was der automatische Modus nicht ist: eine Sicherheitsgrenze. Die meisten der folgenden Maßnahmen härten einen Klassifikator ab, und ein Klassifikator ist keine Sandbox. Am 26. August 2026 veröffentlichte der Prompt-Injection-Forscher Johann Rehberger eine funktionierende Angriffskette gegen Claude Code Opus 5 im automatischen Modus. Bei kleinen Stichproben berichtete er von einer Angriffserfolgsquote von 60–80 %: 3 von 5 Durchläufen bei der Hauptkette, die einen isolierten python3-Kindprozess startet, sowie 3 von 5 und 4 von 5 Durchläufen bei zwei Konfigurationen einer Variante, deren Schadcode eine claude -p-Instanz ohne Benutzeroberfläche startet. Er selbst schränkte ein, dass es sich um kleine Stichproben und nicht um eine allgemeingültige Messung der Angriffserfolgsquote handelt.²¹⁰ Es lohnt sich, die Kette nachzuvollziehen, weil jeder einzelne Schritt plausibel wirkt: Ein Server beantwortet WebFetch mit HTTP 415, sodass der Agent auf curl zurückgreift; das heruntergeladene Archiv wird in ein temporäres Verzeichnis entpackt und enthält ein Manifest, sieben Base85/zlib-kodierte Datensätze, eine native Binärdatei und eine struct.py; Claude lehnt es ab, die nicht vertrauenswürdige Binärdatei auszuführen, schreibt dann seinen eigenen Python-Decoder und führt ihn aus diesem Verzeichnis heraus aus; der Decoder importiert base64, base64 importiert struct, und Python findet zuerst die struct.py des Angreifers. Kein Schritt enthält eine offensichtlich bösartige Anweisung – die Injection muss lediglich dafür sorgen, dass der kompromittierte Weg als vernünftigste Möglichkeit erscheint, die Aufgabe abzuschließen. Rehberger berichtet außerdem, dass Claude in einigen Durchläufen versuchte, den Schadprozess zu beenden, nachdem die Kompromittierung erkannt worden war, und dass der automatische Modus den Bereinigungsbefehl verweigerte.²¹⁰ Er stellt den gesamten Befund einer Zahl gegenüber, mit der Anthropic geworben hat: Eine beauftragte externe Evaluation meldete für Opus 5 im automatischen Modus eine Erfolgsquote von 0,00 % bei Prompt-Injection-Angriffen über 72 Szenarien hinweg, die jeweils zehnmal ausgeführt wurden. Seine Angriffskette gehörte nicht zu diesem Testsatz. Deshalb können ein Benchmark-Ergebnis von 0,00 % und eine funktionierende Angriffskette zur Codeausführung gleichzeitig zutreffen; für ihn passen die beiden Botschaften nicht zusammen.²¹⁰ Beachten Sie auch die Einordnung: In seiner Aktualisierung vom 30. August stimmt Simon Willison dem Hinweis eines Lesers zu, dass dies keine klassische Prompt Injection ist – das Modell liest und befolgt zu keinem Zeitpunkt Anweisungen des Angreifers –, sondern ein „Confused Environment Attack“, also ein Angriff über eine manipulierte Ausführungsumgebung.²¹⁰

Anthropic schloss die Meldung mit der Einstufung „Informative“ ab – das Verhalten entspreche dem vorgesehenen Design. Die von Rehberger wiedergegebene Position sollte die Grundlage Ihrer Schutzmaßnahmen bilden: Der automatische Modus ist ein Klassifikator nach dem Best-Effort-Prinzip und keine Sicherheitsgarantie. Gezielt konstruierte Injection-Ketten aus einzeln harmlosen Schritten liegen außerhalb dessen, was ein Klassifikator erkennen soll, und die tatsächliche Grenze zur Schadensbegrenzung bilden die Isolation auf Betriebssystemebene und die Kontrolle ausgehender Netzwerkverbindungen.²¹⁰ Das widerspricht den folgenden Härtungsmaßnahmen nicht – es ordnet sie richtig ein. Der automatische Modus reduziert die Zahl der Rückfragen, die Sie beantworten müssen, und blockiert eine dokumentierte Liste destruktiver Operationen; er macht eine Sitzung mit nicht vertrauenswürdigen Eingaben jedoch nicht sicher. Wenn eine Sitzung mit Inhalten arbeitet, die Angreifer beeinflussen können – abgerufenen Seiten, heruntergeladenen Archiven, Issue-Texten oder MCP-Servern von Drittanbietern –, begrenzen nur Schutzmaßnahmen außerhalb des Modells den Schaden tatsächlich: ein Container oder eine VM, eingeschränkte ausgehende Netzwerkverbindungen, die Überwachung der tatsächlichen Agentenaktionen und ein Home-Verzeichnis ohne SSH-Schlüssel und Cloud-Zugangsdaten, deren Verlust Ihnen schaden würde. Eine Freigabe durch den automatischen Modus ist kein Beleg dafür, dass eine Aktion sicher war.

Eigene Regeln ohne Verlust der Standardregeln (v2.1.118+). In früheren Versionen galt bei autoMode.allow, autoMode.soft_deny und autoMode.environment ein Entweder-oder: Sobald Sie eine eigene Liste definierten, entfielen die integrierten Sicherheitsregeln. Der Platzhalter $defaults löst dieses Problem – er wird genau an der Stelle, an der Sie ihn einsetzen, durch die integrierte Liste ersetzt. So können Sie davor und danach eigene Regeln ergänzen:¹⁵²

// .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
    ]
  }
}

Regeln des Klassifikators über /permissions bearbeiten (v2.1.246). Führen Sie /permissions aus und öffnen Sie die Registerkarte Auto mode, die nur erscheint, wenn der automatische Modus für die Sitzung verfügbar ist. Sie listet die Einträge für allow, soft_deny, hard_deny und environment aus allen Geltungsbereichen auf, die der Klassifikator ausliest, und zeigt für jeden Abschnitt an, ob die integrierten Regeln aktiv sind. Einträge aus verwalteten Einstellungen oder --settings sind schreibgeschützt; jede Änderung wird in ~/.claude/settings.json gespeichert. Wenn Sie einem Abschnitt die erste Regel hinzufügen, wird zugleich "$defaults" eingefügt, damit die integrierten Regeln aktiv bleiben. Sie können diese pro Abschnitt ein- oder ausschalten; zum Ausschalten muss der Abschnitt mindestens eine eigene Regel enthalten. environment wird als zusammenhängendes Dokument in Ihrem Editor geöffnet.²⁴⁹²⁴⁷

Aktivierung mit „Nicht erneut fragen“ (v2.1.118+). Die Rückfrage zur Aktivierung des automatischen Modus bietet jetzt die Option „Nicht erneut fragen“. Wer ihn häufig nutzt, kann damit den Erklärungstext unterdrücken, ohne einen Flag per Skript setzen zu müssen.¹⁵²

Schutz vor destruktiven Befehlen (v2.1.183). Der automatische Modus blockiert jetzt bestimmte irreversible Befehle strikt, 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 Arbeit zu verwerfen; git commit --amend, wenn der Commit nicht vom Agenten in dieser Sitzung erstellt wurde; und den Abbau von Infrastruktur (terraform destroy, pulumi destroy, cdk destroy), sofern Sie nicht den konkreten Stack genannt haben. Das begrenzt das Schadenspotenzial des Klassifikators genau bei den Operationen, durch die unbemerkt Arbeit verloren geht oder Umgebungen abgebaut werden. Der Agent kann sie weiterhin ausführen, allerdings nur auf Ihre ausdrückliche Anweisung hin und nicht aus eigener Initiative.¹⁷⁴

Jeden Shell-Befehl klassifizieren (v2.1.193). Standardmäßig prüft der Klassifikator des automatischen Modus nur Shell-Befehle, die Mustern zur Ausführung beliebigen Codes entsprechen; Routinebefehle werden nicht geprüft. Die neue Einstellung autoMode.classifyAllShell leitet stattdessen alle Bash-/PowerShell-Befehle durch den Klassifikator. Wenn Sie jeden Shell-Aufruf prüfen lassen möchten, erhalten Sie damit ein engmaschigeres Sicherheitsnetz bei geringfügig höherer Latenz. Dieselbe Version zeigt außerdem Ablehnungsgründe des automatischen Modus im Sitzungsprotokoll, in der kurz eingeblendeten Ablehnungsmeldung und unter den zuletzt abgelehnten Aktionen in /permissions an. Bei einem blockierten Befehl erfahren Sie nun also, warum er blockiert wurde.¹⁷⁹

Drei weitere Härtungsregeln (v2.1.205). Der automatische Modus blockiert jetzt Manipulationen an Sitzungsprotokolldateien – die Prüfspur selbst ist für den Agenten tabu; er fragt nach, bevor er rm -rf mit einer Variablen ausführt, deren Wert er nicht aus dem Kontext ermitteln kann – und verhindert damit Unfälle durch rm -rf $DIR bei unbekanntem $DIR; außerdem weisen Benachrichtigungen von Hintergrundaufgaben jetzt ausdrücklich darauf hin, dass keine menschliche Eingabe erfolgt ist. So kann eine gefälschte Zeile wie „Benutzer hat zugestimmt“ innerhalb eines Protokolls nicht als echte Freigabe eingeschleust und umgesetzt werden.¹⁸³ Die dritte Regel verdeutlicht einen grundlegenden Schutz vor Prompt Injection: Eine Freigabe muss über den Freigabekanal eintreffen, und die Ausführungsumgebung macht diese Voraussetzung nun ausdrücklich deutlich. Befehlssubstitution kann keine Katastrophe verbergen (v2.1.208). Katastrophale Löschvorgänge wie rm -rf ~ lösen jetzt auch dann eine Rückfrage aus, wenn sie in $(...), Backticks oder Prozesssubstitution (<(...)) versteckt sind — und zwar selbst bei --dangerously-skip-permissions und im Auto-Modus. Ein destruktiver Befehl lässt sich nicht mehr durch Einbetten in eine Substitution am Sicherheitsnetz vorbeischleusen.¹⁸⁶

Zustand des Auto-Modus zurücksetzen: claude auto-mode reset (v2.1.212). Ein neuer Unterbefehl setzt den Zustand Ihres Auto-Modus über das Terminal zurück; mit --yes überspringen Sie die Bestätigungsabfrage:¹⁸⁹

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

Weniger Dialoge, gleiche Prüftiefe (v2.1.218). Drei Prüfungen, die den Auto-Modus bislang mit einem Berechtigungsdialog unterbrachen — gefährliches rm, Hintergrundausführung mit & und verdächtige Windows-Pfade — tun dies nicht mehr. Stattdessen entscheidet der Klassifikator des Auto-Modus darüber. Die Sicherheitsprüfung findet also weiterhin statt, ohne Sie bei jedem Treffer einzubeziehen. Dieselbe Version weitet dies auf den Planungsmodus mit Auto aus: Bash-Befehle, für die die statische Analyse keinen ausschließlich lesenden Zugriff nachweisen kann, lösen keine Rückfrage mehr aus — der Klassifikator beurteilt sie, statt auf einen Dialog zurückzugreifen.¹⁹⁵

Regel gegen das Verlassen der isolierten Umgebung (v2.1.257). Die Liste der Aktionen, die der Klassifikator niemals automatisch genehmigt, erhält eine Regel namens „Containment Escape“: Das Abrufen von Zugangsdaten aus Cloud-Metadaten, das Umgehen ausgehender Netzwerkkontrollen und Zugriffe über Mandantengrenzen hinweg werden nicht mehr automatisch genehmigt, sofern die Umgebung sie nicht als erwartet kennzeichnet. Ordnen Sie dies im Sinne des obigen Vorbehalts ein: Der Klassifikator wird weiter gehärtet — eine weitere dokumentierte Ablehnungskategorie, keine Änderung am Wesen des Auto-Modus.²¹¹

Einmalige Rückfrage bei Lesezugriffen außerhalb der Arbeitsverzeichnisse (v2.1.257). Der Auto-Modus fragt jetzt einmal vor dem ersten Dateilesezugriff einer Sitzung außerhalb der Arbeitsverzeichnisse nach; seit v2.1.284 bietet diese Rückfrage auch die Option Ja, aber nächstes Mal erneut fragen.²²⁸ Die zugehörige Einstellung permissions.blockReadsOutsideWorkingDirectories macht aus der Rückfrage eine Ablehnung — solche Lesezugriffe werden vollständig blockiert.²¹¹ v2.1.273 weitet beide Verhaltensweisen auf Fälle aus, die die Prüfung nicht einsehen kann: Bei einem Bash-Befehl, der sich nicht vollständig analysieren lässt, erfolgt eine Rückfrage, statt die Prüfung zu überspringen. Außerdem wird ein durch die Einstellungen eines Repositorys festgelegtes Speicherverzeichnis bei aktivierter Blockierung weder in den Prompt geladen noch abgerufen, indexiert oder zur Speicherextraktion verwendet.²¹⁷

URLs von Diagramm-Renderern gelten als Uploads (v2.1.261). Ein Link, der Inhalte in die URL eines öffentlichen Diagramm-Renderers einbettet — nach dem Muster von mermaid.live, mit den Daten direkt in der URL — wird nicht mehr automatisch genehmigt, sofern Sie nicht darum gebeten haben. Der Klassifikator behandelt einen solchen Link als Upload: Die eingebetteten Daten werden in der URL selbst übertragen, wo die Skripte der Renderer-Website sie nach dem Öffnen der Seite lesen können — Links nach dem Muster von mermaid.live enthalten die Nutzdaten im URL-Fragment, das der Browser an JavaScript der Seite übergibt, statt es mit der Netzwerkanfrage zu senden. Auch hier gilt der obige Vorbehalt: Ein weiterer Kanal zur Datenexfiltration wird im Zuge der Härtung des Klassifikators geschlossen; es entsteht keine neue Grenze.²¹⁴

Die beiden Fehlerfälle des Klassifikators erhalten Abbruchbedingungen (v2.1.280). Bis zu dieser Version konnte der Auto-Modus nicht damit umgehen, wenn eine Sicherheitsprüfung kein verwertbares Urteil lieferte. Aus Benutzersicht zeigten sich beide Lücken auf dieselbe Weise: Ein Durchlauf drehte sich im Kreis und verbrauchte Tokens für eine Aktion, die niemals genehmigt werden würde. v2.1.280 gibt beiden Fällen einen definierten Endzustand.

Serverseitige Prüfung erfasst mehr Befehle (v2.1.281). Wenn die Klassifikatorprüfung serverseitig ausgeführt wird, warten jetzt auch ausschließlich lesende Shell-Befehle und Shell-Befehle in der Sandbox auf diese Prüfung und werden blockiert, wenn sie dabei beanstandet werden. Auch die Ablehnungsmeldung wurde geändert, damit Claude eine Ablehnung auf das angestrebte Ergebnis bezieht und nicht nur auf den exakten Befehl. Nach dem Fortsetzen einer Sitzung in einem neuen Prozess kann der Klassifikator seinen bisherigen Prompt-Cache wiederverwenden, statt ihn neu zu schreiben. Zudem erhält /insights eine Empfehlung zum Auto-Modus, die abschätzt, wie viele Berechtigungsabfragen dieser in Ihren letzten Sitzungen hätte übernehmen können.²²⁴

Unbeaufsichtigte Sitzungen warten nicht mehr endlos auf rm-Rückfragen (v2.1.281). Im Auto-Modus und bei --dangerously-skip-permissions wartet die Rückfrage zu einem gefährlichen rm jetzt 2 Minuten auf eine Antwort. Danach wird der Befehl mit einem Hinweis zur Umformulierung abgelehnt, sodass eine unbeaufsichtigte Sitzung weiterläuft; CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT=1 deaktiviert dieses Zeitlimit. Ein rekursives rm, dessen Ziel ausschließlich aus der Ausgabe einer Befehlssubstitution besteht, etwa rm -rf "$(pwd)", wurde bisher in beiden Modi ohne Rückfrage ausgeführt. Jetzt wird selbst dann nachgefragt, wenn eine Bash-Zulassungsregel zutrifft, sofern nicht CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT=1 gesetzt ist. Die Prüfung auf gefährliche rm-Befehle beanstandet außerdem Löschziele, die aus einer Shell-Variablen mit anschließendem Namen eines Verzeichnisses der obersten Ebene, einer vom Arbeitsverzeichnis abgeleiteten Variablen oder ausschließlich aus Backslashes bestehen.²²⁴ Seit v2.1.299 löst ein Shell-Skript mit -c, das kein rm ausführt, keine Rückfrage mehr aus. Ein zur Laufzeit innerhalb eines für Claude Code nicht lesbaren Skripts zusammengesetztes rm löst nur dann eine Rückfrage aus, wenn CLAUDE_CODE_STRICT_INLINE_SHELL_RM_PROMPT=1 gesetzt ist.²⁷¹

Inline-Shell-Befehle mit ! verlassen den Klassifikator; Rückgaben von subagents kommen hinzu (v2.1.271). Zwei Änderungen am Ablauf statt neuer Ablehnungskategorien. Die Inline-Shell-Befehle mit ! eines skills oder Slash-Befehls folgen jetzt den Berechtigungsregeln des Standardmodus statt dem Klassifikator — ein Befehl, über den keine Regel entscheidet, wird als geprüfter Werkzeugaufruf ausgeführt. Außerdem meldet ein subagent seine Ergebnisse jetzt über einen eigenen Rückgabeaufruf an seinen Aufrufer zurück, den der Sicherheitsklassifikator prüft. Zuvor wurde seine letzte Nachricht nachträglich geprüft — der Prüfpunkt wurde also von der Zeit nach der Übergabe auf die Übergabe selbst verlegt.²¹⁶

Neuerungen in v2.1.309 und v2.1.310

Claude Code 2.1.309 erschien am 22. Oktober 2026 (npm 20:34 UTC; Veröffentlichung auf GitHub 22:18 UTC, 79 Aufzählungspunkte) und 2.1.310 am 23. Oktober (npm 21:20 UTC; Veröffentlichung auf GitHub 23:39 UTC, 26 Aufzählungspunkte), beide mit dem maßgeblichen CHANGELOG identisch. Bei npm stehen latest und next auf 2.1.310, und stable wechselte von 2.1.292 auf 2.1.308, eine Version, deren vollständiger Hinweis „Fehlerbehebungen und Verbesserungen der Zuverlässigkeit“ lautet; 2.1.303 (18. Oktober) enthält dieselbe einzelne Zeile. Zwischen 2.1.302 und 2.1.310 wurde nichts ausgelassen.²⁷⁸

Korrekturen an Sandbox und Berechtigungen (v2.1.309). Bash-Befehle in der Sandbox führen unter macOS und Linux nicht mehr vor jedem Befehl die Startdateien der Shell außerhalb der Sandbox aus; unter macOS greifen denyWrite-Glob-Muster am tatsächlichen Speicherort eines Pfads, wenn der Ordner des Musters über einen Symlink erreicht wird; Befehle in der Sandbox und automatisch akzeptierte Änderungen können die mit --mcp-config übergebene MCP-Konfigurationsdatei nicht mehr verändern; unter Linux werden Schreibverbote nicht mehr aufgehoben, wenn ein Hintergrundbefehl über das Sitzungsende hinaus läuft. Befehle, die laut Einstellungen von der Sandbox ausgeschlossen sind, fragen jetzt vor Schreibzugriffen auf Pfade ihrer Schreibfreigabeliste nach, wenn die Sandbox aktiviert ist, aber nicht ausgeführt werden kann; der Rückfall auf eine Ausführung außerhalb der Sandbox wird dabei verweigert. Bash-Berechtigungsprüfungen vertrauen nicht mehr auf Variablen, die von einem Befehl mit potenziell fehlschlagender Umleitung gesetzt wurden. Sie fragen bei einem umschlossenen oder mit einem Präfix versehenen cd vor git nach und wenden eine Edit(path)-Ablehnungsregel auf eine Bash-Umleitung innerhalb einer Subshell an; der Schutz der Worktree-Isolation weist weitere Befehle mit Locale-Präfix sowie arithmetische zsh-Befehle zurück; der Schreibschutz des Profilspeichers greift auch über ein per Symlink eingebundenes Konfigurationsverzeichnis. sed -i erhält jetzt die übliche Bash-Rückfrage und wird wie angegeben ausgeführt, statt eine simulierte Vorschau der Dateiänderung anzuzeigen. Wie andere Bash-Änderungen lässt es sich nicht mehr durch /rewind rückgängig machen. Siehe Sandbox-Modus.²⁷⁸ Vertrauen, Worktrees und skills (v2.1.309). claude ultrareview setzt voraus, dass dem Arbeitsbereich vertraut wird: Der Befehl fragt dies im Terminal ab und verweigert andernfalls die Ausführung; Skripte übergeben --trust-workspace ohne Wert oder setzen CLAUDE_CODE_DISABLE_ULTRAREVIEW_TRUST_CHECK=1. Die Sicherheitsabfrage für gefährliche rm- und rmdir-Befehle im Modus zum Umgehen von Berechtigungen in der Desktop-App und VS Code lehnt den Befehl jetzt sofort mit einem Hinweis zur Umformulierung ab, damit unbeaufsichtigte Sitzungen weiterlaufen. Beim Erstellen und Wiederverwenden von Worktrees werden Git-Objekte nicht mehr bei Bedarf abgerufen (bei einem partiellen Klon mit Bash-Sandbox werden sie vorab abgerufen); außerdem ignorieren Worktrees und Branch-Checkouts Git-Replace-Refs. Überschreitet eine verschachtelte CLAUDE.md die Größenbegrenzung, wird jetzt nur ihr Anfang geladen. Dadurch werden Sitzungen nach dem Lesen von Dateien in ihrem Geltungsbereich nicht mehr wiederholt komprimiert. Ein skill in einem --add-dir-Ordner, dessen Name bereits von einem anderen skill verwendet wird, wird als <folder>:<name> angeboten; /verify und /code-review finden zudem den eigenen skill eines verschachtelten Pakets. Agent-Teammitglieder in geteilten Terminalbereichen übernehmen die Tool-Verbote und --tools-Regeln des leitenden Agenten, und /rewind listet Gesprächsschritte auf, in denen Dateien mit gespeicherten Checkpoints durch /code-review --fix, einen subagent oder einen Shell-Befehl geändert wurden.²⁷⁸

v2.1.310. Das Monitor-Tool und plugin-Monitore funktionieren auf Bedrock, Vertex und Foundry sowie bei deaktivierter Telemetrie oder deaktiviertem nicht notwendigem Datenverkehr; dort werden jetzt auch lange Wartephasen im Vordergrund blockiert. Anfragen über Gateways und kompatible Server, die den Beta-Wert effort-2025-11-24 oder Systemnachrichten während eines Gesprächs ablehnen, werden ohne diese erneut versucht. Bei der Komprimierung nach einem Fehler „Prompt ist zu lang“ bleibt nicht mehr zu viel dichter Text wie base64 oder SVG erhalten; die Bereinigung im Hintergrund löscht bei sehr großem cleanupPeriodDays keine kürzlich erstellten Dateien wie eingefügte Bilder mehr; Berechtigungsabfragen zum Lesen von Dateien zeigen das Ziel symbolischer Links an; die Abfrage des automatischen Modus vor dem ersten Lesezugriff außerhalb der Arbeitsverzeichnisse weist darauf hin, wenn das Blockieren dieser Zugriffe dazu führt, dass Shell-Befehle eine Berechtigung anfordern; nicht interaktive Sitzungen benötigen beim Komprimieren eines sehr großen Gesprächsverlaufs weniger Arbeitsspeicher; unter Ubuntu benennen /sandbox und die Warnung beim Start die AppArmor-Einschränkung für Benutzernamensräume und erklären, wie sie aufgehoben werden kann; das Image eines Mods wird in tmux bei aktiviertem allow-passthrough und focus-events sowie in kitty, Ghostty und iTerm2 3.5+ mit Vollbilddarstellung angezeigt; und wenn ein MCP-Tool-Aufruf in einer nicht interaktiven Sitzung wegen Zeitüberschreitung abbricht, während eine Eingabeanforderung des Servers unbeantwortet bleibt, wird Claude angewiesen, ihn nicht zu wiederholen. Berechtigungen für Cloud-Sitzungen und Remote Control werden in benutzerdefinierte Enterprise-Rollen aufgenommen.²⁷⁸

Neuerungen in v2.1.307

Claude Code 2.1.307 wurde am 21. Oktober 2026 veröffentlicht (npm 20:47 UTC; GitHub-Release 22:17 UTC; 43 Punkte, identisch mit dem maßgeblichen CHANGELOG), nach 2.1.306 (21. Oktober, 02:28 UTC). Dessen zwei Korrekturen sorgen dafür, dass claude -p innerhalb von Cloud-Sitzungen ohne die Umgebungsvariablen der Sitzung nicht mehr „Nicht angemeldet“ meldet und dass ein API-Fehler in Sitzungen mit vielen MCP-Tools nicht mehr durch „Prompt ist zu lang“ samt unnötiger Komprimierung ersetzt wird. 2.1.308 (22. Oktober, 04:19 UTC) ist das Release zur Verbesserung der Zuverlässigkeit mit einem einzeiligen Änderungseintrag, das zu stable wurde.²⁷⁸

Telemetrie und der API-skill. Das OpenTelemetry-Ereignis claude_code.safety_event wird für jeden Tool-Aufruf ausgelöst, den eine Berechtigungsregel, der automatische Modus, eine Sicherheitsprüfung, ein hook oder die Sandbox gestoppt, zur Bestätigung vorgelegt oder zurückgegeben hat (siehe die Referenz der Umgebungsvariablen). /claude-api api-version stellt Claude-API-Code auf die API-Version 2026-10-21 um, und /claude-api managed-agents-secure (v2.1.304) vergleicht die Einstellungen eines Managed Agents-Agenten mit dem veröffentlichten Sicherheitsleitfaden von Anthropic, ohne etwas zu ändern; der skill erstellt jetzt Managed Agents-subagent-Teams auf Basis von multiagent_20261001, wobei dynamische Workflows standardmäßig aktiviert sind (v2.1.309).²⁷⁸²⁷⁹

Korrekturen und Verhalten. CLAUDE_CODE_DISABLE_1M_CONTEXT führt bei einem Alias mit dem Suffix [1m], etwa opus[1m], nicht mehr zu einem Fehler wegen eines nicht gefundenen Modells; der Beta-Header prompt-caching-scope wird über benutzerdefinierte ANTHROPIC_BASE_URL-Gateways oder auf Foundry nicht mehr gesendet; MCP-Server, die bei gesperrtem macOS-Anmeldeschlüsselbund nicht erreichbar waren, nennen jetzt den Grund, und beim nächsten Start nach dem Entsperren wird die Verbindung ohne erneute Anmeldung hergestellt; HTTP-MCP-Tool-Aufrufe werden nicht mehr doppelt gesendet, wenn die Verbindung während des Aufrufs geschlossen wird, da nur schreibgeschützte oder idempotente Tools erneut versucht werden; Fehler vom Typ „Autocompact wird ständig erneut ausgeführt“ in Gesprächsschritten, die viele PDF-Seiten oder Bilder lesen, sind behoben; nicht parsbare Tool-Aufrufe werden bis zu zweimal erneut versucht, bevor der Gesprächsschritt mit einem Fehler endet; gemeinsam gestarteten Fork-subagents wird jeweils mitgeteilt, welcher Start ihr eigener ist; /permissions > Kürzlich abgelehnt zeigt den abgelehnten Shell-Befehl an; die Einstellung axScreenReader und CLAUDE_AX_SCREEN_READER in einem env-Block der Einstellungen werden nur aus Benutzereinstellungen, verwalteten Einstellungen oder über --settings geladenen Einstellungen übernommen (seit 2.1.305); und Checkout-hooks selbst gehosteter Runner werden standardmäßig nach 30 Minuten gestoppt (--checkout-hook-timeout-min, 0 für keine Begrenzung). Code Review erhält @claude review stop (auch off und pause), um ein mit @claude review always eingerichtetes Abonnement zu beenden.²⁷⁸

Neuerungen in v2.1.304 und v2.1.305

Claude Code 2.1.304 wurde am 19. Oktober 2026 veröffentlicht (npm 19:47 UTC; GitHub-Release 21:34 UTC; 76 Punkte) und 2.1.305 am 20. Oktober (npm 19:29 UTC; GitHub-Release 20:46 UTC; 38 Punkte), beide identisch mit dem maßgeblichen CHANGELOG; 2.1.303 (18. Oktober) ist ein Release zur Verbesserung der Zuverlässigkeit mit einem einzeiligen Änderungseintrag.²⁷⁸

Einrichtung des automatischen Modus und Korrekturen für /usage. /auto-mode-setup (v2.1.304) führt Sie durch die Einrichtung, liest Ihr Projekt und die letzten Sitzungen und entwirft daraus autoMode.environment-Einträge. Die Funktion ist auch auf Bedrock, Vertex, Foundry, über das Claude-Apps-Gateway und in Sitzungen mit deaktivierter Telemetrie verfügbar; sie wird in der Dokumentation zur Konfiguration des automatischen Modus beschrieben. /usage (v2.1.305) wandelt jede Warnung in einen einzeiligen Korrekturvorschlag um, der die Ursache nennt; mit f werden die Korrekturen angewendet. Diese erscheinen auch in VS Code und /doctor; außerdem zeigt /usage an, wann eine Ratenbegrenzung für Nutzungsdaten endet. Bei Pro und Max erscheint beim Fortsetzen eines inaktiven Gesprächs, das einen spürbaren Anteil des 5-Stunden-Nutzungslimits beanspruchen würde, jetzt eine Warnung mit der Option, stattdessen ein neues Gespräch zu beginnen (v2.1.304). Siehe Automatischer Modus auf Max und die Zeile zu /usage unter Slash-Befehle.²⁷⁸²⁷⁹

Einstellungen und Umgebung. sandbox.allowNestedUserNamespaces (v2.1.305) erlaubt Befehlen in der Sandbox unter Linux, Benutzernamensräume zu erstellen (Chromium, rootless podman), ermöglicht ihnen dadurch allerdings auch, den Dateischutz der Sandbox zu umgehen. Mit CLAUDE_CODE_RETRY_WATCHDOG_USAGE_LIMIT_RECHECK_MS (v2.1.305) erkennt der unbeaufsichtigte Wiederholungsmodus, wenn ein Nutzungslimit vor seiner regulären Zurücksetzung aufgehoben wurde. CLAUDE_CODE_AUTO_COMPACT_WINDOW akzeptiert wie --autocompact die Suffixe k und M und warnt bei Werten außerhalb des gültigen Bereichs (200k hatte zuvor stillschweigend ein 100K-Fenster eingestellt). allowedMcpServers filtert stdio-Server aus managed-mcp.json, die ${VAR} ausschließlich in env verwenden, nicht mehr heraus. Ein Server, der nicht auf Ihrer Zulassungsliste stand, wird daher nach dem Upgrade geladen (verwenden Sie deniedMcpServers, um ihn weiterhin zu deaktivieren). Hinter einer benutzerdefinierten ANTHROPIC_BASE_URL ist die Tool-Suche standardmäßig aktiviert (v2.1.304). v2.1.305 behebt zudem die Regression aus 2.1.304, durch die jede Anfrage auf Vertex, Bedrock und anderen Anbietern fehlschlug, deren Endpunkt die Tool-Suche ablehnt: Claude Code versucht die Anfrage jetzt ohne sie erneut. plugins, die Claude Desktop über einen Pfad einbindet, verlieren unter allowManagedPermissionRulesOnly ihre allowed-tools. Mit Stand vom 23. Oktober sind all diese Änderungen außer der standardmäßig aktivierten Tool-Suche dokumentiert.²⁷⁸²⁷⁹

Mods, skills und hooks. Das Ereignis tool.check eines Mods enthält e.isReadOnly; seine Antwort kann decider: "person" setzen, sodass nur der Berechtigungsdialog oder ein Host-Callback die Freigabe erteilen kann; settings.read-hooks erhalten jede Einstellungsebene und schreiben die zusammengeführten Einstellungen um; eine Zeile im Gesprächsprotokoll nennt ein plugin, das einen Ihrer hooks übersprungen hat; und ein angedockter Bereich belegt höchstens 45 % der Terminalbreite (v2.1.305). Nach der Komprimierung erhält Claude die Liste der skills erneut, während /reload-skills nur neue oder geänderte skills sendet; die skills einer Quelle können pro Sitzung höchstens 1.024 hooks und 16.384 Matcher-Zeichen registrieren; der once-hook eines skills entfernt nicht mehr den identischen hook eines anderen skills. Beim Fortsetzen eines Workflows werden abgeschlossene pipeline()- und parallel()-Agenten aus dem Ausführungsjournal übernommen, statt erneut ausgeführt zu werden (v2.1.305); selbst getaktete /loop-Aktivierungen beim Höchstintervall von 1 Stunde erfolgen nicht mehr kurz nach Ablauf des Prompt-Caches; claude --worktree entfernt beim Beenden den Worktree und seinen Branch nicht mehr ungefragt, wenn HEAD losgelöst war oder auf einem anderen Branch stand; bei rm -r für ein eingebundenes Laufwerk oder einen Ordner auf dessen oberster Ebene erscheint die Sicherheitsabfrage; und Code Review erhält Prüfstufen (Schnell, Standard, Gründlich) sowie eine Option, jedes Repository einer GitHub-Organisation zu prüfen. Im Dialog /fast entfällt bei Opus 5.5 die Kennzeichnung „(Forschungsvorschau)“.²⁷⁸

Neuerungen in v2.1.302

Claude Code 2.1.302 wurde am 16. Oktober 2026 veröffentlicht: npm veröffentlichte die Version um 16:48 UTC, der GitHub-Release folgte um 20:53 UTC mit denselben 63 Punkten wie das maßgebliche CHANGELOG. Bei npm verweisen sowohl latest als auch next darauf, während stable bei 2.1.292 bleibt. Die Version folgt auf 2.1.301 (15. Oktober, 51 Punkte); es wurde nichts übersprungen. Die am 17. Oktober abgerufene Dokumentation enthält bereits den vim-Bewegungsbefehl und die Darstellung mathematischer Formeln in VS Code aus 2.1.301, aber noch keinen der folgenden Punkte. Für diese dient daher jeweils das CHANGELOG als Quelle.²⁷⁵²⁷⁶

claude -p und das SDK starten wieder im manuellen Modus. Eine Sitzung mit claude -p oder dem Agent SDK ohne angegebenen Berechtigungsmodus startet bei Drittanbietern, bei deaktivierter Telemetrie und bei einer Neuinstallation jetzt in default (manuell); --permission-mode auto behält den automatischen Modus bei. Damit wird die Regel aus v2.1.285 zurückgenommen, nach der diese Sitzungen im automatischen Modus starteten. Für interaktive Terminal- und VS Code-Sitzungen bleibt alles beim Alten: automatischer Modus in jedem Tarif und bei jedem Anbieter. Die Dokumentation zu Berechtigungsmodi beschreibt weiterhin das Verhalten von v2.1.285. Siehe Berechtigungsmodi.²⁷⁵²⁷⁶

Fork-subagents und Standardeinstellungen für die Hintergrundausführung. Fork-subagents (subagent_type: "fork") sind in claude -p, im Agent SDK, in der Desktop-App und in VS Code standardmäßig aktiviert, wie zuvor schon im Terminal; CLAUDE_CODE_FORK_SUBAGENT=0 deaktiviert sie, und claude mcp serve bietet sie nie an. Die Desktop-App und VS Code führen die subagents des Hauptgesprächs jetzt wie das Terminal immer im Hintergrund aus, statt Claude darüber entscheiden zu lassen. Die eigenen Agent-Aufrufe eines subagent laufen dagegen in claude -p, im SDK, in der Desktop-App und in VS Code standardmäßig im Vordergrund. Von den Prompt- und Agent-hooks eines Ereignisses werden jetzt höchstens 12 gleichzeitig ausgeführt; die übrigen warten, bis sie an der Reihe sind. Die Dokumentation zu Umgebungsvariablen und subagents gibt weiterhin an, dass der Fork-Modus nur in interaktiven Sitzungen aktiviert ist. Siehe Was sind subagents?.²⁷⁵²⁷⁶

Automatischer Modus und Komprimierung. CLAUDE_CODE_AUTO_MODE_MODEL legt fest, welches Modell der clientseitige Klassifikator des automatischen Modus verwendet; das Modell für den serverseitigen automatischen Modus bleibt davon unberührt. Beim serverseitigen Klassifikator wird ein Gespräch, das für die Sicherheitsprüfung zu lang ist, jetzt komprimiert, statt jeden geprüften Tool-Aufruf abzulehnen. /config erhält eine Zeile Komprimierung bei Inaktivität, mit der Sie diese Funktion aus- oder wieder einschalten können. Der Hinweis nach einer solchen Komprimierung erklärt zudem, wie Sie sie deaktivieren. Der Fehler „Prompt ist zu lang“ beim Stoppen eines Durchgangs während der Komprimierung wurde behoben. Außerdem speichern /autocompact und /effort ihre Einstellungen für das richtige Modell, wenn ein Gateway Opus 4 oder 4.1 mit einem Präfix wie anthropic/claude-opus-4-1 benennt.²⁷⁵

Claude Design wird bis zum 14. Dezember 2026 eingestellt. /design-sync und /design-login zeigen jetzt einen Hinweis an, dass das eigenständige Claude Design (claude.ai/design) bis zu diesem Datum eingestellt wird. /design consent und /design revoke verweisen Cloud-Sitzungen jetzt auf claude.ai/design/settings statt auf /design-login. Siehe die Zeile zu /design unter Slash-Befehle.²⁷⁵

Wissenswerte Fehlerbehebungen. Das Tool Read lädt Bilder beliebiger Größe sowie Pipes oder Geräte mit einem bildähnlichen Namen nicht mehr vollständig in den Arbeitsspeicher: Bildquellen über 128 MB werden abgelehnt. Ein während der Sitzung hinzugefügtes Tool, das über ToolSearch oder nach einer Komprimierung erneut geladen wird, verursacht keinen Prompt-Cache-Fehltreffer mehr. claude plugin und andere Unterbefehle warten vor dem Beenden, bis ein ausstehender Schreibvorgang für Einstellungen oder Konfiguration abgeschlossen ist. Änderungen gehen dadurch nicht mehr verloren und bleiben auch nicht als .tmp-Datei zurück. Wenn git standardmäßig das reftable-Format für Referenzen verwendet, werden Plugin-Marktplätze nicht mehr bei jeder Aktualisierung neu geklont, und git-plugins zeigen nicht mehr die Version „unbekannt“ an. Die Worktree-Isolation funktioniert unter git 2.56 oder neuer auch dann, wenn eine verwaiste .git-Datei auf ein nicht vorhandenes Verzeichnis verweist. MCP-Server, die die Protokollversion 2026-07-28 aushandeln, aber resultType, ttlMs oder cacheScope weglassen, zeigen ihre Tools jetzt an. Nach einer Antwort, die über Nutzungsguthaben abgerechnet wurde, werden Prompt-Vorschläge übersprungen. Anfragen scheitern nach einem Wechsel zu Vertex oder Bedrock während einer Sitzung nicht mehr mit „diagnostics: Zusätzliche Eingaben sind nicht zulässig“. Der Start mit vielen plugins ist schneller, insbesondere unter Windows. Zudem werden Schreibvorgänge auf exFAT- oder FAT32-Laufwerken unter Windows nicht mehr abgelehnt.²⁷⁵

Cloud-Sitzungen und Claude Tag. Auf der Seite einer Routine zeigt ein Banner an, warum der letzte Lauf nicht gestartet wurde, etwa wegen der organisationsweiten Obergrenze für gleichzeitige Cloud-Sitzungen. „Bis hierher zurückspulen“ funktioniert bei jeder Nachricht (selbst gehostete Runner benötigen v2.1.246 oder neuer). Ein Lauf, der nach einem Teil der Ausführung fehlgeschlagen ist, wird eine Stunde später nicht mehr von Anfang an wiederholt. Kosten und Nutzung einer Cloud-Sitzung werden nach der Fortsetzung in einem neuen Prozess nicht mehr auf null zurückgesetzt. Die Administratoreinstellungen für Claude Tag sind jetzt in die Registerkarten „Pakete“, „Konnektoren“, „skills und plugins“ sowie „Kanäle“ unterteilt. In Slack angehängte HEIC-, SVG-, TIFF- und BMP-Bilder erreichen Claude jetzt als Dateien. Außerdem gewährt die Managerrolle jetzt auch Zugriff auf Claude Tag in Slack, wenn Organisationen diesen rollenbasiert einschränken.²⁷⁵

Neuerungen in v2.1.301

Claude Code 2.1.301 wurde am 15. Oktober 2026 veröffentlicht (npm um 14:34 UTC; der GitHub-Release um 19:22 UTC enthält dieselben 51 Punkte wie das maßgebliche CHANGELOG). npm latest wechselte am nächsten Tag auf 2.1.302, daher werden die beiden Versionen hier gemeinsam behandelt.²⁷⁵

Unbeaufsichtigte Wiederholungsversuche erhalten eine Wartezeitgrenze bei Nutzungslimits. Mit CLAUDE_CODE_RETRY_WATCHDOG_MAX_USAGE_LIMIT_WAIT_MS beendet der Modus für unbeaufsichtigte Wiederholungsversuche (CLAUDE_CODE_RETRY_WATCHDOG) eine Anfrage, wenn ein erreichtes Nutzungslimit erst zu einem zu weit entfernten Zeitpunkt zurückgesetzt wird, statt darauf zu warten. Die Variable steht neben CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS in der Referenz der Umgebungsvariablen. Ebenfalls für Betreiber relevant: Beim Wechsel zu einem Modell mit kleinerem Kontextfenster fasst jetzt das bisherige Modell ein Gespräch zusammen, das für das neue Modell zu lang ist, statt ungefragt Nutzungsguthaben für eine Zusammenfassung zu verbrauchen. Die Aliase fable und best versuchen es einmal mit dem vorherigen Fable-Modell erneut, wenn das neueste für Ihre Organisation nicht verfügbar ist. Außerdem wird ein Gespräch hinter einem LLM-Gateway, dessen Antworten ein anderes Modell als das angeforderte nennen, nicht mehr immer wieder komprimiert.²⁷⁵

Telemetrie, vim und Mods. OpenTelemetry-Ereignisse vom Typ tool_decision erhalten classifier_verdict und permission_mode, sodass sich Entscheidungen des Klassifikators im automatischen Modus von Berechtigungsregeln unterscheiden lassen. Bei OTEL_LOG_TOOL_DETAILS=1 kommt außerdem classifier_category hinzu: Dieses Feld nennt die integrierte Regel, die zur Blockierung durch den Klassifikator geführt hat. Der Vim-Modus erhält den Bewegungsbefehl %: Damit springen Sie zur passenden Klammer, entweder allein oder in Kombination mit d, c oder y (die Dokumentation zum interaktiven Modus führt ihn bereits auf). Mods erhalten rows für Input, um im Terminal ein mehrzeiliges Textfeld anzuzeigen. Enter sendet die Eingabe ab; Umschalt+Enter oder ein Backslash vor Enter beginnt eine neue Zeile. Der .catch-Handler eines Mod-hooks wird jetzt nur ausgeführt, wenn der hook einen Fehler auslöst oder das Zeitlimit überschreitet. $.env.set wird mit {} aufgelöst, sobald die Variable gesetzt oder entfernt wurde, oder mit { deny } samt Begründung. $.model.fork gibt vor der ersten Antwort eines neuen Prozesses nicht mehr nothing-to-fork zurück. In VS Code sowie den Desktop- und Mobil-Apps kann ein oberhalb des Fragedialogs dargestellter Baum Markdown und bis zu 48 Zeilen enthalten. Siehe Mods und Vim-Modus.²⁷⁵²⁷⁶

Wissenswerte Fehlerbehebungen. Beim Beenden wird ein von einem WorktreeCreate-hook erstellter Worktree nicht mehr ungefragt entfernt, wenn er noch nicht gepushte Commits enthalten könnte. Grep und Glob melden einen Fehler, wenn das Suchprogramm fehlschlägt, statt „keine Treffer“ auszugeben. skills und Befehle mit sehr vielen oder sehr langen Argumentnamen blockieren nicht mehr mehrere Sekunden lang: Nur die ersten 64 Namen mit jeweils bis zu 64 Zeichen werden vervollständigt. Das Tool Read liest Binärdateien wie .xlsm, .parquet, .epub und .heic nicht mehr als Text. Nach /rewind werden dem Modell die skills wieder aufgelistet. Ein Tool-Aufruf, der während seiner Berechtigungsprüfung durch eine mitten im Durchgang gesendete Nachricht unterbrochen wird, wird dem Modell nicht mehr als von Ihnen abgelehnt gemeldet. Esc im vim-Modus verwirft eine eingegebene AskUserQuestion-Antwort nicht mehr: Das Freitextfeld unterstützt den NORMAL-Modus, und Esc bricht nur aus diesem Modus heraus ab. Ein voller Datenträger führt jetzt zu einer Fehlermeldung, die den Datenträger benennt, statt zum irreführenden Hinweis „Bitte führen Sie /login aus“. Aus Slack gestartete, selbst gehostete Runner können ein Repository einbinden, wenn verwaltete Einstellungen MCP-Server einschränken (verwenden Sie deniedMcpServers, um diese Tools deaktiviert zu lassen). VS Code stellt mathematische LaTeX-Formeln in Antworten dar, einschließlich $$- und \[ ... \]-Blöcken, und zeigt im Nutzungslimit-Banner für Pro und Max einen Link „Mehr Nutzung erhalten“ an.²⁷⁵

Neuerungen in v2.1.300

Claude Code 2.1.300 wurde am 14. Oktober 2026 veröffentlicht, wenige Stunden nach 2.1.299: npm veröffentlichte die Version um 14:27 UTC unter next, der GitHub-Release folgte um 18:24 UTC mit denselben 88 Punkten wie das maßgebliche CHANGELOG. Am Abend standen npm latest und next beide auf 2.1.300, während stable von 2.1.287 auf 2.1.292 wechselte. Es wurde nichts übersprungen.²⁷³ Das Advisor-Tool ist jetzt auf Claude Platform on AWS verfügbar. /advisor funktioniert jetzt auf Claude Platform on AWS; ein Advisor wird erst ausgeführt, wenn Sie mit /advisor, advisorModel oder --advisor einen auswählen. Mit CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1 schalten Sie das Tool aus. Die Dokumentationsseite zum Advisor führt Claude Platform on AWS mit Stand vom 14. Oktober weiterhin unter den nicht unterstützten Anbietern auf. Das Tool selbst, mit dem Claude an Entscheidungspunkten ein zweites Modell konsultieren kann, gab es bereits vor dieser Version. Es wird unter Das Advisor-Tool beschrieben.²⁷³²⁷⁴

Mods und Telemetrie. Mods erhalten virtualText-Promptdekorationen (Text, der im Eingabefeld angezeigt wird, aber nie in den Entwurf gelangt), $.ui.view({ agentId }), um das Protokoll eines Agenten in der Hauptansicht anzuzeigen ($.ui.view({}) führt zurück), eine dir-Eigenschaft für Text für Zeilen mit Schreibrichtung von rechts nach links sowie den prompt.change-hook für Änderungen am Eingabefeld, die nicht durch Tippen entstehen (ein aufgerufener Verlaufseintrag, das Leeren des Felds, ein Rückgängigmachen oder das Ausfüllen durch ein plugin). agent.spawn kann jetzt prompt und model eines Workflow-Agenten umschreiben, statt ihn nur abzulehnen; die Mods-Referenz datiert die Ursache rewritten in next.error.cause auf v2.1.300. OpenTelemetry-Ereignisse vom Typ api_request teilen Cache-Schreibvorgänge in cache_creation_5m_tokens und cache_creation_1h_tokens auf. Trace-Spans enthalten Attribute der semantischen GenAI-Konventionen wie gen_ai.provider.name, gen_ai.conversation.id, gen_ai.tool.name und error.type. Ein Prompt, den der prompt.submit-hook eines Mods umgeschrieben oder verworfen hat, wird im Ereignis user_prompt nicht mehr als eingegebener Text aufgezeichnet. Lokale Protokolle erfassen jetzt außerdem den System-Prompt, die Tools und die Parameter jeder API-Anfrage, sodass sich eine Anfrage anhand eines von Ihnen geteilten Protokolls exakt reproduzieren lässt (siehe Mods und Telemetrie).²⁷³²⁷⁴

Änderungen an Betrieb und Verhalten. Große Anfragen an api.anthropic.com verwenden auch bei ausgeschalteter Telemetrie gzip; mit CLAUDE_CODE_GZIP_REQUEST_BODIES=0 schalten Sie es aus. updatedInput aus PreToolUse- und PermissionRequest-hooks wird wie die eigene Eingabe von Claude validiert: Unbekannte Schlüssel werden entfernt, und wenn das Tool die Eingabe ablehnt, wird der Aufruf verweigert. Beim Beenden werden Hintergrundbefehle zwangsweise beendet, die 1,5 Sekunden nach der Aufforderung zum Stoppen noch laufen. Bei claude remote-control entfallen die wirkungslosen Flags --sandbox und --no-sandbox; die Übergabe eines dieser Flags führt zum Abbruch mit einer Fehlermeldung. Solche Sitzungen lassen sich über sandbox.enabled in den Einstellungen in einer Sandbox ausführen. Sitzungen unter CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST ignorieren Variablen für CA-Bundles, Tool-Proxys, Git-TLS und die Git-Konfiguration wie SSL_CERT_FILE in den Einstellungen. In Cowork-Cloud-Sitzungen wird setMode eines PermissionRequest-hooks ignoriert, während der übrige Teil seiner Genehmigung wirksam bleibt. Der Code-Tab von Claude Desktop wendet verwaltete Einstellungen an, wenn forceLoginGatewayUrl ein von Anthropic betriebenes Gateway benennt, das den Hostnamen der Sitzung bedient. claude gateway bricht beim Start ab, wenn es auf einen nicht unterstützten Richtlinienschlüssel mit dem Präfix desktop: trifft. Die /sandbox-Optionen heißen „Befehle in der Sandbox ausführen“. VS Code erhält claudeCode.attachSelection, damit Sie Editor-Markierungen aus Ihren Nachrichten heraushalten können. In Slack kann Claude Tag in Slack-Connect-Kanälen antworten, wenn ein Administrator dies erlaubt.²⁷³

Wissenswerte Fehlerbehebungen. SessionEnd-hooks werden ausgeführt, wenn Sie das Programm beenden, während noch ein Hintergrundbefehl läuft; ENABLE_TOOL_SEARCH=auto schaltet sich nicht mehr mitten im Gespräch ab; eine von forceLoginOrgUUID abgelehnte Anmeldung hinterlässt kein gespeichertes Token dieser Organisation mehr; Headless- und SDK-Sitzungen, die nach einer Komprimierung fortgesetzt werden, behalten die dabei bewahrten Nachrichten und die Zusammenfassung; ein Gespräch scheitert nicht mehr in jeder Runde mit einem 400-Fehler, wenn die API das Eingabeschema eines MCP-Tools ablehnt (das Tool wird stattdessen ohne Parameter gesendet); Agenten-hooks berücksichtigen ihr model; --worktree-Sitzungen starten beim richtigen Commit, wenn ein Tag oder Branch wie eine Commit-ID heißt, und lassen sich in Reftable-Repositories wieder öffnen; claude daemon stop --any wartet, beendet einen hängenden Dienst zwangsweise und endet mit Exit-Code 1, falls dieser weiterhin vorhanden ist; Write und Edit melden in Cowork-Cloud-Sitzungen keinen Erfolg mehr für einen Pfad auf Ihrem eigenen Computer; Cloud-Sitzungen hängen nicht mehr fünf Minuten pro Runde, wenn die Organisationsrichtlinie nicht gelesen werden kann; und selbst gehostete Runner frieren nicht mehr ein, wenn niemand ihre Ausgabe liest.²⁷³

Neuerungen in v2.1.299

Claude Code 2.1.299 erschien am 14. Oktober 2026 (npm um 00:23 UTC; das GitHub-Release um 02:49 UTC enthält dieselben 190 Punkte wie das maßgebliche CHANGELOG). 2.1.297 und 2.1.298 wurden nie veröffentlicht, es wird also nichts übersprungen. npm latest blieb bei 2.1.299, bis später am selben Tag 2.1.300 diesen Status erhielt (siehe Neuerungen in v2.1.300).²⁷¹²⁷³ Aktualisieren Sie von 2.1.296: Diese Version behebt zwei dort eingeführte Regressionen. Zum einen schlugen „Bearbeiten“ und „Erneut versuchen“ in Cowork- und claude.ai-Cloud-Sitzungen bei einer Nachricht fehl, die während der Ausführung ihrer UserPromptSubmit- oder Mod-prompt.submit-hooks gestoppt wurde. Zum anderen führten Cloud- oder Headless-Sitzungen einen genehmigten Tool-Aufruf zweimal aus, wenn beim Fortsetzen der Sitzung nach einem Neustart eine neue Nachricht eintraf.

Komprimierung bei Inaktivität (v2.1.299). Ein Terminal-Gespräch mit mindestens 200.000 Tokens, das etwa 54 Minuten inaktiv bleibt, wird jetzt komprimiert, bevor sein einstündiger Prompt-Cache abläuft. Dadurch muss bei der nächsten Nachricht nicht der gesamte Kontext erneut verarbeitet werden. CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS ändert die Mindestanzahl von 200.000 Tokens (Werte unter 100.000 werden auf 100.000 angehoben), und "idleCompaction": false in settings.json schaltet die Funktion aus; die Einstellungsreferenz und die Seite zu Umgebungsvariablen führen beide Optionen auf und datieren sie auf v2.1.290 oder neuer. Mit CLAUDE_CODE_DISABLE_FILE_MENTIONS=1 übergibt eine @-Erwähnung Claude den Pfad zum Lesen mit seinen Datei-Tools statt des Dateiinhalts. Dadurch werden Ihre PreToolUse-hooks beim Lesen ausgeführt; über Projekt- und lokale Einstellungen lässt sich diese Variable nicht setzen (siehe Referenz der Umgebungsvariablen).²⁷¹²⁷² v2.1.302 ergänzt in /config eine Zeile Komprimierung bei Inaktivität, mit der Sie die Funktion aus- oder wieder einschalten können. Der Hinweis nach einer solchen Komprimierung erklärt, wie das geht.²⁷⁵

Berechtigungen und MCP. Eine Erlaubnisregel wie mcp__a gilt jetzt nur für den Server namens a, nicht für a__b oder a_; schreiben Sie mcp__<server>__* mit dem vollständigen normalisierten Servernamen. Führen Sie einen Server, dessen Name __ enthält, auf dieselbe Weise in der tools:-Liste eines Agenten auf; diese steuert jetzt nur die Tools dieses Servers bei. Ablehnungs- und Rückfrageregeln für einen Server, dessen normalisierter Name einen doppelten Unterstrich enthält, greifen wieder. Tool-Beschreibungen und Serveranweisungen der von Anthropic selbst betriebenen MCP-Server unter api.anthropic.com erreichen Claude vollständig, statt nach 4.096 Zeichen abgeschnitten zu werden. Konnektoren für Cloud-Sitzungen und Remote Control handeln bei Installationen, die keine Flags abrufen, standardmäßig das MCP-Protokoll 2026-07-28 aus (MCP_PROTOCOL_NEGOTIATION=legacy deaktiviert dies). Anfragen an den Konnektor-Proxy von claude.ai und an von Anthropic gehostete MCP-Server folgen keinen HTTP-Weiterleitungen mehr, MCP OAuth sendet jetzt konfigurierte Werte für headers und headersHelper, eine leere .mcp.json wird nicht mehr als ungültig gemeldet, und Server namens constructor oder prototype können sich verbinden. Ein in der Sandbox ausgeführter Befehl kann nicht mehr in einen --plugin-dir-Ordner schreiben oder über einen symbolischen Link auf einen gesperrten Pfad zugreifen. Rückfragen zu rm erscheinen nicht mehr bei einem Shell--c-Skript, das kein rm ausführt. Ein rm, das erst zur Laufzeit innerhalb eines für Claude Code nicht lesbaren Skripts zusammengesetzt wird, löst nur mit CLAUDE_CODE_STRICT_INLINE_SHELL_RM_PROMPT=1 eine Rückfrage aus.²⁷¹

hooks und Mods. UserPromptSubmit-hooks werden ausgeführt, bevor ein skill oder ein benutzerdefinierter Slash-Befehl expandiert wird. Ein hook, der den Prompt blockiert, verhindert damit auch die Ausführung eingebetteter Shell-Befehle. Der eigene UserPromptSubmit-hook im Frontmatter eines skills wird erstmals für den Prompt ausgeführt, der auf den aufrufenden Prompt folgt. Ein plugin-hook, dem keine Aktion übergeben werden kann oder der seine Antwort nicht zurückgeben kann, verweigert die Aktion jetzt, statt sie zuzulassen; bei einem bereits ausgeführten Tool wird das Ergebnis zurückgehalten. Bei Mods empfängt der turn.start-hook auch die Gesprächsrunden von subagents und Teammitgliedern (e.agentId unterscheidet sie). skill.prompt erhält das Frontmatter, die Quelle, den plugin-Namen und den Dateipfad des skills (die Mods-Referenz datiert diese Ergänzungen auf v2.1.299). Mit $.prompt.media kann der prompt.submit-hook eines Mods aus verwalteten Einstellungen ein angehängtes Bild oder Dokument lesen. $.session.identity() gibt Auskunft darüber, wie die Sitzung angemeldet ist. Text akzeptiert size, weight, mono und tabular, Box benannte Abstandsstufen (bold ist zugunsten von weight veraltet). session.append erhält einen queue-Zugang, und agent.spawn wird bei einem fortgesetzten subagent oder Teammitglied mit gesetztem resume ausgelöst. Aus der Ferne deaktivierte Mods werden zwischen den Gesprächsrunden entladen. /plugin und claude plugin validate nennen hooks, die übersprungen werden, wenn eine Organisation Claude Code verwaltet (siehe Mods).²⁷¹²⁷² Befehle, Oberflächen und Betrieb. /usage warnt vor maximalem Denkaufwand, Workflows, dauerhaft eingebundenem Kontext und umfangreichen Werkzeugergebnissen. In der Agentenansicht legen /effort und /fast die Startwerte für neue Sitzungen fest. Ein Aufruf von /model, /effort oder /fast ohne Argumente öffnet eine Auswahl, und die Vorschau zeigt für Sitzungen, die mit --safe-mode gestartet wurden, eine Zeile zum abgesicherten Modus an. Der Planungsmodus zeigt einmalig einen Hinweis an, wenn er vor den meisten Änderungen nicht nachfragen wird, weil das Umgehen der Berechtigungsprüfung verfügbar ist. claude plugin eval akzeptiert --disallow-tools und ein Fallfeld disallowed_tools; ein Durchlauf, der mit einem API-Fehler endet, erhält 0 Punkte und lässt die Testsuite fehlschlagen. claude self-hosted-runner orchestrator --shutdown-drain-sec gibt laufenden Abfragen und Spawn-hooks bei SIGTERM Zeit zum Abschluss. Hinter einem Claude-Apps-Gateway entfernt CLAUDE_CODE_ATTRIBUTION_HEADER=0 im env einer code- oder cli-Richtlinie den Attributionsblock. In Cowork-Cloud-Sitzungen kann ein PermissionRequest-hook im Automatikmodus keine Shell-Befehle oder subagents mehr genehmigen. Eine Aktion von Claude in Chrome, die der Sicherheitsklassifikator auf einer genehmigten Website beanstandet, fragt nun bei Ihnen nach, statt abgelehnt zu werden. Der beim Beenden ausgegebene Befehl zum Fortsetzen identifiziert die Sitzung anhand ihrer ID; /btw überschreitet in nicht interaktiven Sitzungen nach 11 Minuten das Zeitlimit; eine lokale Sitzung kann nun 25 veröffentlichte Artefakte überwachen statt bisher 10; und der Hinweis zu Cyberschutzmaßnahmen fordert Sie nicht mehr dazu auf, sich für das Cyber Verification Program zu bewerben.²⁷¹

Wissenswerte Fehlerbehebungen. Streams über eine benutzerdefinierte ANTHROPIC_BASE_URL warten 300 Sekunden auf Daten, statt nach 180 Sekunden abzubrechen; Anfragen an Anthropic für Funktionsschalter, Startvorgang, Schnellmodus, Profil und serververwaltete Einstellungen enthalten nicht mehr den API-Schlüssel eines Drittanbieter-Gateways; /usage und die Statuszeile zeigen keine Auslastung über 100 % mehr an; geplante Aufgaben und Schleifen werden während der bei der Zeitumstellung auf Winterzeit wiederholten Stunde nicht mehr nach jedem Durchgang erneut ausgelöst; der Speicherverbrauch wächst unter --debug oder wenn ein übergeordneter Prozess stderr nicht mehr liest, nicht mehr unbegrenzt; SendMessage findet einen subagent nach einem Neustart anhand seines Namens; Read verarbeitet UTF-16LE-Dateien mit einer Byte-Reihenfolgemarkierung, und Write weigert sich, Windows-1252-, Shift-JIS-, GBK- oder UTF-16BE-Dateien stillschweigend in UTF-8 umzuwandeln; unter Windows blockieren PreToolUse- und PermissionRequest-hooks ohne festgelegte Shell den Aufruf, wenn Git for Windows fehlt, statt ihn trotz fehlgeschlagener Prüfung zuzulassen.²⁷¹

Neuerungen in v2.1.293–v2.1.296

Zwischen dem 7. und 9. Oktober 2026 erschienen vier Versionen. Bei npm stehen latest und next auf 2.1.296; stable wechselt von 2.1.285 auf 2.1.287.²³⁸ Die wichtigste Neuerung ist ein neues Modell: Mit v2.1.293 wird Claude Haiku 5.5 zum Modell, das haiku über die Anthropic API auswählt (siehe Verfügbare Modelle). Aktualisieren Sie auf v2.1.296, wenn Sie sich über verwaltete Einstellungen bei einem Claude-Apps-Gateway anmelden: Diese Version behebt eine Regression aus v2.1.295, durch die eine gespeicherte Gateway-Anmeldung ignoriert wurde, wenn forceLoginMethod auf gateway gesetzt war und forceLoginGatewayUrl fehlte.

v2.1.296 (9. Oktober). Cache-Lesezugriffe für Sonnet 5.5 werden in /cost, der Statuszeile, --max-budget-usd und den Kostenangaben des SDK mit 0,10 $ pro Million Tokens berechnet; zuvor wurden 0,20 $ angesetzt. Die standardmäßige Längenbegrenzung für vorab übermittelte MCP-Werkzeugbeschreibungen und MCP-Serveranweisungen steigt von 2.048 auf 4.096 Zeichen. Frontmatter von subagents und --agents-Definitionen akzeptieren autoCompactWindow, sodass ein subagent seinen Kontext früher automatisch komprimieren kann als die Hauptkonversation. Mit CLAUDE_CODE_WORKFLOW_SUBAGENT_MODEL laufen alle Workflow-Agenten mit einem einzigen Modell, während andere subagents ihre jeweiligen Modelle behalten. CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS legt eine längere maximale Wartezeit für die Wiederholungsversuche bei 529-Fehlern fest. Das Werkzeug Read akzeptiert allow_large, sodass Claude eine Textdatei jenseits der üblichen Größenbegrenzung in einem einzigen Aufruf lesen kann, sofern im Kontext genügend Platz ist. PreToolUse-hooks aus verwalteten Einstellungen, die einen Werkzeugaufruf mit "continue": false ablehnen, sowie verwaltete prompt-hooks, die einen Aufruf blockieren, beenden nun zusätzlich den Durchgang. --debug nennt unbekannte Frontmatter-Felder in benutzerdefinierten Agentendateien und protokolliert für jeden Befehls-hook dessen Befehl, plugin, Ergebnis und Dauer. Ein Claude-Apps-Gateway erhält unter managed.policies[] einen Schlüssel code mit denselben Einstellungen wie cli; diese gelten auch im Code-Tab von Claude Desktop. Ein Durchgang oder !-Befehl, der gestartet wird, während ← die Sitzung in den Hintergrund verschiebt, wird nun angehalten, statt unbemerkt zu Ende zu laufen. Die Dokumentation wurde inzwischen für zwei dieser Änderungen ergänzt: Die hooks-Referenz ordnet die --debug-Zeilen pro hook v2.1.296 zu, und die Dokumentation zum Claude-Apps-Gateway beschreibt den Richtlinienschlüssel code; autoCompactWindow und CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS wurden bis zum 14. Oktober in die Dokumentation zu subagents und Umgebungsvariablen aufgenommen; CLAUDE_CODE_WORKFLOW_SUBAGENT_MODEL ist mit Stand vom 14. Oktober 2026 weiterhin nur in den Versionshinweisen dokumentiert.^238240270272

v2.1.295 (8. Oktober). Befehls- und HTTP-hooks akzeptieren onFailure: "block": Ein hook, der nicht starten kann, das Zeitlimit überschreitet oder mit einem unerwarteten Exit-Code endet, blockiert die Aktion, statt sie zuzulassen (siehe Ein-/Ausgabeprotokoll für hooks). CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS begrenzt, wie lange der unbeaufsichtigte Wiederholungsmodus bei 429- und 529-Fehlern wartet. Subagents laden höchstens 32 skills aus dem Feld skills vorab. Über die Werkzeugsuche geladene MCP-Werkzeugbeschreibungen werden bei 16.384 statt 2.048 Zeichen gekürzt. forceLoginMethod: "gateway" und forceLoginGatewayUrl funktionieren nun auch in Ihren eigenen Benutzereinstellungen auf einem Rechner ohne verwaltete Einstellungen, sodass /login dieses Gateway öffnet; diese Konfiguration wird inzwischen in der Gateway-Dokumentation beschrieben. Jeder Gateway-Upstream akzeptiert eine optionale Liste models mit * als Platzhalter, und Cloud-Upstreams berücksichtigen timeouts.upstream_ttfb_ms. Terminals, die das Program Status Protocol (OSC 7501) implementieren, können anzeigen, ob Claude Code arbeitet, auf Sie wartet oder fertig ist. Hintergrundanfragen hinter einem Claude-Apps-Gateway verwenden Haiku 4.5 statt des Sitzungsmodells, sofern das Gateway dieses Modell bereitstellt. Wird die context-1m-Beta für ein [1m]-Modell von einem Gateway, Bedrock, Vertex oder Foundry abgelehnt, wird die Anfrage ohne diese Beta erneut gesendet, statt fehlzuschlagen. Ctrl+C an der inaktiven Eingabeaufforderung einer verbundenen Hintergrundsitzung lässt eine ausstehende /loop-Reaktivierung unverändert. Zweimaliges Drücken trennt daher die Verbindung, während die Schleife weiterläuft; Esc hält sie an. claude.ai-Konnektoren handeln bei Installationen, die keine Funktionsschalter abrufen, standardmäßig das MCP-Protokoll 2026-07-28 aus. /copy bietet zitierten Text an, claude -p gibt nach seinem letzten Durchgang auf stderr aus, worauf es wartet, und Mods erhalten $.ui.notify. Websuchen und die Auswertung von agent-hooks dauern bei den Denkaufwandsstufen xhigh und max nicht mehr wesentlich länger.²³⁸²⁴⁰

v2.1.294 (8. Oktober). Zwei Fehlerbehebungen für prompt- und agent-hooks, die als Anweisungen formuliert sind: Ein hook wie „Blockieren Sie Befehle, die …“ lässt nicht mehr zu, was er blockieren sollte. Stop- und SubagentStop-hooks wie „Fahren Sie fort, wenn der Build fehlschlägt“ werden so ausgewertet, dass Claude seltener vorzeitig aufhört.²³⁸

v2.1.293 (7. Oktober). Claude Haiku 5.5 (claude-haiku-5-5) ist das standardmäßige Haiku-Modell über die Anthropic API: 1 Million Tokens Kontext, 0,10 $/0,50 $ pro Million Tokens, 0,50 $/2,50 $ bei Prompts mit mehr als 100.000 Tokens. Die Nutzdaten von subagentStatusLine erhalten agentType, sodass ein Statuszeilenskript benutzerdefinierte subagent-Typen unterscheiden kann; Mods erhalten isDeferred für $.tool.register. Zwei Änderungen wurden zurückgenommen: die Ablehnungsmeldung des Automatikmodus aus v2.1.281, die Claude mitteilte, dass eine Ablehnung das Ergebnis und nicht nur den konkreten Befehl umfasst, sowie die Fehlerbehebung aus v2.1.290 für eine nach einem Containerneustart verlorene /loop-Reaktivierung in Cloud-Sitzungen. Eine solche Sitzung bleibt daher wieder im Ruhezustand. Außerdem betrachtet Claude seine eigenen letzten Aktionen vor einer Kontextkomprimierung danach nicht mehr als erledigt; eine HTTP-MCP-Verbindung bewahrt nicht mehr jede gesendete Anfrage bis zum Schließen auf; claude purge listet auf, was nicht entfernt werden konnte, und endet mit Exit-Code 1, statt stillschweigend abzubrechen; die Synchronisierung von skills über claude.ai prüft alle 40 statt alle 10 Minuten auf Änderungen, solange keine Sitzung verwendet wird; beim Start von Team und Enterprise werden Richtlinien und verwaltete Einstellungen früher abgerufen, wobei eine festhängende Anfrage nach 3 Sekunden wiederholt wird.²³⁸²⁴⁰

Neuerungen in v2.1.288–v2.1.292

Zwischen dem 2. und 6. Oktober 2026 erschienen fünf Versionen. Bei npm stehen latest und next auf 2.1.292; stable bleibt bei 2.1.285.²³⁴ Aktualisieren Sie, wenn Sie 2.1.288, 2.1.289 oder 2.1.290 verwenden: v2.1.291 behebt eine Regression aus 2.1.288, durch die beim Beenden die letzten Nachrichten einer Sitzung verloren gehen konnten, sowie eine Regression aus 2.1.290, durch die in Cloud-Sitzungen Antworten auf Berechtigungsabfragen verloren gehen konnten.²³⁵ v2.1.292 (6. Oktober). Mit CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS lässt sich die Basiswartezeit für das Backoff bei einem erneuten Versuch nach einer Überlastungsantwort (529) verlängern; die Dokumentation zu Umgebungsvariablen nennt jetzt den Standardwert von 500 ms und den zulässigen Bereich von 500 bis 32000. Das Agent-Tool akzeptiert einen effort-Parameter, sodass Claude einen subagent mit der von Ihnen gewünschten Aufwandsstufe ausführen kann; die Dokumentation zu subagents beschreibt jetzt diesen Parameter für einzelne Aufrufe, der das Frontmatter-Feld überschreibt und beim Fortsetzen des subagent weiterhin gilt. CLAUDE_CODE_EFFORT_LEVEL hat dabei Vorrang vor beiden. claude plugin install --marketplace <source> fügt einen Marketplace hinzu und installiert daraus mit einem einzigen Shell-Befehl. Lokale (stdio-)MCP-Server handeln jetzt bei jeder Installation standardmäßig die Protokollversion 2026-07-28 aus, auch bei Bedrock, Vertex und Foundry; mit MCP_PROTOCOL_NEGOTIATION=legacy lässt sich dies deaktivieren. Die MCP-Dokumentation weist jetzt darauf hin, dass bei stdio-Servern standardmäßig diese Version angefragt wird. Agent-Namen sind auf 256 Zeichen begrenzt: Längere Namen werden abgelehnt, ein längerer name in einer skill- oder plugin-Datei wird ignoriert. Die Dokumentation zu subagents nennt jetzt die Obergrenze für das Feld name; eine subagent-Datei mit einem längeren Namen wird übersprungen und ein Fehler im Debug-Protokoll vermerkt. Eine Sicherheitskorrektur verhindert, dass Freigaben durch PreToolUse-hooks und der automatische Modus die Rückfrage beim Lesen von Dateien über Netzwerkpfade (UNC) umgehen. Mods erhalten prompt.autocomplete, Prompt-Caching in $.model.complete und Workflow-Agenten in agent.spawn; außerdem schlägt claude plugin test jetzt fehl, wenn eine Stub-Antwort verweigert wird. Die übrigen Punkte waren mit Stand vom 6. Oktober 2026 nur in den Versionshinweisen dokumentiert.^236237240

v2.1.290 (5. Oktober). Das interaktive WebSearch-Kontingent wird mit 100 Aufrufen pro Stunde aufgefüllt (CLAUDE_CODE_WEB_SEARCH_REFILLS_PER_HOUR; 0 deaktiviert das Auffüllen), statt nach 200 Aufrufen erschöpft zu sein. claude attach und claude logs akzeptieren einen Teil eines Sitzungsnamens. /claude-api managed-agents-onboard <url> wandelt eine Seite, die das Managed-Agents-Muster beschreibt, in Dateien für ant apply um; /claude-api managed-agents-onboard <quickstart-name> erstellt mit der ant-CLI eine Console-Schnellstartvorlage wie deep-researcher. Mehrere Standardeinstellungen werden strenger: Projekteinstellungen können Claude in Chrome nicht mehr aktivieren, die Dateien .claude/settings.json oder .claude/settings.local.json eines Repositorys können CLAUDE_CODE_DISABLE_ATTACHMENTS nicht mehr setzen, pyright und weitere Varianten von ps fragen vor der Ausführung nach, und eine verwaltete Einstellungsdatei, die auf ein Ziel außerhalb des Ordners für verwaltete Einstellungen verweist, löst eine Warnung aus. WebFetch gibt jetzt an, wie viel von einer Seite jenseits von 100.000 Zeichen ungelesen blieb, und akzeptiert einen offset, um weiterzulesen; zuvor wurde dieser Text stillschweigend verworfen. CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC überspringt außerdem den vorsorglichen Verbindungsaufbau beim Start, und CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS=5m wird nicht mehr als 5 ms interpretiert: Bei Werten mit einem Einheitensuffix greift stattdessen die Einstellung dialogExpiry.²³⁵²³⁷

v2.1.290, Teams und Gateways. Die Seite zur Anmeldefreigabe des Claude-Apps-Gateways erhält eine Schaltfläche zum Ablehnen, und die unterstützte PostgreSQL-Mindestversion sinkt von 14 auf 11. Auf selbst gehosteten Runnern erstellt claude --environment <id> seine Sitzung über die aktuelle Sessions-API. claude --teleport und /teleport lehnen einen Stash ab, der Dateien in einem Ordner löschen würde, der eine gleichnamige versionierte Datei ersetzt hat; das --channels-Relay ignoriert eine wiederholte Antwort-ID, statt eine andere Rückfrage zu genehmigen. In Slack schaltet !fast einen Thread in den schnellen Modus und !fast off wieder zurück. VS Code zeigt standardmäßig Zeitstempel für Nachrichten an (über die Einstellung Claude Code: Nachrichtenzeitstempel anzeigen lassen sie sich deaktivieren).²³⁵

v2.1.289 (3. Oktober). Mods erhalten agent.spawn für Teammitglieder, eine einheitliche Agent-ID über plugin-hook-Ereignisse hinweg sowie Zustände für Leerlauf und Warten in $.agent.list(); claude plugin validate überspringt ein plugin nicht mehr, wenn dessen Ordner auch ein Marketplace-Manifest enthält; außerdem werden zwei Lücken in Bash-Verweigerungsregeln bei automatischer Sandbox-Freigabe geschlossen.²³⁵²³⁷

v2.1.288 (2. Oktober). claude project purge heißt jetzt claude purge; der alte Name funktioniert weiterhin und gibt einen Hinweis aus. Das Zeitlimit für Hintergrundbefehle gilt nur in unbeaufsichtigten Sitzungen (-p, Agent-SDK, CI, Cloud). /code-review --max-findings <n>|all ändert die Obergrenze für Befunde, bis Sie --max-findings default übergeben. /autocompact speichert sein Fenster für jedes Modell separat. CLAUDE_CODE_DISABLE_STRUCTURED_OUTPUTS deaktiviert strukturierte Ausgaben für Mantle oder Gateways, die diese ablehnen. Pfadbezogene Regeln und verschachtelte CLAUDE.md-Dateien werden bei Write und Edit geladen, nicht nur bei Read. Sprachserver brechen nach 60 Sekunden wegen Zeitüberschreitung ab (requestTimeout pro Server), statt hängen zu bleiben. Im automatischen Modus wird eine Konversation, die für den clientseitigen Klassifikator zu lang ist, komprimiert, statt bei jedem Tool-Aufruf nachzufragen. Außerdem ignoriert der clientseitige Klassifikator eine Modellfestlegung durch ANTHROPIC_DEFAULT_SONNET_MODEL, die Claude Sonnet 5.5 oder Opus 5.5 angibt, und verwendet stattdessen Claude Sonnet 5. Mods erhalten $.ui.selection(), Cloud-Sitzungen ohne GitHub-CLI erhalten ein integriertes gh api, und die Pfeil-nach-oben-Taste stellt bei leerer Eingabe einen durch Ctrl+C gelöschten Entwurf wieder her.²³⁴²³⁷

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

Sitzungsrückblick (v2.1.108+)

Eine neue Funktion auf Sitzungsebene, die Ihnen beim Zurückkehren zu einer pausierten Sitzung den Kontext anzeigt. Standardmäßig aktiviert und über /config oder CLAUDE_CODE_ENABLE_AWAY_SUMMARY=0 deaktivierbar. Das Modell kann außerdem integrierte Slash-Befehle (/init, /review, /security-review) über das Skill-Tool aufrufen — eine Erweiterung des Musters für subagents und skills.¹⁴⁶

Push-Benachrichtigungen (v2.1.110+)

Wenn in Remote Control die Option „Push senden, wenn Claude es entscheidet“ aktiviert ist, kann Claude jetzt über ein neues Tool für Push-Benachrichtigungen nach eigenem Ermessen Push-Benachrichtigungen an Mobilgeräte senden. Dies ergänzt die bestehende Mobil- und Weboberfläche von Remote Control.¹⁴⁶ /context, /exit und /reload-plugins funktionieren jetzt ebenfalls über Remote-Control-Clients.

Windows-PowerShell-Tool (v2.1.111+, schrittweise 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 (setzt pwsh im PATH voraus). Unter Windows steuert dieselbe Variable während der Einführung die Aktivierung beziehungsweise Deaktivierung.¹⁴⁶

Automatische Freigabe im Berechtigungsmodus (v2.1.119+). Befehle des PowerShell-Tools können jetzt im Berechtigungsmodus ebenso wie Bash-Befehle automatisch freigegeben werden. Freigaberegeln wie PowerShell(Get-*:*) und die bestehende Mustersyntax überspringen jetzt die Rückfrage bei ausschließlich lesenden Vorgängen und bieten damit denselben Bedienkomfort, den Teams unter Linux/macOS bereits haben.¹⁵²

Weniger Berechtigungsabfragen: ausschließlich lesende Bash-Aufrufe (v2.1.111+)

Bash-Befehlsmuster mit Glob-Argumenten, die nur lesend zugreifen (z. B. ls *.ts, cat src/*.md), und Befehle, die mit cd <project-dir> && beginnen, lösen keine Berechtigungsabfrage mehr aus.¹⁴⁶ Zusammen mit /less-permission-prompts sorgt dies für deutlich weniger Unterbrechungen im Arbeitsalltag.

Verteiltes Tracing (v2.1.110+)

SDK und Headless-Sitzungen lesen jetzt TRACEPARENT und TRACESTATE aus der Umgebung und binden dadurch Claude Code-Ausführungen in verteilte Traces ein. Kombinieren Sie dies mit OTEL_LOG_RAW_API_BODIES=1 (v2.1.111+), um zur Fehlersuche vollständige API-Anfrage- und Antwortinhalte als OpenTelemetry-Logereignisse auszugeben.¹⁴⁶

Bereitstellung als native Binärdatei (v2.1.113+)¹⁵⁰

v2.1.113 ändert den Start von CLI: claude startet jetzt über eine plattformspezifische optionale Abhängigkeit eine native Claude Code-Binärdatei, statt das mitgelieferte JavaScript auszuführen. Die Befehle für Installation und Aktualisierung bleiben gleich, und Teams müssen ihre Rollout-Skripte nicht ändern.

Tastenkombinationen im Prompt-Editor (v2.1.113+)¹⁵⁰

Der Prompt-Editor erhält eine Navigation im Readline-Stil für mehrzeilige Eingaben sowie die Möglichkeit, den sichtbaren Bereich im Vollbildmodus zu scrollen:

Zeitlimit bei Stillstand von subagents (v2.1.113+)¹⁵⁰

Wenn subagents während des Streamings nicht mehr reagieren, werden sie jetzt nach 10 Minuten mit einer eindeutigen Fehlermeldung beendet, statt unbemerkt hängen zu bleiben. Kombinieren Sie dies mit CLAUDE_STREAM_IDLE_TIMEOUT_MS (v2.1.84+), um auch andere festhängende Prozesse beim Streaming über APIs abzudecken.

Stabilitätskorrektur in v2.1.114¹⁵⁰

v2.1.114 (18. April 2026) enthält eine einzige Fehlerbehebung: Der Berechtigungsdialog konnte abstürzen, wenn ein Teammitglied in Agent Teams eine Tool-Berechtigung anforderte. Aktualisieren Sie, wenn Sie Agent Teams verwenden.

Inhaltskennzeichnung: Textwasserzeichen und C2PA-Dateimetadaten (August 2026)

Anthropic hat eine maschinenlesbare Kennzeichnung für von Claude erzeugte Inhalte angekündigt. Anlass ist Artikel 50 der EU-KI-Verordnung, der für neu eingeführte KI-Systeme ab dem 2. August 2026 verbindlich ist. Das System besteht aus zwei Komponenten: einem unsichtbaren statistischen Wasserzeichen in generiertem Text und signierten Herkunftsmetadaten nach dem offenen C2PA-Standard in generierten Dateien wie .svg, .png und .jpg.²⁵²²⁰⁴ Ein Detail geht in den Schlagzeilen unter: Für beide Komponenten gilt derselbe modellbezogene Zeitplan. Laut Supportseite werden „Claude-Modelle, die am oder nach dem 2. August 2026 eingeführt werden, die maschinenlesbare Kennzeichnung von Beginn an unterstützen“. Modelle, die vor diesem Datum eingeführt wurden — also die gesamte derzeitige Modellpalette (Fable 5, Opus 5, Sonnet 5, Haiku 4.5) — fallen unter die Übergangsfrist der EU-Verordnung. Anthropic arbeitet daran, „die Kennzeichnung auch für diese Modelle zu unterstützen“.²⁰⁴

Diese Liste stammt aus dem August. Fable 5.1 (1. September), Opus 5.5 (22. September) und Sonnet 5.5 (28. September) wurden nach dem Stichtag eingeführt und fallen damit unter die Regelung zur Kennzeichnung ab Einführung. Die Veröffentlichungshinweise zu Fable 5.1 führen den Herkunftsnachweis für Inhalte als Neuerung auf; auf der Modellseite und im Migrationsleitfaden zu Opus 5.5 sowie auf der Modellseite und der Neuerungsseite zu Sonnet 5.5 wird die Kennzeichnung dagegen nicht erwähnt.^241222230 Ausgaben der vor August eingeführten Modelle tragen keine Kennzeichnung, weder Texte noch Dateien. Ausgaben neuerer Modelle werden hingegen auf allen Oberflächen gekennzeichnet — Claude Platform (API), claude.ai, Claude Code, Claude Cowork, Claude Tag und den Cloud-Gateways —, da die Kennzeichnung auf Modellebene erfolgt. Eine Schlussfolgerung verdient besondere Erwähnung, weil ein viraler Thread sie ins Gegenteil verkehrt hat: Wenn Sie bei einem der vor August eingeführten Modelle eine Veränderung im Stil oder Verhalten wahrnehmen, kann diese nicht auf Wasserzeichen zurückgehen, da die Kennzeichnung bei diesen Modellen noch nicht aktiv ist.

So funktioniert es: Verwendet wird eine Variante von SynthID-Text von Google DeepMind. Das Wasserzeichen verändert „die Quelle des Zufalls, der zur Auswahl zwischen Wörtern verwendet wird“, wenn Claude zwischen semantisch gleichwertigen Optionen wählt. Es werden keine Zeichen hinzugefügt, und es findet keine Nachbearbeitung statt. Laut internen Tests von Anthropic hat die Kennzeichnung „keine Auswirkungen auf den Inhalt, den Grad der Kreativität oder die Lesbarkeit“.²⁵²

Für Benutzer von Claude Code besonders relevant: Code trägt ein dünn verteiltes Wasserzeichen. Funktionsfähiger Code lässt wenig Spielraum für beliebige Entscheidungen. Deshalb konzentriert sich die Kennzeichnung auf Bereiche mit Gestaltungsspielraum — Kommentare und Namensgebung —, wobei sie laut Anthropic „einen vernachlässigbaren Effekt auf den tatsächlich erzeugten Code“ hat.²⁵² Ob die Kennzeichnung erhalten bleibt, lässt sich nur probabilistisch beurteilen und hängt von der Komponente ab: Bei Text entfernen kleinere Änderungen „das Wasserzeichen wahrscheinlich nicht vollständig“, eine vollständige Neufassung hingegen schon. Eine von Claude erstellte Übersetzung trägt ein eigenes, neues Wasserzeichen. Bei Dateimetadaten können Formatkonvertierungen, erneutes Speichern und Screenshots die C2PA-Signatur entfernen.²⁰⁴ Eine API zur Erkennung ist geplant. Ein positives Ergebnis belegt, dass „Claude wahrscheinlich irgendwann an den Inhalten beteiligt war“, kann aber ausdrücklich nicht zwischen „Claude hat dies geschrieben“ und „Claude hat dies stark überarbeitet“ unterscheiden. Laut Supportseite beweist auch eine fehlende Kennzeichnung nichts. Eine Möglichkeit zur Deaktivierung wird für keine Kundenstufe erwähnt.²⁵²²⁰⁴

Was kostet Claude Code?

Für eine nachhaltige Nutzung von Claude Code müssen Sie die Kosten verstehen und kontrollieren. Informationen zu den Modellfunktionen finden Sie auch unter Modellauswahl, Entscheidungshilfen zur Wahl des richtigen 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 in /cost eine Aufschlüsselung nach Modell und Cache-Treffern. Diese zeigt genau, welche Modelle Tokens verbraucht haben und welcher Anteil aus dem Cache bereitgestellt wurde (v2.1.92+).¹³⁷

Vertraglich vereinbarte Tarife statt Listenpreisen (modelPricing, verwaltet, v2.1.243+): Organisationen mit ausgehandelten modellspezifischen Tarifen oder einem Rabattmultiplikator können diese über die verwaltete Einstellung modelPricing bereitstellen. /cost, die Statuszeile und die Kostenangaben in der Telemetrie verwenden dann diese Tarife statt der Listenpreise, sodass die angezeigten Beträge den tatsächlichen Kosten der Organisation entsprechen.²⁵⁰ Seit v2.1.271 kann der Multiplikator auch über 1 liegen – bis zu 10 –, falls eine Organisation ihren internen Teams Aufschläge berechnet.²¹⁶

Sitzungsbezogene Prompt-Cache-Zeile (v2.1.251+): /cost ergänzt für die Sitzung eine Prompt-Cache-Zeile mit Trefferquote, Fehlschlägen, erneut zwischengespeicherten Tokens und dem Status des Caches als warm oder kalt. Für Statuszeilenskripte steht ein entsprechendes prompt_cache-Objekt bereit. Das Objekt erscheint nach der ersten Antwort von API in der Hauptkonversation, berücksichtigt keine Anfragen von subagents und wird anhand der Cache-Tokenzahlen in den Antworten von API berechnet. Deshalb funktioniert es mit jedem Anbieter. /usage zeigt dieselben Statistiken in der Zeile Prompt cache (main) an.²⁰⁶²⁰⁹ Seit v2.1.260 nennen die /cost-Zeile und das prompt_cache-Objekt der Statuszeile außerdem eine wahrscheinliche Ursache für Cache-Fehlschläge – beispielsweise geänderte Tooldefinitionen oder System-Prompts oder eine Sitzung, die länger als die Cache-TTL inaktiv war.²¹²

Agent-Datenverkehr unterbricht nicht mehr sein eigenes Cache-Präfix (v2.1.265): Zwei Korrekturen schließen Prompt-Cache-Lecks bei delegierten Aufgaben. Beim Fortsetzen eines im Vordergrund gestarteten subagent ändern sich dessen Toolliste und System-Prompt-Präfix nicht mehr. Außerdem verschieben Agent-Teammitglieder und fortgesetzte subagents den Hook-Kontext von SubagentStart und vorab geladene skills in späteren Durchläufen nicht mehr aus dem Prompt-Präfix. Beide Fehler verhinderten die Wiederverwendung des Prompt-Caches: Das Präfix änderte sich, sodass alle nachfolgenden Inhalte erneut als nicht zwischengespeicherte Eingabe gesendet wurden – und zwar genau in den langen agentischen Sitzungen, in denen die Cache-Wirtschaftlichkeit am wichtigsten ist. Dies entspricht demselben Fehlermuster, das v2.1.260 für Tool-Aufrufdurchläufe von Fable 5.1 behoben hat.²¹⁵

Das Cache-Stabilitätspaket von v2.1.267: Eine Version, etwa zehn Korrekturen und immer dasselbe Fehlermuster: Etwas schrieb das Prompt-Präfix mitten in der Konversation neu, woraufhin alle nachfolgenden Inhalte erneut als nicht zwischengespeicherte Eingabe gesendet wurden. Fortgesetzte Sitzungen schreiben Toollisten nicht mehr neu, rendern Toolbeschreibungen nicht erneut und schreiben frühere Tool-Ankündigungen von MCP nicht mehr um, bevor deren Connectors die Verbindung wiederherstellen. Beim Modellwechsel mit /model werden nicht mehr alle Tooldefinitionen erneut gesendet; Angaben zur Zuordnung von Commits und PRs werden nun als Konversationsnotiz übermittelt, die bei Modellwechseln aktualisiert wird. subagents und Sitzungen, die mit --system-prompt oder --append-system-prompt gestartet wurden, zeichnen den System-Prompt und die Tooldefinitionen einmalig auf. Außerdem erreichen während einer Sitzung hinzukommende Tools von MCP und plugins Sitzungen ohne ToolSearch als verzögert geladene Definitionen statt in Form einer neu geschriebenen Toolliste. Das Paket erweitert die Korrekturen aus v2.1.260 und v2.1.265 auf die Bereiche Sitzungsfortsetzung, Modellwechsel und erneute Verbindungen von MCP.²¹⁶

v2.1.273 hält den Gesprächsverlauf aufrecht: /login, /upgrade und /extra-usage verwarfen frühere Gedankengänge aus der Konversation, wodurch bei der nächsten Anfrage der Prompt-Cache vollständig neu geschrieben werden musste.²¹⁷

v2.1.277 schließt drei weitere Präfix-Lecks: Bei Sitzungen, die nach /clear fortgesetzt wurden – durch Neustart, --continue oder --resume –, fehlte ein Teil der ersten Nachricht, wenn ein SessionStart-Hook eine Ausgabe erzeugte. Dies verursachte einen vollständigen Prompt-Cache-Fehlschlag. Fortgesetzte subagents und Teammitglieder renderten die geladenen Tooldefinitionen von MCP erneut, wodurch das Prompt-Caching für den betreffenden Agenten unterbrochen wurde. Außerdem wurden zuvor in einer Konversation aufgezeichnete Anhänge nach einer Fortsetzung oder einem Neustart erneut gerendert, wodurch erweitertes Denken verworfen und der Prompt-Cache verfehlt wurde. Es handelt sich um dasselbe Fehlermuster wie bei den Korrekturpaketen v2.1.265–267: Etwas schrieb das Präfix neu, woraufhin alle nachfolgenden Inhalte erneut ohne Cache gesendet wurden. Nun werden auch SessionStart-Ausgaben, MCP-Definitionen fortgesetzter Agenten und aufgezeichnete Anhänge abgedeckt.²¹⁹

v2.1.280 ergänzt zwei weitere Korrekturen: Ein Modellwechsel aus einer Host-App heraus (Claude Desktop, VS Code oder SDK), während Claude arbeitet, verursacht beim nächsten Prompt keinen Prompt-Cache-Fehlschlag mehr. Ein fortgesetzter Fork-subagent sendet nun außerdem erneut die ursprünglich verwendete Toolliste, statt sie neu aufzubauen, was zuvor das Prompt-Caching für diesen Agenten unterbrochen hatte.²²⁰

v2.1.281 ergänzt drei weitere Korrekturen: Wird eine Sitzung nach einem Neustart fortgesetzt, während eine Berechtigungsabfrage aussteht, sendet sie keinen anderen Verlauf mehr als zuvor, was ab diesem Punkt den Prompt-Cache unterbrochen hatte. Ein MCP-Server, der während einer Konversation die Verbindung trennt oder nach dem Fortsetzen noch eine Verbindung aufbaut, beeinträchtigt den Cache bei deaktivierter Toolsuche nicht mehr – etwa hinter einem Proxy oder Gateway. Außerdem senden fortgesetzte Sitzungen frühere Durchläufe nicht mehr in veränderter Form erneut, was dazu führen konnte, dass API die bisherigen Gedankengänge der Konversation verwarf.²²⁴

Abonnementmodelle

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 Standardtarifen von API erwerben.¹⁴

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

Wöchentliche Begrenzungen ab dem 14. September 2026 (angekündigt am 29. August): Die vorübergehende Erhöhung der wöchentlichen Begrenzung um 50 %, die seit der Anhebung im Mai gilt, endet am 14. September. An ihre Stelle tritt für Pro-, Max-, Team- und sitzplatzbasierte Enterprise-Tarife eine dauerhafte Erhöhung um 25 % gegenüber dem Ausgangswert vor der Anhebung. Anthropic rechnet die Änderung selbst folgendermaßen vor: „Im Vergleich zu heute entspricht dies einer Verringerung der wöchentlichen Begrenzungen für Claude Code um 17 %.“ Liegt Ihre wöchentliche Obergrenze heute bei 150 Einheiten, beträgt sie ab dem 14. September 125. Die Fünf-Stunden-Begrenzungen sind nicht Teil dieser Ankündigung; die Verdopplung vom Mai bleibt bestehen. Wenn Sie lange unbeaufsichtigte Sitzungen ausführen, sollten Sie jetzt mit der niedrigeren Obergrenze planen: Entscheidend sind dafür der Schalter zur automatischen Fortsetzung nach dem Zurücksetzen (v2.1.234) und /usage.²¹³

Token-Preise für API (Oktober 2026)^1144222239

Für Benutzer mit Abrechnung über API gelten folgende Preise pro Million Tokens:

Preise für 1M Kontext (April 2026): Opus 4.7, Opus 4.6, Sonnet 4.6 und Mythos Preview bieten alle 1M zu den standardmäßigen Preisen pro MTok – ohne Langkontextaufschlag.¹⁴⁸ Diese Vereinheitlichung erfolgte erst kürzlich; ältere Angaben, nach denen bei Opus 4.6 oder Sonnet 4.6 oberhalb von 200K Eingabetokens der 2-fache Eingabe- und 1,5-fache Ausgabepreis anfiel, sind nicht mehr aktuell. Für das veraltete Opus 4.5 und frühere Modelle gelten weiterhin die ursprünglichen Preisstrukturen.

Preise für Datenresidenz: Wenn Sie mit inference_geo eine ausschließlich in den USA ausgeführte Inferenz festlegen, wird auf sämtliche Token-Preise einschließlich Cache-Lese- und -Schreibvorgängen ein Multiplikator von 1,1x angewendet (Modelle ab Opus 4.6).¹⁴⁸

Prompt-Caching senkt die Kosten wiederholter Eingaben erheblich: Cache-Schreibvorgänge kosten das 1,25-Fache des Grundpreises bei einem 5-Minuten-Cache beziehungsweise das 2-Fache bei einem 1-Stunden-Cache. Cache-Lesevorgänge kosten dagegen nur das 0,1-Fache, was einer Ersparnis von 90 % entspricht. Zwei Ausnahmen liegen noch darunter: Lesevorgänge bei Claude Opus 5.5 kosten das 0,05-Fache ($0.20/MTok, 95 % Ersparnis), bei Claude Fable 5.1 und Mythos 5.1 das 0,025-Fache ($0.25/MTok bei Fable 5.1, 97,5 % Ersparnis).²⁴¹²²² Bei RAG-Systemen und Code-Assistenten mit wiederholt verwendetem Kontext kann Caching die Kosten um 88–95 % senken.

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

Richtlinie für mehrere Konten⁵²

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

Zulässig sind:

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

Unzulässig sind (gemäß der Nutzungsrichtlinie): - Das Erstellen von Konten, um nach einer Sperrung weitere Sperren zu umgehen - Das Koordinieren böswilliger Aktivitäten über mehrere Konten hinweg, um einer Erkennung zu entgehen - Die Nutzung mehrerer Konten, um Ratenbegrenzungen oder Guthaben der kostenlosen Stufe 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 Mitarbeiter Thariq (@trq212) von Anthropic hob die Sperre innerhalb von 4 Stunden auf, nachdem er die berechtigte Nutzung bestätigt hatte. Wenn Sie Claude Code intensiv für berufliche und private Projekte ü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 Support von Anthropic, um Ihre konkrete Konfiguration schriftlich bestätigen zu lassen.

Kostenfaktoren

Kostenbeispiele aus der Praxis

Kosten zu Listenpreisen ($0.10/$0.50 für Haiku 5.5 bei Prompts mit bis zu 100K Tokens, $2/$10 für Sonnet 5.5 und $4/$20 für Opus 5.5 pro MTok), vor Rabatten durch Prompt-Caching.

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

Teamkosten verwalten

Empfohlene TPM/RPM nach Teamgröße:

Versteckte Toolgebühren

Zusätzlich zu den tokenbasierten Preisen fallen für einige Tools separate Gebühren an:⁹

In Agentenschleifen summieren sich diese Kosten. Ein Debugging-Zyklus mit 100 Iterationen und Bash verursacht allein durch den Zusatzaufwand etwa 24.500 zusätzliche Eingabetokens.

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, prüfen Sie jedoch, ob es nicht deaktiviert wurde
3. Begrenzen Sie die maximale Anzahl von Durchläufen: claude --max-turns 5 verhindert außer Kontrolle geratene 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 die Obergrenze auch für im Hintergrund ausgeführte subagents: Sobald sie erreicht ist, werden neue Starts abgelehnt und laufende Hintergrundagenten angehalten. Zuvor waren Hintergrundagenten von der Begrenzung ausgenommen¹⁹⁴
5. Verwenden Sie den Planungsmodus für explorative Aufgaben: Keine Ausführung = keine versehentlich ausgelösten kostspieligen Vorgänge
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 Aufgaben: 50 % Rabatt auf Eingabe- und Ausgabetokens
9. Analysieren Sie die API-Ausgaben eines Projekts für Claude: /claude-api cost-optimize (v2.1.247+) analysiert die bisherigen API-Ausgaben eines Projekts für Claude und arbeitet die Kostenhebel – Caching, Token-Hygiene, Batch, Aufwand und Modellauswahl – schrittweise anhand messbarer Änderungen ab. Dies gilt für die Apps, die Sie mit API erstellen, nicht für die Claude Code-Sitzung selbst²⁴⁵

Nutzung überwachen

• Claude Console: platform.claude.com (erfordert die Rolle Admin oder Billing)
• Arbeitsbereichsbegrenzungen: Legen Sie Ausgabenbegrenzungen pro Arbeitsbereich fest
• Bedrock/Vertex: Verwenden Sie die native Kostenüberwachung des jeweiligen Cloud-Anbieters
• LiteLLM: Für eine detaillierte benutzerspezifische Erfassung bei Drittanbietern

Token-Nutzung im Hintergrund

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

In der Regel weniger als $0.04 pro Sitzung.

Claude Code Analytics-API (Team/Enterprise)⁴⁶

Greifen Sie über Admin-API programmgesteuert auf Nutzungsanalysen und Produktivitätskennzahlen Ihrer Organisation für Claude Code zu.

Endpunkt: GET /v1/organizations/usage_report/claude_code

Voraussetzungen: - Admin-API-Schlüssel (sk-ant-admin...) - Team- oder Enterprise-Tarif - 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 Toolnutzung (Annahme-/Ablehnungsquoten 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. Aus Konsistenzgründen enthalten Antworten nur Daten, die älter als 1 Stunde sind.

Entscheidungsrahmen

Es reicht nicht, die Funktionen zu kennen. Sie müssen auch 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 5.5 (medium effort default; /effort high or xhigh for harder)
                  │         Cost: ~$1.60/task
                  │         Quality: Highest (1M context at standard price, adaptive reasoning)
                  │
                  └── NO → Use Sonnet
                           Cost: ~$0.50/task
                           Balance: Best overall when cost matters

Faustregel: Seit v2.1.280 richtet sich die Standardeinstellung nicht mehr nach Ihrem Plan – jede Sitzung beginnt mit Opus 5.5, ausgenommen Microsoft Foundry. Damit gilt nun das Gegenteil der früheren Strategie „auf Opus hochstufen“: Mit /model sonnet schalten Sie herunter und halbieren den Tokenpreis, wenn eine Aufgabe diese Denkleistung nicht erfordert.^{181197207220221} Verwenden Sie Haiku für subagents. Bleiben Sie bei Opus, wenn eine nach dem Herunterschalten erzeugte Antwort oberflächlich wirkt. Mit agent teams (ab 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 sollten Sie Extended Thinking verwenden?

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

Schalten Sie es während der Sitzung mit Alt+T um. Höhere Denkbudgets kosten mehr; beginnen Sie mit dem Minimum und erhöhen Sie es nur, wenn die Antworten übereilt wirken.

Adaptives Denken von Opus 4.6: Opus 4.6 passt die Denktiefe automatisch an die Komplexität des Problems an. Bei den meisten Aufgaben ist eine ausdrückliche Steuerung des Denkbudgets nicht erforderlich – Opus erhöht es bei schwierigen Problemen und bleibt bei einfachen Aufgaben schnell. Das manuelle Umschalten des Denkmodus ist vor allem bei Sonnet sinnvoll, wenn Sie eine gründlichere 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