SpyBara
Go Premium

env-vars.md 2026-10-03 23:57 UTC to 2026-10-04 09:58 UTC

This page contains 291 additions and 288 deletions.

2026
Thu 1 23:59 Fri 2 22:59 Sat 3 23:57 Sun 4 10:59

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 die Anzahl der Wiederholungsversuche akzeptieren neben einfachen Ziffern auch wissenschaftliche Notation und Schreibweisen mit Zifferntrennzeichen, sofern die Zeile einer Variablen nicht angibt, dass sie nur einfache Ziffern akzeptiert. 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; so setzte etwa 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 gebeten, 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, generiert in der AWS Console. Wird als x-api-key gesendet und hat Vorrang vor AWS SigV4
ANTHROPIC_AWS_BASE_URL Überschreibt die Endpunkt-URL für 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 dies auf einen 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 dies auf einen anderen Host als api.anthropic.com zeigt, entsprechend dem Verhalten bei Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry
ANTHROPIC_BEDROCK_BASE_URL Überschreibt die Endpunkt-URL von Amazon Bedrock. 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 für das regionsübergreifende Inferenzprofil (us, eu, apac, jp, au oder global), das Claude Code zuerst versucht, anstelle 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 selbst; verwenden Sie dies, um eine Anthropic-API-Beta zu aktivieren, bevor Claude Code native Unterstützung dafür hinzufügt. Im Gegensatz zum --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 zu 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 transportieren kann, etwa ein typografisches Anführungszeichen oder ein Leerzeichen ohne Breite, schlägt die Anfrage mit einem Fehler fehl, der das Paar anhand seiner Position identifiziert. Erfordert Claude Code v2.1.227 oder höher. Invalid request header value listet den genauen Zeichensatz auf und beschreibt, wo die Prüfung stattfindet. Ein Wert, der einen Header für Anmeldedaten, Organisation oder Tenant, Routing oder API-Verhalten setzt, etwa Authorization oder Host, gilt als Einstellung, die eine Genehmigung erfordert, wenn serververwaltete Einstellungen ihn bereitstellen. 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 zur /model-Auswahl hinzugefügt wird. Verwenden Sie dies, um ein nicht standardmäßiges oder Gateway-spezifisches Modell auswählbar zu machen, ohne integrierte Aliase zu ersetzen. Siehe Modellkonfiguration
ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION Anzeigebeschreibung für den benutzerdefinierten Modelleintrag in der /model-Auswahl. Standardmäßig Custom model (<model-id>), wenn nicht gesetzt
ANTHROPIC_CUSTOM_MODEL_OPTION_NAME Anzeigename für den benutzerdefinierten Modelleintrag in der /model-Auswahl. Wenn nicht gesetzt, zeigt der Eintrag den Namen des Modells an, 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, in 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 Anzeigebeschreibung für das fixierte Fable-Modell in der /model-Auswahl. Wenn nicht gesetzt, zeigt die Zeile eine Standardbeschreibung an, die mit Custom Fable model beginnt. Siehe Modellkonfiguration
ANTHROPIC_DEFAULT_FABLE_MODEL_NAME Anzeigename für das fixierte Fable-Modell in der /model-Auswahl. Wenn nicht gesetzt, zeigt die Zeile den Namen des Modells an, falls Claude Code die fixierte ID erkennt, andernfalls die fixierte ID. Siehe Modellkonfiguration
ANTHROPIC_DEFAULT_FABLE_MODEL_SUPPORTED_CAPABILITIES Kommagetrennte Liste der Fähigkeiten, die das fixierte Fable-Modell unterstützt, zum Beispiel effort,thinking. Siehe Modellkonfiguration
ANTHROPIC_DEFAULT_HAIKU_MODEL Modell-ID, in die der Alias haiku aufgelöst wird; wird auch für Hintergrundfunktionen verwendet. Siehe Modellkonfiguration
ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTION Anzeigebeschreibung für das fixierte Haiku-Modell in der /model-Auswahl. Wenn nicht gesetzt, zeigt die Zeile eine Standardbeschreibung an, die mit Custom Haiku model beginnt. Siehe Modellkonfiguration
ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME Anzeigename für das fixierte Haiku-Modell in der /model-Auswahl. Wenn nicht gesetzt, zeigt die Zeile den Namen des Modells an, falls Claude Code die fixierte ID erkennt, andernfalls die fixierte ID. Siehe Modellkonfiguration
ANTHROPIC_DEFAULT_HAIKU_MODEL_SUPPORTED_CAPABILITIES Kommagetrennte Liste der Fähigkeiten, die das fixierte 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, in die der Alias opus aufgelöst wird und die opusplan verwendet, solange der Plan-Modus aktiv ist. Siehe Modellkonfiguration
ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION Anzeigebeschreibung für das fixierte Opus-Modell in der /model-Auswahl. Wenn nicht gesetzt, zeigt die Zeile eine Standardbeschreibung an, die mit Custom Opus model beginnt. Siehe Modellkonfiguration
ANTHROPIC_DEFAULT_OPUS_MODEL_NAME Anzeigename für das fixierte Opus-Modell in der /model-Auswahl. Wenn nicht gesetzt, zeigt die Zeile den Namen des Modells an, falls Claude Code die fixierte ID erkennt, andernfalls die fixierte ID. Siehe Modellkonfiguration
ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES Kommagetrennte Liste der Fähigkeiten, die das fixierte Opus-Modell unterstützt, zum Beispiel effort,thinking. Siehe Modellkonfiguration
ANTHROPIC_DEFAULT_SONNET_MODEL Modell-ID, in 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 Anzeigebeschreibung für das fixierte Sonnet-Modell in der /model-Auswahl. Wenn nicht gesetzt, zeigt die Zeile eine Standardbeschreibung an, die mit Custom Sonnet model beginnt. Siehe Modellkonfiguration
ANTHROPIC_DEFAULT_SONNET_MODEL_NAME Anzeigename für das fixierte Sonnet-Modell in der /model-Auswahl. Wenn nicht gesetzt, zeigt die Zeile den Namen des Modells an, falls Claude Code die fixierte ID erkennt, andernfalls die fixierte ID. Siehe Modellkonfiguration
ANTHROPIC_DEFAULT_SONNET_MODEL_SUPPORTED_CAPABILITIES Kommagetrennte Liste der Fähigkeiten, die das fixierte Sonnet-Modell unterstützt, zum Beispiel effort,thinking. Siehe Modellkonfiguration
ANTHROPIC_FEDERATION_RULE_ID Federation-Regel-ID für Workload Identity Federation. Wenn Sie sie zusammen mit ANTHROPIC_ORGANIZATION_ID setzen, wählt Claude Code Federation-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 Profils, 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 sich dies nur aus, wenn auch ANTHROPIC_DEFAULT_HAIKU_MODEL oder das veraltete ANTHROPIC_SMALL_FAST_MODEL gesetzt ist, da Amazon Bedrock Hintergrundaufgaben andernfalls mit 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 diese, wenn Ihre Federation-Regel auf mehr als einen Workspace beschränkt ist, damit der Token-Austausch weiß, welcher Workspace adressiert werden soll
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 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 außer der direkten Anthropic API, Claude Platform on AWS und Amazon Bedrock mit gesetztem CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1 aktiv. 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 bei Anfragen in langsamen Netzwerken oder beim Routing über einen Proxy eine Zeitüberschreitung auftritt. 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 Bash- oder PowerShell-Tool-Befehl im Vordergrund, in Millisekunden (Standard: 120000 bzw. 2 Minuten). Ein Standardwert von mehr als 30 Minuten wird in unbeaufsichtigten Sitzungen auch 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 Bash- oder PowerShell-Tool-Befehl im Vordergrund festlegen 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 auch 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, anstatt 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 dies auch in ihren integrierten Terminals. Verwenden Sie dies, um zu erkennen, wann 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 in einem stdio-MCP-Server, den Claude Code gestartet hat, 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, sofern 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 Leerlaufzeit 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 auch dann ein, wenn die Einstellung nicht gesetzt oder never ist. 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 (Flag -p). Nützlich für SDK-Nutzer, 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 weglä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 MCP-Servern, die über das SDK erstellt wurden, 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 hängende API-Antworten behandeln beschrieben. Der Timer wird bei jedem Streaming-Fortschrittsereignis zurückgesetzt; wenn innerhalb des Zeitfensters kein Fortschritt eintrifft, 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 ab Claude Code v2.1.212 im nicht interaktiven Modus außerdem das automatische Verschieben langer MCP-Tool-Aufrufe in den Hintergrund
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 darzustellen: flacher Text ohne dekorative Rahmen oder Animationen. Setzen Sie 0, um den Screenreader-Modus zwangsweise auszuschalten, selbst 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 die erste Darstellung 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 darzustellen. Claude Code begrenzt die Wartezeit auf 600000 (10 Minuten). Ihr erster Tastendruck beendet die Wartezeit vorzeitig. Erfordert Claude Code v2.1.217 oder höher
CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR Kehrt nach jedem Bash- oder PowerShell-Befehl in der Hauptsitzung zum ursprünglichen Arbeitsverzeichnis zurück
CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS Timeout in Millisekunden für den Streaming-Leerlauf-Watchdog 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 Push-Benachrichtigungen von Remote Control auf Mobilgeräte, 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, anstatt 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 halten und die Cursoranzeige mit invertiertem Text zu deaktivieren. Ermöglicht Bildschirmlupen wie 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 im Vollbild-Rendering bei jedem Frame den gesamten Bildschirm neu zu zeichnen, anstatt inkrementelle Aktualisierungen zu senden. Verwenden Sie dies, wenn der Vollbildmodus veraltete oder falsch platzierte Textfragmente anzeigt. Claude Code aktiviert dies unter Windows automatisch für Hintergrundsitzungen und die Agentenansicht
CLAUDE_CODE_ALWAYS_ENABLE_EFFORT Setzen Sie 1, um den Parameter effort bei 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 ausgeschlossen, 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 nicht mehr automatisch den Browser ö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 nicht mehr eigenständig auf an ihn gesendete Kommentare antwortet. 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 Klassifikator-Anfragen im Auto-Modus bei, auch wenn Sie 0 setzen. Prüfen Sie unter Attributionsblock im System-Prompt, 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 die Variable daher bei diesen Versionen auf 0, wenn Ihr LLM-Gateway anhand des Request-Body cacht 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 angehoben. 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 Wert used_percentage der Statuszeile bezieht sich immer auf das vollständige Kontextfenster des Modells; 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 Turn-Ende hinaus weiterhin einen laufenden Status, solange Hintergrundarbeit wie ein Hintergrundagent oder ein Workflow-Lauf noch aktiv ist. Dadurch wird verhindert, dass ein Host, der den Status beobachtet, etwa eine Liste von Remote-Sitzungen, mitten in der Arbeit meldet, 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 Abwahl per 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 automatisch in Unterprozessen des Bash-Tools und von Hook-Befehlen gesetzt, solange die Sitzung eine aktive Remote Control-Verbindung hat, und entfernt, wenn die Verbindung endet. Der Wert ist die ID der Sitzung im Format session_, derselbe Bezeichner, der in der claude.ai/code-URL der Sitzung erscheint, sodass ein Skript auf die Sitzung zurückverweisen 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 einfaches Backspace liest, oder 1, um es als Ctrl+Backspace zu lesen. Beide Werte ersetzen den Plattformstandard. Standardmäßig liest Claude Code es unter Windows als Ctrl+Backspace, außer wenn TERM_PROGRAM den Wert mintty oder TERM den Wert cygwin hat, und unter macOS und Linux als einfaches Backspace. Setzen Sie 0 in einem Windows-Terminal, in dem Backspace ein ganzes Wort löscht
CLAUDE_CODE_CERT_STORE Kommagetrennte Liste von CA-Zertifikatquellen für TLS-Verbindungen. bundled ist das mit Claude Code ausgelieferte Mozilla-CA-Set. 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-Zertifikatspeicher. Standard ist bundled,system
CLAUDE_CODE_CHILD_SESSION Wird in Unterprozessen, die Claude Code über die Tools Bash, PowerShell und Monitor startet, sowie in Hook-Befehlen und Statuszeilen-Befehlen auf 1 gesetzt. Nicht gesetzt für stdio-MCP-Server-Unterprozesse, die langlebig sind und die Sitzung überdauern, die sie gestartet hat. Im Gegensatz zu CLAUDECODE wird dies nur von Claude Code selbst gesetzt, wenn es einen Unterprozess startet, und nicht von IDE-Erweiterungen, sodass es eine verschachtelte Sitzung zuverlässig von einem claude der obersten Ebene unterscheidet, das in einem in die IDE integrierten Terminal gestartet wurde. Eine verschachtelte interaktive claude-TUI, die auf diese Weise gestartet wird, 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 den verschlüsselten 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 Streaming-API-Anfrage fest. Verwenden Sie API_TIMEOUT_MS für den Timeout pro Anfrage. Für die Response-Header-Phase einer Streaming-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 und kein Verzeichnis. Erfordert, dass der Debug-Modus separat über --debug, /debug oder die Umgebungsvariable DEBUG aktiviert wird: Das Setzen dieser Variable allein aktiviert das Logging nicht. Das Flag --debug-file erledigt beides gleichzeitig. Standard 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 Ausgabe des Statuszeilenbefehls 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 beschränkt Sitzungen mit Modellen mit nativem 1M-Fenster, etwa Sonnet 5.5 und den Fable-Modellen, auf ein 200K-Fenster; unter Erweiterter Kontext erfahren Sie, wie die Beschränkung 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 durch MAX_THINKING_TOKENS gesteuert wird. Hat keine Wirkung auf Fable-Modelle, Sonnet 5 und höher oder Opus 4.7 und höher, die immer adaptives Reasoning verwenden
CLAUDE_CODE_DISABLE_ADMIN_ENV_UNION Setzen Sie 1, damit Claude Code env-Blöcke aus verwalteten Einstellungen nicht mehr pro Schlüssel ü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 den Einstellungen bereitgestellte 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 ist nicht mehr verfügbar, ein konfiguriertes advisorModel wird ignoriert, und das Flag --advisor wird zwar akzeptiert, hat aber keine Wirkung, sodass bestehende Skripte, die es übergeben, ohne Fehler weiter funktionieren
CLAUDE_CODE_DISABLE_AGENT_VIEW Setzen Sie 1, um Hintergrundagenten und die Agentenansicht auszuschalten: claude agents, --bg, /background und den bedarfsgesteuerten Supervisor. Entspricht der Einstellung disableAgentView
CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN Setzen Sie 1, um das Vollbild-Rendering zu deaktivieren und den klassischen Hauptbildschirm-Renderer 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 wechseln. 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 Sitzungsausgaben 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 reiner Text gesendet, anstatt in Dateiinhalte erweitert zu werden
CLAUDE_CODE_DISABLE_AUTH_REFRESH_LOCK Setzen Sie 1, damit ein Claude Code-Prozess seinen Befehl gcpAuthRefresh oder awsAuthRefresh selbst ausführt, anstatt 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 zwangsweise einzuschalten, auch wenn der --bare-Modus oder autoMemoryEnabled: false es sonst deaktivieren würde. 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 Ctrl+B
CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_DEFAULT Setzen Sie 1, damit Claude Code eine Streaming-Antwort von Amazon Bedrock mit fehlendem oder leerem Content-Type-Header nicht mehr als binären Event-Stream von Amazon Bedrock behandelt. Standardmäßig geht Claude Code davon aus, dass ein Gateway den Header aus einer ansonsten unveränderten Antwort entfernt hat, und dekodiert daher den Body, sodass das Streaming weiter funktioniert. 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 Streaming-Antwort von Amazon Bedrock den Content-Type application/vnd.amazon.eventstream trägt. Ohne diese Variable lässt Claude Code die Anfrage bei einer Antwort mit anderem Content-Type mit einem Fehler fehlschlagen, der diesen Typ nennt; das bedeutet, dass ein Gateway oder Proxy die Antwort transformiert. Konfigurieren Sie das Gateway so, dass es den Content-Type-Header und den Body unverändert weiterleitet, anstatt diese Variable zu setzen. Erfordert Claude Code v2.1.208 oder höher
CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF Setzen Sie 1, um die laufenden Hintergrund-Shell-Befehle, dynamischen Workflows und ab v2.1.198 auch die Hintergrund-Subagenten einer Hintergrundsitzung zu beenden, wenn der Supervisor den Prozess dieser Sitzung stoppt, neu startet oder aktualisiert, anstatt 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 mehr beendet. Standardmäßig beendet Claude Code unter macOS und Linux Hintergrund-Shells, wenn das Betriebssystem kritischen Speicherdruck meldet und die Sitzung seit 30 Minuten ohne laufenden Turn oder Subagenten im Leerlauf ist. 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 und dabei den Chrome-Abschnitt des System-Prompts und den mitgelieferten Skill /claude-in-chrome wegzulassen. Für Hosts, die Claude Code einbetten und eigene Browser-Anleitungen 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 sind nicht mehr 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 beim Entfernen kritischer Pfade auszuschalten. Im Modus auto sendet Claude Code diese Entfernungen 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 den Einstellungen bereitgestellte Kopie ignoriert. Erfordert Claude Code v2.1.281 oder höher
CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS Setzen Sie 1, um anthropic-beta-Request-Header für Vorabversionen, die zugehörigen Body-Felder sowie Beta-Felder des 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. Vorabfunktionen 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 Suchtools oder dem General-Purpose-Subagenten, und der Plan-Modus liest Dateien direkt, anstatt Explore- und Plan-Agenten zu starten. Benutzerdefinierte Subagenten namens 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, anstatt 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 Datei-Checkpointing 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 Claudes Kontext 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 Entfernungen kritischer Pfade hin liest. Claude Code prüft weiterhin die Ziele aus Shell-Variablen und Positionsparametern in diesen Skripten, und die anderen 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 den Einstellungen bereitgestellte Kopie ignoriert. Erfordert Claude Code v2.1.288 oder höher
CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP Setzen Sie 1, um die automatische Neuzuordnung von Opus 4.0 und 4.1 zur aktuellen Opus-Version in der Anthropic API zu verhindern. Verwenden Sie dies, wenn Sie bewusst ein älteres Modell fixieren möchten. Die Neuzuordnung findet bei Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry nicht statt
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 stattdessen 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 im Vollbild-Rendering zu deaktivieren. Das Scrollen per Tastatur mit PgUp und PgDn funktioniert weiterhin. Verwenden Sie dies, um das native Verhalten Ihres Terminals beizubehalten, beim Auswählen zu kopieren
CLAUDE_CODE_DISABLE_MOUSE_CLICKS Setzen Sie 1, um die Verarbeitung von Klicken, Ziehen und Hovern im Vollbild-Rendering zu deaktivieren, während das Scrollen mit dem Mausrad erhalten bleibt. Verwenden Sie dies, wenn das Scrollen mit dem Mausrad in Claude Code funktionieren soll, Klicks aber nicht den Cursor positionieren, Tool-Ausgaben 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 zugehörigen 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 wesentlichen Netzwerkverkehr zu deaktivieren: automatische Updates, Telemetrie, Fehlerberichte, den Befehl /feedback, von Claude entworfenes Feedback, Versionshinweise, die Prüfungen für das PR- und MR-Statusabzeichen sowie Verfügbarkeitsprüfungen wie die Prüfung für den Fast-Modus. Außerdem werden die Hintergrundläufe von Plugin-command-Quellen gestoppt, bei denen es sich um lokale Befehle und nicht um Netzwerkverkehr handelt, 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 separat aktiviert werden muss
CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK Setzen Sie 1, um den Fallback ohne Streaming zu deaktivieren, wenn eine Streaming-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 verursacht
CLAUDE_CODE_DISABLE_NOTIFICATION_PRESENCE_CHECK Setzen Sie 1, um die Desktop-Benachrichtigung des Tools PushNotification auch dann zu senden, wenn Sie im Terminal tippen oder es im Fokus haben. Standardmäßig überspringt das Tool sowohl die Desktop-Benachrichtigung als auch den Push auf Mobilgeräte, wenn es kürzliche Tastaturaktivität oder Terminalfokus erkennt. Diese Variable deaktiviert nur diese lokale Prüfung, sodass der Server den Push auf Mobilgeräte 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 den Marketplace registrieren will, in der Regel beim ersten interaktiven Start auf einem Rechner. Wenn die Variable zu diesem Zeitpunkt gesetzt ist, überspringt Claude Code die Registrierung dauerhaft. Das spätere Entfernen der Variable 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 nicht mehr in Sitzungen ausführt, in denen Claude Code diese an den canUseTool-Callback des Agent SDK sendet; auf diese Weise 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 Laufwerksstamm 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; dieses Verhalten wird durch die Einstellung switchModelsOnFlag gesteuert
CLAUDE_CODE_DISABLE_STRUCTURED_OUTPUTS Setzen Sie 1, damit Claude Code das Feld output_config.format für strukturierte Ausgaben und den zugehörigen anthropic-beta-Wert nicht mehr sendet, etwa für ein LLM-Gateway, dessen Upstream diese ablehnt. Die anderen Vorabfunktionen, 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 die Ausgabe einer Befehlssubstitution ist, etwa rm -rf "$(pwd)". Die anderen 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 den Einstellungen bereitgestellte 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 Basis des Konversationskontexts zu deaktivieren. Dadurch wird auch die Hintergrundanfrage an das kleine/schnelle Modell übersprungen, die einen Sitzungstitel generiert
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 nachdenken, bedeutet das Weglassen des Parameters, dass das Modell trotzdem nachdenken kann. Um Extended Thinking in der Anthropic API explizit 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 proaktive automatische Komprimierung zu überspringen, wenn Claude Code die Modell-ID nicht erkennt, etwa einen Alias eines LLM-Gateways. Ohne diese Variable komprimiert Claude Code anhand des Kontextfensters, 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 im Vollbild-Rendering zu deaktivieren und jede Nachricht im Transkript darzustellen. Verwenden Sie dies, wenn beim Scrollen im Vollbildmodus leere Bereiche angezeigt werden, wo Nachrichten erscheinen sollten
CLAUDE_CODE_DISABLE_WEB_FETCH Setzen Sie 1, um das Tool WebFetch auszuschalten. Das Tool WebSearch 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 PowerShell-Befehl, der im Hintergrund läuft, in den nächsten Prozess der Sitzung übernommen wird, etwa wenn Sie die Sitzung in den Hintergrund verschieben. Wenn Sie die Variable setzen, wird ein in den Hintergrund verschobener PowerShell-Befehl beendet, wenn der Prozess der Sitzung endet. 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 Modellstandard zu verwenden. Die verfügbaren Stufen hängen vom Modell ab. Hat Vorrang vor --effort, /effort sowie den Einstellungen modelSettings und effortLevel. Eine Obergrenze durch maxEffortLevel gilt weiterhin. Siehe Effort-Stufe anpassen
CLAUDE_CODE_ENABLE_AUTO_MODE Wird aus Kompatibilitätsgründen mit älteren Releases 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 angemeldeten Claude apps gateway-Sitzungen. 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 /config-Schalter auszuschalten. Auf 1 setzen, um Zusammenfassungen zu erzwingen, wenn awaySummaryEnabled false ist. Hat Vorrang vor der Einstellung und dem /config-Schalter
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, weil die Aktualisierung den System-Prompt mitten in der Sitzung ändert, was das Prompt-Caching für diesen Turn ungültig macht
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 weiterzuleiten, 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 Organisationsrichtlinie für Produktfeedback haben Vorrang
CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING Steuert, ob Tool-Aufruf-Eingaben von der API gestreamt werden, während Claude sie generiert. Ist dies deaktiviert, kommt eine große Tool-Eingabe, etwa ein langer Dateischreibvorgang, erst an, nachdem Claude sie vollständig generiert hat, was wie ein Hängen wirken kann. Standardmäßig in der Anthropic API aktiviert. Auf Amazon Bedrock und Google Cloud's Agent Platform pro Modell aktiviert, sofern der bereitgestellte Container es unterstützt. Auf 0 setzen, um es abzuwählen. Auf 1 setzen, um es zu erzwingen, wenn über einen Proxy per ANTHROPIC_BASE_URL, ANTHROPIC_VERTEX_BASE_URL oder ANTHROPIC_BEDROCK_BASE_URL geroutet wird. Standardmäßig deaktiviert bei Microsoft Foundry und Gateway-Verbindungen
CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY Auf 1 setzen, um die /model-Auswahl aus dem /v1/models-Endpunkt 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, weil Gateways mit einem gemeinsam genutzten API-Schlüssel 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 Entfernt in v2.1.142, 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 auszuschalten, also die ausgegrauten Vorhersagen, die in Ihrer Prompt-Eingabe 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 eingeschaltet zu lassen, bis Sie das Limit erreichen. 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 die Variable in Ihrer Shell, in den Benutzereinstellungen oder in den verwalteten Einstellungen. Wird in Projekt- und lokalen Einstellungen ignoriert. Siehe Monitoring
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 des Task-Tools aufgeführt sind. CLAUDE_CODE_ENABLE_TASKS legt weiterhin fest, ob die Task-Tools oder TodoWrite verwendet werden. Erfordert Claude Code v2.1.233 oder höher
CLAUDE_CODE_EXIT_AFTER_STOP_DELAY Zeit in Millisekunden, die nach dem Leerlauf der Abfrageschleife gewartet wird, bevor 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 Hintergrund-Supervisor-Prozess geerbt hatte
CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS Überschreibt das Standard-Token-Limit für Dateilesevorgänge. Nützlich, wenn Sie größere Dateien vollständig lesen müssen
CLAUDE_CODE_FORCE_SESSION_PERSISTENCE Auf 1 setzen, um die Speicherung von Transkripten, 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 CLAUDE_CODE_CHILD_SESSION-Wert, etwa 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älschlich 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 Durchstreichungsdarstellung für ~~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, statt den Text durchgestrichen darzustellen. Erfordert Claude Code v2.1.186 oder höher
CLAUDE_CODE_FORCE_SYNC_OUTPUT Auf 1 setzen, um den DEC-Private-Mode 2026 synchronisierte Ausgabe zwangsweise zu aktivieren, wenn Ihr Terminal ihn 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. Anders als CLAUDE_CODE_NO_FLICKER, das auf Vollbilddarstellung 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 einzuschalten, oder auf 0, um ihn in jeder Art von Sitzung auszuschalten. 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 einzuschalten
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. Anders als das 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 weiterhin 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, einschließlich 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; 0, negative Werte und andere Schreibweisen behalten den Standard bei. 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, aber nicht in Ihrem PATH ist. Wenn der Pfad nicht existiert oder die Datei nicht bash.exe, sh.exe, bash oder sh heißt, ignoriert Claude Code die Variable und 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 handelte. Siehe Einrichtung unter Windows
CLAUDE_CODE_GLOB_HIDDEN Auf false setzen, um Dotfiles von 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 ihre eigene respectGitignore-Einstellung 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, danach zu sehen. Standard 30. Auf 0 setzen, um die Nachfragen auszuschalten. Geben Sie ganze Minuten als reine Ziffern an, höchstens 10080, was einer Woche entspricht. 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 offenlegt
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 während der Verbindung 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 als reine 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 routen, 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 als reine 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 oberhalb der Obergrenze eines Modells auf die Obergrenze. Für eine Modell-ID, die Claude Code keinem bekannten Modell zuordnen kann, beträgt der Standard 32000 und die Obergrenze 128000. Eine Erhöhung dieses Werts verringert das effektiv verfügbare Kontextfenster, 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. Setzen Sie für unbeaufsichtigte Sitzungen, die längere Ausfälle abwarten müssen, stattdessen CLAUDE_CODE_RETRY_WATCHDOG
CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION Entfernt in v2.1.224 und jetzt ohne Wirkung. Begrenzte zuvor die Gesamtzahl der Subagenten, die Claude in einer Sitzung mit dem Agent-Tool 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 Subagenten-Ebenen, die unterhalb der Hauptkonversation zulässig sind (Standard: 3). Beim Standard können Subagenten ihre eigenen Subagenten starten, und ein Subagent auf der dritten Ebene kann keine weiteren starten; auf 1 setzen, um die Verschachtelung auszuschalten. In v2.1.217 bis v2.1.218 war der Standard 1, sodass ein Subagent keine eigenen starten konnte, es sei denn, Sie haben das Limit erhöht; v2.1.219 hob den Standard auf 3 an. Akzeptiert eine positive ganze Zahl als reine 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 an nur lesenden 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 durchführen kann (Standard: 200). Wenn Claude die Obergrenze erreicht, geben weitere WebSearch-Aufrufe einen Hinweis zurück, der Claude auffordert, 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 ausgeschaltet 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 das automatische Verschieben in den Hintergrund auszuschalten. 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 verbinden, anstelle der standardmäßigen Wartezeit im ersten Turn. Wenn gesetzt, gilt die Wartezeit für jeden ausstehenden Server. Auf 0 setzen, um die Wartezeit 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 übergreifende MCP_TOOL_TIMEOUT zu warten. Überschreibt die transportspezifischen Standardwerte 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 in .mcp.json von mindestens 1000 hebt das Leerlauffenster dieses Servers auf mindestens den timeout-Wert an. Gilt nicht für IDE-Server oder In-Process-Server des SDK. 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 Posteingangs-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 einer übergeordneten Sitzung geerbten, und eingehende Nachrichten durchlaufen die Steuerung eingehender Nachrichten der Sitzung. env-Blöcke in Einstellungen können die Variable 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 Posteingangs-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 erfordert 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 die Variable nicht setzen. Erfordert Claude Code v2.1.228 oder höher
CLAUDE_CODE_NATIVE_CURSOR Auf 1 setzen, um den eigenen Cursor des Terminals an der Eingabemarke anstelle eines gezeichneten Blocks anzuzeigen. Der Cursor berücksichtigt die Blink-, Form- und Fokuseinstellungen des Terminals
CLAUDE_CODE_NEW_INIT Auf 1 setzen, damit /init einen interaktiven Einrichtungsablauf ausführt. Der Ablauf fragt, welche Dateien generiert werden sollen, einschließlich CLAUDE.md, Skills und Hooks, bevor er die Codebasis untersucht und sie schreibt. Ohne diese Variable generiert /init automatisch eine CLAUDE.md, ohne nachzufragen
CLAUDE_CODE_NONBLOCKING_STDOUT Auf 1 setzen, um die Terminalausgabe über einen zweiten, nicht blockierenden Dateideskriptor zu schreiben, sodass ein Terminal, das aufhört zu lesen, etwa ein pausiertes tmux-Control-Mode-Pane 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-Streaming-Anfrage, die in einen Timeout läuft, 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. Siehe Wiederholungsverhalten anpassen für den Timeout. Erfordert Claude Code v2.1.285 oder höher
CLAUDE_CODE_NO_FLICKER Auf 1 setzen, um die Vollbilddarstellung 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, um die Authentifizierung in automatisierten Umgebungen bereitzustellen
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. Erzeugen 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, erzeugen Sie ein neues und starten Sie neu
CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE Entfernt in v2.1.160 und jetzt ohne Wirkung. Legte den Fast-Modus zuvor 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-Bodies), einschließlich Kürzungsmarkierung, in UTF-16-Codeeinheiten (Standard: 61440, also 60 KB). Erhöhen Sie den Wert nur, wenn Ihr Telemetrie-Backend Attributwerte größer als 64 KB akzeptiert, oder senken Sie ihn, um das Telemetrievolumen zu reduzieren. Erfordert Claude Code v2.1.214 oder höher. Siehe Monitoring
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, sonst unbemerkt fehlschlägt. Erfordert Claude Code v2.1.179 oder höher. Siehe Monitoring
CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS Timeout in Millisekunden für das Leeren ausstehender OpenTelemetry-Spans (Standard: 5000). Siehe Monitoring
CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS Intervall in Millisekunden für die Aktualisierung dynamischer OpenTelemetry-Header (Standard: 1740000 / 29 Minuten). Siehe Dynamische Header
CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS Timeout in Millisekunden, in dem der OpenTelemetry-Exporter beim Herunterfahren abschließen muss (Standard: 2000). Erhöhen Sie den Wert, wenn Metriken beim Beenden verloren gehen. Siehe Monitoring
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 den Upgrade-Befehl weiterhin an, ohne ihn auszuführen. Siehe Automatische Updates
CLAUDE_CODE_PERFORCE_MODE Auf 1 setzen, um Perforce-bewussten Schreibschutz zu aktivieren. Wenn gesetzt, schlagen Edit, Write und NotebookEdit mit einem p4 edit <file>-Hinweis fehl, wenn der Zieldatei das Schreibbit für den Besitzer fehlt, das Perforce bei synchronisierten Dateien löscht, bis p4 edit sie öffnet. Dies verhindert, dass Claude Code die Änderungsverfolgung von Perforce umgeht
CLAUDE_CODE_PLUGIN_CACHE_DIR Überschreibt das Stammverzeichnis für Plugins. Trotz des Namens legt dies das übergeordnete Verzeichnis fest, nicht den Cache selbst: Marketplaces und der Plugin-Cache befinden sich 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 unter Unix mit : oder unter Windows mit ;. 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 nicht daran authentifizieren kann. Nützlich in Offline- oder Air-Gapped-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, unter Unix durch : oder unter Windows durch ; getrennt. 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 sie erneut zu 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 dem Standard Restricted funktionieren. Die Umgehung auf Prozessebene überschreibt niemals die Gruppenrichtlinien MachinePolicy oder UserPolicy, unabhängig von dieser Einstellung
CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS Obergrenze in Millisekunden für das Warten im Leerlauf auf Hintergrund-Subagenten und Workflows nach dem letzten Turn im nicht interaktiven Modus mit dem Flag -p. Das Warten im Leerlauf beginnt jedes Mal neu, wenn Claude einen Turn ausführt, um ein Hintergrundergebnis zu verarbeiten. Standard: 600000, also 10 Minuten. Wenn das Warten im Leerlauf die Obergrenze erreicht, hört Claude Code auf, auf die verbleibenden Hintergrundaufgaben zu warten, und wird beendet. 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. Siehe Claude Code hinter einem Unternehmens-Launcher ausführen für das Werteformat, den Umfang des Launchers und die Anforderungen, die 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 Auf 5m oder 1h setzen, 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 direkt 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 1-Stunden-Cache-Schreibvorgänge zu einem höheren Tarif. 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 traceparent-Header bei Modell- und HTTP-MCP-Anfragen sowie die Umgebungsvariable TRACEPARENT für Bash-, PowerShell- und Hook-Unterprozesse. Standardmäßig ist die Weitergabe nur bei direkter 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 seinem Namen verwalten. Wenn gesetzt, ignoriert Claude Code Variablen zur Anbieterauswahl, zu Endpunkten und zur 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 Hostnamensauflösung übernehmen soll
CLAUDE_CODE_REMOTE Wird automatisch auf true gesetzt, wenn Claude Code als Cloud-Sitzung läuft. Lesen Sie die Variable in einem Hook oder Setup-Skript aus, um zu erkennen, 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 sie 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 auszuschalten, entfernen Sie die Variable oder setzen Sie sie auf 0. Für das VS Code-Chatpanel siehe Konversationen nach einem Neuladen fortsetzen
CLAUDE_CODE_RESUME_INTERRUPTED_TURN_MAX_AGE_MS Maximales Alter in Millisekunden der letzten Transkriptnachricht, damit eine Sitzung, die mitten in einem Turn endete, beim Fortsetzen automatisch weiterläuft. Ist die letzte Nachricht älter als diese Grenze, überspringt Claude Code das automatische Fortsetzen per 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 wendet eine Grenze von einer Stunde an. 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 Zeichenfolge verwendet den Standard
CLAUDE_CODE_RETRY_WATCHDOG Auf 1 setzen für unbeaufsichtigte Sitzungen wie Eval-Harnesses, CI-Jobs oder Remote-Worker. Versucht Kapazitätsfehler 429 und 529 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 erschöpftes Nutzungsguthaben meldet, selbst wenn er von einer Gateway-Ausgabenobergrenze stammt, die 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 das Limit zurückgesetzt wird, 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, wenn 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 Themes, 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, Statuszeile 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) dennoch 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 in der Vollbilddarstellung 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 vim zu entsprechen, wenn Ihr Terminal ein Mausrad-Event pro Raste ohne Verstärkung sendet. Wird im Terminal der JetBrains-IDE ignoriert, wo Claude Code seine eigene Scroll-Behandlung verwendet
CLAUDE_CODE_SEND_FEEDBACK Auf 0 setzen, um von Claude entworfenes Feedback für eine Sitzung auszuschalten. Auf 1 setzen, um es einzuschalten, wenn Ihr Konto bereits Zugriff hat; die Variable kann selbst keinen Zugriff gewähren, und die anderen Schalter, die Feedback ausschalten, etwa 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 außerdem der Timeout für jeden Hook, der keinen eigenen timeout festlegt. Gilt für das Beenden der Sitzung, /clear und das Wechseln von Sitzungen über das interaktive /resume. Standardmäßig beträgt das Budget 1,5 Sekunden und wird automatisch auf den höchsten in Einstellungsdateien konfigurierten hookspezifischen timeout angehoben, bis zu 60 Sekunden. Timeouts von Hooks aus Plugins erhöhen das Budget nicht
CLAUDE_CODE_SESSION_ID Wird automatisch in Unterprozessen des Bash- und PowerShell-Tools, in Unterprozessen von Hook-Befehlen und in Unterprozessen von stdio-MCP-Servern auf die aktuelle Sitzungs-ID gesetzt. Bei Bash, PowerShell und Hooks entspricht dies dem Feld session_id in der JSON-Eingabe des 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 ID der fortgesetzten Sitzung, 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 in Beziehung zu setzen, die sie gestartet hat
CLAUDE_CODE_SHELL Legt die Shell fest, die Claude Code zur Ausführung von Bash-Tool-Befehlen 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 fällt auf die automatische Erkennung zurück. Die automatische Erkennung verwendet Ihr $SHELL, wenn es auf bash oder zsh zeigt, andernfalls wählt sie die erste funktionierende zsh und dann 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: Bash-Tool-Aufrufe, 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. Wird ein reiner Pfad zu einer ausführbaren Datei wie /path/to/logger.sh gesetzt, wird jeder Befehl als /path/to/logger.sh '<command>' ausgeführt. Der Wrapper erhält die Befehlszeile als einzelnes, für die Shell quotiertes Argument in $1, daher muss der Wrapper $1 mit einer Shell neu 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 Bash-Tool-Aufrufen 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 für Bash, Dateilesen und Dateibearbeitung 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 verkürzte Tool-Beschreibungen zu verwenden. Auf 0, false, no oder off setzen, um dies auch bei Modellen abzuwählen, bei denen das Experiment oder die Serverkonfiguration es sonst aktivieren würde. Der vollständige Tool-Satz, Hooks, MCP-Server und die Erkennung von CLAUDE.md 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 auszuschalten, die über die standardmäßige AWS-Credential-Provider-Chain aufgelöst werden, sodass Claude Code die Chain bei jeder API-Anfrage auflöst. Bei ausgeschaltetem Cache fordert ein SSO-gestütztes Profil bei jeder Anfrage Anmeldedaten von IAM Identity Center an. Siehe Caching 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 seinen 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 auf Amazon Bedrock und Google Cloud's Agent Platform merken sich auf diesem Rechner bis zu einen Tag lang, welche Modelle Ihr Konto laut ihren Ergebnissen nicht aufrufen kann. Auf 1 setzen, um dieses Merken auszuschalten. Erfordert Claude Code v2.1.285 oder höher
CLAUDE_CODE_SKIP_PROMPT_HISTORY Auf 1 setzen, um das Schreiben des Prompt-Verlaufs und der Sitzungstranskripte auf die Festplatte zu überspringen. Sitzungen, die mit gesetzter Variable gestartet wurden, erscheinen nicht in --resume, --continue oder im Verlauf über die Pfeil-nach-oben-Taste. Nützlich für kurzlebige, per Skript gesteuerte 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 mit dem Grund, warum Claude Code den Start verweigert hat, schreibt. 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 Ende 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 nicht auf andere Weise ein Modell 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 das zu ändern, setzen Sie CLAUDE_CODE_SUBAGENT_MODEL_FORCE. Siehe Ein Modell wählen für die vollständige Reihenfolge. Das Setzen auf inherit entspricht dem Nicht-Setzen. 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 ein Modell für Subagenten, Teammitglieder und Workflow-Agenten zu erzwingen. Jeden Subagenten mit einem Modell ausführen beschreibt, welches Modell das ist. Erfordert Claude Code v2.1.257 oder höher
CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL Auf 5m oder 1h setzen, die einzigen Werte, die Claude Code akzeptiert, um die Prompt-Cache-TTL für Anfragen außerhalb der Hauptkonversation zu wählen, etwa für 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 1-Stunden-Cache-Schreibvorgänge zu einem höheren Tarif. Erfordert Claude Code v2.1.242 oder höher
CLAUDE_CODE_SUBPROCESS_ENV_SCRUB Auf 1 setzen, um Anmeldedaten aus Unterprozessumgebungen (Bash-Tool, Hooks, stdio-MCP-Server) zu entfernen: Anmeldedaten von Anthropic und Cloud-Anbietern, jede andere Variable, die Claude Code als Anmeldedaten erkennt, sowie in Paket-Registry-URLs eingebettete Anmeldedaten. Der übergeordnete Claude-Prozess behält diese Anmeldedaten für API-Aufrufe, aber Kindprozesse können sie nicht lesen, was die Angriffsfläche für Prompt-Injection-Angriffe verringert, die versuchen, Geheimnisse über Shell-Expansion abzugreifen. Ab v2.1.251 entfernt die Bereinigung außerdem die eigenen Zeigervariablen von Claude Code auf den Konfigurationsspeicher (etwa CLAUDE_CONFIG_DIR), sodass ein Kindprozess ein verlagertes Konfigurationsverzeichnis nicht finden kann. Lassen Sie die Bereinigung ungesetzt, wenn ein Unterprozess diese Variablen benötigt. Unter Linux werden Bash-Unterprozesse dadurch außerdem in einem isolierten PID-Namespace ausgeführt, sodass sie Umgebungen von Host-Prozessen nicht über /proc lesen können; als Nebeneffekt können ps, pgrep und kill Host-Prozesse weder sehen noch ihnen Signale senden. 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 im ersten Turn möglicherweise nicht verfügbar. Kombinieren Sie sie 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 Standard: 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 eine claude.ai-Authentifizierung. Terminalsitzungen, 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 Terminalsitzungen 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 Skill-Neusynchronisierung, 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, den 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 mit Ihrer Terminal-Einrichtung in Konflikt geraten. 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 darauf wartet, dass 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}/ und unter Windows /claude/ an diesen Pfad an. Standard: /tmp unter macOS, os.tmpdir() unter Linux und Windows. Unter macOS und Linux erhalten in der Sandbox ausgeführte Bash-Unterprozesse ein kurzes Fallback-$TMPDIR unter dem Systemstandard, wenn Ihre Überschreibung ein langer Pfad ist, da manche Tools fehlschlagen, wenn temporäre Pfade zu lang werden. Bash-Befehle ohne Sandbox erben das $TMPDIR Ihrer Shell, wenn es gesetzt ist. Unter nativem Windows erhält ein Bash-Befehl, der auf $TMPDIR verweist, Ihre Überschreibung oder %TEMP%, wenn Sie keine gesetzt haben, sofern Ihre Shell $TMPDIR nicht setzt. Die eigenen temporären Dateien von Claude Code verwenden immer Ihre Überschreibung. Setzen Sie die Variable in Ihrer Shell, in den Benutzereinstellungen oder in den verwalteten Einstellungen. Wird in Projekt- und lokalen Einstellungen ignoriert
CLAUDE_CODE_TMUX_TRUECOLOR Auf einen beliebigen nicht leeren Wert, etwa 1, setzen, um 24-Bit-Truecolor-Ausgabe innerhalb von tmux zu erlauben. Das Setzen auf 0 oder false erlaubt weiterhin Truecolor, anders als bei den meisten Ein/Aus-Variablen; entfernen Sie die Variable, um die Begrenzung auf 256 Farben wiederherzustellen. Standardmäßig begrenzt Claude Code die Ausgabe auf 256 Farben, wenn $TMUX gesetzt ist, da tmux Truecolor-Escape-Sequenzen nur weitergibt, wenn es entsprechend konfiguriert ist. Setzen Sie dies, nachdem Sie set -ga terminal-overrides ',*:Tc' zu Ihrer ~/.tmux.conf hinzugefügt haben. Siehe Terminalkonfiguration für weitere tmux-Einstellungen
CLAUDE_CODE_TOOL_MEMORY_CGROUP_EXCLUDE Unter Linux und WSL auf eine durch Kommas getrennte Liste der Prozessarten setzen, die Claude Code von der Speicherobergrenze für Tools ausnimmt, etwa mcp oder lsp. Auf none setzen, um jede Art zu begrenzen, oder auf all-new, um nur Befehle der Bash-, PowerShell- und Monitor-Tools zu begrenzen. Claude Code hält Befehle der 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 der Bash- und PowerShell-Tools nutzen können, ab v2.1.246 auch für Befehle des Monitor-Tools. Geben Sie die Größe als reine Ziffern an, allein für eine Anzahl von Bytes oder mit einem Suffix K, M, G oder T. Auf 0 oder off setzen, um die Obergrenze auszuschalten. Sobald der erste von Claude Code gestartete Prozess die Obergrenze ein- oder ausgeschaltet hat, wird ein geänderter Wert erst beim nächsten Start von claude wirksam. Erfordert Claude Code v2.1.233 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 dieser Frist nicht. Ab Claude Code v2.1.236 begrenzt sie außerdem die Einwilligungsabfrage für Fable-Nutzungsguthaben mitten in einer Sitzung, die 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 Claude Platform on AWS verwenden
CLAUDE_CODE_USE_BEDROCK Amazon Bedrock verwenden
CLAUDE_CODE_USE_FOUNDRY Microsoft Foundry verwenden
CLAUDE_CODE_USE_MANTLE Den Amazon Bedrock-Mantle-Endpunkt verwenden
CLAUDE_CODE_USE_NATIVE_FILE_SEARCH Auf 1 setzen, um benutzerdefinierte Befehle, Subagenten und Ausgabestile mit den Datei-APIs von Node.js 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 Dateisuch-Tools aus
CLAUDE_CODE_USE_POWERSHELL_TOOL Steuert das PowerShell-Tool. Unter Windows ohne Git Bash wird das Tool automatisch aktiviert; auf 0 setzen, um es zu deaktivieren. Unter Windows mit installiertem Git Bash ist das Tool für claude.ai- und Console-Konten standardmäßig aktiviert; auf 1 setzen, um es in Sitzungen mit Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry zu aktivieren, oder auf 0, um es auszuschalten. Unter Linux, macOS und WSL auf 1 setzen, um es zu aktivieren, was pwsh in Ihrem PATH erfordert. Wenn es 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 Google Cloud's Agent Platform verwenden
CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS Legen Sie hier die Anzahl der Millisekunden fest, 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. Setzen Sie den Wert auf 0, 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 noch laufenden Hintergrund-Subagenten zu sehen. 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 die Variable nicht gesetzt ist, 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; wartende 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, anstatt es jeweils ohne Cache zu verarbeiten. Standard 5000. Setzen Sie den Wert auf 0, 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 nebeneinander zu betreiben: 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 Setzen Sie den Wert auf 1, um laufende Hintergrundarbeit zu beenden, anstatt 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 beendet 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 Setzen Sie den Wert auf 1, 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 die Variable nicht gesetzt ist, 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 Ereignisebene dort einen Stillstand melden konnte, selbst während Keep-alive-Pings eintrafen. Zu Timeouts und zum Zusammenspiel der Timer siehe Streaming-Leerlauf-Watchdogs
CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK Setzen Sie den Wert auf 1, 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 Setzen Sie den Wert auf 0, um den Streaming-Leerlauf-Watchdog auf Ereignisebene zwangsweise zu deaktivieren, oder auf 1, um ihn zwangsweise zu aktivieren. Wenn die Variable nicht gesetzt ist, ist der Watchdog standardmäßig für alle Anbieter aktiv. Vor v2.1.196 wurde der Standard ohne gesetzte Variable bei der direkten Anthropic API serverseitig gesteuert und war bei anderen Anbietern deaktiviert. Konfigurieren Sie den Timeout mit CLAUDE_STREAM_IDLE_TIMEOUT_MS; zu den anderen Stillstands-Timern, die parallel zu diesem laufen, siehe 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 diese Variable in den von ihm gestarteten Subprozessen auf seine eigene Prozess-ID: Befehle des Bash- und PowerShell-Tools sowie Hook-Befehle. Unter Linux verwendet die Shell-Integration des Bash-Tools sie, 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 wird. 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 Request-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 Ereignis- und Byte-Ebene eine blockierte 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. Zu den Standardwerten der einzelnen Watchdogs ohne gesetzte Variable siehe Streaming-Leerlauf-Watchdogs
CLAUDE_SUBAGENT_BG_SHELL_MAX_MS In v2.1.260 entfernt und jetzt wirkungslos. Begrenzte zuvor in Millisekunden, wie lange ein von einem Subagenten gestarteter Shell-Befehl im Hintergrund laufen konnte, mit einem Standard von 60 Minuten. Siehe die Regeln zur Lebensdauer von Hintergrundbefehlen
DEBUG Setzen Sie den Wert auf 1, um den Debug-Modus zu aktivieren, entsprechend einem Start mit --debug. Debug-Logs werden nach ~/.claude/debug/<session-id>.txt geschrieben oder in den durch CLAUDE_CODE_DEBUG_LOGS_DIR festgelegten Pfad. 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 Setzen Sie den Wert auf 1, um automatische Hintergrundupdates zu deaktivieren. Ein manuelles claude update funktioniert weiterhin. Verwenden Sie DISABLE_UPDATES, um beides zu blockieren
DISABLE_AUTO_COMPACT Setzen Sie den Wert auf 1, 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 Setzen Sie den Wert auf 1, um jegliche Komprimierung zu deaktivieren: sowohl die automatische Komprimierung als auch den manuellen Befehl /compact
DISABLE_COST_WARNINGS Setzen Sie den Wert auf 1, um Kostenwarnungen zu deaktivieren
DISABLE_DOCTOR_COMMAND Setzen Sie den Wert auf 1, 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 Setzen Sie die Variable auf einen beliebigen nicht leeren Wert, etwa 1, um die Fehlerberichterstattung abzulehnen. Auch ein Wert von 0 oder false deaktiviert sie, anders als bei den meisten Ein/Aus-Variablen; entfernen Sie die Variable, um die Fehlerberichterstattung wieder einzuschalten
DISABLE_EXTRA_USAGE_COMMAND Setzen Sie den Wert auf 1, um den Befehl /usage-credits auszublenden, mit dem Benutzer zusätzliche Nutzung über die Rate-Limits hinaus erwerben können
DISABLE_FEEDBACK_COMMAND Setzen Sie den Wert auf 1, um den Befehl /feedback und von Claude entworfenes Feedback zu deaktivieren. Deaktiviert auch /bug und /share, die über denselben Weg berichten; vor v2.1.212 waren sie Aliase von /feedback, sodass der Befehl unter jedem Namen deaktiviert wurde. Der ältere Name DISABLE_BUG_COMMAND wird ebenfalls akzeptiert
DISABLE_GROWTHBOOK Setzen Sie den Wert auf 1 oder true, um das Abrufen von GrowthBook-Feature-Flags zu deaktivieren und für jedes Flag die Standardwerte aus dem Code zu verwenden. Dadurch sind Remote Control und die anderen Funktionen, die das Abrufen von Feature-Flags benötigen, nicht verfügbar. Ein Wert von 0 oder false lässt das Abrufen eingeschaltet. Das Logging von Telemetrieereignissen bleibt aktiv, sofern nicht auch DISABLE_TELEMETRY gesetzt ist
DISABLE_INSTALLATION_CHECKS Setzen Sie den Wert auf 1, um Installationswarnungen zu deaktivieren. Nur verwenden, wenn Sie den Installationsort manuell verwalten, da dies Probleme mit Standardinstallationen verdecken kann
DISABLE_INSTALL_GITHUB_APP_COMMAND Setzen Sie den Wert auf 1, 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 Setzen Sie den Wert auf 1, 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 Setzen Sie den Wert auf 1, um den Befehl /login auszublenden. Nützlich, wenn die Authentifizierung extern über API-Schlüssel oder apiKeyHelper erfolgt
DISABLE_LOGOUT_COMMAND Setzen Sie den Wert auf 1, um den Befehl /logout auszublenden
DISABLE_PROMPT_CACHING Setzen Sie den Wert auf 1, um Prompt-Caching für alle Modelle zu deaktivieren (hat Vorrang vor modellspezifischen Einstellungen)
DISABLE_PROMPT_CACHING_FABLE Setzen Sie den Wert auf 1, um Prompt-Caching für Fable-Modelle zu deaktivieren
DISABLE_PROMPT_CACHING_HAIKU Setzen Sie den Wert auf 1, um Prompt-Caching für das standardmäßige Haiku-Modell zu deaktivieren, unabhängig davon, wo es ausgeführt wird
DISABLE_PROMPT_CACHING_OPUS Setzen Sie den Wert auf 1, um Prompt-Caching für das standardmäßige Opus-Modell zu deaktivieren
DISABLE_PROMPT_CACHING_SONNET Setzen Sie den Wert auf 1, um Prompt-Caching für das standardmäßige Sonnet-Modell zu deaktivieren
DISABLE_TELEMETRY Setzen Sie die Variable auf einen beliebigen nicht leeren Wert, etwa 1, um Telemetrie abzulehnen. Auch ein Wert von 0 oder false deaktiviert sie, anders als bei den meisten Ein/Aus-Variablen; entfernen Sie die Variable, um die Telemetrie wieder einzuschalten. Telemetrieereignisse 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 Setzen Sie den Wert auf 1, 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 Setzen Sie den Wert auf 1, um den Befehl /upgrade auszublenden
DO_NOT_TRACK Setzen Sie den Wert auf 1, um Telemetrie abzulehnen, mit derselben Wirkung wie DISABLE_TELEMETRY, einschließlich der Auswirkung auf das Abrufen von Feature-Flags. Claude Code liest diese Variable als standardmäßigen booleschen Wert, sodass 0 die Telemetrie eingeschaltet lässt, und berücksichtigt sie als toolübergreifende Konvention, die von vielen Entwickler-CLIs anerkannt wird
ENABLE_BETA_TRACING_DETAILED Setzen Sie den Wert zusammen mit BETA_TRACING_ENDPOINT auf 1, um detailliertes Beta-Tracing einzuschalten, das inhaltstragende Span-Attribute und den Span claude_code.hook hinzufügt. Für interaktive CLI-Sitzungen muss Ihre Organisation zudem für die Beta freigeschaltet sein. Beide Variablen werden in Projekt- und lokalen Einstellungen ignoriert
ENABLE_CLAUDEAI_MCP_SERVERS Setzen Sie den Wert auf false, damit Claude Code keine claude.ai-MCP-Server mehr 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 Setzen Sie den Wert auf 1, um eine Prompt-Cache-TTL von 1 Stunde anstelle 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. Abonnement-Benutzer innerhalb der enthaltenen Nutzung erhalten die 1-Stunden-TTL automatisch für die Hauptkonversation. Abonnement-Benutzer, 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 Tarif 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. Ohne gesetzte Variable lädt Claude Code alle MCP-Tools standardmäßig verzögert. Vorab geladen werden sie weiterhin auf Modellen von Google Cloud's Agent Platform, die älter als die Generation Claude 4.5 sind, auf einer auf Azure gehosteten Microsoft-Foundry-Bereitstellung und wenn ANTHROPIC_BASE_URL auf einen Host verweist, der kein Erstanbieter-Host ist. true lädt immer verzögert und sendet den Beta-Header, außer auf denselben Agent-Platform-Modellen und Microsoft-Foundry-Bereitstellungen; Anfragen schlagen bei 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 von Ihnen 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 Setzen Sie die Variable auf einen beliebigen nicht leeren Wert, etwa 1, damit Claude Code bei wiederholten Überlastungsfehlern für jedes Modell keine weiteren Wiederholungsversuche unternimmt, wenn kein Fallback-Modell konfiguriert ist. Auch ein Wert von 0 oder false aktiviert dies, anders als bei den meisten Ein/Aus-Variablen; entfernen Sie die Variable, um das Standardverhalten für Wiederholungsversuche wiederherzustellen. Ohne die Variable stellt Claude Code die Wiederholungsversuche auf diese Weise nur 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 Setzen Sie den Wert auf 1, um automatische Plugin-Updates zu erzwingen, selbst wenn der Haupt-Auto-Updater über DISABLE_AUTOUPDATER deaktiviert ist
FORCE_HYPERLINK Setzen Sie den Wert auf 1, um klickbare 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 die Variable nicht gesetzt ist, aktiviert Claude Code Hyperlinks nur, wenn es Terminal-Unterstützung erkennt. Claude Code interpretiert diesen Wert als Zahl, nicht als booleschen Wert, daher aktiviert ein Wert wie false, no oder off Hyperlinks, statt sie zu deaktivieren. Das PR- oder Merge-Request-Badge in der Fußzeile wird als Hyperlink dargestellt, selbst 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 Setzen Sie den Wert auf 1, um die 5-Minuten-Prompt-Cache-TTL zu erzwingen, selbst 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 Setzen Sie die Variable auf einen beliebigen nicht leeren Wert, etwa 1, um den Demo-Modus zu aktivieren: Er 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 ein Wert von 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. 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 (Standard: 25000)
MAX_STRUCTURED_OUTPUT_RETRIES Anzahl der Versuche, die Claude Code zulässt, wenn die Antwort des Modells die Validierung gegen das --json-schema im nicht interaktiven Modus mit dem Flag -p 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 unterhalb der maximalen Ausgabe-Token der Anfrage und nie unter 1.024. Wie dieses Limit festgelegt wird, erfahren Sie bei CLAUDE_CODE_MAX_OUTPUT_TOKENS. Wenn die Variable nicht gesetzt und Thinking aktiviert ist, wählen Modelle mit adaptivem Reasoning ihre Denktiefe selbst, und andere Modelle verwenden die Obergrenze. Setzen Sie den Wert auf 0, um Thinking auf der Anthropic API zu deaktivieren, außer bei Opus 5.5, Sonnet 5.5 und den Fable-Modellen, bei denen sich Thinking nicht ausschalten lässt. Bei Drittanbietern lässt 0 stattdessen den Parameter thinking weg. Bei ausgeschaltetem Thinking auf der Anthropic API sendet Claude Code an Modelle, von denen es weiß, dass sie diese Kombination nicht akzeptieren, etwa Opus 5, den Effort high statt einer höheren Stufe. 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 benötigen. Vermeidet die interaktive Abfrage beim Hinzufügen eines Servers mit --client-secret
MCP_CONNECTION_NONBLOCKING Steuert, ob der Start wartet, bis MCP-Server verbunden sind, bevor die erste Abfrage erfolgt. Der MCP-Start ist standardmäßig nicht blockierend: Server verbinden sich im Hintergrund, und ihre Tools werden verfügbar, sobald sie fertig sind. Setzen Sie den Wert auf 0, damit Claude Code vor der ersten Abfrage wartet, bis die Server verbunden sind. Server, die mit alwaysLoad: true konfiguriert sind, lassen den Start trotzdem warten, außer wenn sie aus dem Discovery-Cache bedient 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 außerdem 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 Verbindungs-Batch wartet, bevor er einen Snapshot der Tool-Liste erstellt (Standard: 5000). Gilt bei MCP_CONNECTION_NONBLOCKING=0 oder für Server, die mit alwaysLoad: true markiert sind. Server, die bei Ablauf der Frist noch ausstehen, verbinden sich weiter im Hintergrund. Zu unterscheiden 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 beim ersten Tool-Aufruf statt beim Start. Der Cache ist standardmäßig ausgeschaltet, sofern ihn nicht ein schrittweiser Rollout für Ihr Konto aktiviert hat. Setzen Sie den Wert auf 1, um ihn einzuschalten, oder auf 0, um ihn ausgeschaltet zu lassen, selbst 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 Standard 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 ohne Aktualisierung verwendet (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 bei der v2-MCP-Client-Laufzeit: ob Claude Code Server auf die MCP-Protokollrevision 2026-07-28 prüft. Setzen Sie auto, um HTTP-Server, claude.ai-Konnektor-Server und stdio-Server zu prüfen, oder legacy, um keine zu prüfen. Ohne gesetzte Variable prüft Claude Code die unter MCP-Client-Laufzeiten 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 an Remote-MCP-Servern (HTTP/SSE), die beim Start parallel verbunden werden (Standard: 20)
MCP_SDK_GENERATION Legt fest, mit welcher MCP-Client-Laufzeit sich dieser Prozess 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-Laufzeit den Issuer, 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 dieser nicht übereinstimmt. Die v1-Laufzeit führt diese Prüfung nicht durch. Wenn Sie einen unbekannten 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 an lokalen MCP-Servern (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 zusätzlich jede Anfrage standardmäßig nach 60 Sekunden ab; setzen Sie diese Variable oder den serverspezifischen timeout auf einen Wert über 60000, um dieses Limit pro Anfrage zu erhöhen. Ein niedrigerer Wert verkürzt zwar den Gesamt-Timeout der 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 diesen Wert für den jeweiligen 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 Standardlimit des OpenTelemetry SDK für die Länge von Attributwerten. Claude Code begrenzt inhaltstragende Telemetrieattribute auf den kleineren Wert aus diesem Limit und CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH, sodass 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 Setzen Sie den Wert auf 1, um den Antworttext des Modells in OpenTelemetry-Log-Ereignisse vom Typ assistant_response aufzunehmen. Wenn die Variable nicht gesetzt ist, verwendet Claude Code stattdessen den Wert von OTEL_LOG_USER_PROMPTS. Setzen Sie den Wert auf 0, um Antworten geschwärzt zu lassen, selbst 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 Setzen Sie den Wert auf 1, um die geschwärzten verwalteten Einstellungen sowie einen SHA-256-Digest der Einstellungen vor der Schwärzung zu OpenTelemetry-Log-Ereignissen 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 das JSON von Anfragen und Antworten der Anthropic Messages API als Log-Ereignisse api_request_body / api_response_body aus. Setzen Sie den Wert auf 1 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; die 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 Setzen Sie den Wert auf 1, um Tool-Inhalte in das OpenTelemetry-Span-Ereignis tool.output aufzunehmen. 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 in diesem Abschnitt beschriebenen Aus-Werten. Siehe Monitoring
OTEL_LOG_TOOL_DETAILS Setzen Sie den Wert auf 1, um Folgendes in OpenTelemetry-Metriken, -Traces und -Logs aufzunehmen: Eingabeargumente von Tools; Namen von MCP-Servern; von Benutzern verfasste Workflow-Namen; rohe Fehlerzeichenfolgen bei Tool-Fehlern; die Ablehnungs-category bei api_refusal-Ereignissen; echte Namen von Agenten, Skills, Plugins und MCP-Servern bei Kosten- und Token-Metriken; sowie weitere Tool-Details. 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 in diesem Abschnitt beschriebenen Aus-Werten. Siehe Monitoring
OTEL_LOG_USER_PROMPTS Setzen Sie den Wert auf 1, um den Text von Benutzer-Prompts in OpenTelemetry-Traces und -Logs aufzunehmen. 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 in diesem Abschnitt beschriebenen Aus-Werten. Siehe Monitoring
OTEL_METRICS_INCLUDE_ACCOUNT_UUID Setzen Sie den Wert auf false, um die Konto-UUID aus den Metrik-Attributen auszuschließen (Standard: enthalten). Siehe Monitoring
OTEL_METRICS_INCLUDE_ENTRYPOINT Setzen Sie den Wert auf true, um den Einstiegspunkt der Sitzung in die Metrik-Attribute aufzunehmen (Standard: ausgeschlossen). Hinzugefügt in v2.1.152. Siehe Monitoring
OTEL_METRICS_INCLUDE_REPOSITORY Setzen Sie den Wert auf true, um OpenTelemetry-Metriken und -Ereignisse 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 von Metrik-Datenpunkten an. Setzen Sie den Wert auf false, um sie auszuschließen (Standard: enthalten). Siehe Monitoring
OTEL_METRICS_INCLUDE_SESSION_ID Setzen Sie den Wert auf false, um die Sitzungs-ID aus den Metrik-Attributen auszuschließen (Standard: enthalten). Siehe Monitoring
OTEL_METRICS_INCLUDE_VERSION Setzen Sie den Wert auf true, um die Claude-Code-Version in die Metrik-Attribute 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 wirkungslos, 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 Setzen Sie den Wert auf 0, um das systemweit installierte rg anstelle des in Claude Code enthaltenen 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 sowie 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 in diesem Abschnitt beschriebenen Aus-Werten. OTEL_RESOURCE_ATTRIBUTES sowie die Variablen für Exportintervall, Timeout und Komprimierung, etwa OTEL_METRIC_EXPORT_INTERVAL, gelten auch aus Projekt- und lokalen Einstellungen.

Funktionen, die das Abrufen von Feature-Flags erfordern

Claude Code aktiviert einige Funktionen durch Feature-Flags, die von Anthropic abgerufen werden. Claude Code überspringt diesen Abruf in diesen Sitzungen:

  • Eine Sitzung, in der Sie DISABLE_GROWTHBOOK, DISABLE_TELEMETRY, DO_NOT_TRACK oder CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC setzen; die Zeile jeder Variablen in der Variablentabelle gibt an, welche Werte das Abrufen deaktivieren
  • Eine Sitzung auf einem Drittanbieter-Provider, wie Amazon Bedrock, Claude Platform auf AWS, Google Clouds Agent Platform oder Microsoft Foundry, es sei denn, eine Host-Plattform, die Claude Code einbettet, setzt CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST
  • Eine Claude-Apps-Gateway-Sitzung

Wenn das Abrufen deaktiviert ist, können Sie nicht:

Erste Sitzung nach einer Installation oder einem Upgrade

In Ihrer ersten Sitzung nach der Installation von Claude Code oder dem Upgrade auf eine Version, die eine Funktion hinzufügt, kann eine Flag-gesteuerte Funktion fehlen. Diese Sitzung kann auch in einem anderen Berechtigungsmodus starten als Ihre späteren Sitzungen. Claude Code ruft die Flags während dieser Sitzung ab, sodass Ihre nächste Sitzung die Funktion und den üblichen Startberechtigungsmodus 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 immer noch abrufen, bevor es den Startberechtigungsmodus wählt.

Siehe auch