SpyBara
Go Premium

env-vars.md 2026-10-04 23:58 UTC to 2026-10-05 13:59 UTC

This page contains 307 additions and 307 deletions.

2026
Thu 1 23:59 Fri 2 22:59 Sat 3 23:57 Sun 4 23:58 Mon 5 14:57

Umgebungsvariablen

Referenz für Umgebungsvariablen, die das Verhalten von Claude Code steuern.

Umgebungsvariablen können das Verhalten von Claude Code steuern, z. B. Modellauswahl, Authentifizierung, Anfragerouting und Funktionsschalter. Viele der gleichen Verhaltensweisen können auch über ein Einstellungsfeld, ein CLI-Flag oder einen In-Session-Befehl wie /model konfiguriert werden.

Diese Seite behandelt folgende Themen:

Umgebungsvariablen festlegen

Eine Variable, die Sie in Ihrer Shell festlegen, gilt für diese Terminalsitzung, während eine Variable in einer Einstellungsdatei jedes Mal gilt, wenn claude ausgeführt wird.

In Ihrer Shell

Legen Sie die Variable vor dem Starten von claude fest:

export API_TIMEOUT_MS="1200000"
claude

Um sie für jede Sitzung festzulegen, fügen Sie die export-Zeile zu ~/.bashrc, ~/.zshrc oder der Profildatei Ihrer Shell hinzu.

Die Zuweisungszeile gibt bei erfolgreicher Ausführung nichts aus. Um zu bestätigen, dass die Variable festgelegt ist, geben Sie sie in derselben Shell aus:

echo $API_TIMEOUT_MS

In Einstellungsdateien

Fügen Sie Variablen unter dem Schlüssel env in einer settings.json-Datei hinzu und erstellen Sie die Datei, falls sie nicht vorhanden ist. Claude Code liest sie direkt aus der Datei, sodass sie wirksam werden, unabhängig davon, wie claude gestartet wurde. Eine laufende Sitzung wendet neue und geänderte Werte auf ihre Umgebung an, wenn Sie die Datei speichern. Ein Feature, das seine Variablen einmalig beim Start liest, wie z. B. OpenTelemetry-Überwachung, behält seine Startwerte bei, bis Sie neu starten. Das Entfernen einer Variable aus der Datei hebt sie in einer laufenden Sitzung nicht auf. Die Entfernung wird wirksam, wenn Sie claude das nächste Mal starten.

{
  "env": {
    "API_TIMEOUT_MS": "1200000",
    "BASH_DEFAULT_TIMEOUT_MS": "300000"
  }
}

Die Datei, die Sie wählen, bestimmt, für wen die Variablen gelten:

Datei Gilt für
~/.claude/settings.json Sie, in jedem Projekt
.claude/settings.json Alle, die im Projekt arbeiten, eingecheckt in die Versionskontrolle
.claude/settings.local.json Sie, nur in diesem Projekt, gitignored, wenn Claude Code eine Einstellung darin speichert; fügen Sie es zu Ihrer gitignore hinzu, wenn Sie es manuell erstellen
Verwaltete Einstellungen Alle in Ihrer Organisation, bereitgestellt von einem Administrator

Siehe Einstellungsdateien für den Speicherort jeder Datei und Einstellungspriorität für die Kombination, wenn mehr als eine dieselbe Variable festlegt.

Vorrang

Einige Verhaltensweisen haben sowohl eine Umgebungsvariable als auch einen dedizierten Einstellungsschlüssel, und welche Claude Code zuerst liest, unterscheidet sich je nach Schlüssel. Für ANTHROPIC_MODEL und CLAUDE_CODE_AUTO_CONNECT_IDE liest Claude Code zuerst die Variable und verwendet die Einstellung model oder autoConnectIde nur, wenn die Variable nicht gesetzt ist. Für das Paar, das Sie einstellen, überprüfen Sie die Zeile der Variable unten und den Eintrag des Schlüssels in der Einstellungsreferenz.

Wenn dieselbe Variable sowohl in Ihrer Shell als auch in einem Einstellungsdatei-env-Block gesetzt ist, gilt der Wert der Einstellungsdatei in den meisten Sitzungen. Claude Code schreibt jeden env-Eintrag in die Prozessumgebung und ersetzt den Wert, der von der Shell geerbt wird. Wie env-Werte mit Ihrer Shell interagieren behandelt die Sitzungen, die stattdessen den geerbten Wert behalten, und die env-Einstellung gibt an, wann sie angewendet werden. Einige Variablen sind Sonderfälle; die env-Einstellung listet die Ausnahmen auf.

In einer Einstellungsdatei können Sie eine Variable setzen, aber Sie können sie nicht entfernen. Um eine Variable zu überschreiben, die Sie nicht aufheben können, z. B. eine veraltete CLAUDE_CODE_USE_VERTEX, die von einem Shell-Profil exportiert wird, das Sie nicht kontrollieren, setzen Sie sie im env-Block auf eine leere Zeichenkette: "CLAUDE_CODE_USE_VERTEX": "". Claude Code behandelt den leeren Wert als nicht gesetzt für die Anbieterauswahl. Unterprozesse erben weiterhin den leeren Wert.

Zwischen Einstellungsdateien folgen env-Werte dem Einstellungsvorrang, sodass ein verwalteter Einstellungseintrag dieselbe Variable in Benutzer- oder Projekteinstellungen überschreibt. Projekt- und lokale Einstellungen können einige Variablen nicht setzen, z. B. CLAUDE_CONFIG_DIR und die OpenTelemetry-Exporter-Variablen. Variablen, die Claude Code in env ignoriert listet sie auf, zusammen mit den OpenTelemetry-Ausschaltungswerten, die weiterhin gelten.

Wie eine Umgebungsvariable mit CLI-Flags und In-Session-Befehlen interagiert, variiert je nach Funktion: --model und /model überschreiben ANTHROPIC_MODEL, während CLAUDE_CODE_EFFORT_LEVEL --effort und /effort überschreibt. Wenn eine Variable mit einer anderen Konfigurationsquelle interagiert, gibt ihre Zeile in der Liste Variablen den Vorrang an oder verlinkt auf die Seite, die ihn dokumentiert.

Claude Code liest Shell-Umgebungsvariablen beim Start, sodass Änderungen daran beim nächsten Start von claude wirksam werden. Variablen, die unter dem env-Schlüssel in Einstellungsdateien gesetzt sind, werden erneut auf eine laufende Sitzung angewendet, wenn sich die Datei ändert, mit der Ausnahme beim Start, die in In Einstellungsdateien beschrieben ist.

Variablen

Numerische Variablen wie Timeouts, Token-Budgets und Anzahlen von Wiederholungsversuchen akzeptieren neben einfachen Ziffern auch wissenschaftliche Notation und Schreibweisen mit Zifferntrennzeichen, außer wenn die Zeile einer Variablen vermerkt, dass sie nur einfache Ziffern annimmt. Beispielsweise liest Claude Code 2e3 als 2000 und 64_000 als 64000. Vor v2.1.211 konnten diese Schreibweisen stillschweigend einen viel kleineren Wert setzen, etwa setzte 1e6 einen Timeout auf 1.

Variable Zweck
ANTHROPIC_API_KEY API-Schlüssel, der als X-Api-Key-Header gesendet wird. Wenn er gesetzt ist, wird dieser Schlüssel anstelle Ihres Claude Pro-, Max-, Team- oder Enterprise-Abonnements verwendet, selbst wenn Sie angemeldet sind. Im nicht interaktiven Modus (-p) wird der Schlüssel immer verwendet, wenn er vorhanden ist. Im interaktiven Modus werden Sie einmalig aufgefordert, den Schlüssel zu genehmigen, bevor er Ihr Abonnement überschreibt. Um stattdessen Ihr Abonnement zu verwenden, führen Sie unset ANTHROPIC_API_KEY aus
ANTHROPIC_AUTH_TOKEN Benutzerdefinierter Wert für den Authorization-Header (dem hier gesetzten Wert wird Bearer vorangestellt)
ANTHROPIC_AWS_API_KEY Workspace-API-Schlüssel für Claude Platform on AWS, der in der AWS Console erzeugt wird. Wird als x-api-key gesendet und hat Vorrang vor AWS SigV4
ANTHROPIC_AWS_BASE_URL Überschreibt die Endpunkt-URL von Claude Platform on AWS. Verwenden Sie dies für benutzerdefinierte Regionen oder beim Routing über ein LLM-Gateway. Standardwert ist https://aws-external-anthropic.{region}.api.aws. Claude Code ermittelt die Region mit der gleichen Rangfolge wie bei Amazon Bedrock
ANTHROPIC_AWS_WORKSPACE_ID Erforderlich für Claude Platform on AWS. Wird bei jeder Anfrage als anthropic-workspace-id-Header gesendet
ANTHROPIC_BASE_URL Überschreibt den API-Endpunkt, um Anfragen über einen Proxy oder ein Gateway zu leiten. Wenn ein Host gesetzt ist, der kein First-Party-Host ist, ist MCP Tool Search standardmäßig deaktiviert. Setzen Sie ENABLE_TOOL_SEARCH=true, wenn Ihr Proxy tool_reference-Blöcke weiterleitet. Ab v2.1.196 ist Remote Control deaktiviert, wenn dieser Wert auf einen anderen Host als api.anthropic.com verweist, entsprechend dem Verhalten bei Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry
ANTHROPIC_BEDROCK_BASE_URL Überschreibt die Amazon-Bedrock-Endpunkt-URL. Verwenden Sie dies für benutzerdefinierte Amazon-Bedrock-Endpunkte oder beim Routing über ein LLM-Gateway. Siehe Amazon Bedrock
ANTHROPIC_BEDROCK_MANTLE_BASE_URL Überschreibt die Endpunkt-URL von Amazon Bedrock Mantle. Siehe Mantle-Endpunkt
ANTHROPIC_BEDROCK_REGION_PREFIX Präfix des regionsübergreifenden Inferenzprofils (us, eu, apac, jp, au oder global), das Claude Code zuerst versucht, statt des aus der AWS-Region abgeleiteten Präfixes. Wird in AWS-GovCloud-Regionen ignoriert. Erfordert Claude Code v2.1.224 oder höher. Siehe Amazon Bedrock
ANTHROPIC_BEDROCK_SERVICE_TIER Amazon-Bedrock-Service-Tier (default, flex oder priority). Wird als X-Amzn-Bedrock-Service-Tier-Header gesendet. Siehe Amazon Bedrock
ANTHROPIC_BETAS Kommagetrennte Liste zusätzlicher anthropic-beta-Header-Werte, die in API-Anfragen aufgenommen werden. Claude Code sendet die benötigten Beta-Header bereits; verwenden Sie dies, um eine Anthropic-API-Beta zu nutzen, bevor Claude Code native Unterstützung dafür hinzufügt. Anders als das --betas-Flag, das eine Authentifizierung per API-Schlüssel erfordert, funktioniert diese Variable mit allen Authentifizierungsmethoden einschließlich eines Claude.ai-Abonnements
ANTHROPIC_CUSTOM_HEADERS Benutzerdefinierte Header, die Anfragen hinzugefügt werden (Format Name: Value, bei mehreren Headern durch Zeilenumbrüche getrennt). Wenn ein Name oder Wert ein Zeichen enthält, das ein HTTP-Header nicht übertragen kann, etwa ein typografisches Anführungszeichen oder ein Leerzeichen mit der Breite null, schlägt die Anfrage mit einem Fehler fehl, der das Paar anhand seiner Position benennt. Erfordert Claude Code v2.1.227 oder höher. Invalid request header value listet den genauen Zeichensatz auf und gibt an, wo die Prüfung ausgeführt wird. Ein Wert, der einen Header für Anmeldedaten, Organisation oder Mandant, Routing oder API-Verhalten setzt, etwa Authorization oder Host, gilt als Einstellung, die eine Genehmigung erfordert, wenn serververwaltete Einstellungen ihn liefern. Aus Projekt- oder lokalen Einstellungen folgt ein solcher Wert den Regeln dafür, wann env-Werte gelten
ANTHROPIC_CUSTOM_MODEL_OPTION Modell-ID, die als benutzerdefinierter Eintrag in der /model-Auswahl hinzugefügt wird. Verwenden Sie dies, um ein nicht standardmäßiges oder gateway-spezifisches Modell auswählbar zu machen, ohne integrierte Aliasse zu ersetzen. Siehe Modellkonfiguration
ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION Angezeigte Beschreibung für den benutzerdefinierten Modelleintrag in der /model-Auswahl. Standardmäßig Custom model (<model-id>), wenn nicht gesetzt
ANTHROPIC_CUSTOM_MODEL_OPTION_NAME Angezeigter Name für den benutzerdefinierten Modelleintrag in der /model-Auswahl. Wenn nicht gesetzt, zeigt der Eintrag den Namen des Modells, falls Claude Code die ID erkennt, andernfalls die Modell-ID
ANTHROPIC_CUSTOM_MODEL_OPTION_SUPPORTED_CAPABILITIES Kommagetrennte Liste der Fähigkeiten, die das benutzerdefinierte Modell unterstützt, zum Beispiel effort,thinking. Siehe Modellkonfiguration
ANTHROPIC_DEFAULT_FABLE_MODEL Modell-ID, auf die der Alias fable aufgelöst wird, und die ID, die Claude Code bei Drittanbietern als Fable-Modell für den automatischen Modell-Fallback erkennt. Siehe Modellkonfiguration
ANTHROPIC_DEFAULT_FABLE_MODEL_DESCRIPTION Angezeigte Beschreibung für das festgelegte Fable-Modell in der /model-Auswahl. Wenn nicht gesetzt, zeigt die Zeile eine Standardbeschreibung, die mit Custom Fable model beginnt. Siehe Modellkonfiguration
ANTHROPIC_DEFAULT_FABLE_MODEL_NAME Angezeigter Name für das festgelegte Fable-Modell in der /model-Auswahl. Wenn nicht gesetzt, zeigt die Zeile den Namen des Modells, falls Claude Code die festgelegte ID erkennt, andernfalls die festgelegte ID. Siehe Modellkonfiguration
ANTHROPIC_DEFAULT_FABLE_MODEL_SUPPORTED_CAPABILITIES Kommagetrennte Liste der Fähigkeiten, die das festgelegte Fable-Modell unterstützt, zum Beispiel effort,thinking. Siehe Modellkonfiguration
ANTHROPIC_DEFAULT_HAIKU_MODEL Modell-ID, auf die der Alias haiku aufgelöst wird; wird auch für Hintergrundfunktionen verwendet. Siehe Modellkonfiguration
ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTION Angezeigte Beschreibung für das festgelegte Haiku-Modell in der /model-Auswahl. Wenn nicht gesetzt, zeigt die Zeile eine Standardbeschreibung, die mit Custom Haiku model beginnt. Siehe Modellkonfiguration
ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME Angezeigter Name für das festgelegte Haiku-Modell in der /model-Auswahl. Wenn nicht gesetzt, zeigt die Zeile den Namen des Modells, falls Claude Code die festgelegte ID erkennt, andernfalls die festgelegte ID. Siehe Modellkonfiguration
ANTHROPIC_DEFAULT_HAIKU_MODEL_SUPPORTED_CAPABILITIES Kommagetrennte Liste der Fähigkeiten, die das festgelegte Haiku-Modell unterstützt, zum Beispiel effort,thinking. Siehe Modellkonfiguration
ANTHROPIC_DEFAULT_MODEL Modell, mit dem neue Sitzungen standardmäßig starten. Erfordert Claude Code v2.1.236 oder höher. Siehe Standardmodell für neue Sitzungen festlegen
ANTHROPIC_DEFAULT_OPUS_MODEL Modell-ID, auf die der Alias opus aufgelöst wird und die opusplan verwendet, während der Plan-Modus aktiv ist. Siehe Modellkonfiguration
ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION Angezeigte Beschreibung für das festgelegte Opus-Modell in der /model-Auswahl. Wenn nicht gesetzt, zeigt die Zeile eine Standardbeschreibung, die mit Custom Opus model beginnt. Siehe Modellkonfiguration
ANTHROPIC_DEFAULT_OPUS_MODEL_NAME Angezeigter Name für das festgelegte Opus-Modell in der /model-Auswahl. Wenn nicht gesetzt, zeigt die Zeile den Namen des Modells, falls Claude Code die festgelegte ID erkennt, andernfalls die festgelegte ID. Siehe Modellkonfiguration
ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES Kommagetrennte Liste der Fähigkeiten, die das festgelegte Opus-Modell unterstützt, zum Beispiel effort,thinking. Siehe Modellkonfiguration
ANTHROPIC_DEFAULT_SONNET_MODEL Modell-ID, auf die der Alias sonnet aufgelöst wird und die opusplan verwendet, wenn der Plan-Modus nicht aktiv ist. Siehe Modellkonfiguration
ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTION Angezeigte Beschreibung für das festgelegte Sonnet-Modell in der /model-Auswahl. Wenn nicht gesetzt, zeigt die Zeile eine Standardbeschreibung, die mit Custom Sonnet model beginnt. Siehe Modellkonfiguration
ANTHROPIC_DEFAULT_SONNET_MODEL_NAME Angezeigter Name für das festgelegte Sonnet-Modell in der /model-Auswahl. Wenn nicht gesetzt, zeigt die Zeile den Namen des Modells, falls Claude Code die festgelegte ID erkennt, andernfalls die festgelegte ID. Siehe Modellkonfiguration
ANTHROPIC_DEFAULT_SONNET_MODEL_SUPPORTED_CAPABILITIES Kommagetrennte Liste der Fähigkeiten, die das festgelegte Sonnet-Modell unterstützt, zum Beispiel effort,thinking. Siehe Modellkonfiguration
ANTHROPIC_FEDERATION_RULE_ID ID der Föderationsregel für Workload Identity Federation. Wenn Sie sie zusammen mit ANTHROPIC_ORGANIZATION_ID setzen, wählt Claude Code Föderations-Anmeldedaten aus, die Vorrang vor Ihren /login-Anmeldedaten haben. Siehe Rangfolge der Authentifizierung
ANTHROPIC_FOUNDRY_API_KEY API-Schlüssel für die Authentifizierung bei Microsoft Foundry (siehe Microsoft Foundry)
ANTHROPIC_FOUNDRY_AUTH_TOKEN Bearer-Token für die Authentifizierung bei Microsoft Foundry, etwa ein Microsoft-Entra-Zugriffstoken. Claude Code sendet es als Authorization: Bearer-Header. Hat Vorrang vor ANTHROPIC_FOUNDRY_API_KEY und vor der Azure-Standardkette für Anmeldedaten. Siehe Microsoft Foundry. Erfordert Claude Code v2.1.203 oder höher
ANTHROPIC_FOUNDRY_BASE_URL Vollständige Basis-URL für die Microsoft-Foundry-Ressource (zum Beispiel https://my-resource.services.ai.azure.com/anthropic). Alternative zu ANTHROPIC_FOUNDRY_RESOURCE (siehe Microsoft Foundry)
ANTHROPIC_FOUNDRY_RESOURCE Name der Microsoft-Foundry-Ressource (zum Beispiel my-resource). Claude Code lehnt eine URL oder einen Hostnamen ab. Erforderlich, wenn ANTHROPIC_FOUNDRY_BASE_URL nicht gesetzt ist (siehe Microsoft Foundry)
ANTHROPIC_MODEL Name der zu verwendenden Modelleinstellung (siehe Modellkonfiguration)
ANTHROPIC_ORGANIZATION_ID Organisations-ID für Workload Identity Federation. Setzen Sie sie zusammen mit ANTHROPIC_FEDERATION_RULE_ID. Siehe Rangfolge der Authentifizierung
ANTHROPIC_PROFILE Name des Anthropic-Profils, mit dem die Authentifizierung erfolgt, etwa eines, das mit ant auth login oder durch Anmelden bei einem Console-Konto ohne API-Schlüssel erstellt wurde. Siehe Rangfolge der Authentifizierung
ANTHROPIC_SMALL_FAST_MODEL [VERALTET] Name des Modells der Haiku-Klasse für Hintergrundaufgaben
ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION Überschreibt die AWS-Region für das Modell der Haiku-Klasse bei Verwendung von Amazon Bedrock oder Amazon Bedrock Mantle. Bei Amazon Bedrock wirkt dies nur, wenn auch ANTHROPIC_DEFAULT_HAIKU_MODEL oder das veraltete ANTHROPIC_SMALL_FAST_MODEL gesetzt ist, da Amazon Bedrock Hintergrundaufgaben andernfalls auf dem Standard-Sonnet-Modell oder dem primären Modell in der Region der Sitzung ausführt
ANTHROPIC_VERTEX_BASE_URL Überschreibt die Endpunkt-URL von Google Cloud's Agent Platform. Verwenden Sie dies für benutzerdefinierte Endpunkte von Google Cloud's Agent Platform oder beim Routing über ein LLM-Gateway. Siehe Google Cloud's Agent Platform
ANTHROPIC_VERTEX_PROJECT_ID GCP-Projekt-ID, an die Anfragen an Google Cloud's Agent Platform adressiert werden. Siehe GCP-Anmeldedaten konfigurieren
ANTHROPIC_WORKSPACE_ID Workspace-ID für Workload Identity Federation. Setzen Sie sie, wenn Ihre Föderationsregel für mehr als einen Workspace gilt, damit der Token-Austausch weiß, welcher Workspace das Ziel ist
API_FORCE_IDLE_TIMEOUT Überschreibt den 5-minütigen Leerlauf-Timeout für den Body, der eine gestreamte Modellantwort abbricht, wenn keine Bytes eintreffen. Setzen Sie 0, um den Timeout auszuschalten, zum Beispiel wenn ein langsames Gateway oder ein lokales Modell zwischen Chunks länger als 5 Minuten pausiert, oder 1, um ihn für jeden Anbieter eingeschaltet zu lassen. Wenn nicht gesetzt, ist der Timeout bei allen Anbietern aktiv außer der direkten Anthropic API, Claude Platform on AWS und Amazon Bedrock mit gesetztem CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1. Die Stream-Watchdogs laufen unabhängig davon und brechen eine lange stille Pause auch dann ab, wenn Sie hier 0 setzen
API_TIMEOUT_MS Timeout für API-Anfragen in Millisekunden (Standard: 600000 bzw. 10 Minuten; Maximum: 2147483647). Erhöhen Sie diesen Wert, wenn Anfragen in langsamen Netzwerken oder beim Routing über einen Proxy in eine Zeitüberschreitung laufen. Werte über dem Maximum lassen den zugrunde liegenden Timer überlaufen und führen dazu, dass Anfragen sofort fehlschlagen
AWS_BEARER_TOKEN_BEDROCK Amazon-Bedrock-API-Schlüssel für die Authentifizierung (siehe Amazon-Bedrock-API-Schlüssel)
BASH_DEFAULT_TIMEOUT_MS Standard-Timeout für einen Befehl des Bash- oder PowerShell-Tools im Vordergrund, in Millisekunden (Standard: 120000 bzw. 2 Minuten). Ein Standardwert von mehr als 30 Minuten wird in unbeaufsichtigten Sitzungen außerdem zum Standard-Zeitlimit für Hintergrundbefehle. Das Zeitlimit für Hintergrundbefehle erfordert Claude Code v2.1.285 oder höher
BASH_MAX_OUTPUT_LENGTH Maximale Anzahl an Zeichen der Bash-Ausgabe, die Claude Code in das Ergebnis eines Befehls zurückliest (Standard: 30000; Maximum: 150000). Wenn Sie die Einstellung bashOutputMaxChars setzen, ignoriert Claude Code diese Variable. Siehe Ausgabelimits
BASH_MAX_TIMEOUT_MS Maximaler Timeout, den das Modell für einen Befehl des Bash- oder PowerShell-Tools im Vordergrund setzen kann, in Millisekunden (Standard: 600000 bzw. 10 Minuten). Die effektive Obergrenze ist der größere Wert aus diesem und BASH_DEFAULT_TIMEOUT_MS. Eine effektive Obergrenze von mehr als 2 Stunden wird in unbeaufsichtigten Sitzungen außerdem zum maximalen Zeitlimit für Hintergrundbefehle. Das Zeitlimit für Hintergrundbefehle erfordert Claude Code v2.1.285 oder höher
BETA_TRACING_ENDPOINT OTLP-Endpunkt für detailliertes Beta-Tracing: Mit ENABLE_BETA_TRACING_DETAILED=1 gehen Logs und Traces dorthin statt an die konfigurierten Exporter. Setzen Sie ihn in Ihrer Shell, in den Benutzereinstellungen oder in verwalteten Einstellungen. Wird in Projekt- und lokalen Einstellungen ignoriert
CCR_FORCE_BUNDLE Setzen Sie 1, um claude --cloud zu zwingen, Ihr lokales Repository zu bündeln und hochzuladen, statt es von seinem Remote zu klonen
CLAUDECODE Wird in Unterprozessen, die Claude Code startet (Bash- und PowerShell-Tools, tmux-Sitzungen, Hook-Befehle, Statuszeilen-Befehle, stdio-MCP-Server-Unterprozesse), auf 1 gesetzt. IDE-Erweiterungen setzen sie auch in ihren integrierten Terminals. Verwenden Sie sie, um zu erkennen, ob ein Skript in einem von Claude Code gestarteten Unterprozess läuft. Um zu prüfen, ob der aktuelle Prozess direkt durch einen Tool-Aufruf oder Hook gestartet wurde und nicht innerhalb eines von Claude Code gestarteten stdio-MCP-Servers, verwenden Sie stattdessen CLAUDE_CODE_CHILD_SESSION
CLAUDE_AFK_COUNTDOWN_MS Wie viele Millisekunden vor dem automatischen Fortfahren der Countdown auf dem Bildschirm bei einem unbeantworteten AskUserQuestion-Dialog erscheint. Standard 20000 (20 Sekunden), begrenzt auf den Timeout für das automatische Fortfahren. Hat keine Wirkung, solange das automatische Fortfahren nicht eingeschaltet ist; siehe die Einstellung askUserQuestionTimeout und CLAUDE_AFK_TIMEOUT_MS. Erfordert Claude Code v2.1.198 oder höher
CLAUDE_AFK_TIMEOUT_MS Wie viele Millisekunden Leerlauf vergehen, bevor ein unbeantworteter AskUserQuestion-Dialog ohne Sie automatisch fortfährt. Das automatische Fortfahren ist standardmäßig ausgeschaltet; aktivieren Sie es mit der Einstellung askUserQuestionTimeout. Diese Variable ist eine Überschreibung für Demos und automatisierte Tests: Wenn sie gesetzt ist, hat sie Vorrang vor dieser Einstellung und schaltet das automatische Fortfahren ein, selbst wenn die Einstellung nicht gesetzt ist oder never lautet. Das Setzen von 0 schaltet den Timeout nicht aus, sondern schließt den Dialog sofort. In v2.1.198 und v2.1.199 war das automatische Fortfahren standardmäßig mit einem Timeout von 60000 (60 Sekunden) eingeschaltet. Erfordert Claude Code v2.1.198 oder höher
CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS Setzen Sie 1, um alle integrierten Subagenten-Typen wie Explore und Plan zu deaktivieren. Gilt nur im nicht interaktiven Modus (das Flag -p). Nützlich für SDK-Benutzer, die bei null beginnen möchten. Dadurch wird auch general-purpose entfernt, der Subagent, den Claude Code ausführt, wenn ein Aufruf des Agent-Tools subagent_type auslässt. Ein solcher Aufruf schlägt dann mit subagent_type is required fehl
CLAUDE_AGENT_SDK_MCP_NO_PREFIX Setzen Sie 1, um das Präfix mcp__<server>__ bei Tool-Namen von per SDK erstellten MCP-Servern wegzulassen. Tools verwenden ihre ursprünglichen Namen. Nur für die SDK-Nutzung
CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS Stillstands-Timeout in Millisekunden für Subagenten. Standard 600000 (10 Minuten); wenn Sie CLAUDE_STREAM_IDLE_TIMEOUT_MS erhöhen, während der Stream-Watchdog eingeschaltet ist, steigt der Standardwert mit, wie unter Langsame oder stockende API-Antworten behandeln beschrieben. Der Timer wird bei jedem Streaming-Fortschrittsereignis zurückgesetzt; trifft innerhalb des Zeitfensters kein Fortschritt ein, bricht Claude Code den Subagenten ab und meldet den Stillstand an den übergeordneten Agenten
CLAUDE_AUTOCOMPACT_PCT_OVERRIDE Legt den Prozentsatz (1–100) des Fensters für die automatische Komprimierung fest, bei dem die automatische Komprimierung ausgelöst wird. Verwenden Sie niedrigere Werte wie 50, um früher zu komprimieren; die Variable kann den Schwellenwert nicht anheben, daher werden Werte über dem Standardprozentsatz ignoriert. Sie gilt nur in Sitzungen, die vor dem Kontextlimit des Modells komprimieren. Gilt sowohl für Hauptkonversationen als auch für Subagenten
CLAUDE_AUTO_BACKGROUND_TASKS Setzen Sie 1, um das automatische Verschieben lang laufender Agentenaufgaben in den Hintergrund zwangsweise zu aktivieren. Wenn aktiviert, werden Subagenten nach etwa zwei Minuten Laufzeit in den Hintergrund verschoben. Aktiviert außerdem das automatische Verschieben langer MCP-Tool-Aufrufe in den Hintergrund im nicht interaktiven Modus ab Claude Code v2.1.212
CLAUDE_AX_PREPARK_MS Im Screenreader-Modus, wie viele Millisekunden Claude Code wartet, bevor es eine neue oder geänderte Zeile schreibt. Standard 0, sodass Claude Code nicht wartet. Vor v2.1.287 war der Standardwert 50. Claude Code begrenzt die Wartezeit auf 5000. Erfordert Claude Code v2.1.233 oder höher
CLAUDE_AX_SCREEN_READER Setzen Sie 1, um eine screenreaderfreundliche Ausgabe zu rendern: flacher Text ohne dekorative Rahmen oder Animationen. Setzen Sie 0, um den Screenreader-Modus auch dann auszuschalten, wenn axScreenReader true ist. Das Flag --ax-screen-reader hat Vorrang. Erfordert Claude Code v2.1.181 oder höher
CLAUDE_AX_STARTUP_QUIET_MS Im Screenreader-Modus, wie viele Millisekunden Claude Code das erste Rendern der Oberfläche nach der Startbestätigungszeile zurückhält, damit Ihr Screenreader die Zeile vollständig vorlesen kann, bevor neue Ausgabe sie unterbricht. Standard 3000. Setzen Sie 0, um sofort zu rendern. Claude Code begrenzt die Verzögerung auf 600000 (10 Minuten). Ihr erster Tastendruck beendet die Verzögerung vorzeitig. Erfordert Claude Code v2.1.217 oder höher
CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR Nach jedem Bash- oder PowerShell-Befehl in der Hauptsitzung zum ursprünglichen Arbeitsverzeichnis zurückkehren
CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS Timeout in Millisekunden für den Leerlauf-Watchdog des Streamings auf Byte-Ebene; wenn gesetzt, hat er für diesen Watchdog Vorrang vor CLAUDE_STREAM_IDLE_TIMEOUT_MS und lässt den Watchdog auf Ereignisebene unverändert. Claude Code begrenzt diese Variable auf einen Wert zwischen 10 Sekunden und 30 Minuten. Erfordert Claude Code v2.1.210 oder höher
CLAUDE_CLIENT_PRESENCE_FILE Pfad zu einer Datei, die ein externes Tool, etwa ein Listener für die Bildschirmsperre, erstellt, wenn Sie Ihren Bildschirm entsperren, und löscht, wenn Sie ihn sperren. Solange die Datei existiert, überspringt Claude Code mobile Push-Benachrichtigungen von Remote Control, sodass Sie keine Pushes erhalten, während Sie den Computer aktiv nutzen. Wenn die Datei fehlt oder nicht lesbar ist, werden Benachrichtigungen wie gewohnt gesendet. Claude Code prüft die Datei einmal pro Push auslösendem Ereignis, statt sie regelmäßig abzufragen. Erfordert Claude Code v2.1.181 oder höher
CLAUDE_CODE_ACCESSIBILITY Setzen Sie 1, um den nativen Terminal-Cursor sichtbar zu lassen und die Cursoranzeige mit invertiertem Text zu deaktivieren. Ermöglicht Bildschirmlupen wie dem macOS-Zoom, die Cursorposition zu verfolgen
CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD Setzen Sie 1, um Memory-Dateien aus Verzeichnissen zu laden, die mit --add-dir angegeben wurden. Lädt CLAUDE.md, .claude/CLAUDE.md, .claude/rules/*.md und CLAUDE.local.md. Standardmäßig laden zusätzliche Verzeichnisse keine Memory-Dateien
CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT Setzen Sie 1, um beim Vollbild-Rendering bei jedem Frame den gesamten Bildschirm neu zu zeichnen, statt inkrementelle Aktualisierungen zu senden. Verwenden Sie dies, wenn der Vollbildmodus veraltete oder falsch platzierte Textfragmente zeigt. Claude Code aktiviert dies unter Windows automatisch für Hintergrundsitzungen und die Agentenansicht
CLAUDE_CODE_ALWAYS_ENABLE_EFFORT Setzen Sie 1, um den Effort-Parameter mit jeder Anfrage zu senden, auch wenn Claude Code die Modell-ID nicht als Effort-fähig erkennt. Verwenden Sie dies beim Routing über ein LLM-Gateway oder einen Drittanbieter, der Modelle unter benutzerdefinierten Bezeichnern bereitstellt. Modelle, die den Effort-Parameter auf API-Ebene ablehnen, darunter Claude-3-Modelle, Sonnet 4.0 und 4.5, Opus 4.0 und 4.1 sowie Haiku 4.5, bleiben weiterhin ausgenommen, damit Anfragen nicht fehlschlagen
CLAUDE_CODE_API_KEY_HELPER_TTL_MS Intervall in Millisekunden, in dem Anmeldedaten aktualisiert werden sollen (bei Verwendung von apiKeyHelper)
CLAUDE_CODE_ARTIFACT_AUTO_OPEN Setzen Sie 0, damit Claude Code den Browser nicht automatisch öffnet, wenn ein neues Artefakt veröffentlicht wird
CLAUDE_CODE_ARTIFACT_COMMENTS Setzen Sie 0, damit Claude Kommentare zu einem Artefakt nicht mehr liest und beantwortet. Hat keine Wirkung, wenn CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC Artefakte ausgeschaltet hat. Erfordert Claude Code v2.1.221 oder höher
CLAUDE_CODE_ARTIFACT_COMMENTS_AUTOREACT Setzen Sie 0, damit Claude an Claude gesendete Kommentare nicht mehr selbstständig beantwortet. Erfordert Claude Code v2.1.228 oder höher
CLAUDE_CODE_ATTRIBUTION_HEADER Setzen Sie 0, um den Attributionsblock, der die Client-Version und einen Prompt-Fingerabdruck enthält, am Anfang des System-Prompts wegzulassen. Das Caching bei einer direkten Verbindung zur Anthropic API ist in beiden Fällen nicht betroffen. In einigen Konfigurationen mit direkter Verbindung behält Claude Code den Block bei Anfragen des Auto-Modus-Klassifikators bei, selbst wenn Sie 0 setzen. Unter Attributionsblock im System-Prompt sehen Sie, welche Verbindungen und Anmeldedaten dies betrifft. Vor v2.1.181 enthielt der Block bei benutzerdefinierten Basis-URLs und Microsoft-Foundry-Verbindungen ein Token pro Anfrage; setzen Sie ihn in diesen Versionen daher auf 0, wenn Ihr LLM-Gateway anhand des Request-Bodys zwischenspeichert oder Anfragen an einen Drittanbieter weiterleitet oder wenn Sie sich direkt mit Microsoft Foundry verbinden
CLAUDE_CODE_AUTO_BACKGROUND_WORKER_CHECKIN_SECONDS In v2.1.283 entfernt. Verwenden Sie stattdessen CLAUDE_CODE_WORKER_CHECKIN_SCHEDULE
CLAUDE_CODE_AUTO_COMPACT_WINDOW Legt das Fenster für die automatische Komprimierung in Token fest, von 100000 bis 1000000. Akzeptiert nur eine einfache Ganzzahl wie 500000: Ein Wert wie 500k wird als 500 gelesen und auf das Minimum von 100K begrenzt. Das effektive Fenster ist außerdem auf das Kontextfenster des Modells begrenzt. Hat Vorrang vor dem Befehl /autocompact, dem Flag --autocompact und der Einstellung autoCompactWindow. Der used_percentage-Wert der Statuszeile wird immer am vollständigen Kontextfenster des Modells gemessen; sobald diese Variable gesetzt ist, zeigt dieser Prozentsatz daher nicht mehr an, wann die Komprimierung ausgeführt wird
CLAUDE_CODE_AUTO_CONNECT_IDE Überschreibt die automatische IDE-Verbindung. Standardmäßig verbindet sich Claude Code automatisch, wenn es im integrierten Terminal einer unterstützten IDE gestartet wird. Setzen Sie false, um dies zu verhindern. Setzen Sie true, um einen Verbindungsversuch zu erzwingen, wenn die automatische Erkennung fehlschlägt, etwa wenn tmux das übergeordnete Terminal verdeckt. Hat Vorrang vor der globalen Konfigurationseinstellung autoConnectIde
CLAUDE_CODE_AUTO_MODE_SERVER Steuert, ob Claude Code den Server bittet, Aktionen im Auto-Modus zu prüfen. Setzen Sie 0, um stattdessen die eigenen Klassifikator-Anfragen von Claude Code zu verwenden. Bei einer direkten Verbindung zur Anthropic API ist v2.1.281 oder höher erforderlich. Der verlinkte Abschnitt listet auf, welche Sitzungen den Server fragen, wenn die Variable nicht gesetzt ist, und ab welcher Version. Erfordert Claude Code v2.1.271 oder höher
CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS Zeit in Millisekunden, die Claude Code darauf wartet, dass die AWS-Standardkette der Anmeldedatenanbieter Anmeldedaten liefert, bevor die Anfrage mit AWS default-chain credential resolve timed out fehlschlägt (Standard: 60000). Erhöhen Sie den Wert, wenn ein Schritt in Ihrer Kette berechtigterweise länger braucht, etwa eine browserbasierte SSO-Anmeldung mit MFA über einen Wrapper wie aws-vault. Gilt überall dort, wo Claude Code mit der Standardkette signiert: Amazon Bedrock, Claude Platform on AWS und der Mantle-Endpunkt. Erfordert Claude Code v2.1.207 oder höher
CLAUDE_CODE_BASH_EDIT_DIFF Setzen Sie 0, um den Diff der Dateien, die sich während der Ausführung eines Bash-Befehls geändert haben, auszuschalten, oder 1, um ihn in jedem Berechtigungsmodus aufzuzeichnen. Hat Vorrang vor der Einstellung bashEditDiffEnabled. Erfordert Claude Code v2.1.269 oder höher
CLAUDE_CODE_BG_TASKS_REPORT_RUNNING Setzen Sie 0, damit eine nicht interaktive Sitzung ihrem Host am Ende jedes Turns einen Leerlaufstatus meldet, auch während noch Hintergrundarbeit läuft. Standardmäßig meldet die Sitzung über das Ende des Turns hinaus weiterhin einen laufenden Status, solange Hintergrundarbeit wie ein Hintergrundagent oder ein Workflow-Lauf noch aktiv ist. So wird verhindert, dass ein Host, der den Status beobachtet, etwa eine Liste von Remote-Sitzungen, mitten in der Arbeit ankündigt, dass Claude auf Ihre Eingabe wartet. Hintergrund-Shell-Befehle wie ein Entwicklungsserver halten den laufenden Status nicht aufrecht. Der laufende Status als Standard und die Deaktivierung mit 0 erfordern Claude Code v2.1.269 oder höher; setzen Sie in früheren Versionen 1, um den laufenden Status aufrechtzuerhalten
CLAUDE_CODE_BRIDGE_SESSION_ID Wird in Unterprozessen des Bash-Tools und von Hook-Befehlen automatisch gesetzt, während die Sitzung eine aktive Remote Control-Verbindung hat, und entfernt, wenn die Verbindung endet. Der Wert ist die ID der Sitzung in der Form session_, derselbe Bezeichner, der in der claude.ai/code-URL der Sitzung erscheint, sodass ein Skript auf die Sitzung verlinken kann, die es ausgeführt hat. Erfordert Claude Code v2.1.199 oder höher. Lesen Sie in Cloud-Sitzungen stattdessen CLAUDE_CODE_REMOTE_SESSION_ID
CLAUDE_CODE_BS_AS_CTRL_BACKSPACE Setzen Sie 0, damit Claude Code das Byte 0x08, auch als ^H geschrieben, als einfache Rücktaste liest, oder 1, um es als Strg+Rücktaste zu lesen. Beide Werte ersetzen den Plattformstandard. Standardmäßig liest Claude Code es unter Windows als Strg+Rücktaste, außer wenn TERM_PROGRAM mintty oder TERM cygwin ist, und unter macOS und Linux als einfache Rücktaste. Setzen Sie 0 in einem Windows-Terminal, in dem die Rücktaste ein ganzes Wort löscht
CLAUDE_CODE_CERT_STORE Kommagetrennte Liste von CA-Zertifikatsquellen für TLS-Verbindungen. bundled ist der mit Claude Code ausgelieferte Mozilla-CA-Satz. system ist der Vertrauensspeicher des Betriebssystems, der nur auf Laufzeitumgebungen mit tls.getCACertificates gelesen wird: der nativen Binärdatei oder Node 22.15 oder höher bei npm-Installationen. Siehe CA-Zertifikatsspeicher. Standard ist bundled,system
CLAUDE_CODE_CHILD_SESSION Wird in Unterprozessen, die Claude Code über die Tools Bash, PowerShell und Monitor, Hook-Befehle und Statuszeilen-Befehle startet, auf 1 gesetzt. Wird nicht für stdio-MCP-Server-Unterprozesse gesetzt, die langlebig sind und die Sitzung überdauern, die sie gestartet hat. Anders als CLAUDECODE wird diese Variable nur von Claude Code selbst beim Starten eines Unterprozesses gesetzt und nicht von IDE-Erweiterungen, sodass sie eine verschachtelte Sitzung zuverlässig von einem claude der obersten Ebene unterscheidet, das in einem IDE-integrierten Terminal gestartet wurde. Eine auf diese Weise gestartete verschachtelte interaktive claude-TUI wird automatisch von --resume, --continue, dem Verlauf über die Pfeil-nach-oben-Taste und der Liste claude agents ausgeschlossen. Nicht interaktive claude -p-Sitzungen werden weiterhin gespeichert. Setzen Sie CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1, um diesen Ausschluss zu überschreiben. Erfordert Claude Code v2.1.172 oder höher
CLAUDE_CODE_CLIENT_CERT Pfad zur Client-Zertifikatsdatei für die mTLS-Authentifizierung
CLAUDE_CODE_CLIENT_KEY Pfad zur Datei mit dem privaten Client-Schlüssel für die mTLS-Authentifizierung
CLAUDE_CODE_CLIENT_KEY_PASSPHRASE Passphrase für verschlüsseltes CLAUDE_CODE_CLIENT_KEY (optional)
CLAUDE_CODE_CONNECT_TIMEOUT_MS In v2.1.186 entfernt und jetzt ohne Wirkung. Legte zuvor einen separaten Timeout für die Verbindungs-, TLS- und Response-Header-Phase einer gestreamten API-Anfrage fest. Verwenden Sie API_TIMEOUT_MS für den Timeout pro Anfrage. Für die Response-Header-Phase einer gestreamten Anfrage siehe CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS
CLAUDE_CODE_DEBUG_LOGS_DIR Überschreibt den Pfad der Debug-Logdatei. Trotz des Namens ist dies ein Dateipfad, kein Verzeichnis. Erfordert, dass der Debug-Modus separat über --debug, /debug oder die Umgebungsvariable DEBUG aktiviert wird: Das Setzen dieser Variablen allein aktiviert das Logging nicht. Das Flag --debug-file erledigt beides gleichzeitig. Standardwert ist ~/.claude/debug/<session-id>.txt
CLAUDE_CODE_DEBUG_LOG_LEVEL Minimale Log-Stufe, die in die Debug-Logdatei geschrieben wird. Werte: verbose, debug (Standard), info, warn, error. Setzen Sie verbose, um umfangreiche Diagnosedaten wie die vollständige Befehlsausgabe der Statuszeile einzuschließen, oder erhöhen Sie auf error, um Rauschen zu reduzieren
CLAUDE_CODE_DISABLE_1M_CONTEXT Setzen Sie 1, um die Unterstützung für das 1M-Kontextfenster zu deaktivieren. Wenn gesetzt, sind 1M-Modellvarianten in der Modellauswahl nicht verfügbar, und Claude Code begrenzt Sitzungen auf Modellen mit nativem 1M-Fenster, etwa Sonnet 5.5 und den Fable-Modellen, auf ein 200K-Fenster; unter Erweiterter Kontext erfahren Sie, wie diese Begrenzung durchgesetzt wird. Nützlich für Unternehmensumgebungen mit Compliance-Anforderungen. Zu ihrer Rolle bei der Korrektur des Fensters für eine nicht erkannte [1m]-Modell-ID siehe Fenster für ein Gateway oder eine benutzerdefinierte Modell-ID korrigieren
CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING Setzen Sie 1, um adaptives Reasoning bei Opus 4.6 und Sonnet 4.6 zu deaktivieren und auf das feste Thinking-Budget zurückzufallen, das über MAX_THINKING_TOKENS gesteuert wird. Hat keine Wirkung bei Fable-Modellen, Sonnet 5 und neuer oder Opus 4.7 und neuer, die immer adaptives Reasoning verwenden
CLAUDE_CODE_DISABLE_ADMIN_ENV_UNION Setzen Sie 1, damit Claude Code env-Blöcke der verwalteten Einstellungen nicht mehr schlüsselweise über Admin-Quellen hinweg zusammenführt, sodass wie vor v2.1.223 nur der gesamte env-Block der Quelle mit der höchsten Priorität gilt. Setzen Sie die Variable in der Umgebung, die Claude Code startet, da Claude Code eine über einen env-Block in Einstellungen gelieferte Kopie ignoriert. Erfordert Claude Code v2.1.223 oder höher
CLAUDE_CODE_DISABLE_ADVISOR_TOOL Setzen Sie 1, um das Advisor-Tool zu deaktivieren. Der Befehl /advisor wird nicht verfügbar, ein konfiguriertes advisorModel wird ignoriert, und das Flag --advisor wird akzeptiert, hat aber keine Wirkung, sodass bestehende Skripte, die es übergeben, weiterhin ohne Fehler funktionieren
CLAUDE_CODE_DISABLE_AGENT_VIEW Setzen Sie 1, um Hintergrundagenten und die Agentenansicht auszuschalten: claude agents, --bg, /background und den bei Bedarf gestarteten Supervisor. Entspricht der Einstellung disableAgentView
CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN Setzen Sie 1, um das Vollbild-Rendering zu deaktivieren und den klassischen Renderer auf dem Hauptbildschirm zu verwenden. Die Konversation bleibt im nativen Scrollback Ihres Terminals, sodass Cmd+f und der tmux-Kopiermodus wie gewohnt funktionieren. Hat Vorrang vor CLAUDE_CODE_NO_FLICKER und der Einstellung tui. Sie können auch mit /tui default umschalten. Gilt nicht für Hintergrundsitzungen, die aus der Agentenansicht geöffnet werden und immer Vollbild-Rendering verwenden
CLAUDE_CODE_DISABLE_ARTIFACT Setzen Sie 1, um das Artifact-Tool auszuschalten, das Sitzungsausgabe als private Webseite auf claude.ai veröffentlicht. Sobald Sie die Variable gesetzt haben, kann keine Einstellungsdatei das Tool wieder einschalten. Um das Tool stattdessen über eine Einstellungsdatei auszuschalten, setzen Sie enableArtifact auf false; der veraltete Schlüssel disableArtifact schaltet es ebenfalls aus
CLAUDE_CODE_DISABLE_ATTACHMENTS Setzen Sie 1, um die Verarbeitung von Anhängen zu deaktivieren. Dateierwähnungen mit @-Syntax werden als einfacher Text gesendet, statt zum Dateiinhalt erweitert zu werden
CLAUDE_CODE_DISABLE_AUTH_REFRESH_LOCK Setzen Sie 1, damit ein Claude-Code-Prozess seinen gcpAuthRefresh- oder awsAuthRefresh-Befehl selbst ausführt, statt zu warten, während ein anderer Prozess ihn ausführt. Erfordert Claude Code v2.1.286 oder höher
CLAUDE_CODE_DISABLE_AUTO_MEMORY Setzen Sie 1, um Auto-Memory zu deaktivieren. Setzen Sie 0, um Auto-Memory auch dann zu erzwingen, wenn der --bare-Modus oder autoMemoryEnabled: false es andernfalls deaktivieren würden. Wenn deaktiviert, erstellt oder lädt Claude keine Auto-Memory-Dateien
CLAUDE_CODE_DISABLE_BACKGROUND_TASKS Setzen Sie 1, um alle Funktionen für Hintergrundaufgaben zu deaktivieren, einschließlich des Parameters run_in_background bei Bash- und Subagenten-Tools, des automatischen Verschiebens in den Hintergrund und der Tastenkombination Strg+B
CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_DEFAULT Setzen Sie 1, damit Claude Code eine gestreamte Amazon Bedrock-Antwort mit fehlendem oder leerem Content-Type-Header nicht mehr als binären Ereignisstream von Amazon Bedrock behandelt. Standardmäßig geht Claude Code davon aus, dass ein Gateway den Header aus einer ansonsten unveränderten Antwort entfernt hat, dekodiert also den Body, und das Streaming funktioniert weiter. Setzen Sie dies nur für ein Gateway, das den Stream außerdem als Server-Sent Events neu ausgibt; Claude Code liest den Body ohne Header dann stattdessen als Server-Sent Events. Erfordert Claude Code v2.1.239 oder höher
CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD Setzen Sie 1, um die Prüfung zu überspringen, ob eine gestreamte Amazon Bedrock-Antwort den Content-Type application/vnd.amazon.eventstream trägt. Ohne diese Variable lässt Claude Code die Anfrage, wenn eine Antwort einen anderen Content-Type trägt, mit einem Fehler fehlschlagen, der diesen Typ nennt; das bedeutet, dass ein Gateway oder Proxy die Antwort umwandelt. Konfigurieren Sie das Gateway so, dass es den Content-Type-Header und den Body unverändert weiterleitet, statt diese Variable zu setzen. Erfordert Claude Code v2.1.208 oder höher
CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF Setzen Sie 1, um laufende Hintergrund-Shell-Befehle, dynamische Workflows und ab v2.1.198 Hintergrund-Subagenten einer Hintergrundsitzung zu beenden, wenn der Supervisor den Prozess dieser Sitzung stoppt, neu startet oder aktualisiert, statt sie an den nächsten Prozess der Sitzung zu übergeben. Betrifft nur diese Übergabe: Das Verschieben einer Sitzung in den Hintergrund mit ← oder /background übernimmt laufende Arbeit weiterhin, und CLAUDE_DISABLE_ADOPT schaltet beides aus. Erfordert Claude Code v2.1.196 oder höher
CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP Setzen Sie 1, damit Claude Code Hintergrund-Shell-Befehle bei Speicherdruck nicht beendet. Standardmäßig beendet Claude Code unter macOS und Linux Hintergrund-Shells, wenn das Betriebssystem kritischen Speicherdruck meldet und die Sitzung 30 Minuten lang im Leerlauf war, ohne dass ein Turn oder Subagent lief. Windows hat kein Signal für Speicherdruck, daher hat diese Variable dort keine Wirkung. Erfordert Claude Code v2.1.193 oder höher
CLAUDE_CODE_DISABLE_BUNDLED_SKILLS Setzen Sie 1, um die in Claude Code enthaltenen Skills und Workflows zu deaktivieren: Mitgelieferte Skills und Workflows werden vollständig entfernt, während integrierte Befehle wie /init weiterhin eingegeben werden können, aber vor dem Modell verborgen sind. /doctor bleibt wie die integrierten Befehle eingebbar; blenden Sie ihn stattdessen mit DISABLE_DOCTOR_COMMAND aus. Skills aus Plugins, .claude/skills/ und .claude/commands/ sind nicht betroffen. Entspricht der Einstellung disableBundledSkills
CLAUDE_CODE_DISABLE_CFC_PROMPT Setzen Sie 1, um die Browser-Tools von Claude in Chrome verfügbar zu halten, aber den Chrome-Abschnitt des System-Prompts und den mitgelieferten Skill /claude-in-chrome wegzulassen. Für Hosts, die Claude Code einbetten und eigene Anleitungen für den Browser bereitstellen. Erfordert Claude Code v2.1.257 oder höher
CLAUDE_CODE_DISABLE_CLAUDE_MDS Setzen Sie 1, um das Laden jeglicher CLAUDE.md-Memory-Dateien in den Kontext zu verhindern, einschließlich Benutzer-, Projekt- und Auto-Memory-Dateien
CLAUDE_CODE_DISABLE_CRON Setzen Sie 1, um geplante Aufgaben zu deaktivieren. Der Skill /loop und die Cron-Tools werden nicht verfügbar, und bereits geplante Aufgaben werden nicht mehr ausgelöst, einschließlich Aufgaben, die bereits mitten in der Sitzung laufen
CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT Setzen Sie 1, um das Zeitlimit für Abfragen zum Entfernen kritischer Pfade auszuschalten. Im Modus auto sendet Claude Code diese Löschvorgänge dann stattdessen an den Klassifikator, und im Modus bypassPermissions wartet die Abfrage auf Ihre Antwort. Setzen Sie die Variable in der Umgebung, die Claude Code startet, da Claude Code eine über einen env-Block in Einstellungen gelieferte Kopie ignoriert. Erfordert Claude Code v2.1.281 oder höher
CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS Setzen Sie 1, um Vorabversions-anthropic-beta-Request-Header, die dazugehörigen Body-Felder und Beta-Felder von Tool-Schemas wie defer_loading und eager_input_streaming aus API-Anfragen zu entfernen. Verwenden Sie dies, wenn ein Proxy-Gateway Anfragen mit einem Unexpected value(s)-Fehler für den anthropic-beta-Header oder einem Extra inputs are not permitted-Fehler ablehnt. Vorabversions-Funktionen deaktivieren listet auf, was die Variable entfernt, einschließlich MCP Tool Search, und was Claude Code weiterhin sendet
CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS Setzen Sie 1, um die integrierten Explore- und Plan-Subagenten zu deaktivieren. Claude erkundet stattdessen mit seinen Such-Tools oder dem Allzweck-Subagenten, und der Plan-Modus liest Dateien direkt, statt Explore- und Plan-Agenten zu starten. Benutzerdefinierte Subagenten mit dem Namen Explore oder Plan sind nicht betroffen. Um im Agent SDK oder im nicht interaktiven Modus alle integrierten Subagenten-Typen zu entfernen, verwenden Sie stattdessen CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS. Erfordert Claude Code v2.1.198 oder höher
CLAUDE_CODE_DISABLE_FAST_MODE Setzen Sie 1, um den Fast-Modus zu deaktivieren
CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY Setzen Sie 1, um die Umfragen zur Sitzungsqualität „How is Claude doing?“ zu deaktivieren. Umfragen sind auch deaktiviert, wenn DISABLE_TELEMETRY, DO_NOT_TRACK oder CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC gesetzt ist, es sei denn, CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL aktiviert sie wieder. Um eine Stichprobenrate festzulegen, statt die Umfragen vollständig zu deaktivieren, verwenden Sie die Einstellung feedbackSurveyRate. Siehe Umfragen zur Sitzungsqualität
CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING Setzen Sie 1, um das Checkpointing von Dateien zu deaktivieren. Der Befehl /rewind kann dann keine Codeänderungen wiederherstellen. Überschreibt die Einstellung fileCheckpointingEnabled
CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS Setzen Sie 1, um die integrierten Anweisungen für Commit- und PR-Workflows sowie den Git-Status-Snapshot aus dem Kontext von Claude zu entfernen. Nützlich, wenn Sie eigene Skills für Git-Workflows verwenden. Hat, wenn gesetzt, Vorrang vor der Einstellung includeGitInstructions
CLAUDE_CODE_DISABLE_INLINE_SHELL_RM_PROMPT Setzen Sie 1, damit Claude Code Skripte, die mit -c an eine Shell übergeben werden, etwa bash -c 'rm -rf ~', nicht mehr auf das Entfernen kritischer Pfade hin liest. Claude Code prüft in diesen Skripten weiterhin Ziele aus Shell-Variablen und Positionsparametern, und die übrigen Prüfungen kritischer Pfade laufen weiter. Setzen Sie die Variable in der Umgebung, die Claude Code startet, da Claude Code eine über einen env-Block in Einstellungen gelieferte Kopie ignoriert. Erfordert Claude Code v2.1.288 oder höher
CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP Setzen Sie 1, um die automatische Umleitung von Opus 4.0 und 4.1 auf die aktuelle Opus-Version bei der Anthropic API zu verhindern. Verwenden Sie dies, wenn Sie bewusst ein älteres Modell festlegen möchten. Die Umleitung erfolgt nicht bei Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry
CLAUDE_CODE_DISABLE_MODEL_ACCESS_FALLBACK Setzen Sie 1, damit Claude Code bei Amazon Bedrock und Google Cloud's Agent Platform nicht auf ein älteres Modell wechselt, wenn Ihr Konto mitten in der Sitzung den Zugriff auf das Modell der Sitzung verliert; die abgelehnte Anfrage schlägt dann sofort fehl. Eine von Ihnen konfigurierte Fallback-Modellkette wechselt bei dieser Ablehnung weiterhin, und die Modellprüfungen beim Start greifen beim Start weiterhin auf einen Fallback zurück. Erfordert Claude Code v2.1.285 oder höher
CLAUDE_CODE_DISABLE_MOUSE Setzen Sie 1, um die Mausverfolgung beim Vollbild-Rendering zu deaktivieren. Das Scrollen per Tastatur mit PgUp und PgDn funktioniert weiterhin. Verwenden Sie dies, um das native Kopieren-bei-Auswahl-Verhalten Ihres Terminals beizubehalten
CLAUDE_CODE_DISABLE_MOUSE_CLICKS Setzen Sie 1, um die Verarbeitung von Klicks, Ziehen und Hover beim Vollbild-Rendering zu deaktivieren, das Scrollen mit dem Mausrad aber beizubehalten. Verwenden Sie dies, wenn das Scrollen mit dem Mausrad in Claude Code funktionieren soll, Klicks aber nicht den Cursor positionieren, Tool-Ausgabe erweitern oder Links öffnen sollen. CLAUDE_CODE_DISABLE_MOUSE hat Vorrang, wenn beide gesetzt sind. Erfordert Claude Code v2.1.195 oder höher
CLAUDE_CODE_DISABLE_MTLS_RELOAD_ON_STALE_CONNECTION Setzen Sie 1, damit Claude Code das mTLS-Client-Zertifikat und den Schlüssel nicht erneut einliest, wenn eine API-Anfrage mit einem Fehler auf Verbindungsebene fehlschlägt, etwa einem Verbindungsabbruch oder einem Fehler beim TLS-Handshake. Bei deaktiviertem Neuladen lädt Claude Code rotierte Dateien erst, wenn es das nächste Mal Einstellungen anwendet, oder beim nächsten Start. Erfordert Claude Code v2.1.232 oder höher
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC Setzen Sie einen beliebigen nicht leeren Wert, etwa 1, um nicht unbedingt erforderlichen Netzwerkverkehr zu deaktivieren: automatische Updates, Telemetrie, Fehlerberichte, den Befehl /feedback, von Claude entworfenes Feedback, Versionshinweise, die Prüfungen für das PR- und MR-Status-Badge sowie Verfügbarkeitsprüfungen wie die Prüfung für den Fast-Modus. Außerdem werden die Hintergrundläufe von Plugin-command-Quellen gestoppt, die lokale Befehle und kein Netzwerkverkehr sind, da sie Installationen von Abhängigkeiten auslösen können. Auch das Setzen auf 0 oder false deaktiviert diesen Verkehr, anders als bei den meisten Ein/Aus-Variablen; entfernen Sie die Variable, um ihn wieder zuzulassen. Deaktiviert außerdem das Abrufen von Feature-Flags, wodurch Remote Control und die anderen Funktionen, die das Abrufen von Feature-Flags benötigen, nicht verfügbar sind. Die automatische Installation des offiziellen Plugin-Marketplace ist nicht abgedeckt; deaktivieren Sie sie mit CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL. Wirkt sich nicht auf die Modellerkennung über das Gateway aus, die eine eigene Aktivierung hat
CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK Setzen Sie 1, um den Fallback ohne Streaming zu deaktivieren, wenn eine gestreamte Anfrage mitten im Stream fehlschlägt. Streaming-Fehler werden stattdessen an die Ebene für Wiederholungsversuche weitergegeben. Nützlich, wenn ein Proxy oder Gateway dazu führt, dass der Fallback eine doppelte Tool-Ausführung erzeugt
CLAUDE_CODE_DISABLE_NOTIFICATION_PRESENCE_CHECK Setzen Sie 1, um die Desktop-Benachrichtigung des PushNotification-Tools auch dann zu senden, wenn Sie im Terminal tippen oder es fokussiert ist. Standardmäßig überspringt das Tool sowohl die Desktop-Benachrichtigung als auch den mobilen Push, wenn es kürzliche Tastaturaktivität oder Terminalfokus erkennt. Diese Variable deaktiviert nur diese lokale Prüfung, sodass der Server den mobilen Push weiterhin unterdrücken kann, wenn er erkennt, dass Sie aktiv sind. Erfordert Claude Code v2.1.193 oder höher
CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL Setzen Sie 1, um die automatische Registrierung des offiziellen Plugin-Marketplace zu deaktivieren. Claude Code liest die Variable, wenn es im Begriff ist, den Marketplace zu registrieren, in der Regel beim ersten interaktiven Start auf einem Rechner. Ist die Variable zu diesem Zeitpunkt gesetzt, überspringt Claude Code die Registrierung dauerhaft. Ein späteres Entfernen der Variablen macht das Überspringen nicht rückgängig. Führen Sie claude plugin marketplace add anthropics/claude-plugins-official aus, um den Marketplace jederzeit zu registrieren
CLAUDE_CODE_DISABLE_PERMISSION_PROMPT_NOTIFY_HOOKS Setzen Sie 1, damit Claude Code Ihre Notification-Hooks für unbeantwortete Berechtigungsanfragen in Sitzungen nicht ausführt, in denen Claude Code diese an den canUseTool-Callback des Agent SDK sendet; so hosten Claude Desktop und die VS Code-Erweiterung Claude Code. Hat in Terminalsitzungen keine Wirkung. Erfordert Claude Code v2.1.233 oder höher
CLAUDE_CODE_DISABLE_POLICY_SKILLS Setzen Sie 1, um das Laden von Skills aus dem systemweiten Verzeichnis für verwaltete Skills zu überspringen. Nützlich für Container- oder CI-Sitzungen, die keine vom Betreiber bereitgestellten Skills laden sollen
CLAUDE_CODE_DISABLE_POWERSHELL_CMD_RM_DENY Setzen Sie 1, um die Prüfung des PowerShell-Tools auszuschalten, die die cmd-Built-ins rd, rmdir, del und erase auf einem Systempfad wie einem Laufwerksstammverzeichnis oder Ihrem Home-Verzeichnis verweigert. Claude Code ignoriert diese Variable im env-Block einer Einstellungsdatei. Erfordert Claude Code v2.1.283 oder höher
CLAUDE_CODE_DISABLE_REFUSAL_FALLBACK Setzen Sie 1, um den automatischen Modellwechsel, wenn ein Sicherheitsklassifikator eine Anfrage kennzeichnet, auszuschalten, also das Verhalten, das die Einstellung switchModelsOnFlag steuert
CLAUDE_CODE_DISABLE_STRUCTURED_OUTPUTS Setzen Sie 1, damit Claude Code das Feld output_config.format für strukturierte Ausgaben und den dazugehörigen anthropic-beta-Wert nicht mehr sendet, für ein LLM-Gateway, dessen Upstream diese ablehnt. Die übrigen Vorabversions-Funktionen, die CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS ausschaltet, bleiben dabei eingeschaltet. Erfordert Claude Code v2.1.288 oder höher
CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT Setzen Sie 1, um die Prüfung kritischer Pfade für ein rekursives rm auszuschalten, dessen Ziel vollständig aus der Ausgabe einer Befehlssubstitution besteht, etwa rm -rf "$(pwd)". Die übrigen Prüfungen kritischer Pfade laufen weiter. Setzen Sie die Variable in der Umgebung, die Claude Code startet, da Claude Code eine über einen env-Block in Einstellungen gelieferte Kopie ignoriert. Erfordert Claude Code v2.1.281 oder höher
CLAUDE_CODE_DISABLE_TERMINAL_TITLE Setzen Sie 1, um automatische Aktualisierungen des Terminaltitels auf Grundlage des Konversationskontexts zu deaktivieren. Dadurch entfällt auch die Hintergrundanfrage an das kleine/schnelle Modell, die einen Sitzungstitel erzeugt
CLAUDE_CODE_DISABLE_THINKING Setzen Sie 1, um den Parameter thinking vollständig aus API-Anfragen wegzulassen. Dies ist eine Kompatibilitätsoption für Proxys und Gateways, die den Parameter ablehnen. Bei Modellen, die standardmäßig Thinking verwenden, bedeutet das Weglassen des Parameters, dass das Modell möglicherweise trotzdem Thinking verwendet. Um Extended Thinking bei der Anthropic API ausdrücklich zu deaktivieren, verwenden Sie stattdessen MAX_THINKING_TOKENS=0. Keine der beiden Variablen schaltet Thinking bei Opus 5.5, Sonnet 5.5 oder den Fable-Modellen aus, bei denen Thinking nicht ausgeschaltet werden kann. Bei Drittanbietern lässt MAX_THINKING_TOKENS=0 den Parameter ebenfalls weg, sodass sich die beiden Variablen dort gleich verhalten
CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT Setzen Sie 1, um die vorausschauende automatische Komprimierung zu überspringen, wenn Claude Code die Modell-ID nicht erkennt, etwa bei einem Alias eines LLM-Gateways. Ohne diese Variable komprimiert Claude Code beim Kontextfenster, das es für die ID annimmt. CLAUDE_CODE_MAX_CONTEXT_TOKENS kann stattdessen das angenommene Fenster korrigieren; unter Fenster für ein Gateway oder eine benutzerdefinierte Modell-ID korrigieren erfahren Sie, wann welche Variable gilt. Erfordert Claude Code v2.1.223 oder höher
CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL Setzen Sie 1, um virtuelles Scrollen beim Vollbild-Rendering zu deaktivieren und jede Nachricht im Transkript zu rendern. Verwenden Sie dies, wenn beim Scrollen im Vollbildmodus leere Bereiche erscheinen, wo Nachrichten stehen sollten
CLAUDE_CODE_DISABLE_WEB_FETCH Setzen Sie 1, um das WebFetch-Tool auszuschalten. Das WebSearch-Tool bleibt verfügbar. Erfordert Claude Code v2.1.285 oder höher
CLAUDE_CODE_DISABLE_WINDOWS_SHELL_LAUNCHER Setzen Sie 1, um Befehle des PowerShell-Tools unter Windows direkt statt über den cmd.exe-Launcher zu starten. Standardmäßig ermöglicht der Launcher, dass ein im Hintergrund laufender PowerShell-Befehl auf den nächsten Prozess der Sitzung übergeht, etwa wenn Sie die Sitzung in den Hintergrund verschieben. Wenn Sie die Variable setzen, stoppt ein in den Hintergrund verschobener PowerShell-Befehl, sobald der Prozess der Sitzung beendet wird. Bash-Befehle sind nicht betroffen. Erfordert Claude Code v2.1.269 oder höher
CLAUDE_CODE_DISABLE_WORKFLOWS Setzen Sie 1, um Workflows zu deaktivieren. Entspricht der Einstellung disableWorkflows
CLAUDE_CODE_EFFORT_LEVEL Legt die Effort-Stufe für unterstützte Modelle fest. Werte: low, medium, high, xhigh, max oder auto, um den Standard des Modells zu verwenden. Die verfügbaren Stufen hängen vom Modell ab. Hat Vorrang vor --effort, /effort und den Einstellungen modelSettings und effortLevel. Eine Obergrenze durch maxEffortLevel gilt weiterhin. Siehe Effort-Stufe anpassen
CLAUDE_CODE_ENABLE_AUTO_MODE Wird aus Gründen der Kompatibilität mit älteren Versionen akzeptiert und hat keine Wirkung. Der Auto-Modus ist standardmäßig bei jedem Anbieter verfügbar, einschließlich Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry und angemeldeter Sitzungen über das Claude apps gateway. In v2.1.158 bis v2.1.206 musste diese Variable auf 1 gesetzt werden, um den Auto-Modus bei diesen Anbietern verfügbar zu machen
CLAUDE_CODE_ENABLE_AWAY_SUMMARY Überschreibt die Verfügbarkeit der Sitzungszusammenfassung. Auf 0 setzen, um Zusammenfassungen unabhängig vom Schalter in /config zu deaktivieren. Auf 1 setzen, um Zusammenfassungen zu erzwingen, wenn awaySummaryEnabled false ist. Hat Vorrang vor der Einstellung und dem Schalter in /config
CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH Auf 1 setzen, um den Plugin-Zustand im nicht interaktiven Modus an Turn-Grenzen zu aktualisieren, nachdem eine Installation im Hintergrund abgeschlossen ist. Standardmäßig deaktiviert, da die Aktualisierung den System-Prompt mitten in der Sitzung ändert, wodurch das Prompt-Caching für diesen Turn ungültig wird
CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL Auf 1 setzen, um die Umfrage zur Sitzungsqualität „How is Claude doing?“ an Ihren eigenen OpenTelemetry-Collector zu leiten, wenn nicht wesentlicher Datenverkehr an Anthropic blockiert ist. Umfragebewertungen werden nur als OTEL-Events an Ihren konfigurierten Collector gesendet. In diesem Modus werden keine Umfragedaten an Anthropic gesendet. Gilt, wenn CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC, DISABLE_TELEMETRY oder DO_NOT_TRACK gesetzt ist, und hat andernfalls keine Wirkung. CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY und die Richtlinie der Organisation für Produktfeedback haben Vorrang
CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING Steuert, ob Eingaben von Tool-Aufrufen von der API gestreamt werden, während Claude sie generiert. Ist dies deaktiviert, kommt eine große Tool-Eingabe wie das Schreiben einer langen Datei erst an, nachdem Claude sie vollständig generiert hat, was wie ein Hängen aussehen kann. Standardmäßig in der Anthropic API aktiviert. Bei Amazon Bedrock und Google Cloud's Agent Platform pro Modell aktiviert, sofern der bereitgestellte Container dies unterstützt. Auf 0 setzen, um es abzuschalten. Auf 1 setzen, um es zu erzwingen, wenn Anfragen über ANTHROPIC_BASE_URL, ANTHROPIC_VERTEX_BASE_URL oder ANTHROPIC_BEDROCK_BASE_URL über einen Proxy geleitet werden. Standardmäßig deaktiviert bei Microsoft Foundry und Gateway-Verbindungen
CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY Auf 1 setzen, um die /model-Auswahl über den Endpunkt /v1/models Ihres Gateways zu befüllen, wenn ANTHROPIC_BASE_URL auf ein Anthropic-kompatibles Gateway wie LiteLLM, Kong oder einen internen Proxy zeigt. Standardmäßig deaktiviert, da Gateways, die auf einem gemeinsam genutzten API-Schlüssel basieren, sonst jedem Benutzer jedes Modell anzeigen würden, auf das der Schlüssel zugreifen kann. Erkannte Modelle werden weiterhin durch eine availableModels-Allowlist gefiltert, die die Sitzung erhält; stellen Sie die Liste über MDM oder eine Datei für verwaltete Einstellungen bereit, da die serverseitig verwaltete Bereitstellung bei Gateway-Konfigurationen nicht verfügbar ist
CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE In v2.1.142 entfernt, als der Standard für den Fast-Modus von Opus 4.6 auf Opus 4.7 wechselte
CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION Auf false setzen, um Prompt-Vorschläge zu deaktivieren, also die ausgegrauten Vorhersagen, die in Ihrem Prompt-Eingabefeld erscheinen. Hat Vorrang vor der Einstellung promptSuggestionEnabled, die der Schalter Prompt suggestions in /config schreibt. Claude Code pausiert Vorschläge außerdem, während Ihr Konto nahe an seinem Nutzungslimit ist oder es erreicht hat. Auf true setzen, um sie bis zum Erreichen des Limits aktiviert zu lassen. Erfordert Claude Code v2.1.238 oder höher. Siehe Prompt-Vorschläge
CLAUDE_CODE_ENABLE_TASKS Legt fest, welche Tools zur Aufgabenverfolgung Claude Code in Sitzungen, die diese haben, bereitstellt. Standardmäßig stellt Claude Code die Task-Tools TaskCreate, TaskUpdate, TaskGet und TaskList bereit. Auf 0 setzen, um stattdessen das ältere Tool TodoWrite zu erhalten. Siehe Aufgabenliste
CLAUDE_CODE_ENABLE_TELEMETRY Auf 1 setzen, um die OpenTelemetry-Datenerfassung für Metriken und Logging zu aktivieren. Erforderlich, bevor OTel-Exporter konfiguriert werden. Setzen Sie sie in Ihrer Shell, in den Benutzereinstellungen oder in verwalteten Einstellungen. Wird in Projekt- und lokalen Einstellungen ignoriert. Siehe Überwachung
CLAUDE_CODE_ENABLE_TODO_TOOLS Auf 1 setzen, um die Tools zur Aufgabenverfolgung bei jedem Modell zu erhalten. Ohne diese Variable stellt Claude Code sie standardmäßig nur bei den Modellen bereit, die unter Verfügbarkeit der Task-Tools aufgeführt sind. CLAUDE_CODE_ENABLE_TASKS wählt weiterhin zwischen den Task-Tools und TodoWrite. Erfordert Claude Code v2.1.233 oder höher
CLAUDE_CODE_EXIT_AFTER_STOP_DELAY Wartezeit in Millisekunden, nachdem die Abfrageschleife in den Leerlauf übergegangen ist, bevor Claude Code automatisch beendet wird. Nützlich für automatisierte Workflows und Skripte im SDK-Modus
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS Auf 1 setzen, um Agent Teams zu aktivieren. Agent Teams sind experimentell und standardmäßig deaktiviert
CLAUDE_CODE_EXTRA_BODY JSON-Objekt, das in die oberste Ebene jedes API-Anfragekörpers zusammengeführt wird. Nützlich, um anbieterspezifische Parameter zu übergeben, die Claude Code nicht direkt bereitstellt. Ein in Ihrer Shell exportierter Wert gilt auch für die Hintergrundsitzungen, die Sie mit claude agents oder --bg starten. Vor v2.1.206 ignorierten Hintergrundsitzungen einen in der Shell exportierten Wert und verwendeten die Kopie, die der Supervisor-Prozess im Hintergrund geerbt hatte
CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS Überschreibt das Standard-Token-Limit für das Lesen von Dateien. Nützlich, wenn Sie größere Dateien vollständig lesen müssen
CLAUDE_CODE_FORCE_SESSION_PERSISTENCE Auf 1 setzen, um die Speicherung des Transkripts, den Prompt-Verlauf und die Registrierung bei claude agents zu erzwingen, selbst wenn dieses claude aus einer anderen Claude Code-Sitzung heraus gestartet wurde. Verwenden Sie dies, wenn ein geerbter Wert von CLAUDE_CODE_CHILD_SESSION, zum Beispiel aus einer screen-Sitzung oder einem Hintergrund-Launcher, der zuerst vom Bash-Tool von Claude Code gestartet wurde, dazu führt, dass eine echte Sitzung der obersten Ebene fälschlicherweise als verschachtelt eingestuft wird. Ab v2.1.178 erkennt Claude Code den tmux-Fall automatisch und ignoriert die geerbte Markierung, sodass tmux diese Variable nicht mehr benötigt. Wird auch in v2.1.169 und früher berücksichtigt; hat in v2.1.170 und v2.1.171 keine Wirkung, da dort die Erkennung verschachtelter Sitzungen, die sie überschreibt, entfernt war
CLAUDE_CODE_FORCE_STRIKETHROUGH Auf 1 setzen, um die durchgestrichene Darstellung von ~~text~~ in Claudes Antworten zu erzwingen, wenn Ihr Terminal sie unterstützt, aber nicht automatisch erkannt wird, etwa über SSH ohne weitergeleitetes TERM_PROGRAM. Ohne diese Variable zeigen nicht erkannte Terminals die wörtlichen ~~-Markierungen an, anstatt den Text durchgestrichen darzustellen. Erfordert Claude Code v2.1.186 oder höher
CLAUDE_CODE_FORCE_SYNC_OUTPUT Auf 1 setzen, um DEC Private Mode 2026 synchronisierte Ausgabe zwangsweise zu aktivieren, wenn Ihr Terminal dies unterstützt, aber nicht automatisch erkannt wird. Nützlich für Emulatoren wie Emacs eat, die BSU/ESU implementieren, aber nicht auf die Fähigkeitsabfrage antworten. Hat unter tmux keine Wirkung. Im Gegensatz zu CLAUDE_CODE_NO_FLICKER, das auf Vollbild-Rendering umschaltet, ändert dies den Renderer nicht
CLAUDE_CODE_FORK_SUBAGENT Steuert den Fork-Modus, mit dem Claude selbst geforkte Subagenten starten kann und der standardmäßig nur in interaktiven Sitzungen aktiviert ist. Auf 1 setzen, um ihn auch in claude -p und im Agent SDK zu aktivieren, oder auf 0, um ihn in allen Arten von Sitzungen zu deaktivieren. Sie können /subtask unabhängig davon ausführen, ob der Fork-Modus aktiviert ist. Der interaktive Standard erfordert Claude Code v2.1.232 oder höher; setzen Sie die Variable in früheren Versionen auf 1, um den Fork-Modus zu aktivieren
CLAUDE_CODE_FORWARD_SUBAGENT_TEXT Auf 1 setzen, um Text- und Thinking-Blöcke von Subagenten in der Ausgabe von claude -p --output-format stream-json auszugeben, mit demselben Verhalten wie das Flag --forward-subagent-text. Verwenden Sie die Variable, wenn ein Harness claude aufruft und das Flag nicht selbst übergeben kann. Im Gegensatz zum Flag, das außerhalb des nicht interaktiven Modus mit stream-json-Ausgabe mit einem Fehler beendet wird, wird die Variable dort ignoriert, damit verschachtelte Aufrufe weiter funktionieren, wenn sie prozessweit gesetzt ist. Erfordert Claude Code v2.1.211 oder höher
CLAUDE_CODE_GATEWAY_HINT_HEADERS Auf 1 setzen, um die Gateway-Hinweis-Header wie x-claude-code-request-class und x-claude-code-compaction an einen benutzerdefinierten Proxy oder einen Drittanbieter wie Amazon Bedrock oder Claude Platform on AWS zu senden. Auf 0 setzen, um sie bei keiner Verbindung mehr zu senden, auch nicht bei einer direkten Verbindung zur Anthropic API, bei der Claude Code sie standardmäßig sendet. Erfordert Claude Code v2.1.273 oder höher
CLAUDE_CODE_GATEWAY_MODEL_DISCOVERY_TIMEOUT_MS Timeout in Millisekunden für die Anfrage zur Gateway-Modellerkennung, die CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY aktiviert (Standard: 3000). Erhöhen Sie den Wert, wenn Ihr Gateway beim Start länger als drei Sekunden benötigt, um auf /v1/models zu antworten. Akzeptiert nur reine Ziffern; bei 0, negativen Werten und anderen Schreibweisen bleibt der Standard erhalten. Erfordert Claude Code v2.1.269 oder höher
CLAUDE_CODE_GIT_BASH_PATH Nur Windows: Pfad zur ausführbaren Git-Bash-Datei (bash.exe). Verwenden Sie dies, wenn Git Bash installiert ist, aber nicht in Ihrem PATH liegt. Wenn der Pfad nicht existiert oder die Datei nicht bash.exe, sh.exe, bash oder sh heißt, ignoriert Claude Code die Variable, erkennt Git Bash automatisch, als wäre sie nicht gesetzt, und protokolliert eine Warnung, die mit --debug sichtbar ist. Vor v2.1.219 wurde Claude Code beim Start beendet, wenn der Pfad nicht existierte, und verwendete jede vorhandene Datei als Shell, ohne zu prüfen, ob es sich um bash oder sh handelt. Siehe Einrichtung unter Windows
CLAUDE_CODE_GLOB_HIDDEN Auf false setzen, um Dotfiles aus den Ergebnissen auszuschließen, wenn Claude das Glob-Tool aufruft. Standardmäßig enthalten. Wirkt sich nicht auf die @-Dateiautovervollständigung, ls, Grep oder Read aus
CLAUDE_CODE_GLOB_NO_IGNORE Auf false setzen, damit das Glob-Tool .gitignore-Muster berücksichtigt. Standardmäßig gibt Glob alle passenden Dateien zurück, einschließlich der durch gitignore ausgeschlossenen. Wirkt sich nicht auf die @-Dateiautovervollständigung aus, die eine eigene Einstellung respectGitignore hat
CLAUDE_CODE_GLOB_TIMEOUT_SECONDS Timeout in Sekunden für die Dateisuche des Glob-Tools. Standardmäßig 20 Sekunden auf den meisten Plattformen und 60 Sekunden unter WSL
CLAUDE_CODE_GOAL_CHECKIN_MINUTES Wie viele Minuten Hintergrundarbeit ein aktives Ziel warten lassen kann, bevor Claude Code Claude bittet, nach dem Stand zu sehen. Standard 30. Auf 0 setzen, um diese Zwischenprüfungen zu deaktivieren. Geben Sie ganze Minuten in reinen Ziffern an, höchstens 10080, also eine Woche. Claude Code behandelt jeden anderen Wert als nicht gesetzt und verwendet den Standard. Erfordert Claude Code v2.1.234 oder höher
CLAUDE_CODE_HIDE_CWD Auf 1 setzen, um das Arbeitsverzeichnis im Startlogo auszublenden. Nützlich für Bildschirmfreigaben oder Aufzeichnungen, bei denen der Pfad Ihren Betriebssystem-Benutzernamen preisgibt
CLAUDE_CODE_IDE_HOST_OVERRIDE Überschreibt die Host-Adresse, die für die Verbindung zur IDE-Erweiterung verwendet wird. Standardmäßig erkennt Claude Code die richtige Adresse automatisch, einschließlich des Routings von WSL zu Windows
CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL Auf 1 setzen, um die automatische Installation von IDE-Erweiterungen zu überspringen. Entspricht dem Setzen von autoInstallIdeExtension auf false
CLAUDE_CODE_IDE_SKIP_VALID_CHECK Auf 1 setzen, um die Validierung von IDE-Lockfile-Einträgen beim Verbinden zu überspringen. Verwenden Sie dies, wenn die automatische Verbindung Ihre IDE nicht findet, obwohl sie läuft
CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS Wie viele Subagenten in einer Sitzung gleichzeitig laufen können, bevor das Agent-Tool das Starten eines weiteren verweigert (Standard: 20). Akzeptiert eine positive ganze Zahl in reinen Ziffern; alles andere wird ignoriert, sodass die Variable die Obergrenze anpassen, aber nicht deaktivieren kann. Erfordert Claude Code v2.1.217 oder höher
CLAUDE_CODE_MAX_CONTEXT_TOKENS Überschreibt die Größe des Kontextfensters, die Claude Code für das aktive Modell annimmt. Ab v2.1.193 hängt die Anwendung davon ab, wie Claude Code die Modell-ID auflöst; siehe Das Fenster für ein Gateway oder eine benutzerdefinierte Modell-ID korrigieren. Verwenden Sie dies, wenn Sie über ANTHROPIC_BASE_URL an ein Modell weiterleiten, dessen Kontextfenster nicht der integrierten Größe für seinen Namen entspricht
CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH Maximale Länge in Zeichen jeder MCP-Tool-Beschreibung und der Anweisungen jedes MCP-Servers, die Claude Code an das Modell sendet (Standard: 2048). Claude Code kürzt längeren Text. Akzeptiert eine positive ganze Zahl in reinen Ziffern. Alles andere wird ignoriert, und der Standard gilt. Erfordert Claude Code v2.1.280 oder höher
CLAUDE_CODE_MAX_OUTPUT_TOKENS Legt die maximale Anzahl an Ausgabe-Token für die meisten Anfragen fest. Standardwerte und Obergrenzen variieren je nach Modell; siehe maximale Ausgabe-Token. Claude Code senkt einen Wert, der über der Obergrenze eines Modells liegt, auf diese Obergrenze. Für eine Modell-ID, die Claude Code keinem bekannten Modell zuordnen kann, beträgt der Standard 32000 und die Obergrenze 128000. Ein höherer Wert verringert das effektive Kontextfenster, das verfügbar ist, bevor die automatische Komprimierung ausgelöst wird
CLAUDE_CODE_MAX_RETRIES Überschreibt, wie oft fehlgeschlagene API-Anfragen erneut versucht werden (Standard: 10). Ab v2.1.186 auf 15 begrenzt; ab v2.1.199 erhöht CLAUDE_CODE_RETRY_WATCHDOG den Standard und hebt die Obergrenze auf. Für unbeaufsichtigte Sitzungen, die längere Ausfälle abwarten müssen, setzen Sie stattdessen CLAUDE_CODE_RETRY_WATCHDOG
CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION In v2.1.224 entfernt und jetzt wirkungslos. Begrenzte früher die Gesamtzahl der Subagenten, die Claude mit dem Agent-Tool in einer Sitzung starten konnte (Standard: 200); das Starten über die Obergrenze hinaus schlug mit Subagent spawn limit reached fehl. Das Limit für gleichzeitige Subagenten und das Tiefenlimit gelten weiterhin
CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH Anzahl der unterhalb der Hauptkonversation erlaubten Subagenten-Ebenen (Standard: 3). Beim Standardwert können Subagenten eigene Subagenten starten, und ein Subagent auf der dritten Ebene kann keine weiteren starten; setzen Sie 1, um die Verschachtelung zu deaktivieren. In v2.1.217 bis v2.1.218 war der Standard 1, sodass ein Subagent keine eigenen starten konnte, sofern Sie das Limit nicht erhöht hatten; v2.1.219 erhöhte den Standard auf 3. Akzeptiert eine positive ganze Zahl in reinen Ziffern; alles andere wird ignoriert, sodass das Limit angepasst, aber nicht entfernt werden kann. Erfordert Claude Code v2.1.217 oder höher
CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY Maximale Anzahl nur lesender Tools und Subagenten, die parallel ausgeführt werden können (Standard: 10). Höhere Werte erhöhen die Parallelität, verbrauchen aber mehr Ressourcen
CLAUDE_CODE_MAX_TURNS Begrenzt die Anzahl agentischer Turns, wenn kein explizites Limit übergeben wird. Entspricht der Übergabe von --max-turns, das Vorrang hat, wenn beide gesetzt sind. Ein Wert, der keine positive ganze Zahl ist, wird beim Start mit einem Fehler abgelehnt, statt als fehlende Begrenzung behandelt zu werden
CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION Obergrenze für die Gesamtzahl der WebSearch-Aufrufe, die eine Sitzung ausführen kann (Standard: 200). Wenn Claude die Obergrenze erreicht, geben weitere WebSearch-Aufrufe einen Hinweis zurück, der Claude anweist, mit den bereits gesammelten Informationen fortzufahren. Akzeptiert eine positive ganze Zahl ohne Obergrenze. Alles andere wird ignoriert, und der Standard gilt, sodass die Obergrenze erhöht, aber nicht deaktiviert werden kann. Erfordert Claude Code v2.1.212 oder höher
CLAUDE_CODE_MCP_ALLOWLIST_ENV Auf 1 setzen, um stdio-MCP-Server nur mit einer sicheren Basisumgebung plus dem konfigurierten env des Servers zu starten, statt Ihre Shell-Umgebung zu erben
CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS Verstrichene Zeit in Millisekunden, bevor ein noch laufender MCP-Tool-Aufruf in eine Hintergrundaufgabe verschoben wird (Standard: 120000, also 2 Minuten). Auf 0 setzen, um die automatische Verschiebung in den Hintergrund zu deaktivieren. Erfordert Claude Code v2.1.212 oder höher
CLAUDE_CODE_MCP_STARTUP_WAIT_MS Wie lange in Millisekunden der erste Turn einer nicht interaktiven Sitzung auf MCP-Server wartet, die noch eine Verbindung herstellen, anstelle der standardmäßigen Wartezeit im ersten Turn. Wenn gesetzt, gilt die Wartezeit für jeden ausstehenden Server. Auf 0 setzen, um das Warten zu überspringen. Ein --permission-prompt-tool-Server behält unabhängig vom Wert seine eigene MCP_TIMEOUT-Wartezeit. Erfordert Claude Code v2.1.274 oder höher
CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT Leerlauf-Timeout in Millisekunden für MCP-Tool-Aufrufe. Wenn ein stdio-, HTTP-, SSE-, WebSocket- oder claude.ai-Konnektor-MCP-Server so lange weder eine Antwort noch eine Fortschrittsbenachrichtigung sendet, wird der Tool-Aufruf mit einem Fehler abgebrochen, statt auf das gesamte MCP_TOOL_TIMEOUT zu warten. Überschreibt die Standardwerte pro Transport von 300000 (5 Minuten) für Netzwerkserver und 1800000 (30 Minuten) für stdio-Server. Auf 0 setzen, um die Leerlaufprüfung zu deaktivieren. Werte unter 1000 werden auf eine Sekunde angehoben, und der Wert ist auf das effektive MCP_TOOL_TIMEOUT begrenzt. Ein serverspezifisches timeout von mindestens 1000 in .mcp.json erhöht das Leerlauffenster dieses Servers auf mindestens den timeout-Wert. Gilt nicht für IDE-Server oder prozessinterne SDK-Server. Erfordert Claude Code v2.1.187 oder höher. Vor v2.1.203 waren stdio-Server vom Leerlauf-Timeout ausgenommen
CLAUDE_CODE_MESSAGING_SOCKET Wird von Claude Code gesetzt, nicht von Ihnen: In Sitzungen, die einen Inbox-Socket binden, exportiert Claude Code den Pfad dieses Sockets an Hooks und Bash-Befehle, wenn es den Socket bindet. In einer Sitzung, die mit aktiviertem Messaging startet, bindet Claude Code den Socket, bevor ein Hook ausgeführt wird. Andere Sitzungen auf dem Rechner stellen Nachrichten an diesen Pfad zu. Jede Sitzung exportiert ihren eigenen Socket statt eines von einem übergeordneten Prozess geerbten, und darauf eingehende Nachrichten durchlaufen die Steuerung eingehender Nachrichten der Sitzung. env-Blöcke in Einstellungen können sie nicht setzen. Erfordert Claude Code v2.1.224 oder höher
CLAUDE_CODE_MESSAGING_TOKEN Wird von Claude Code gesetzt, nicht von Ihnen: In Sitzungen, die einen Inbox-Socket binden, exportiert Claude Code dieses sitzungsspezifische Token zusammen mit CLAUDE_CODE_MESSAGING_SOCKET an Hooks und Bash-Befehle. Ein Skript, das an den Socket sendet, kann {"type":"auth","token":"<token>"} als erste Zeile senden, um nachzuweisen, dass es zur Sitzung gehört. Unter nativem Windows verlangt Claude Code diese Zeile und schließt jede Verbindung, die nicht mit einer gültigen Zeile beginnt. Die Regeln für eigene Kindprozesse legen fest, wann Claude Code das Token heranzieht. Jede Sitzung exportiert ihr eigenes Token, niemals eines, das von einer übergeordneten Sitzung geerbt wurde. env-Blöcke in Einstellungen können es nicht setzen. Erfordert Claude Code v2.1.228 oder höher
CLAUDE_CODE_NATIVE_CURSOR Auf 1 setzen, um an der Eingabemarke den eigenen Cursor des Terminals statt eines gezeichneten Blocks anzuzeigen. Der Cursor berücksichtigt die Einstellungen des Terminals für Blinken, Form und Fokus
CLAUDE_CODE_NEW_INIT Auf 1 setzen, damit /init einen interaktiven Einrichtungsablauf ausführt. Der Ablauf fragt, welche Dateien generiert werden sollen, darunter CLAUDE.md, Skills und Hooks, bevor die Codebasis untersucht und die Dateien geschrieben werden. Ohne diese Variable generiert /init automatisch eine CLAUDE.md, ohne nachzufragen
CLAUDE_CODE_NONBLOCKING_STDOUT Auf 1 setzen, um Terminal-Ausgabe über einen zweiten, nicht blockierenden Dateideskriptor zu schreiben, damit ein Terminal, das nicht mehr liest, etwa ein pausierter tmux-Bereich im Control Mode oder eine hängende SSH-Verbindung, Claude Code nicht mitten in der Sitzung einfrieren kann. Gilt unter macOS, Linux und WSL, wenn stdout ein Terminal ist. Erfordert Claude Code v2.1.261 oder höher
CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES Begrenzt, wie oft Claude Code eine nicht gestreamte Anfrage, bei der ein Timeout auftritt, erneut sendet. Mit 0 schlägt die Anfrage beim ersten Timeout fehl. Standardmäßig nicht gesetzt, sodass CLAUDE_CODE_MAX_RETRIES diese erneuten Sendungen begrenzt. Informationen zum Timeout finden Sie unter Wiederholungsverhalten anpassen. Erfordert Claude Code v2.1.285 oder höher
CLAUDE_CODE_NO_FLICKER Auf 1 setzen, um das Vollbild-Rendering zu aktivieren, eine Research Preview, die Flackern reduziert und den Speicherverbrauch in langen Konversationen konstant hält. Überschreibt die Einstellung tui; Sie können auch mit /tui fullscreen umschalten
CLAUDE_CODE_OAUTH_REFRESH_TOKEN OAuth-Refresh-Token für die Claude.ai-Authentifizierung. Wenn gesetzt, tauscht claude auth login dieses Token direkt ein, statt einen Browser zu öffnen. Erfordert CLAUDE_CODE_OAUTH_SCOPES. Nützlich für die Bereitstellung der Authentifizierung in automatisierten Umgebungen
CLAUDE_CODE_OAUTH_SCOPES Durch Leerzeichen getrennte OAuth-Scopes, mit denen das Refresh-Token ausgestellt wurde, etwa "user:profile user:inference user:sessions:claude_code". Erforderlich, wenn CLAUDE_CODE_OAUTH_REFRESH_TOKEN gesetzt ist
CLAUDE_CODE_OAUTH_TOKEN OAuth-Zugriffstoken für die claude.ai-Authentifizierung. Alternative zu /login für SDK- und automatisierte Umgebungen. Hat Vorrang vor im Schlüsselbund gespeicherten Anmeldedaten. Generieren Sie eines mit claude setup-token. Sofern Sie nicht /login ausführen, verwendet Claude Code das von Ihnen gesetzte Token für die gesamte Sitzung. Um ein abgelaufenes Token zu ersetzen, generieren Sie ein neues und starten Sie neu
CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE In v2.1.160 entfernt und jetzt wirkungslos. Legte früher den Fast-Modus auf Claude Opus 4.6 statt auf den aktuellen Standard fest. Opus 4.6 unterstützt den Fast-Modus nicht mehr
CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH Maximale Länge inhaltstragender OpenTelemetry-Attribute (Modellantworten, Tool-Inhalte, System-Prompts, rohe API-Bodys) einschließlich Kürzungsmarkierung, in UTF-16-Codeeinheiten (Standard: 61440, d. h. 60 KB). Erhöhen Sie den Wert nur, wenn Ihr Telemetrie-Backend Attributwerte über 64 KB akzeptiert, oder verringern Sie ihn, um das Telemetrievolumen zu reduzieren. Erfordert Claude Code v2.1.214 oder höher. Siehe Überwachung
CLAUDE_CODE_OTEL_DIAG_STDERR Auf 1 setzen, um Diagnosefehler des OpenTelemetry-Exporters nach stderr zu schreiben. Standardmäßig erscheinen diese Fehler nur mit --debug, sodass ein falsch konfigurierter Exporter, etwa bei einer Prometheus-Portkollision, andernfalls unbemerkt fehlschlägt. Erfordert Claude Code v2.1.179 oder höher. Siehe Überwachung
CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS Timeout in Millisekunden für das Leeren ausstehender OpenTelemetry-Spans (Standard: 5000). Siehe Überwachung
CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS Intervall für die Aktualisierung dynamischer OpenTelemetry-Header in Millisekunden (Standard: 1740000 / 29 Minuten). Siehe Dynamische Header
CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS Timeout in Millisekunden, innerhalb dessen der OpenTelemetry-Exporter beim Herunterfahren fertig sein muss (Standard: 2000). Erhöhen Sie den Wert, wenn Metriken beim Beenden verloren gehen. Siehe Überwachung
CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE Auf 1 setzen, damit Claude Code den Upgrade-Befehl Ihres Paketmanagers im Hintergrund ausführt, wenn eine neue Version verfügbar ist. Gilt für Homebrew- und WinGet-Installationen. Andere Paketmanager zeigen weiterhin den Upgrade-Befehl an, ohne ihn auszuführen. Siehe Automatische Updates
CLAUDE_CODE_PERFORCE_MODE Auf 1 setzen, um einen Perforce-kompatiblen Schreibschutz zu aktivieren. Wenn gesetzt, schlagen Edit, Write und NotebookEdit mit dem Hinweis p4 edit <file> fehl, wenn der Zieldatei das Schreibbit für den Eigentümer fehlt, das Perforce bei synchronisierten Dateien entfernt, bis p4 edit sie öffnet. Dadurch wird verhindert, dass Claude Code die Änderungsverfolgung von Perforce umgeht
CLAUDE_CODE_PLUGIN_CACHE_DIR Überschreibt das Stammverzeichnis für Plugins. Anders als der Name vermuten lässt, legt dies das übergeordnete Verzeichnis fest, nicht den Cache selbst: Marketplaces und der Plugin-Cache liegen in Unterverzeichnissen unter diesem Pfad. Standardmäßig ~/.claude/plugins
CLAUDE_CODE_PLUGIN_DIRS Plugin-Verzeichnisse, die für die Sitzung geladen werden, jeweils so, wie ein --plugin-dir-Flag sie lädt. Trennen Sie mehrere Pfade mit : unter Unix oder ; unter Windows. Geben Sie jeden Pfad als absoluten Pfad an oder beginnen Sie ihn mit ~, da Claude Code relative Pfade überspringt. Erfordert Claude Code v2.1.280 oder höher. Siehe Ein Plugin für eine Sitzung laden
CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS Timeout in Millisekunden für das Klonen oder Aktualisieren eines Plugin-Marketplace (Standard: 120000). Erhöhen Sie diesen Wert bei großen Repositorys oder langsamen Netzwerkverbindungen. Siehe Git clone timed out
CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE Auf 1 setzen, um den erneuten Klonversuch zu überspringen und den vorhandenen Marketplace-Checkout weiter zu verwenden, wenn eine Marketplace-Aktualisierung das Remote nicht erreichen oder sich dort nicht authentifizieren kann. Nützlich in Offline- oder Air-Gap-Umgebungen, in denen ein erneutes Klonen auf dieselbe Weise fehlschlagen würde. Siehe Marketplace-Updates schlagen in Offline-Umgebungen fehl
CLAUDE_CODE_PLUGIN_PREFER_HTTPS Auf 1 setzen, um GitHub-Quellen in der Kurzform owner/repo über HTTPS statt über SSH zu klonen. Gilt für die Installation und Aktualisierung von Plugins sowie für /plugin marketplace add und update. Nützlich in CI-Runnern, Containern oder jeder Umgebung ohne konfigurierten SSH-Schlüssel für github.com
CLAUDE_CODE_PLUGIN_SEED_DIR Pfad zu einem oder mehreren schreibgeschützten Plugin-Seed-Verzeichnissen, getrennt durch : unter Unix oder ; unter Windows. Verwenden Sie dies, um ein vorbefülltes Plugin-Verzeichnis in ein Container-Image einzubinden. Claude Code registriert beim Start Marketplaces aus diesen Verzeichnissen und verwendet vorab zwischengespeicherte Plugins ohne erneutes Klonen. Siehe Plugins für Container vorbefüllen
CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY Auf 1 setzen, damit Claude Code beim Starten von PowerShell für Tool-Aufrufe, Hooks und Statuszeilenbefehle nicht mehr -ExecutionPolicy Bypass übergibt und stattdessen die effektive Ausführungsrichtlinie des Rechners berücksichtigt. Standardmäßig umgeht Claude Code die Ausführungsrichtlinie auf Prozessebene, damit .ps1-Skripte und Modulimporte auf Windows-Installationen mit der Standardeinstellung Restricted funktionieren. Die Umgehung auf Prozessebene überschreibt unabhängig von dieser Einstellung niemals die Gruppenrichtlinien MachinePolicy oder UserPolicy
CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS Obergrenze in Millisekunden für das Warten im Leerlauf auf Hintergrundarbeit wie Subagenten und Workflows nach dem letzten Turn im nicht interaktiven Modus mit dem Flag -p. Das Warten im Leerlauf beginnt jedes Mal von vorn, wenn Claude einen Turn nutzt, um ein Hintergrundergebnis zu verarbeiten. Standard: 600000, also 10 Minuten. Wenn das Warten im Leerlauf die Obergrenze erreicht, wartet Claude Code nicht länger auf die verbleibenden Hintergrundaufgaben und beendet sich. Auf 0 setzen, um unbegrenzt zu warten. Diese Obergrenze ist unabhängig von der fünfsekündigen Karenzzeit, die für einfache Hintergrund-Shells gilt. Erfordert Claude Code v2.1.182 oder höher
CLAUDE_CODE_PROCESS_WRAPPER Startet die Prozesse, die Claude Code aus seiner eigenen Binärdatei startet, etwa den Hintergrunddienst, der Agent View-Sitzungen hostet, über einen Unternehmens-Launcher, der als argv-Präfix wie /opt/corp/launcher angegeben wird. Setzen Sie die Variable im env-Block der Benutzereinstellungen oder der verwalteten Einstellungen, nicht als Shell-Export, damit der losgelöste Hintergrunddienst sie erbt; Projekt- und lokale Einstellungen können sie nicht setzen. Entspricht der Einstellung processWrapper, die Claude Code v2.1.210 oder höher erfordert; diese Variable hat Vorrang, wenn beide gesetzt sind. Die VS Code-Erweiterung konfiguriert ihren eigenen Launcher separat über ihre Einstellung claudeProcessWrapper. Wird unter Windows ignoriert. Unter Claude Code hinter einem Unternehmens-Launcher ausführen finden Sie das Werteformat, was der Launcher abdeckt und welche Anforderungen der Launcher erfüllen muss. Erfordert Claude Code v2.1.208 oder höher
CLAUDE_CODE_PROJECT_DIR_NAME Zusammen mit CLAUDE_CONFIG_DIR setzen, um den Verzeichnisnamen unter projects/ zu wählen, unter dem Claude Code die Transkripte und das Auto-Memory dieser Sitzung speichert, anstelle eines aus dem Pfad des Arbeitsverzeichnisses abgeleiteten Namens. Wenn Sie Claude Code beispielsweise mit CLAUDE_CONFIG_DIR=/srv/tenant-a CLAUDE_CODE_PROJECT_DIR_NAME=work claude starten, werden sie unter /srv/tenant-a/projects/work/ gespeichert. Claude Code ignoriert diese Variable, wenn CLAUDE_CONFIG_DIR nicht gesetzt ist, und liest sie nur aus der Umgebung, aus der Sie claude starten, niemals aus einem env-Block einer Einstellungsdatei. Siehe Das Projektverzeichnis selbst benennen. Erfordert Claude Code v2.1.234 oder höher
CLAUDE_CODE_PROMPT_CACHE_TTL Setzen Sie 5m oder 1h, die einzigen Werte, die Claude Code akzeptiert, um die Prompt-Cache-TTL für die Hauptkonversation zu wählen: Ihre interaktiven, -p- und SDK-Turns sowie die Hilfsprozesse, die inline mit ihnen laufen. Hat Vorrang vor der Einstellung promptCacheTtl und vor ENABLE_PROMPT_CACHING_1H, und FORCE_PROMPT_CACHING_5M überschreibt sie. Die API berechnet Cache-Schreibvorgänge mit einer Stunde Gültigkeit zu einem höheren Satz. Erfordert Claude Code v2.1.242 oder höher
CLAUDE_CODE_PROPAGATE_TRACEPARENT Auf 1 setzen, um den W3C-Trace-Kontext weiterzugeben, wenn ANTHROPIC_BASE_URL auf einen benutzerdefinierten Proxy zeigt. Die Weitergabe umfasst den Header traceparent bei Modell- und HTTP-MCP-Anfragen sowie die Umgebungsvariable TRACEPARENT für Bash-, PowerShell- und Hook-Unterprozesse. Standardmäßig ist die Weitergabe nur bei einer direkten Verbindung zur Anthropic API aktiviert. Hinzugefügt in v2.1.152. Siehe Traces (Beta)
CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST Wird von Host-Plattformen gesetzt, die Claude Code einbetten und das Routing zum Modellanbieter in dessen Auftrag verwalten. Wenn gesetzt, ignoriert Claude Code Variablen für Anbieterauswahl, Endpunkt und Authentifizierung wie CLAUDE_CODE_USE_BEDROCK, ANTHROPIC_BASE_URL und ANTHROPIC_API_KEY in Einstellungsdateien, sodass Benutzereinstellungen das Routing des Hosts nicht überschreiben können. Claude Code ignoriert außerdem Schlüssel zur Modellauswahl wie model, fallbackModel und modelOverrides in verwalteten Einstellungen, unabhängig davon, welche verwaltete Quelle sie bereitstellt, sodass die Modellkonfiguration des Hosts Vorrang vor einer veralteten verwalteten Modellfestlegung hat. Claude Code ignoriert außerdem Variablen zur Modellauswahl wie ANTHROPIC_MODEL und die Familie ANTHROPIC_DEFAULT_*_MODEL in einem verwalteten env-Block; eine availableModels-Allowlist in verwalteten Einstellungen gilt weiterhin, sofern der Host keine eigene bereitstellt. Claude Code überspringt außerdem die automatische Telemetrie-Abmeldung, die es sonst bei Drittanbietern wie Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform und Microsoft Foundry anwendet, sodass die Telemetrie der standardmäßigen Abmeldung über DISABLE_TELEMETRY folgt. Siehe Standardverhalten nach API-Anbieter
CLAUDE_CODE_PROXY_RESOLVES_HOSTS Auf 1 setzen, damit der Proxy die DNS-Auflösung anstelle des Aufrufers durchführt. Opt-in für Umgebungen, in denen der Proxy die Auflösung von Hostnamen übernehmen soll
CLAUDE_CODE_REMOTE Wird automatisch auf true gesetzt, wenn Claude Code als Cloud-Sitzung läuft. Lesen Sie diesen Wert in einem Hook oder Setup-Skript aus, um festzustellen, ob Sie sich in einer Cloud-Sitzung befinden
CLAUDE_CODE_REMOTE_SESSION_ID Wird in Cloud-Sitzungen automatisch auf die ID der aktuellen Sitzung gesetzt. Lesen Sie diesen Wert aus, um einen Link zurück zum Sitzungstranskript zu erstellen. Siehe Ausgabe mit der Sitzung verknüpfen
CLAUDE_CODE_RESTRICTED Auf 1 setzen, um die Sitzung im eingeschränkten Modus zu starten, genau wie bei Übergabe von --restricted. Claude Code ignoriert diese Variable im env-Block einer Einstellungsdatei. Erfordert Claude Code v2.1.248 oder höher
CLAUDE_CODE_RESUME_INTERRUPTED_TURN Auf 1 setzen, um automatisch fortzufahren, wenn die vorherige Sitzung mitten in einem Turn endete. Wird im SDK-Modus verwendet, damit das Modell fortfährt, ohne dass das SDK den Prompt erneut senden muss. Um dies zu deaktivieren, heben Sie die Variable auf oder setzen Sie sie auf 0. Für das Chat-Panel in VS Code siehe Konversationen nach einem Neuladen fortsetzen
CLAUDE_CODE_RESUME_INTERRUPTED_TURN_MAX_AGE_MS Maximales Alter in Millisekunden der letzten Transkriptnachricht, bis zu dem eine mitten in einem Turn beendete Sitzung beim Fortsetzen automatisch weiterläuft. Ist die letzte Nachricht älter als diese Grenze, überspringt Claude Code die automatische Fortsetzung durch CLAUDE_CODE_RESUME_INTERRUPTED_TURN und die zugehörige Fortsetzungsnachricht aus CLAUDE_CODE_RESUME_PROMPT, und die Sitzung startet im Leerlauf, sodass Sie explizit fortfahren. Nicht gesetzt oder 0 bedeutet keine Grenze, außer dass ein Turn, dessen letzte Anfrage mit einem API-Fehler fehlschlug, nur fortgesetzt wird, solange dieser Fehler weniger als sechs Stunden alt ist. Ein positiver Wert begrenzt jeden Turn, auch diese; ein negativer oder nicht numerischer Wert legt eine Grenze von einer Stunde fest. Startskripte für lang laufende Agenten können dies setzen, damit ein Neustart mit einem alten Transkript keinen veralteten Prompt erneut ausführt. Claude Code setzt selbst eine Grenze von einer Stunde, wenn es eine abgestürzte Agent View-Sitzung neu startet, die ihre Konversation von einer interaktiven Sitzung geerbt hat. Erfordert Claude Code v2.1.211 oder höher
CLAUDE_CODE_RESUME_PROMPT Überschreibt die Fortsetzungsnachricht, die Claude Code an Claude sendet, wenn CLAUDE_CODE_RESUME_INTERRUPTED_TURN einen unterbrochenen Turn fortsetzt, statt dessen Prompt erneut zu senden, oder wenn Sie einen zurückgestellten Tool-Aufruf mit -p fortsetzen. Standardmäßig Continue from where you left off.. Eine leere Zeichenkette verwendet den Standard
CLAUDE_CODE_RETRY_WATCHDOG Für unbeaufsichtigte Sitzungen wie Eval-Harnesses, CI-Jobs oder Remote-Worker auf 1 setzen. Versucht 429- und 529-Kapazitätsfehler unbegrenzt erneut, statt nach CLAUDE_CODE_MAX_RETRIES Versuchen fehlzuschlagen. Claude Code schlägt sofort fehl, wenn eine Anfrage mit Standardgeschwindigkeit einen 429 erhält, der ein Ausgabenlimit oder aufgebrauchtes Nutzungsguthaben meldet, selbst wenn er von einem Gateway-Ausgabenlimit stammt, das nach einem Zeitplan zurückgesetzt wird. Vor v2.1.239 versuchte der Watchdog diese unbegrenzt erneut. Für Anfragen im Fast-Modus siehe Rate-Limits handhaben. Der Watchdog wartet zwischen den Versuchen bis zu 5 Minuten oder bis zum Zurücksetzen des Limits, wenn die Antwort einen Rücksetzzeitpunkt für das Rate-Limit enthält, sodass eine Sitzung, die ein Nutzungslimit erreicht, das verbleibende Zeitfenster abwartet. Ab v2.1.199 erhöht er außerdem die Standardanzahl der Wiederholungsversuche für andere vorübergehende Fehler wie Serverfehler, Timeouts und abgebrochene Verbindungen auf 300, was etwa drei Stunden Backoff entspricht, und hebt die Obergrenze von 15 für CLAUDE_CODE_MAX_RETRIES auf, falls Sie diese Variable explizit setzen. Erfordert Claude Code v2.1.186 oder höher
CLAUDE_CODE_SAFE_MODE Auf 1 setzen, um im abgesicherten Modus zu starten: CLAUDE.md, Skills, Plugins, Hooks, MCP-Server, benutzerdefinierte Befehle und Agenten, Ausgabestile, Workflows, benutzerdefinierte Designs, benutzerdefinierte Tastenkombinationen, Statuszeilen- und Dateivorschlagsbefehle, LSP-Server und Auto-Memory werden nicht geladen, um eine fehlerhafte Konfiguration zu untersuchen. Die Richtlinie der verwalteten Einstellungen gilt weiterhin, einschließlich per Richtlinie konfigurierter Hooks, Statuszeilen- und Dateivorschlagsbefehle; verwaltete Plugins, verwaltete Skills, verwaltete CLAUDE.md und per Richtlinie konfigurierte MCP-Server hingegen nicht. Entspricht der Übergabe von --safe-mode. Direkt gestartete Kindprozesse erben die Variable
CLAUDE_CODE_SCRIPT_CAPS JSON-Objekt, das begrenzt, wie oft bestimmte Skripte pro Sitzung aufgerufen werden dürfen, wenn CLAUDE_CODE_SUBPROCESS_ENV_SCRUB gesetzt ist. Schlüssel sind Teilzeichenfolgen, die mit dem Befehlstext abgeglichen werden; Werte sind ganzzahlige Aufruflimits. Zum Beispiel erlaubt {"deploy.sh": 2}, dass deploy.sh höchstens zweimal aufgerufen wird. Der Abgleich basiert auf Teilzeichenfolgen, sodass Shell-Expansionstricks wie ./scripts/deploy.sh $(evil) trotzdem auf die Obergrenze angerechnet werden. Eine Auffächerung zur Laufzeit über xargs oder find -exec wird nicht erkannt; dies ist eine Defense-in-Depth-Maßnahme
CLAUDE_CODE_SCROLL_SPEED Legt den Multiplikator für das Scrollen mit dem Mausrad im Vollbild-Rendering fest. Akzeptiert jeden positiven Wert bis 20, einschließlich Bruchwerten unter 1 wie 0.5, um beschleunigtes Trackpad- und Mausrad-Scrollen in Terminals zu verlangsamen, die Mausrad-Events bereits verstärken. Auf 3 setzen, um dem Verhalten von vim zu entsprechen, wenn Ihr Terminal pro Raste ein Mausrad-Event ohne Verstärkung sendet. Wird im Terminal der JetBrains-IDE ignoriert, wo Claude Code eine eigene Scroll-Behandlung verwendet
CLAUDE_CODE_SEND_FEEDBACK Auf 0 setzen, um von Claude entworfenes Feedback für eine Sitzung zu deaktivieren. Auf 1 setzen, um es zu aktivieren, wenn Ihr Konto bereits Zugriff hat; die Variable kann selbst keinen Zugriff gewähren, und die anderen Schalter, die Feedback deaktivieren, wie DISABLE_FEEDBACK_COMMAND und der Wert off der Einstellung feedbackDrafts, gelten weiterhin
CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS Überschreibt das Zeitbudget in Millisekunden für SessionEnd-Hooks. Der Wert ist auch der Timeout für jeden Hook, der kein eigenes timeout festlegt. Gilt für das Beenden der Sitzung, /clear und das Wechseln von Sitzungen über interaktives /resume. Standardmäßig beträgt das Budget 1,5 Sekunden und wird automatisch auf das höchste in Einstellungsdateien konfigurierte timeout eines einzelnen Hooks angehoben, bis zu 60 Sekunden. Timeouts von Hooks aus Plugins erhöhen das Budget nicht
CLAUDE_CODE_SESSION_ID Wird in Unterprozessen des Bash- und PowerShell-Tools, in Unterprozessen von Hook-Befehlen und in Unterprozessen von stdio-MCP-Servern automatisch auf die aktuelle Sitzungs-ID gesetzt. Für Bash, PowerShell und Hooks entspricht dies dem Feld session_id in der JSON-Eingabe von Hooks und wird bei /clear aktualisiert. Ein MCP-Server-Unterprozess behält die ID, mit der er gestartet wurde. Bei --resume <session-id> erhält er die fortgesetzte ID, passend zu Hooks und Bash. Bei --continue oder --resume ohne explizite ID erhält er möglicherweise stattdessen die ursprüngliche Start-ID. Verwenden Sie dies, um Skripte und externe Tools mit der Claude Code-Sitzung zu korrelieren, die sie gestartet hat
CLAUDE_CODE_SHELL Legt die Shell fest, die Claude Code zum Ausführen von Befehlen des Bash-Tools verwendet. Akzeptiert einen Pfad zu einer bash- oder zsh-Binärdatei, zum Beispiel /opt/homebrew/bin/bash. Andere Shells wie fish werden nicht unterstützt. Ist der Wert kein funktionierender bash- oder zsh-Pfad, ignoriert Claude Code ihn und greift auf die automatische Erkennung zurück. Die automatische Erkennung verwendet Ihre $SHELL, wenn sie auf bash oder zsh zeigt; andernfalls wählt sie die erste funktionierende zsh und danach bash, die in Ihrem PATH und an Standard-Installationsorten gefunden wird
CLAUDE_CODE_SHELL_PREFIX Befehlspräfix, das Shell-Befehle umschließt, die Claude Code startet: Aufrufe des Bash-Tools, Hook-Befehle, Statuszeilen-Befehle und Startbefehle von stdio-MCP-Servern. PowerShell-Hooks und Hooks in Exec-Form laufen ohne das Präfix. Nützlich für Logging oder Auditing. Ein reiner Pfad zu einer ausführbaren Datei wie /path/to/logger.sh führt jeden Befehl als /path/to/logger.sh '<command>' aus. Der Wrapper erhält die Befehlszeile als einzelnes, für die Shell maskiertes Argument in $1, daher muss der Wrapper $1 mit einer Shell erneut auswerten, zum Beispiel exec bash -c "$1". Wird $1 als reiner Pfad zu einer ausführbaren Datei behandelt, funktionieren stdio-MCP-Server nicht mehr, die Argumente wie npx -y <package> übergeben. Bei Aufrufen des Bash-Tools enthält $1 den vollständigen Shell-Aufruf, den Claude Code zusammensetzt, einschließlich der Umgebungseinrichtung, nicht nur den Befehl, den Claude ausgeführt hat
CLAUDE_CODE_SIMPLE Auf 1 setzen, um mit einem minimalen System-Prompt und nur den Tools Bash, Datei lesen und Datei bearbeiten zu arbeiten. MCP-Tools aus --mcp-config sind weiterhin verfügbar. Deaktiviert die automatische Erkennung von Hooks, Skills, benutzerdefinierten Befehlen, Subagenten, installierten Plugins, MCP-Servern, Auto-Memory und CLAUDE.md. Skills in einem Verzeichnis, das Sie mit --add-dir übergeben, werden weiterhin geladen. OAuth-Token und Anmeldedaten aus dem Schlüsselbund werden nicht gelesen, daher muss die Anthropic-Authentifizierung über ANTHROPIC_API_KEY oder einen apiKeyHelper in --settings erfolgen. Entspricht der Übergabe von --bare
CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT Auf 1 setzen, um bei jedem Modell einen kürzeren System-Prompt und gekürzte Tool-Beschreibungen zu verwenden. Auf 0, false, no oder off setzen, um dies selbst bei Modellen abzulehnen, bei denen das Experiment oder die Serverkonfiguration es sonst aktivieren würde. Der vollständige Tool-Satz, Hooks, MCP-Server und die CLAUDE.md-Erkennung bleiben aktiviert
CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH Überspringt die clientseitige Authentifizierung für Claude Platform on AWS, für Gateways, die Anfragen selbst signieren
CLAUDE_CODE_SKIP_AWS_CRED_CACHE Auf 1 setzen, um den prozessinternen Cache für Anmeldedaten zu deaktivieren, die aus der AWS-Standardkette der Anmeldedatenanbieter aufgelöst werden, sodass Claude Code die Kette bei jeder API-Anfrage auflöst. Bei deaktiviertem Cache fordert ein SSO-gestütztes Profil bei jeder Anfrage Anmeldedaten von IAM Identity Center an. Siehe Zwischenspeicherung von Anmeldedaten und Timeout für die Auflösung. Erfordert Claude Code v2.1.207 oder höher
CLAUDE_CODE_SKIP_BEDROCK_AUTH Überspringt die AWS-Authentifizierung für Amazon Bedrock (zum Beispiel bei Verwendung eines LLM-Gateways)
CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS Auf 1 setzen, um eine fehlgeschlagene Verfügbarkeitsprüfung für den Fast-Modus als verfügbar zu behandeln, für Netzwerke, die die direkte Anfrage der Prüfung an api.anthropic.com blockieren. Claude Code berücksichtigt weiterhin eine Antwort „disabled by your organization“
CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK Auf 1 setzen, um die clientseitige Verfügbarkeitsprüfung für den Fast-Modus zu überspringen, für Proxys, die die Anfrage der Prüfung abfangen, statt sie abzulehnen. Die API lehnt Anfragen im Fast-Modus weiterhin ab, wenn Ihre Organisation den Fast-Modus deaktiviert hat
CLAUDE_CODE_SKIP_FOUNDRY_AUTH Überspringt die Azure-Authentifizierung für Microsoft Foundry, für einen Proxy oder ein Gateway, das einen eigenen Authorization-Header einfügt. Claude Code sendet Anfragen ohne Azure-Anmeldedaten und behält den von Ihnen bereitgestellten Authorization-Header bei, zum Beispiel über ANTHROPIC_CUSTOM_HEADERS. Wird ignoriert, wenn ANTHROPIC_FOUNDRY_API_KEY oder ANTHROPIC_FOUNDRY_AUTH_TOKEN gesetzt ist. Vor v2.1.203 führte diese Variable dazu, dass der Microsoft Foundry-Client keine Anfragen senden konnte, sofern nicht zusätzlich ein API-Schlüssel gesetzt war
CLAUDE_CODE_SKIP_MANTLE_AUTH Überspringt die AWS-Authentifizierung für Amazon Bedrock Mantle (zum Beispiel bei Verwendung eines LLM-Gateways)
CLAUDE_CODE_SKIP_MODEL_ACCESS_MEMORY Die Modellprüfungen beim Start bei Amazon Bedrock und Google Cloud's Agent Platform merken sich auf diesem Rechner bis zu einen Tag lang, bei welchen Modellen sie festgestellt haben, dass Ihr Konto sie nicht aufrufen kann. Auf 1 setzen, um dieses Merken zu deaktivieren. Erfordert Claude Code v2.1.285 oder höher
CLAUDE_CODE_SKIP_PROMPT_HISTORY Auf 1 setzen, um das Schreiben von Prompt-Verlauf und Sitzungstranskripten auf die Festplatte zu überspringen. Sitzungen, die mit gesetzter Variable gestartet werden, erscheinen nicht in --resume, --continue oder im Verlauf über die Pfeil-nach-oben-Taste. Nützlich für kurzlebige, skriptgesteuerte Sitzungen
CLAUDE_CODE_SKIP_VERTEX_AUTH Überspringt die Google-Authentifizierung für Google Cloud's Agent Platform (zum Beispiel bei Verwendung eines LLM-Gateways)
CLAUDE_CODE_STARTUP_FAILURE_RESULTS Auf 1 setzen, damit eine mit --output-format stream-json gestartete Sitzung bei Startfehlern, die sonst nur mit einer Ausgabe auf stderr enden, eine Ergebnisnachricht schreibt, die den Grund nennt, warum Claude Code den Start verweigert hat. Erfordert Claude Code v2.1.274 oder höher
CLAUDE_CODE_STOP_HOOK_BLOCK_CAP Maximale Anzahl aufeinanderfolgender Male, die ein Stop- oder SubagentStop-Hook das Beenden des Turns blockieren darf, bevor Claude Code ihn überschreibt und den Turn trotzdem beendet (Standard: 8). Auf 0 setzen, um die Obergrenze zu deaktivieren. Erhöhen Sie den Wert, wenn Ihr Hook berechtigterweise mehr Iterationen zur Auflösung benötigt
CLAUDE_CODE_SUBAGENT_MODEL Das Standardmodell für Subagenten, Teammitglieder eines Agent-Teams und Workflow-Agenten, denen kein Modell auf andere Weise zugewiesen ist. Akzeptiert einen Alias wie haiku oder einen vollständigen Modellnamen. Zwei Quellen haben Vorrang davor: ein Modell, das Claude beim Starten des Agenten übergibt, und ein model-Feld in der Definition des Agenten, einschließlich inherit. Um dies zu ändern, setzen Sie CLAUDE_CODE_SUBAGENT_MODEL_FORCE. Die vollständige Reihenfolge finden Sie unter Ein Modell wählen. Das Setzen auf inherit entspricht dem Nichtsetzen. Vor v2.1.251 überschrieb diese Variable sowohl das Modell pro Aufruf als auch das model-Feld der Definition
CLAUDE_CODE_SUBAGENT_MODEL_FORCE Auf 1 setzen, um Subagenten, Teammitgliedern und Workflow-Agenten ein einziges Modell vorzugeben. Welches Modell das ist, erfahren Sie unter Jeden Subagenten mit einem Modell ausführen. Erfordert Claude Code v2.1.257 oder höher
CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL Setzen Sie 5m oder 1h, die einzigen Werte, die Claude Code akzeptiert, um die Prompt-Cache-TTL für Anfragen außerhalb der Hauptkonversation zu wählen, etwa Subagenten, Workflows und Hintergrundarbeit. Hat Vorrang vor der Einstellung subagentPromptCacheTtl und vor ENABLE_PROMPT_CACHING_1H, und FORCE_PROMPT_CACHING_5M überschreibt sie. Die API berechnet Cache-Schreibvorgänge mit einer Stunde Gültigkeit zu einem höheren Satz. Erfordert Claude Code v2.1.242 oder höher
CLAUDE_CODE_SUBPROCESS_ENV_SCRUB Auf 1 setzen, um Anmeldedaten aus den Umgebungen der Unterprozesse zu entfernen, die Claude Code startet, etwa Bash-Befehle, Hooks und stdio-MCP-Server. Die Bereinigung erkennt Anmeldedaten am Variablennamen oder am Wert und lässt GitHub-Token und Proxy-Einstellungen unverändert. Siehe Was die Bereinigung der Unterprozessumgebung entfernt. claude-code-action setzt dies automatisch, wenn allowed_non_write_users konfiguriert ist
CLAUDE_CODE_SYNC_PLUGIN_INSTALL Im nicht interaktiven Modus (Flag -p) auf 1 setzen, um vor der ersten Abfrage auf den Abschluss der Plugin-Installation zu warten. Ohne diese Variable werden Plugins im Hintergrund installiert und sind beim ersten Turn möglicherweise nicht verfügbar. Kombinieren Sie dies mit CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS, um die Wartezeit zu begrenzen
CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS Timeout in Millisekunden für die synchrone Plugin-Installation. Bei Überschreitung fährt Claude Code ohne Plugins fort und protokolliert einen Fehler. Kein Standardwert: Ohne diese Variable wartet die synchrone Installation bis zum Abschluss
CLAUDE_CODE_SYNC_SKILLS Im nicht interaktiven Modus mit dem Flag -p auf 1 setzen, damit Claude Code in diesem Lauf die für Ihr claude.ai-Konto aktivierten Skills herunterlädt und bis zu CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS auf deren Liste wartet, bevor es die erste Abfrage ausführt. Die Downloads selbst werden im Hintergrund abgeschlossen, und Claude wartet auf den Download eines Skills, wenn es diesen Skill aufruft. Erfordert die claude.ai-Authentifizierung. Terminal-Sitzungen, in denen Sie sich mit Ihrem claude.ai-Konto anmelden, laden diese Skills auch ohne diese Variable nach ~/.claude/skills/synced/ herunter und synchronisieren sie etwa alle 10 Minuten neu. Setzen Sie sie daher nur, wenn ein -p-Lauf Ihre aktuellen Skills bereits bei der ersten Abfrage benötigt. Vor v2.1.273 luden Terminal-Sitzungen sie nur in einem -p-Lauf mit gesetzter Variable herunter. Der Ordnername synced ist für diesen Download reserviert. Vor v2.1.227 wurden die Skills direkt nach ~/.claude/skills/ heruntergeladen. Claude Code wendet zusätzliche Regeln auf die heruntergeladenen Skills an, etwa dass ihre !-Befehle nicht auf Ihrem Rechner ausgeführt werden
CLAUDE_CODE_SYNC_SKILLS_INSTALL_TIMEOUT_MS Timeout in Millisekunden für die Neusynchronisierung der Skills, die mitten in der Sitzung läuft, wenn eine auf dem Agent SDK basierende App Skills neu lädt (Standard: 30000). Bei Überschreitung fährt das Neuladen mit den bereits eingetroffenen Skills fort, und die verbleibenden Downloads werden im Hintergrund abgeschlossen
CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS Timeout in Millisekunden, wie lange die erste Abfrage auf die anfängliche Skill-Liste wartet, wenn CLAUDE_CODE_SYNC_SKILLS gesetzt ist (Standard: 5000). Bei Überschreitung läuft die erste Abfrage mit den bereits eingetroffenen Skills. Die Downloads werden in jedem Fall im Hintergrund abgeschlossen, und Claude wartet auf den Download eines Skills, wenn es diesen Skill aufruft
CLAUDE_CODE_SYNTAX_HIGHLIGHT Auf false setzen, um die Syntaxhervorhebung in der Diff-Ausgabe zu deaktivieren. Nützlich, wenn Farben Ihre Terminal-Einrichtung stören. Um die Hervorhebung auch in Codeblöcken und Dateivorschauen zu deaktivieren, verwenden Sie die Einstellung syntaxHighlightingDisabled
CLAUDE_CODE_TASK_LIST_ID Teilt eine Aufgabenliste über Sitzungen hinweg. Setzen Sie dieselbe ID in mehreren Claude Code-Instanzen, um sich in Sitzungen mit den Task-Tools über eine gemeinsame Aufgabenliste abzustimmen. Siehe Aufgabenliste
CLAUDE_CODE_TEAM_TEARDOWN_PARK_TIMEOUT_MS Überschreibt in Millisekunden, wie lange eine nicht interaktive Sitzung beim Beenden wartet, bis ihr Agent-Team vollständig abgebaut ist. Akzeptiert 1000 bis 60000; ein Wert außerhalb dieses Bereichs wird ignoriert, und der Standard von 10000 gilt. Erfordert Claude Code v2.1.206 oder höher
CLAUDE_CODE_TMPDIR Überschreibt das temporäre Verzeichnis für interne temporäre Dateien. Claude Code hängt unter Unix /claude-{uid}/ an diesen Pfad an, unter Windows /claude/. Standard: /tmp unter macOS, os.tmpdir() unter Linux und Windows. Unter macOS und Linux erhalten in einer Sandbox ausgeführte Bash-Unterprozesse ein kurzes Fallback-$TMPDIR unter dem Systemstandard, wenn Ihre Überschreibung ein langer Pfad ist, da einige Tools fehlschlagen, wenn temporäre Pfade zu lang werden. Bash-Befehle ohne Sandbox erben das $TMPDIR Ihrer Shell, wenn es gesetzt ist. Wenn Ihre Shell unter nativem Windows kein $TMPDIR setzt, erhält ein Bash-Befehl, der $TMPDIR referenziert, Ihre Überschreibung oder %TEMP%, wenn Sie keine gesetzt haben. Die eigenen temporären Dateien von Claude Code verwenden immer Ihre Überschreibung. Setzen Sie die Variable in Ihrer Shell, in den Benutzereinstellungen oder in verwalteten Einstellungen. Wird in Projekt- und lokalen Einstellungen ignoriert
CLAUDE_CODE_TMUX_TRUECOLOR Auf einen beliebigen nicht leeren Wert wie 1 setzen, um 24-Bit-Truecolor-Ausgabe in tmux zu erlauben. Das Setzen auf 0 oder false erlaubt weiterhin Truecolor, anders als bei den meisten Ein/Aus-Variablen; heben Sie die Variable auf, um die Begrenzung auf 256 Farben wiederherzustellen. Standardmäßig begrenzt Claude Code auf 256 Farben, wenn $TMUX gesetzt ist, da tmux Truecolor-Escape-Sequenzen nicht durchreicht, sofern es nicht entsprechend konfiguriert ist. Setzen Sie dies, nachdem Sie set -ga terminal-overrides ',*:Tc' zu Ihrer ~/.tmux.conf hinzugefügt haben. Weitere tmux-Einstellungen finden Sie unter Terminal-Konfiguration
CLAUDE_CODE_TOOL_MEMORY_CGROUP_EXCLUDE Unter Linux und WSL auf eine kommagetrennte Liste der Prozessarten setzen, die Claude Code von der Speicherobergrenze für Tools ausnimmt, etwa mcp oder lsp. Setzen Sie none, um jede Art zu begrenzen, oder all-new, um nur Befehle des Bash-, PowerShell- und Monitor-Tools zu begrenzen. Claude Code hält Befehle des Bash-, PowerShell- und Monitor-Tools unabhängig von Ihrer Liste unter der Obergrenze. Erfordert Claude Code v2.1.246 oder höher
CLAUDE_CODE_TOOL_MEMORY_LIMIT Unter Linux und WSL auf eine Größe wie 4G setzen, um den Arbeitsspeicher zu begrenzen, den Befehle des Bash- und PowerShell-Tools nutzen können, ab v2.1.246 auch Befehle des Monitor-Tools. Geben Sie die Größe in reinen Ziffern an, allein für eine Anzahl von Bytes oder mit einem Suffix K, M, G oder T. Setzen Sie 0 oder off, um die Obergrenze zu deaktivieren. Sobald der erste von Claude Code gestartete Prozess die Obergrenze aktiviert oder deaktiviert hat, wird ein geänderter Wert beim nächsten Start von claude wirksam. Erfordert Claude Code v2.1.233 oder höher
CLAUDE_CODE_TRANSCRIPT_LOCAL_GC Auf 1 setzen, um zu begrenzen, wie groß die Transkriptdatei einer langen -p- oder Agent SDK-Sitzung wird. Nach jeder Komprimierung entfernt Claude Code, sobald die Datei größer als 5 MB ist, den Verlauf aus der Zeit vor dieser Komprimierung. Beim Fortsetzen der Sitzung wird dieselbe Konversation wiederhergestellt, unabhängig davon, ob die Datei gekürzt wurde. Setzen Sie die Variable in der Umgebung, aus der Sie Claude Code starten, da ein env-Block in den Einstellungen sie nicht aktivieren kann. Erfordert Claude Code v2.1.287 oder höher
CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS Frist in Millisekunden, bevor Claude Code einen Dialog abbricht, den es an einen Remote-Client wie einen Remote Control- oder SDK-Host weiterleitet, oder den Genehmigungsdialog für eine zurückgehaltene sitzungsübergreifende Nachricht; Berechtigungsabfragen und AskUserQuestion-Fragen verwenden eigene Abläufe und unterliegen ihr nicht. Ab Claude Code v2.1.236 begrenzt sie außerdem die Einwilligungsabfrage für Fable-Nutzungsguthaben mitten in der Sitzung, wenn die Sitzung möglicherweise unbeaufsichtigt läuft. Eingehende Nachrichten steuern und Nicht interaktive Sitzungen beschreiben die vollständigen Ablaufregeln für zurückgehaltene Nachrichten, einschließlich der Fälle, in denen die Frist nicht gilt. Überschreibt die Einstellung dialogExpiry. 0 oder ein negativer Wert deaktiviert die Frist
CLAUDE_CODE_USE_ANTHROPIC_AWS Verwendet Claude Platform on AWS
CLAUDE_CODE_USE_BEDROCK Verwendet Amazon Bedrock
CLAUDE_CODE_USE_FOUNDRY Verwendet Microsoft Foundry
CLAUDE_CODE_USE_MANTLE Verwendet den Mantle-Endpunkt von Amazon Bedrock
CLAUDE_CODE_USE_NATIVE_FILE_SEARCH Auf 1 setzen, um benutzerdefinierte Befehle, Subagenten und Ausgabestile mit Node.js-Datei-APIs statt mit ripgrep zu erkennen. Setzen Sie dies, wenn die mitgelieferte ripgrep-Binärdatei in Ihrer Umgebung nicht verfügbar oder blockiert ist. Wirkt sich nicht auf Grep oder die Tools zur Dateisuche aus
CLAUDE_CODE_USE_POWERSHELL_TOOL Steuert das PowerShell-Tool. Unter Windows ohne Git Bash wird das Tool automatisch aktiviert; setzen Sie die Variable auf 0, um es zu deaktivieren. Unter Windows mit installiertem Git Bash ist das Tool für claude.ai- und Console-Konten standardmäßig aktiviert; setzen Sie die Variable auf 1, um es in Sitzungen mit Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry zu aktivieren, oder auf 0, um es zu deaktivieren. Unter Linux, macOS und WSL setzen Sie die Variable auf 1, um es zu aktivieren, was pwsh in Ihrem PATH erfordert. Wenn das Tool unter Windows aktiviert ist, kann Claude PowerShell-Befehle nativ ausführen, statt sie über Git Bash zu leiten. Siehe PowerShell-Tool
CLAUDE_CODE_USE_VERTEX Verwendet Google Cloud's Agent Platform
CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS Auf die Anzahl der Millisekunden setzen, die WebFetch die Antwort jeder abgerufenen URL im Cache behält. Der Standardwert ist 900000, also 15 Minuten. Akzeptiert nur reine Ziffern; 0, eine Dezimalzahl oder jede andere Schreibweise behält den Standardwert bei. Claude Code liest den Wert einmal pro Start, daher wird eine Änderung in einem env-Block der Einstellungen beim nächsten Start von claude wirksam. Erfordert Claude Code v2.1.233 oder höher
CLAUDE_CODE_WEBFETCH_DEADLINE_MS Obergrenze in Millisekunden dafür, wie lange WebFetch auf den Download einer Seite wartet, einschließlich aller Weiterleitungen, denen es folgt. Ein Download, der bis dahin nicht abgeschlossen ist, schlägt mit einem Deadline-Fehler fehl. Der Standardwert ist 300000, also fünf Minuten. Auf 0 setzen, um das Limit aufzuheben. Akzeptiert nur reine Ziffern; eine Dezimalzahl oder jede andere Schreibweise behält den Standardwert bei. Erfordert Claude Code v2.1.268 oder höher
CLAUDE_CODE_WORKER_CHECKIN_SCHEDULE Wenn CLAUDE_AUTO_BACKGROUND_TASKS auf 1 gesetzt ist: wie lange Claude Code vor jeder Erinnerung an Claude wartet, nach Hintergrund-Subagenten zu sehen, die noch laufen. Akzeptiert eine oder mehrere durch Kommas getrennte Wartezeiten in ganzen Sekunden von 1 bis 86400, etwa 600 oder 600,1800,3600. Jeder Wert ist die Wartezeit vor der nächsten Erinnerung, und der letzte Wert wiederholt sich. Akzeptiert nur reine Ziffern; jeder andere Wert und jede andere Schreibweise gilt als nicht gesetzt. Wenn nicht gesetzt, gibt es keine Erinnerungen. Erfordert Claude Code v2.1.283 oder höher
CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS Wie viele Agenten ein einzelner Workflow-Lauf gleichzeitig ausführt, von 1 bis 256. Standardmäßig führt ein Lauf bis zu 16 Agenten gleichzeitig aus, weniger, wenn Claude Code weniger CPUs zur Verfügung stehen; eingereihte agent()-Aufrufe warten auf einen freien Platz. Das Transkript jedes laufenden Agenten bleibt im Arbeitsspeicher von Claude Code, daher erhöhen höhere Werte den Speicherverbrauch. Akzeptiert nur reine Ziffern; Werte außerhalb des Bereichs und andere Schreibweisen behalten den Standardwert bei. Erfordert Claude Code v2.1.269 oder höher
CLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MS Obergrenze in Millisekunden dafür, wie lange ein Workflow-Agent darauf wartet, dass die erste Antwort eines Geschwister-Agenten mit demselben Präfix beginnt, bevor er seine eigene erste Anfrage sendet. Wenn ein Fan-out mehrere Agenten startet, die ein Prompt-Cache-Präfix teilen, hält Claude Code alle außer dem ersten Agenten bis zu dieser Dauer zurück, damit die übrigen das zwischengespeicherte Präfix lesen, statt es jeweils ohne Cache zu verarbeiten. Standard 5000. Auf 0 setzen, um das Warten zu deaktivieren. Wenn DISABLE_PROMPT_CACHING gesetzt ist, warten Agenten nie. Erfordert Claude Code v2.1.229 oder höher
CLAUDE_CONFIG_DIR Überschreibt das Konfigurationsverzeichnis (Standard: ~/.claude). Alle Einstellungen, der Sitzungsverlauf und Plugins werden unter diesem Pfad gespeichert. Informationen zu Anmeldedaten finden Sie unter wo Claude Code Anmeldedaten speichert. Nützlich, um mehrere Konten parallel zu verwenden: zum Beispiel alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'. Setzen Sie die Variable in Ihrer Shell, in den Benutzereinstellungen oder in verwalteten Einstellungen. Wird in Projekt- und lokalen Einstellungen ignoriert
CLAUDE_DISABLE_ADOPT Auf 1 setzen, um laufende Hintergrundarbeit zu stoppen, statt sie zu übernehmen, wenn Sie eine Sitzung durch Drücken von ← oder mit /background in den Hintergrund verschieben. Claude Code bittet Sie vor dem Verschieben in den Hintergrund um Bestätigung und stoppt dann die Aufgaben, die sonst übernommen würden. Erfordert Claude Code v2.1.195 oder höher
CLAUDE_EFFORT Wird in Subprozessen des Bash-Tools und in Hook-Befehlen automatisch auf die Effort-Stufe gesetzt, die beim Start des Subprozesses gilt: low, medium, high, xhigh oder max. Entspricht dem Feld effort.level, das an Hooks übergeben wird. Wird nur gesetzt, wenn das aktuelle Modell den Effort-Parameter unterstützt
CLAUDE_ENABLE_BYTE_WATCHDOG Auf 1 setzen, um den Streaming-Leerlauf-Watchdog auf Byte-Ebene zwangsweise zu aktivieren, oder auf 0, um ihn zwangsweise zu deaktivieren. 0 schaltet außerdem die First-Byte-Deadline auf den Verbindungen aus, auf denen diese Deadline läuft. Wenn nicht gesetzt, ist der Watchdog standardmäßig für direkte Verbindungen zur Anthropic API und zu Claude Platform on AWS aktiviert sowie für Streaming-Antworten auf Gateway-Verbindungen, die über ANTHROPIC_BASE_URL oder ANTHROPIC_AWS_BASE_URL erreicht werden; vor v2.1.222 lief er auf diesen Gateway-Verbindungen nicht, sodass der Watchdog auf Event-Ebene dort einen Stillstand melden konnte, obwohl Keep-alive-Pings eintrafen. Informationen zu Timeouts und zum Zusammenspiel der Timer finden Sie unter Streaming-Leerlauf-Watchdogs
CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK Auf 1 setzen, um den Streaming-Leerlauf-Watchdog auf Byte-Ebene für Amazon-Bedrock-Antworten vom Typ vnd.amazon.eventstream zu aktivieren, wodurch auch die First-Byte-Deadline für Bedrock-Streaming-Anfragen aktiviert wird. Standardmäßig deaktiviert. Konfigurieren Sie den Timeout mit CLAUDE_STREAM_IDLE_TIMEOUT_MS
CLAUDE_ENABLE_STREAM_WATCHDOG Auf 0 setzen, um den Streaming-Leerlauf-Watchdog auf Event-Ebene zwangsweise zu deaktivieren, oder auf 1, um ihn zwangsweise zu aktivieren. Wenn nicht gesetzt, ist der Watchdog standardmäßig für alle Anbieter aktiviert. Vor v2.1.196 wurde der Standardwert bei nicht gesetzter Variable auf der direkten Anthropic API serverseitig gesteuert und war bei anderen Anbietern deaktiviert. Konfigurieren Sie den Timeout mit CLAUDE_STREAM_IDLE_TIMEOUT_MS; Informationen zu den anderen Stillstands-Timern, die parallel zu diesem laufen, finden Sie unter Streaming-Leerlauf-Watchdogs
CLAUDE_ENV_FILE Pfad zu einem Shell-Skript, dessen Inhalt Claude Code vor jedem Bash-Befehl im selben Shell-Prozess ausführt, sodass Exporte in der Datei für den Befehl sichtbar sind. Verwenden Sie dies, um die Aktivierung von virtualenv oder conda über Befehle hinweg beizubehalten. Wird außerdem dynamisch von den Hooks SessionStart, Setup, CwdChanged und FileChanged befüllt
CLAUDE_JOB_DIR Wird von Claude Code in jeder Hintergrundsitzung auf das Verzeichnis ~/.claude/jobs/<id> dieser Sitzung gesetzt. Shell-Befehle, die die Sitzung ausführt, erben die Variable. Schreiben Sie temporäre Dateien nach $CLAUDE_JOB_DIR/tmp. Claudes Write- und Edit-Aufrufe dort fragen nicht nach Berechtigung, und das Verzeichnis wird entfernt, wenn die Sitzung gelöscht wird
CLAUDE_PID Claude Code setzt dies in den von ihm gestarteten Subprozessen auf seine eigene Prozess-ID: Befehle der Bash- und PowerShell-Tools sowie Hook-Befehle. Unter Linux verwendet die Shell-Integration des Bash-Tools die Variable, um ein pkill-Muster abzulehnen, das auf den Claude-Code-Prozess selbst zutreffen würde; siehe die Fehlerreferenz. Lesen Sie sie in Ihren eigenen Skripten aus, um den übergeordneten Claude-Code-Prozess gezielt zu identifizieren oder ihm Signale zu senden. Erfordert Claude Code v2.1.214 oder höher
CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX Präfix für automatisch generierte Namen von Remote Control-Sitzungen, wenn kein expliziter Name angegeben ist. Standardmäßig der Hostname Ihres Rechners, was Namen wie myhost-graceful-unicorn ergibt. Das CLI-Flag --remote-control-session-name-prefix setzt denselben Wert für einen einzelnen Aufruf
CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS Deadline in Millisekunden für das erste Antwort-Byte einer Streaming-Anfrage, auf den Verbindungen, auf denen die First-Byte-Deadline läuft. Wie Claude Code den Wert begrenzt, welche zusätzliche Zeit es für große Anfrage-Bodys hinzufügt und wie es die Deadline wählt, wenn Sie diese Variable nicht setzen, erfahren Sie unter No response from API. Erfordert Claude Code v2.1.242 oder höher
CLAUDE_STREAM_IDLE_TIMEOUT_MS Timeout in Millisekunden, bevor die Streaming-Leerlauf-Watchdogs auf Event- und Byte-Ebene eine stillstehende Verbindung schließen. Wenn Sie diese Variable explizit setzen, beträgt das Minimum 300000 (5 Minuten); niedrigere Werte werden stillschweigend angehoben, um längere Thinking-Pausen und Proxy-Pufferung abzufangen, und der Watchdog auf Byte-Ebene begrenzt den Wert auf 30 Minuten. CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS hat für den Watchdog auf Byte-Ebene Vorrang vor dieser Variable. Die Standardwerte der einzelnen Watchdogs bei nicht gesetzter Variable finden Sie unter Streaming-Leerlauf-Watchdogs
CLAUDE_SUBAGENT_BG_SHELL_MAX_MS In v2.1.260 entfernt und jetzt ohne Wirkung. Begrenzte zuvor in Millisekunden, wie lange ein von einem Subagenten gestarteter Shell-Befehl im Hintergrund laufen konnte, mit einem Standardwert von 60 Minuten. Siehe die Regeln zur Lebensdauer von Hintergrundbefehlen
DEBUG Auf 1 setzen, um den Debug-Modus zu aktivieren; entspricht dem Start mit --debug. Debug-Logs werden nach ~/.claude/debug/<session-id>.txt geschrieben oder in den Pfad, der mit CLAUDE_CODE_DEBUG_LOGS_DIR festgelegt ist. Nur die wahren Werte 1, true, yes und on aktivieren den Debug-Modus, sodass Namespace-Muster wie DEBUG=express:*, die für andere Tools gesetzt sind, ihn nicht auslösen
DISABLE_AUTOUPDATER Auf 1 setzen, um automatische Hintergrund-Updates zu deaktivieren. Manuelles claude update funktioniert weiterhin. Verwenden Sie DISABLE_UPDATES, um beides zu blockieren
DISABLE_AUTO_COMPACT Auf 1 setzen, um die automatische Komprimierung bei Annäherung an das Kontextlimit zu deaktivieren. Der manuelle Befehl /compact bleibt verfügbar. Verwenden Sie dies, wenn Sie explizit steuern möchten, wann die Komprimierung erfolgt. Überschreibt die Einstellung autoCompactEnabled
DISABLE_COMPACT Auf 1 setzen, um jegliche Komprimierung zu deaktivieren: sowohl die automatische Komprimierung als auch den manuellen Befehl /compact
DISABLE_COST_WARNINGS Auf 1 setzen, um Kostenwarnungen zu deaktivieren
DISABLE_DOCTOR_COMMAND Auf 1 setzen, um den Setup-Checkup-Skill /doctor und seinen Alias /checkup auszublenden. Nützlich für verwaltete Bereitstellungen, in denen Benutzer keine Setup-Diagnosen aus einer Sitzung heraus ausführen sollen. Wirkt sich nicht auf den Terminal-Befehl claude doctor aus. Vor v2.1.205 blendete diese Variable den Befehl /doctor für den Diagnosebildschirm aus
DISABLE_ERROR_REPORTING Auf einen beliebigen nicht leeren Wert wie 1 setzen, um die Fehlerberichterstattung abzulehnen. Auch das Setzen auf 0 oder false lehnt sie ab, anders als bei den meisten Ein/Aus-Variablen; entfernen Sie die Variable, um die Fehlerberichterstattung wieder einzuschalten
DISABLE_EXTRA_USAGE_COMMAND Auf 1 setzen, um den Befehl /usage-credits auszublenden, mit dem Benutzer zusätzliche Nutzung über die Rate-Limits hinaus erwerben können
DISABLE_FEEDBACK_COMMAND Auf 1 setzen, um den Befehl /feedback und von Claude entworfenes Feedback zu deaktivieren. Deaktiviert außerdem /bug und /share, die über denselben Weg melden; vor v2.1.212 waren sie Aliasse von /feedback, sodass der Befehl unter jedem Namen deaktiviert war. Der ältere Name DISABLE_BUG_COMMAND wird ebenfalls akzeptiert
DISABLE_GROWTHBOOK Auf 1 oder true setzen, um das Abrufen von GrowthBook-Feature-Flags zu deaktivieren und für jedes Flag die Standardwerte im Code zu verwenden. Dadurch sind Remote Control und die anderen Funktionen, die das Abrufen von Feature-Flags benötigen, nicht verfügbar. Das Setzen auf 0 oder false lässt das Abrufen aktiviert. Die Protokollierung von Telemetrie-Events bleibt aktiv, sofern nicht auch DISABLE_TELEMETRY gesetzt ist
DISABLE_INSTALLATION_CHECKS Auf 1 setzen, um Installationswarnungen zu deaktivieren. Nur verwenden, wenn Sie den Installationsort manuell verwalten, da dies Probleme mit Standardinstallationen verdecken kann
DISABLE_INSTALL_GITHUB_APP_COMMAND Auf 1 setzen, um den Befehl /install-github-app auszublenden. Bei Verwendung von Drittanbietern (Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry) bereits ausgeblendet
DISABLE_INTERLEAVED_THINKING Auf 1 setzen, um das Senden des Beta-Headers für Interleaved Thinking zu verhindern. Nützlich, wenn Ihr LLM-Gateway oder Anbieter Interleaved Thinking nicht unterstützt
DISABLE_LOGIN_COMMAND Auf 1 setzen, um den Befehl /login auszublenden. Nützlich, wenn die Authentifizierung extern über API-Schlüssel oder apiKeyHelper erfolgt
DISABLE_LOGOUT_COMMAND Auf 1 setzen, um den Befehl /logout auszublenden
DISABLE_PROMPT_CACHING Auf 1 setzen, um Prompt-Caching für alle Modelle zu deaktivieren (hat Vorrang vor modellspezifischen Einstellungen)
DISABLE_PROMPT_CACHING_FABLE Auf 1 setzen, um Prompt-Caching für Fable-Modelle zu deaktivieren
DISABLE_PROMPT_CACHING_HAIKU Auf 1 setzen, um Prompt-Caching für das Standard-Haiku-Modell zu deaktivieren, unabhängig davon, wo es ausgeführt wird
DISABLE_PROMPT_CACHING_OPUS Auf 1 setzen, um Prompt-Caching für das Standard-Opus-Modell zu deaktivieren
DISABLE_PROMPT_CACHING_SONNET Auf 1 setzen, um Prompt-Caching für das Standard-Sonnet-Modell zu deaktivieren
DISABLE_TELEMETRY Auf einen beliebigen nicht leeren Wert wie 1 setzen, um die Telemetrie abzulehnen. Auch das Setzen auf 0 oder false lehnt sie ab, anders als bei den meisten Ein/Aus-Variablen; entfernen Sie die Variable, um die Telemetrie wieder einzuschalten. Telemetrie-Events enthalten keine Benutzerdaten wie Code, Dateipfade oder Bash-Befehle. Deaktiviert außerdem das Abrufen von Feature-Flags. Siehe Telemetrie für Ihre Organisation ausschalten
DISABLE_UPDATES Auf 1 setzen, um alle Updates zu blockieren, einschließlich manueller Aufrufe von claude update und claude install. Strenger als DISABLE_AUTOUPDATER. Verwenden Sie dies, wenn Sie Claude Code über eigene Kanäle verteilen und Benutzer nicht selbst aktualisieren sollen
DISABLE_UPGRADE_COMMAND Auf 1 setzen, um den Befehl /upgrade auszublenden
DO_NOT_TRACK Auf 1 setzen, um die Telemetrie abzulehnen, mit derselben Wirkung wie DISABLE_TELEMETRY, auch auf das Abrufen von Feature-Flags. Claude Code liest diese Variable als Standard-Boolean, sodass 0 die Telemetrie aktiviert lässt, und berücksichtigt sie als toolübergreifende Konvention, die von vielen Entwickler-CLIs erkannt wird
ENABLE_BETA_TRACING_DETAILED Zusammen mit BETA_TRACING_ENDPOINT auf 1 setzen, um detailliertes Beta-Tracing einzuschalten, das inhaltstragende Span-Attribute und den Span claude_code.hook hinzufügt. Interaktive CLI-Sitzungen erfordern außerdem, dass Ihre Organisation für die Beta freigeschaltet ist. Beide Variablen werden in Projekt- und lokalen Einstellungen ignoriert
ENABLE_CLAUDEAI_MCP_SERVERS Auf false setzen, damit Claude Code keine claude.ai-MCP-Server abruft. Für angemeldete Benutzer standardmäßig aktiviert. Um dies pro Projekt oder pro Organisation zu deaktivieren, setzen Sie stattdessen disableClaudeAiConnectors in den Einstellungen
ENABLE_PROMPT_CACHING_1H Auf 1 setzen, um eine Prompt-Cache-TTL von 1 Stunde statt der standardmäßigen 5 Minuten anzufordern. Gedacht für Benutzer mit API-Schlüssel sowie Benutzer von Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry und Claude Platform on AWS. Abonnementbenutzer innerhalb der enthaltenen Nutzung erhalten die 1-Stunden-TTL automatisch in der Hauptkonversation. Abonnementbenutzer, die Nutzungsguthaben in Anspruch nehmen, können die Variable setzen, um die 1-Stunden-TTL beizubehalten. 1-Stunden-Cache-Schreibvorgänge werden zu einem höheren Satz abgerechnet. Um die TTL stattdessen pro Anfragekategorie zu wählen, verwenden Sie CLAUDE_CODE_PROMPT_CACHE_TTL und CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL, die Vorrang vor dieser Variable haben
ENABLE_PROMPT_CACHING_1H_BEDROCK Veraltet. Verwenden Sie stattdessen ENABLE_PROMPT_CACHING_1H
ENABLE_TOOL_SEARCH Steuert MCP Tool Search. Wenn nicht gesetzt, lädt Claude Code standardmäßig alle MCP-Tools verzögert. Vorab geladen werden sie weiterhin auf Modellen von Google Cloud's Agent Platform, die älter als die Claude-4.5-Generation sind, bei einer auf Azure gehosteten Microsoft-Foundry-Bereitstellung und wenn ANTHROPIC_BASE_URL auf einen Nicht-First-Party-Host verweist. true lädt immer verzögert und sendet den Beta-Header, außer auf denselben Agent-Platform-Modellen und Microsoft-Foundry-Bereitstellungen; Anfragen schlagen auf Proxys fehl, die tool_reference nicht unterstützen. auto lädt vorab, wenn die Tool-Definitionen in 10 % des Kontexts passen. auto:N legt einen benutzerdefinierten Schwellenwert fest, etwa auto:5 für 5 %. false lädt alle Tools vorab. Ein selbst gesetzter Wert wird ignoriert, wenn CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS gesetzt ist. Vor v2.1.221 deaktivierte Claude Code Tool Search für alle Modelle auf Google Cloud's Agent Platform, sofern Sie diese Variable nicht auf true setzten
FALLBACK_FOR_ALL_PRIMARY_MODELS Auf einen beliebigen nicht leeren Wert wie 1 setzen, damit Claude Code bei wiederholten Überlastungsfehlern für jedes Modell keine weiteren Wiederholungsversuche unternimmt, wenn kein Fallback-Modell konfiguriert ist. Auch das Setzen auf 0 oder false aktiviert dies, anders als bei den meisten Ein/Aus-Variablen; entfernen Sie die Variable, um das standardmäßige Wiederholungsverhalten wiederherzustellen. Ohne die Variable stellt Claude Code die Wiederholungsversuche auf diese Weise bei Modellen ein, die es als Opus-, Fable- oder Mythos-Modelle erkennt, wenn Sie sich mit einem API-Schlüssel oder über einen Drittanbieter statt mit einem Claude-Abonnement authentifizieren. Ab Claude Code v2.1.160 wechselt Claude Code bei wiederholten Überlastungsfehlern für jedes primäre Modell zu Ihrer konfigurierten Fallback-Modellkette, sodass diese Variable den Wechsel zu einem Fallback-Modell nicht beeinflusst
FORCE_AUTOUPDATE_PLUGINS Auf 1 setzen, um automatische Plugin-Updates zu erzwingen, auch wenn der Haupt-Auto-Updater über DISABLE_AUTOUPDATER deaktiviert ist
FORCE_HYPERLINK Auf 1 setzen, um anklickbare OSC-8-Hyperlinks zu aktivieren, wenn Ihr Terminal sie unterstützt, dies aber nicht automatisch erkannt wird, oder auf 0, um sie zu deaktivieren. Wenn nicht gesetzt, aktiviert Claude Code Hyperlinks nur, wenn es Terminal-Unterstützung erkennt. Claude Code wertet diesen Wert als Zahl aus, nicht als Boolean, sodass ein Wert wie false, no oder off Hyperlinks aktiviert, statt sie zu deaktivieren. Das PR- oder Merge-Request-Badge in der Fußzeile wird als Hyperlink dargestellt, auch wenn Claude Code keine Terminal-Unterstützung erkennen kann, etwa über SSH. Setzen Sie 0, um das Badge als reinen Text darzustellen
FORCE_PROMPT_CACHING_5M Auf 1 setzen, um die 5-Minuten-TTL für den Prompt-Cache zu erzwingen, auch wenn sonst die 1-Stunden-TTL gelten würde. Überschreibt CLAUDE_CODE_PROMPT_CACHE_TTL, CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL, ENABLE_PROMPT_CACHING_1H sowie die Einstellungen promptCacheTtl und subagentPromptCacheTtl
HTTP_PROXY Gibt den HTTP-Proxyserver für Netzwerkverbindungen an
HTTPS_PROXY Gibt den HTTPS-Proxyserver für Netzwerkverbindungen an
IS_DEMO Auf einen beliebigen nicht leeren Wert wie 1 setzen, um den Demo-Modus zu aktivieren: blendet Ihre E-Mail-Adresse und den Namen Ihrer Organisation in der Kopfzeile und in der Ausgabe von /status aus und überspringt das Onboarding. Auch das Setzen auf 0 oder false aktiviert den Demo-Modus, anders als bei den meisten Ein/Aus-Variablen; entfernen Sie die Variable, um ihn auszuschalten. Nützlich beim Streamen oder Aufzeichnen einer Sitzung
MAX_MCP_OUTPUT_TOKENS Maximale Anzahl an Token, die in Antworten von MCP-Tools zulässig sind (Standard: 25000). Claude Code zeigt eine Warnung an, wenn die Ausgabe 10.000 Token überschreitet. Tools, die anthropic/maxResultSizeChars deklarieren, verwenden stattdessen dieses Zeichenlimit für Textinhalte, Bildinhalte dieser Tools unterliegen jedoch weiterhin dieser Variable. Ein erfolgreiches Textergebnis mit mehr als 50.000 Zeichen von einem Tool ohne diese Annotation wird unabhängig von dieser Variable in einer Datei gespeichert
MAX_STRUCTURED_OUTPUT_RETRIES Anzahl der Versuche, die Claude Code zulässt, wenn die Antwort des Modells im nicht interaktiven Modus mit dem Flag -p die Validierung gegen das --json-schema nicht besteht; nach so vielen fehlgeschlagenen Versuchen ohne gültige Ausgabe schlägt der Lauf fehl. Dieselbe Obergrenze gilt, wenn die strukturierte Ausgabe eines Workflow-Subagenten die Validierung nicht besteht. Standardmäßig 5: ein erster Versuch plus vier Wiederholungsversuche
MAX_THINKING_TOKENS Festes Token-Budget für Extended Thinking. Claude Code begrenzt es auf ein Token unter den maximalen Ausgabe-Token der Anfrage und nie unter 1.024. Wie dieses Limit festgelegt wird, erfahren Sie unter CLAUDE_CODE_MAX_OUTPUT_TOKENS. Wenn die Variable nicht gesetzt und Thinking aktiviert ist, wählen Modelle mit adaptivem Reasoning ihre Thinking-Tiefe selbst, und andere Modelle verwenden die Obergrenze. Auf 0 setzen, um Thinking auf der Anthropic API zu deaktivieren, außer bei Opus 5.5, Sonnet 5.5 und den Fable-Modellen, bei denen Thinking nicht ausgeschaltet werden kann. Bei Drittanbietern lässt 0 stattdessen den Parameter thinking weg. Wenn Thinking auf der Anthropic API ausgeschaltet ist, sendet Claude Code den Effort high statt einer höheren Stufe an Modelle, von denen es weiß, dass sie diese Kombination nicht akzeptieren, etwa Opus 5. Bei einem positiven Wert ignoriert Claude Code die Zahl selbst bei Modellen mit adaptivem Reasoning, außer wenn CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING das adaptive Reasoning ausschaltet
MCP_CLIENT_SECRET OAuth-Client-Secret für MCP-Server, die vorkonfigurierte Anmeldedaten erfordern. Vermeidet die interaktive Abfrage beim Hinzufügen eines Servers mit --client-secret
MCP_CONNECTION_NONBLOCKING Steuert, ob der Start vor der ersten Anfrage auf die Verbindung der MCP-Server wartet. Der MCP-Start ist standardmäßig nicht blockierend: Server verbinden sich im Hintergrund, und ihre Tools werden verfügbar, sobald sie fertig sind. Auf 0 setzen, damit Claude Code vor der ersten Anfrage auf die Verbindung der Server wartet. Server, die mit alwaysLoad: true konfiguriert sind, lassen den Start dennoch in jedem Fall warten, außer wenn sie aus dem Discovery-Cache bereitgestellt werden, da ihre Tools vorhanden sein müssen, wenn der erste Prompt erstellt wird. Im nicht interaktiven Modus (-p) ohne --input-format stream-json wartet Claude Code unabhängig von dieser Variable ebenfalls vor dem ersten Turn auf noch ausstehende Server. Wenn Sie --mcp-config explizit übergeben, hat das Warten eine längere Frist; die Ausnahme für zwischengespeicherte Server finden Sie im Eintrag zu diesem Flag
MCP_CONNECT_TIMEOUT_MS Wie lange der blockierende MCP-Start in Millisekunden auf den Verbindungsbatch wartet, bevor ein Snapshot der Tool-Liste erstellt wird (Standard: 5000). Gilt, wenn MCP_CONNECTION_NONBLOCKING=0 gesetzt ist, oder für Server, die mit alwaysLoad: true gekennzeichnet sind. Server, die bei Ablauf der Frist noch ausstehen, verbinden sich weiter im Hintergrund. Unterscheidet sich von MCP_TIMEOUT, das den Verbindungsversuch eines einzelnen Servers begrenzt
MCP_DISCOVERY_CACHE Schaltet den MCP-Discovery-Cache ein oder aus. Bei eingeschaltetem Cache kann ein Remote-HTTP- oder SSE-Server, den Sie bereits verwendet haben, den Status cached anzeigen, und Claude Code verbindet ihn bei seinem ersten Tool-Aufruf statt beim Start. Der Cache ist standardmäßig ausgeschaltet, sofern ihn kein schrittweiser Rollout für Ihr Konto aktiviert hat. Auf 1 setzen, um ihn einzuschalten, oder auf 0, um ihn auch dann ausgeschaltet zu lassen, wenn der Rollout ihn aktiviert hat. Vor v2.1.238 war der Cache standardmäßig eingeschaltet. Der Status cached erfordert Claude Code v2.1.221 oder höher
MCP_DISCOVERY_CACHE_MAX_STALE_S Maximales Alter eines Discovery-Cache-Eintrags in Sekunden (Standard: 14400, also 4 Stunden). Bei einem Start, bei dem der Eintrag älter ist, verwirft Claude Code ihn und verbindet den Server beim Start, wie bei ausgeschaltetem Cache. Claude Code begrenzt den Wert auf 7 Tage. Vor v2.1.238 betrug der Standardwert 86400, also 24 Stunden, und Claude Code begrenzte den Wert nicht
MCP_DISCOVERY_CACHE_STRIKES Bei einem Start, bei dem ein Discovery-Cache-Eintrag älter als MCP_DISCOVERY_CACHE_TTL_S ist, aktualisiert Claude Code ihn im Hintergrund. Diese Variable legt fest, wie viele Aktualisierungen hintereinander fehlschlagen können, bevor Claude Code den Eintrag verwirft und den Server stattdessen beim nächsten Start verbindet (Standard: 1). Erhöhen Sie den Wert, wenn Ihre Netzwerkverbindung gelegentlich abbricht, damit eine einzelne fehlgeschlagene Aktualisierung den Eintrag nicht verwirft. Erfordert Claude Code v2.1.238 oder höher
MCP_DISCOVERY_CACHE_TTL_S Sekunden, für die Claude Code einen Discovery-Cache-Eintrag verwendet, ohne ihn zu aktualisieren (Standard: 900). Bei einem Start, bei dem der Eintrag älter ist, verwendet Claude Code ihn weiterhin, aktualisiert ihn aber im Hintergrund. Sobald der Eintrag älter als MCP_DISCOVERY_CACHE_MAX_STALE_S ist, verwirft Claude Code ihn stattdessen. Claude Code begrenzt den Wert auf MCP_DISCOVERY_CACHE_MAX_STALE_S, standardmäßig 4 Stunden. Vor v2.1.238 begrenzte Claude Code den Wert nicht
MCP_OAUTH_CALLBACK_PORT Fester Port für den OAuth-Redirect-Callback, als Alternative zu --callback-port beim Hinzufügen eines MCP-Servers mit vorkonfigurierten Anmeldedaten
MCP_PROTOCOL_NEGOTIATION Nur in der v2-MCP-Client-Runtime: ob Claude Code Server auf die MCP-Protokollrevision 2026-07-28 prüft. Setzen Sie auto, um HTTP-, claude.ai-Konnektor- und stdio-Server zu prüfen, oder legacy, um keine zu prüfen. Wenn die Variable nicht gesetzt ist, prüft Claude Code die unter MCP-Client-Runtimes beschriebenen Server. Jeder andere Wert wird mit einer Warnung im Debug-Log ignoriert. Erfordert Claude Code v2.1.221 oder höher
MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZE Maximale Anzahl von Remote-MCP-Servern (HTTP/SSE), die beim Start parallel verbunden werden (Standard: 20)
MCP_SDK_GENERATION Legt fest, mit welcher MCP-Client-Runtime dieser Prozess sich mit MCP-Servern verbindet: v1, basierend auf MCP TypeScript SDK 1.x, oder v2, basierend auf MCP TypeScript SDK 2.0. Ohne die Variable verwendet Claude Code v2, beginnend mit den in diesem Abschnitt aufgeführten Versionen. Ab Claude Code v2.1.221 prüft die v2-Runtime den Aussteller, den ein MCP-OAuth-Server in seiner Autorisierungsantwort zurückgibt, und lässt die Anmeldung mit einem Fehler fehlschlagen, der mit Issuer mismatch in authorization response beginnt, wenn er nicht übereinstimmt. Die v1-Runtime führt diese Prüfung nicht durch. Wenn Sie einen nicht erkannten Wert setzen, ignoriert Claude Code ihn und schreibt eine Warnung in das Debug-Log. Claude Code liest den Wert einmal pro Prozess. Erfordert Claude Code v2.1.218 oder höher
MCP_SERVER_CONNECTION_BATCH_SIZE Maximale Anzahl lokaler MCP-Server (stdio), die beim Start parallel verbunden werden (Standard: 3)
MCP_TIMEOUT Timeout in Millisekunden für den Start von MCP-Servern (Standard: 30000, also 30 Sekunden)
MCP_TOOL_TIMEOUT Timeout in Millisekunden für die Ausführung von MCP-Tools (Standard: 100000000, etwa 28 Stunden). Bei einem HTTP-, SSE- oder claude.ai-Konnektor-Server läuft außerdem jede Anfrage standardmäßig nach 60 Sekunden ab; setzen Sie diese Variable oder den serverspezifischen timeout auf über 60000, um dieses Limit pro Anfrage anzuheben. Ein niedrigerer Wert verkürzt zwar den gesamten Timeout für die Tool-Ausführung, belässt das Limit pro Anfrage aber bei 60 Sekunden. Stdio- und WebSocket-Server haben keinen Timer pro Anfrage. Ein serverspezifisches Feld timeout in .mcp.json überschreibt dies für diesen Server. Ein serverspezifischer timeout von mindestens 1000 legt außerdem das minimale Leerlauffenster für die Tool-Aufrufe dieses Servers fest, sodass CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT sie nie früher abbricht; diese Untergrenze erfordert Claude Code v2.1.203 oder höher. Bei der Umgebungsvariable werden Werte unter 1000 auf eine Sekunde angehoben; beim serverspezifischen Feld werden Werte unter 1000 ignoriert
NO_PROXY Liste von Domains und IPs, an die Anfragen direkt unter Umgehung des Proxys gesendet werden
OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT Standardmäßiges OpenTelemetry-SDK-Limit für die Länge von Attributwerten. Claude Code begrenzt inhaltstragende Telemetrie-Attribute auf den kleineren Wert aus diesem Limit und CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH, damit die Kürzungsmarkierung innerhalb des SDK-Limits bleibt. Claude Code liest die Varianten OTEL_LOGRECORD_ATTRIBUTE_VALUE_LENGTH_LIMIT und OTEL_SPAN_ATTRIBUTE_VALUE_LENGTH_LIMIT auf dieselbe Weise, und der kleinste gesetzte Wert gilt für alle Signale. Erfordert Claude Code v2.1.214 oder höher. Siehe Monitoring
OTEL_LOG_ASSISTANT_RESPONSES Auf 1 setzen, um den Antworttext des Modells in OpenTelemetry-Log-Events vom Typ assistant_response einzuschließen. Wenn nicht gesetzt, verwendet Claude Code stattdessen den Wert von OTEL_LOG_USER_PROMPTS. Auf 0 setzen, um Antworten auch dann geschwärzt zu lassen, wenn OTEL_LOG_USER_PROMPTS gesetzt ist. Setzen Sie die Variable in Ihrer Shell, in den Benutzereinstellungen oder in verwalteten Einstellungen. Wird in Projekt- und lokalen Einstellungen ignoriert. Erfordert Claude Code v2.1.193 oder höher. Siehe Monitoring
OTEL_LOG_MANAGED_SETTINGS Auf 1 setzen, um die geschwärzten verwalteten Einstellungen und einen SHA-256-Digest der Einstellungen vor der Schwärzung zu OpenTelemetry-Log-Events vom Typ managed_settings_resolved hinzuzufügen. Standardmäßig deaktiviert. Setzen Sie die Variable in Ihrer Shell, in den Benutzereinstellungen oder in verwalteten Einstellungen; ein Wert in Projekt- oder lokalen Einstellungen schaltet sie nicht ein. Erfordert Claude Code v2.1.274 oder höher. Siehe Monitoring
OTEL_LOG_RAW_API_BODIES Gibt Anfrage- und Antwort-JSON der Anthropic Messages API als Log-Events api_request_body / api_response_body aus. Auf 1 setzen für Inline-Bodys, die beim Inhaltslimit gekürzt werden, oder auf file:<dir>, um ungekürzte Bodys auf die Festplatte zu schreiben und stattdessen einen body_ref-Pfad auszugeben. CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH konfiguriert das Inhaltslimit, standardmäßig 60 KB. Standardmäßig deaktiviert; Bodys enthalten den gesamten Konversationsverlauf. Setzen Sie die Variable in Ihrer Shell, in den Benutzereinstellungen oder in verwalteten Einstellungen. Wird in Projekt- und lokalen Einstellungen ignoriert. Siehe Monitoring
OTEL_LOG_TOOL_CONTENT Auf 1 setzen, um Tool-Inhalte in das OpenTelemetry-Span-Event tool.output einzuschließen. Span-Attribute enthalten Tool-Inhalte unter eigenen Schaltern. Erfordert Tracing. Standardmäßig deaktiviert, um sensible Daten zu schützen. Setzen Sie die Variable in Ihrer Shell, in den Benutzereinstellungen oder in verwalteten Einstellungen. Wird in Projekt- und lokalen Einstellungen ignoriert, abgesehen von den Aus-Werten, die dieser Abschnitt beschreibt. Siehe Monitoring
OTEL_LOG_TOOL_DETAILS Auf 1 setzen, um Tool-Eingabeargumente; Namen von MCP-Servern; von Benutzern erstellte Workflow-Namen; rohe Fehlerzeichenfolgen bei Tool-Fehlern; die Ablehnungs-category bei api_refusal-Events; echte Namen von Agenten, Skills, Plugins und MCP-Servern in Kosten- und Token-Metriken; und andere Tool-Details in OpenTelemetry-Metriken, -Traces und -Logs einzuschließen. Standardmäßig deaktiviert, um personenbezogene Daten zu schützen. Setzen Sie die Variable in Ihrer Shell, in den Benutzereinstellungen oder in verwalteten Einstellungen. Wird in Projekt- und lokalen Einstellungen ignoriert, abgesehen von den Aus-Werten, die dieser Abschnitt beschreibt. Siehe Monitoring
OTEL_LOG_USER_PROMPTS Auf 1 setzen, um den Text von Benutzer-Prompts in OpenTelemetry-Traces und -Logs einzuschließen. Standardmäßig deaktiviert (Prompts werden geschwärzt). Setzen Sie die Variable in Ihrer Shell, in den Benutzereinstellungen oder in verwalteten Einstellungen. Wird in Projekt- und lokalen Einstellungen ignoriert, abgesehen von den Aus-Werten, die dieser Abschnitt beschreibt. Siehe Monitoring
OTEL_METRICS_INCLUDE_ACCOUNT_UUID Auf false setzen, um die Konto-UUID aus den Metrikattributen auszuschließen (Standard: enthalten). Siehe Monitoring
OTEL_METRICS_INCLUDE_ENTRYPOINT Auf true setzen, um den Einstiegspunkt der Sitzung in die Metrikattribute aufzunehmen (Standard: ausgeschlossen). Hinzugefügt in v2.1.152. Siehe Monitoring
OTEL_METRICS_INCLUDE_REPOSITORY Auf true setzen, um OpenTelemetry-Metriken und -Events mit vcs.*-Attributen zu versehen, die das Repository der Sitzung identifizieren (Standard: ausgeschlossen). Erfordert Claude Code v2.1.269 oder höher. Siehe Repository-Attribute
OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES Ab v2.1.161 hängt Claude Code die Schlüssel aus OTEL_RESOURCE_ATTRIBUTES an die Labels der Metrik-Datenpunkte an. Auf false setzen, um sie auszuschließen (Standard: enthalten). Siehe Monitoring
OTEL_METRICS_INCLUDE_SESSION_ID Auf false setzen, um die Sitzungs-ID aus den Metrikattributen auszuschließen (Standard: enthalten). Siehe Monitoring
OTEL_METRICS_INCLUDE_VERSION Auf true setzen, um die Claude-Code-Version in die Metrikattribute aufzunehmen (Standard: ausgeschlossen). Siehe Monitoring
SLASH_COMMAND_TOOL_CHAR_BUDGET Überschreibt das Zeichenbudget für Skill-Metadaten, die dem Skill-Tool angezeigt werden. Das Budget skaliert dynamisch mit 1 % des Kontextfensters, mit einem Fallback von 8.000 Zeichen. Der alte Name wird aus Gründen der Abwärtskompatibilität beibehalten
TASK_MAX_OUTPUT_LENGTH In v2.1.277 entfernt und jetzt ohne Wirkung, zusammen mit dem Tool TaskOutput, dessen Größe sie festlegte. Legte zuvor die maximale Anzahl an Zeichen der Ausgabe einer Hintergrundaufgabe fest, die das Tool TaskOutput behielt. Claude liest die Ausgabedatei einer Hintergrundaufgabe stattdessen mit Read
USE_BUILTIN_RIPGREP Auf 0 setzen, um das systemweit installierte rg statt des mit Claude Code mitgelieferten rg zu verwenden
VERTEX_REGION_CLAUDE_3_5_HAIKU Überschreibt die Region für Claude 3.5 Haiku bei Verwendung von Google Cloud's Agent Platform
VERTEX_REGION_CLAUDE_3_5_SONNET Überschreibt die Region für Claude 3.5 Sonnet bei Verwendung von Google Cloud's Agent Platform
VERTEX_REGION_CLAUDE_3_7_SONNET Überschreibt die Region für Claude 3.7 Sonnet bei Verwendung von Google Cloud's Agent Platform
VERTEX_REGION_CLAUDE_4_0_OPUS Überschreibt die Region für Claude 4.0 Opus bei Verwendung von Google Cloud's Agent Platform
VERTEX_REGION_CLAUDE_4_0_SONNET Überschreibt die Region für Claude 4.0 Sonnet bei Verwendung von Google Cloud's Agent Platform
VERTEX_REGION_CLAUDE_4_1_OPUS Überschreibt die Region für Claude 4.1 Opus bei Verwendung von Google Cloud's Agent Platform
VERTEX_REGION_CLAUDE_4_5_OPUS Überschreibt die Region für Claude Opus 4.5 bei Verwendung von Google Cloud's Agent Platform
VERTEX_REGION_CLAUDE_4_5_SONNET Überschreibt die Region für Claude Sonnet 4.5 bei Verwendung von Google Cloud's Agent Platform
VERTEX_REGION_CLAUDE_4_6_OPUS Überschreibt die Region für Claude Opus 4.6 bei Verwendung von Google Cloud's Agent Platform
VERTEX_REGION_CLAUDE_4_6_SONNET Überschreibt die Region für Claude Sonnet 4.6 bei Verwendung von Google Cloud's Agent Platform
VERTEX_REGION_CLAUDE_4_7_OPUS Überschreibt die Region für Claude Opus 4.7 bei Verwendung von Google Cloud's Agent Platform
VERTEX_REGION_CLAUDE_4_8_OPUS Überschreibt die Region für Claude Opus 4.8 bei Verwendung von Google Cloud's Agent Platform
VERTEX_REGION_CLAUDE_5_5_OPUS Überschreibt die Region für Claude Opus 5.5 bei Verwendung von Google Cloud's Agent Platform. Hinzugefügt in v2.1.280
VERTEX_REGION_CLAUDE_5_5_SONNET Überschreibt die Region für Claude Sonnet 5.5 bei Verwendung von Google Cloud's Agent Platform. Hinzugefügt in v2.1.284
VERTEX_REGION_CLAUDE_5_OPUS Überschreibt die Region für Claude Opus 5 bei Verwendung von Google Cloud's Agent Platform. Hinzugefügt in v2.1.219
VERTEX_REGION_CLAUDE_5_SONNET Überschreibt die Region für Claude Sonnet 5 bei Verwendung von Google Cloud's Agent Platform. Hinzugefügt in v2.1.197
VERTEX_REGION_CLAUDE_FABLE_5 Überschreibt die Region für Claude Fable 5 bei Verwendung von Google Cloud's Agent Platform. Hinzugefügt in v2.1.170
VERTEX_REGION_CLAUDE_FABLE_5_1 Überschreibt die Region für Claude Fable 5.1 bei Verwendung von Google Cloud's Agent Platform. Hinzugefügt in v2.1.257
VERTEX_REGION_CLAUDE_HAIKU_4_5 Überschreibt die Region für Claude Haiku 4.5 bei Verwendung von Google Cloud's Agent Platform

Die standardmäßigen OpenTelemetry-Exporter-Variablen (OTEL_METRICS_EXPORTER, OTEL_LOGS_EXPORTER, OTEL_EXPORTER_OTLP_ENDPOINT, OTEL_EXPORTER_OTLP_PROTOCOL, OTEL_EXPORTER_OTLP_HEADERS, OTEL_METRIC_EXPORT_INTERVAL, OTEL_RESOURCE_ATTRIBUTES und signalspezifische Varianten) werden ebenfalls unterstützt. Konfigurationsdetails finden Sie unter Monitoring.

Setzen Sie CLAUDE_CODE_ENABLE_TELEMETRY und die OpenTelemetry-Variablen, die den Export einschalten, sein Ziel festlegen oder Inhalte erfassen, in Ihrer Shell, in den Benutzereinstellungen oder in verwalteten Einstellungen. Claude Code ignoriert sie in Projekt- und lokalen Einstellungen, abgesehen von den Aus-Werten, die dieser Abschnitt beschreibt. OTEL_RESOURCE_ATTRIBUTES sowie die Variablen für Exportintervall, Timeout und Komprimierung, etwa OTEL_METRIC_EXPORT_INTERVAL, gelten weiterhin auch aus Projekt- und lokalen Einstellungen.

Was die Bereinigung der Subprozess-Umgebung entfernt

Wenn Sie CLAUDE_CODE_SUBPROCESS_ENV_SCRUB auf 1 setzen, entfernt Claude Code Anmeldedaten aus den Umgebungen der Subprozesse, die es startet, etwa Bash-Befehle, Hooks und stdio-MCP-Server. Dadurch wird eingeschränkt, was ein Prompt-Injection-Angriff über Shell-Expansion auslesen kann. Der Claude Code-Prozess behält die Anmeldedaten für seine eigenen API-Aufrufe.

Die Bereinigung erkennt Anmeldedaten anhand des Variablennamens oder der Form des Werts. Setzen Sie sie daher als eine Schutzebene neben eng gefassten Berechtigungsregeln ein und nicht als einzige Kontrolle.

Die Tabelle zeigt, wie die Bereinigung mit Beispielvariablen verfährt:

Beispielvariable Was die Bereinigung tut
ANTHROPIC_API_KEY, AWS_SECRET_ACCESS_KEY Entfernt sie
NPM_TOKEN, DB_PASSWORD Entfernt sie, weil der Name nach Anmeldedaten aussieht
DATABASE_URL, die ein Passwort enthält Entfernt sie, weil der Wert nach Anmeldedaten aussieht
PIP_INDEX_URL oder NPM_CONFIG_REGISTRY, die ein Passwort enthält Behält die URL und entfernt Benutzername und Passwort daraus
CLAUDE_CONFIG_DIR Entfernt sie. Erfordert Claude Code v2.1.251 oder höher
GITHUB_TOKEN, GH_TOKEN, GH_ENTERPRISE_TOKEN, GITHUB_ENTERPRISE_TOKEN Belässt sie, damit gh und Skripte, die die GitHub-API aufrufen, weiterhin funktionieren
HTTP_PROXY, HTTPS_PROXY Belässt sie, einschließlich Benutzername und Passwort in der URL. Die Sandbox kann diese Variablen für in der Sandbox ausgeführte Befehle selbst setzen
GIT_CONFIG_COUNT, GIT_CONFIG_KEY_<n>, GIT_CONFIG_VALUE_<n> Belässt sie, unabhängig von ihrem Inhalt
Ein Geheimnis, dessen Variablenname und Wert nicht nach Anmeldedaten aussehen Belässt es

Da die Bereinigung GITHUB_TOKEN belässt, sollten Sie einem GitHub Actions-Job nur die minimal erforderlichen permissions erteilen. Um ein GitHub-Token aus in der Sandbox ausgeführten Bash-Befehlen zu entfernen, fügen Sie unter sandbox.credentials einen deny-Eintrag hinzu.

Lassen Sie die Bereinigung deaktiviert, wenn ein Subprozess eine der entfernten Variablen benötigt.

Unter Linux führt die Bereinigung Bash-Subprozesse außerdem in einem isolierten PID-Namespace aus, sodass sie die Umgebungen von Host-Prozessen nicht über /proc auslesen können. Als Nebeneffekt können ps, pgrep und kill Host-Prozesse weder sehen noch ihnen Signale senden.

Funktionen, die das Abrufen von Feature-Flags erfordern

Claude Code aktiviert einige Funktionen über Feature-Flags, die es von Anthropic abruft. In diesen Sitzungen überspringt Claude Code diesen Abruf:

  • Eine Sitzung, in der Sie DISABLE_GROWTHBOOK, DISABLE_TELEMETRY, DO_NOT_TRACK oder CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC setzen; die Zeile der jeweiligen Variable in der Variablentabelle gibt an, welche Werte das Abrufen ausschalten
  • Eine Sitzung bei einem Drittanbieter wie Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform oder Microsoft Foundry, es sei denn, eine Host-Plattform, die Claude Code einbettet, setzt CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST
  • Eine Sitzung über ein Claude-Apps-Gateway

Bei ausgeschaltetem Abruf können Sie Folgendes nicht:

Erste Sitzung nach einer Installation oder einem Upgrade

In Ihrer ersten Sitzung nach der Installation von Claude Code oder nach einem Upgrade auf eine Version, die eine Funktion hinzufügt, kann eine durch Flags gesteuerte Funktion fehlen. Diese Sitzung kann außerdem in einem anderen Berechtigungsmodus starten als Ihre späteren Sitzungen. Wenn Claude Code die Flags während dieser Sitzung abruft, speichert es sie auf dem Rechner, sodass Ihre nächste Sitzung auf diesem Rechner die Funktion und den üblichen anfänglichen Berechtigungsmodus hat.

Nach einer Neuinstallation kann Claude Code in einer nicht interaktiven Sitzung wie claude -p, dem Agent SDK oder der VS Code-Erweiterung die Flags übernehmen, bevor es den anfänglichen Berechtigungsmodus wählt, wartet aber nicht immer auf sie.

In Konfigurationen wie den folgenden starten auch Sitzungen nach der ersten ohne frisch abgerufene Flags:

  • Eine saubere Umgebung bei jedem Lauf: Wenn jeder Lauf in einem CI-Container oder einer anderen Umgebung ohne die von einer früheren Sitzung gespeicherten Flags startet, ist jeder Lauf eine erste Sitzung
  • Ein Gateway-Token ohne API-Schlüssel: Wenn Sie sich mit ANTHROPIC_AUTH_TOKEN und ohne API-Schlüssel authentifizieren und ANTHROPIC_BASE_URL auf einen anderen Host als den von Anthropic verweist, etwa ein LLM-Gateway, hat Claude Code keine Anmeldedaten, mit denen es die Flags abrufen kann

Wie Sie den Berechtigungsmodus wählen, in dem Sitzungen in diesen Konfigurationen starten, erfahren Sie unter In einem anderen Berechtigungsmodus starten.

Siehe auch