SpyBara
Go Premium

env-vars.md 2026-10-02 22:59 UTC to 2026-10-03 02:59 UTC

This page contains 383 additions and 381 deletions.

2026
Thu 1 23:59 Fri 2 22:59 Sat 3 04:00

Umgebungsvariablen

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

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

Diese Seite behandelt folgende Themen:

Umgebungsvariablen festlegen

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

In Ihrer Shell

Legen Sie die Variable vor dem Starten von claude fest:

export API_TIMEOUT_MS="1200000"
claude

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

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

echo $API_TIMEOUT_MS

In Einstellungsdateien

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

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

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

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

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

Vorrang

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

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

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

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

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

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

Variablen

Numerische Variablen wie Timeouts, Token-Budgets und Anzahlen von Wiederholungsversuchen akzeptieren neben einfachen Ziffern auch wissenschaftliche Notation und Schreibweisen mit Zifferntrennzeichen, außer wenn die Zeile einer Variablen 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, etwa setzte 1e6 einen Timeout auf 1.

Variable Zweck
ANTHROPIC_API_KEY API-Schlüssel, der als X-Api-Key-Header gesendet wird. Wenn gesetzt, wird dieser Schlüssel anstelle Ihres Claude Pro-, Max-, Team- oder Enterprise-Abonnements verwendet, auch wenn Sie angemeldet sind. Im nicht interaktiven Modus (-p) wird der Schlüssel immer verwendet, wenn er vorhanden ist. Im interaktiven Modus werden Sie einmalig aufgefordert, den Schlüssel zu genehmigen, bevor er Ihr Abonnement überschreibt. Um stattdessen Ihr Abonnement zu verwenden, führen Sie unset ANTHROPIC_API_KEY aus
ANTHROPIC_AUTH_TOKEN Benutzerdefinierter Wert für den Authorization-Header (dem hier gesetzten Wert wird Bearer vorangestellt)
ANTHROPIC_AWS_API_KEY Workspace-API-Schlüssel für Claude Platform on AWS, in der AWS Console generiert. Wird als x-api-key gesendet und hat Vorrang vor AWS SigV4
ANTHROPIC_AWS_BASE_URL Überschreibt die Endpunkt-URL von Claude Platform on AWS. Verwenden Sie dies für benutzerdefinierte Regionen oder beim Routing über ein LLM-Gateway. Standardwert ist https://aws-external-anthropic.{region}.api.aws. Claude Code ermittelt die Region mit der gleichen Rangfolge wie bei Amazon Bedrock
ANTHROPIC_AWS_WORKSPACE_ID Erforderlich für Claude Platform on AWS. Wird bei jeder Anfrage als anthropic-workspace-id-Header gesendet
ANTHROPIC_BASE_URL Überschreibt den API-Endpunkt, um Anfragen über einen Proxy oder ein Gateway zu leiten. Wenn auf einen Host gesetzt, 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 verweist, entsprechend dem Verhalten auf Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry
ANTHROPIC_BEDROCK_BASE_URL Überschreibt die Amazon-Bedrock-Endpunkt-URL. Verwenden Sie dies für benutzerdefinierte Amazon-Bedrock-Endpunkte oder beim Routing über ein LLM-Gateway. Siehe Amazon Bedrock
ANTHROPIC_BEDROCK_MANTLE_BASE_URL Überschreibt die Endpunkt-URL von Amazon Bedrock Mantle. Siehe Mantle-Endpunkt
ANTHROPIC_BEDROCK_REGION_PREFIX Präfix des regionsübergreifenden Inferenzprofils (us, eu, apac, jp, au oder global), das Claude Code zuerst versucht, anstelle des aus der AWS-Region abgeleiteten. Wird in AWS-GovCloud-Regionen ignoriert. Erfordert Claude Code v2.1.224 oder höher. Siehe Amazon Bedrock
ANTHROPIC_BEDROCK_SERVICE_TIER Amazon-Bedrock-Service-Tier (default, flex oder priority). Wird als X-Amzn-Bedrock-Service-Tier-Header gesendet. Siehe Amazon Bedrock
ANTHROPIC_BETAS Kommagetrennte Liste zusätzlicher anthropic-beta-Header-Werte, die in API-Anfragen aufgenommen werden. Claude Code sendet die benötigten Beta-Header bereits; verwenden Sie dies, um sich für eine Anthropic-API-Beta anzumelden, bevor Claude Code native Unterstützung hinzufügt. Anders als das --betas-Flag, das eine Authentifizierung per API-Schlüssel erfordert, funktioniert diese Variable mit allen Authentifizierungsmethoden einschließlich eines Claude.ai-Abonnements
ANTHROPIC_CUSTOM_HEADERS Benutzerdefinierte Header, die Anfragen hinzugefügt werden (Format Name: Value, bei mehreren Headern durch Zeilenumbrüche getrennt). Wenn ein Name oder Wert ein Zeichen enthält, das ein HTTP-Header nicht transportieren kann, etwa ein typografisches Anführungszeichen oder ein Leerzeichen mit Nullbreite, 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 wo die Prüfung ausgeführt wird. 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 Aliasse zu ersetzen. Siehe Modellkonfiguration
ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION Angezeigte Beschreibung für den benutzerdefinierten Modelleintrag in der /model-Auswahl. Standardwert ist 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, sofern Claude Code die ID erkennt, andernfalls die Modell-ID
ANTHROPIC_CUSTOM_MODEL_OPTION_SUPPORTED_CAPABILITIES Kommagetrennte Liste der Fähigkeiten, die das benutzerdefinierte Modell unterstützt, zum Beispiel effort,thinking. Siehe Modellkonfiguration
ANTHROPIC_DEFAULT_FABLE_MODEL Modell-ID, auf die der Alias fable aufgelöst wird, und die ID, die Claude Code bei Drittanbietern als Fable-Modell für den automatischen Modell-Fallback erkennt. Siehe Modellkonfiguration
ANTHROPIC_DEFAULT_FABLE_MODEL_DESCRIPTION Angezeigte Beschreibung für das fixierte Fable-Modell in der /model-Auswahl. Wenn nicht gesetzt, zeigt die Zeile eine Standardbeschreibung, die mit Custom Fable model beginnt. Siehe Modellkonfiguration
ANTHROPIC_DEFAULT_FABLE_MODEL_NAME Anzeigename für das fixierte Fable-Modell in der /model-Auswahl. Wenn nicht gesetzt, zeigt die Zeile den Namen des Modells, sofern 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, auf die der Alias haiku aufgelöst wird, auch für Hintergrundfunktionen verwendet. Siehe Modellkonfiguration
ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTION Angezeigte Beschreibung für das fixierte Haiku-Modell in der /model-Auswahl. Wenn nicht gesetzt, zeigt die Zeile eine Standardbeschreibung, die mit Custom Haiku model beginnt. Siehe Modellkonfiguration
ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME Anzeigename für das fixierte Haiku-Modell in der /model-Auswahl. Wenn nicht gesetzt, zeigt die Zeile den Namen des Modells, sofern 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 Ein Standardmodell für neue Sitzungen festlegen
ANTHROPIC_DEFAULT_OPUS_MODEL Modell-ID, auf die der Alias opus aufgelöst wird und die opusplan verwendet, solange der Plan-Modus aktiv ist. Siehe Modellkonfiguration
ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION Angezeigte Beschreibung für das fixierte Opus-Modell in der /model-Auswahl. Wenn nicht gesetzt, zeigt die Zeile eine Standardbeschreibung, die mit Custom Opus model beginnt. Siehe Modellkonfiguration
ANTHROPIC_DEFAULT_OPUS_MODEL_NAME Anzeigename für das fixierte Opus-Modell in der /model-Auswahl. Wenn nicht gesetzt, zeigt die Zeile den Namen des Modells, sofern 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, auf die der Alias sonnet aufgelöst wird und die opusplan verwendet, wenn der Plan-Modus nicht aktiv ist. Siehe Modellkonfiguration
ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTION Angezeigte Beschreibung für das fixierte Sonnet-Modell in der /model-Auswahl. Wenn nicht gesetzt, zeigt die Zeile eine Standardbeschreibung, die mit Custom Sonnet model beginnt. Siehe Modellkonfiguration
ANTHROPIC_DEFAULT_SONNET_MODEL_NAME Anzeigename für das fixierte Sonnet-Modell in der /model-Auswahl. Wenn nicht gesetzt, zeigt die Zeile den Namen des Modells, sofern 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 Föderationsregel-ID für Workload Identity Federation. Wenn Sie sie zusammen mit ANTHROPIC_ORGANIZATION_ID setzen, wählt Claude Code Föderations-Anmeldedaten aus, die Vorrang vor Ihren /login-Anmeldedaten haben. Siehe Rangfolge der Authentifizierung
ANTHROPIC_FOUNDRY_API_KEY API-Schlüssel für die Authentifizierung bei Microsoft Foundry (siehe Microsoft Foundry)
ANTHROPIC_FOUNDRY_AUTH_TOKEN Bearer-Token für die Authentifizierung bei Microsoft Foundry, etwa ein Microsoft-Entra-Zugriffstoken. Claude Code sendet es als Authorization: Bearer-Header. Hat Vorrang vor ANTHROPIC_FOUNDRY_API_KEY und vor der Azure-Standardkette für Anmeldedaten. Siehe Microsoft Foundry. Erfordert Claude Code v2.1.203 oder höher
ANTHROPIC_FOUNDRY_BASE_URL Vollständige Basis-URL für die Microsoft-Foundry-Ressource (zum Beispiel https://my-resource.services.ai.azure.com/anthropic). Alternative zu ANTHROPIC_FOUNDRY_RESOURCE (siehe Microsoft Foundry)
ANTHROPIC_FOUNDRY_RESOURCE Name der Microsoft-Foundry-Ressource (zum Beispiel my-resource). Claude Code lehnt eine URL oder einen Hostnamen ab. Erforderlich, wenn ANTHROPIC_FOUNDRY_BASE_URL nicht gesetzt ist (siehe Microsoft Foundry)
ANTHROPIC_MODEL Name der zu verwendenden Modelleinstellung (siehe Modellkonfiguration)
ANTHROPIC_ORGANIZATION_ID Organisations-ID für Workload Identity Federation. Setzen Sie sie zusammen mit ANTHROPIC_FEDERATION_RULE_ID. Siehe Rangfolge der Authentifizierung
ANTHROPIC_PROFILE Name des Anthropic-Profils, mit dem authentifiziert wird, etwa eines, das mit ant auth login oder durch Anmelden bei einem Console-Konto ohne API-Schlüssel erstellt wurde. Siehe Rangfolge der Authentifizierung
ANTHROPIC_SMALL_FAST_MODEL [VERALTET] Name des Modells der Haiku-Klasse für Hintergrundaufgaben
ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION Überschreibt die AWS-Region für das Modell der Haiku-Klasse bei Verwendung von Amazon Bedrock oder Amazon Bedrock Mantle. Auf Amazon Bedrock wirkt dies nur, wenn auch ANTHROPIC_DEFAULT_HAIKU_MODEL oder das veraltete ANTHROPIC_SMALL_FAST_MODEL gesetzt ist, da Amazon Bedrock Hintergrundaufgaben andernfalls 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 Föderationsregel auf mehr als einen Workspace beschränkt ist, damit der Token-Austausch weiß, welcher Workspace das Ziel ist
API_FORCE_IDLE_TIMEOUT Überschreibt den 5-minütigen Leerlauf-Timeout für den Response-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 anderen Anbietern als 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 Anfragen in langsamen Netzwerken oder beim Routing über einen Proxy in eine Zeitüberschreitung laufen. Werte über dem Maximum lassen den zugrunde liegenden Timer überlaufen und führen dazu, dass Anfragen sofort fehlschlagen
AWS_BEARER_TOKEN_BEDROCK Amazon-Bedrock-API-Schlüssel für die Authentifizierung (siehe Amazon-Bedrock-API-Schlüssel)
BASH_DEFAULT_TIMEOUT_MS Standard-Timeout für einen 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 außerdem zum Standard-Zeitlimit für Hintergrundbefehle. Das Zeitlimit für Hintergrundbefehle erfordert Claude Code v2.1.285 oder höher
BASH_MAX_OUTPUT_LENGTH Maximale Anzahl von 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 außerdem zum maximalen Zeitlimit für Hintergrundbefehle. Das Zeitlimit für Hintergrundbefehle erfordert Claude Code v2.1.285 oder höher
BETA_TRACING_ENDPOINT OTLP-Endpunkt für detailliertes Beta-Tracing: Mit ENABLE_BETA_TRACING_DETAILED=1 gehen Logs und Traces dorthin statt an die konfigurierten Exporter. Setzen Sie ihn in Ihrer Shell, in den Benutzereinstellungen oder in den 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 ebenfalls 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 statt innerhalb eines von Claude Code gestarteten stdio-MCP-Servers, verwenden Sie stattdessen CLAUDE_CODE_CHILD_SESSION
CLAUDE_AFK_COUNTDOWN_MS Wie viele Millisekunden vor dem automatischen Fortfahren der Countdown auf dem Bildschirm in 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 gesetzt, hat sie Vorrang vor dieser Einstellung und schaltet das automatische Fortfahren ein, auch wenn die Einstellung nicht gesetzt oder never ist. Das Setzen von 0 schaltet den Timeout nicht aus; es 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-Benutzer, die bei null anfangen möchten. Dadurch wird auch general-purpose entfernt, der Subagent, den Claude Code ausführt, wenn ein Agent-Tool-Aufruf 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 SDK-erstellten MCP-Servern wegzulassen. Tools verwenden ihre ursprünglichen Namen. Nur für die SDK-Nutzung
CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS Stillstands-Timeout in Millisekunden für Subagenten. Standard 600000 (10 Minuten); wenn Sie CLAUDE_STREAM_IDLE_TIMEOUT_MS erhöhen, während der Stream-Watchdog eingeschaltet ist, steigt der Standardwert mit, wie in Langsame oder stockende API-Antworten behandeln beschrieben. Der Timer wird bei jedem Streaming-Fortschrittsereignis zurückgesetzt; trifft innerhalb des Zeitfensters kein Fortschritt ein, bricht Claude Code den Subagenten ab und meldet den Stillstand an den übergeordneten Agenten
CLAUDE_AUTOCOMPACT_PCT_OVERRIDE Legt den Prozentsatz (1-100) des Fensters für die automatische Komprimierung fest, bei dem die automatische Komprimierung ausgelöst wird. Verwenden Sie niedrigere Werte wie 50, um früher zu komprimieren; die Variable kann den Schwellenwert nicht anheben, daher werden Werte über dem Standardprozentsatz ignoriert. Sie gilt nur in Sitzungen, die vor dem Kontextlimit des Modells komprimieren. Gilt sowohl für Hauptkonversationen als auch für Subagenten
CLAUDE_AUTO_BACKGROUND_TASKS Setzen Sie 1, um das automatische Verschieben lang laufender Agentenaufgaben in den Hintergrund zwangsweise zu aktivieren. Wenn aktiviert, werden Subagenten nach etwa zwei Minuten Laufzeit in den Hintergrund verschoben. Aktiviert außerdem das automatische Verschieben langer MCP-Tool-Aufrufe in den Hintergrund im nicht interaktiven Modus ab Claude Code v2.1.212
CLAUDE_AX_PREPARK_MS Im Screenreader-Modus die Anzahl der Millisekunden, die 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, auch 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 die Anzahl der Millisekunden, die 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 das Zurückhalten auf 600000 (10 Minuten). Ihr erster Tastendruck beendet das Zurückhalten 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 mobile Push-Benachrichtigungen von Remote Control, sodass Sie keine Push-Benachrichtigungen mehr erhalten, während Sie den Computer aktiv verwenden. Wenn die Datei fehlt oder nicht lesbar ist, werden Benachrichtigungen normal gesendet. Claude Code prüft die Datei einmal pro Ereignis, das eine Push-Benachrichtigung auslöst, statt sie regelmäßig abzufragen. Erfordert Claude Code v2.1.181 oder höher
CLAUDE_CODE_ACCESSIBILITY Setzen Sie 1, um den nativen Terminal-Cursor sichtbar zu halten und die Cursoranzeige mit invertiertem Text zu deaktivieren. Ermöglicht Bildschirmlupen wie macOS Zoom, der Cursorposition zu folgen
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 in der Vollbilddarstellung bei jedem Frame den gesamten Bildschirm neu zu zeichnen, statt inkrementelle Aktualisierungen zu senden. Verwenden Sie dies, wenn der Vollbildmodus veraltete oder falsch platzierte Textfragmente 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 mit jeder Anfrage zu senden, auch wenn Claude Code die Modell-ID nicht als Effort-fähig erkennt. Verwenden Sie dies beim Routing über ein LLM-Gateway oder einen Drittanbieter, der Modelle unter benutzerdefinierten Kennungen bereitstellt. Modelle, die den Effort-Parameter an der API 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 den Browser nicht automatisch öffnet, wenn ein neues Artefakt veröffentlicht wird
CLAUDE_CODE_ARTIFACT_COMMENTS Setzen Sie 0, damit Claude Kommentare zu einem Artefakt nicht mehr liest und beantwortet. Hat keine Wirkung, wenn CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC Artefakte ausgeschaltet hat. Erfordert Claude Code v2.1.221 oder höher
CLAUDE_CODE_ARTIFACT_COMMENTS_AUTOREACT Setzen Sie 0, damit Claude nicht mehr selbststä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 des Auto-Modus bei, auch wenn Sie 0 setzen. Unter Attributionsblock im System-Prompt können Sie prüfen, welche Verbindungen und Anmeldedaten dies betrifft. Vor v2.1.181 enthielt der Block bei benutzerdefinierten Basis-URLs und Microsoft-Foundry-Verbindungen ein anfragespezifisches Token; setzen Sie ihn bei diesen Versionen daher auf 0, wenn Ihr LLM-Gateway anhand des Request-Bodys zwischenspeichert oder Anfragen an einen Drittanbieter weiterleitet, oder wenn Sie sich direkt mit Microsoft Foundry verbinden
CLAUDE_CODE_AUTO_BACKGROUND_WORKER_CHECKIN_SECONDS Wenn CLAUDE_AUTO_BACKGROUND_TASKS aktiviert ist, die Sekunden zwischen Erinnerungen an Claude, nach noch laufenden Hintergrund-Subagenten zu sehen. Akzeptiert nur eine einfache Ganzzahl von 1 bis 86400; jeder andere Wert und jede andere Schreibweise wird als nicht gesetzt gelesen. Wenn nicht gesetzt, gibt es keine Erinnerungen. Erfordert Claude Code v2.1.248 oder höher
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 wartet, bis 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 benötigt, etwa eine browserbasierte SSO-Anmeldung mit MFA über einen Wrapper wie aws-vault. Gilt überall dort, wo Claude Code mit der Standardkette signiert: Amazon Bedrock, Claude Platform on AWS und der Mantle-Endpunkt. Erfordert Claude Code v2.1.207 oder höher
CLAUDE_CODE_BASH_EDIT_DIFF Setzen Sie 0, um den Diff der Dateien, die sich während der Ausführung eines Bash-Befehls geändert haben, auszuschalten, oder 1, um ihn in jedem Berechtigungsmodus aufzuzeichnen. Hat Vorrang vor der Einstellung bashEditDiffEnabled. Erfordert Claude Code v2.1.269 oder höher
CLAUDE_CODE_BG_TASKS_REPORT_RUNNING Setzen Sie 0, damit eine nicht interaktive Sitzung ihrem Host am Ende jedes Turns einen Leerlaufstatus meldet, auch während noch Hintergrundarbeit läuft. Standardmäßig meldet die Sitzung über das Ende des Turns hinaus weiterhin einen laufenden Status, solange Hintergrundarbeit wie ein Hintergrund-Agent 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 ankündigt, dass Claude auf Ihre Eingabe wartet. Hintergrund-Shell-Befehle wie ein Dev-Server halten den laufenden Status nicht aufrecht. Der Standard für den laufenden Status und die Abwahl mit 0 erfordern Claude Code v2.1.269 oder höher; setzen Sie in früheren Versionen 1, um den laufenden Status aufrechtzuerhalten
CLAUDE_CODE_BRIDGE_SESSION_ID Wird in Unterprozessen des Bash-Tools und von Hook-Befehlen automatisch gesetzt, solange die Sitzung eine aktive Remote Control-Verbindung hat, und entfernt, wenn die Verbindung endet. Der Wert ist die ID der Sitzung in der Form session_, dieselbe Kennung, die in der claude.ai/code-URL der Sitzung erscheint, sodass ein Skript auf die Sitzung zurückverlinken kann, die es ausgeführt hat. Erfordert Claude Code v2.1.199 oder höher. In Cloud-Sitzungen lesen Sie 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. Jeder der beiden Werte ersetzt den Plattformstandard. Standardmäßig liest Claude Code es unter Windows als Ctrl+Backspace, außer wenn TERM_PROGRAM mintty oder TERM cygwin ist, 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-Zertifikatsquellen für TLS-Verbindungen. bundled ist der mit Claude Code ausgelieferte Mozilla-CA-Satz. system ist der Vertrauensspeicher des Betriebssystems, der nur auf Laufzeitumgebungen mit tls.getCACertificates gelesen wird: dem nativen Binary oder Node 22.15 oder höher bei npm-Installationen. Siehe CA-Zertifikatsspeicher. Standard ist bundled,system
CLAUDE_CODE_CHILD_SESSION Wird in Unterprozessen, die Claude Code über die Tools Bash, PowerShell und Monitor, über Hook-Befehle und über Statuszeilen-Befehle startet, auf 1 gesetzt. Nicht gesetzt für stdio-MCP-Server-Unterprozesse, die langlebig sind und die Sitzung überdauern, die sie gestartet hat. Anders als CLAUDECODE wird dies nur von Claude Code selbst gesetzt, wenn es einen Unterprozess startet, und nicht von IDE-Erweiterungen, sodass es zuverlässig eine verschachtelte Sitzung von einem claude der obersten Ebene unterscheidet, das in einem IDE-integrierten Terminal gestartet wurde. Eine auf diese Weise gestartete verschachtelte interaktive claude-TUI wird automatisch von --resume, --continue, dem Verlauf über die Pfeil-nach-oben-Taste und der Liste claude agents ausgeschlossen. Nicht interaktive claude -p-Sitzungen werden weiterhin gespeichert. Setzen Sie CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1, um diesen Ausschluss zu überschreiben. Erfordert Claude Code v2.1.172 oder höher
CLAUDE_CODE_CLIENT_CERT Pfad zur Client-Zertifikatsdatei für die mTLS-Authentifizierung
CLAUDE_CODE_CLIENT_KEY Pfad zur Datei mit dem privaten Client-Schlüssel für die mTLS-Authentifizierung
CLAUDE_CODE_CLIENT_KEY_PASSPHRASE Passphrase für einen verschlüsselten CLAUDE_CODE_CLIENT_KEY (optional)
CLAUDE_CODE_CONNECT_TIMEOUT_MS In v2.1.186 entfernt und jetzt wirkungslos. 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, kein Verzeichnis. Erfordert, dass der Debug-Modus separat über --debug, /debug oder die Umgebungsvariable DEBUG aktiviert wird: Das Setzen dieser Variablen allein aktiviert das Logging nicht. Das Flag --debug-file erledigt beides gleichzeitig. Standardwert ist ~/.claude/debug/<session-id>.txt
CLAUDE_CODE_DEBUG_LOG_LEVEL Minimale Log-Stufe, die in die Debug-Logdatei geschrieben wird. Werte: verbose, debug (Standard), info, warn, error. Setzen Sie verbose, um umfangreiche Diagnosen wie die vollständige Ausgabe von Statuszeilen-Befehlen einzuschließen, oder erhöhen Sie auf error, um das 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 auf Modellen mit einem nativen 1M-Fenster, etwa Sonnet 5.5 und den Fable-Modellen, auf ein 200K-Fenster; unter Erweiterter Kontext erfahren Sie, wie diese 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 Das 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 der verwalteten Einstellungen nicht mehr schlüsselweise über Admin-Quellen hinweg zusammenführt, sodass wie vor v2.1.223 nur der gesamte env-Block der Quelle mit der höchsten Priorität gilt. Setzen Sie die Variable in der Umgebung, die Claude Code startet, da Claude Code eine über einen env-Block in 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 akzeptiert, hat aber keine Wirkung, sodass bestehende Skripte, die es übergeben, ohne Fehler weiter funktionieren
CLAUDE_CODE_DISABLE_AGENT_VIEW Setzen Sie 1, um Hintergrund-Agenten 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 die Vollbilddarstellung zu deaktivieren und den klassischen Renderer für den Hauptbildschirm zu verwenden. Die Konversation bleibt im nativen Scrollback Ihres Terminals, sodass Cmd+f und der tmux-Kopiermodus wie gewohnt funktionieren. Hat Vorrang vor CLAUDE_CODE_NO_FLICKER und der Einstellung tui. Sie können auch mit /tui default wechseln. Gilt nicht für Hintergrundsitzungen, die aus der Agentenansicht geöffnet werden und immer die Vollbilddarstellung verwenden
CLAUDE_CODE_DISABLE_ARTIFACT Setzen Sie 1, um das Tool Artifact auszuschalten, das die Ausgabe einer Sitzung als private Webseite auf claude.ai veröffentlicht. Sobald Sie die Variable gesetzt haben, schaltet keine Einstellungsdatei das Tool wieder ein. 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, statt zu Dateiinhalten erweitert zu werden
CLAUDE_CODE_DISABLE_AUTH_REFRESH_LOCK Setzen Sie 1, damit ein Claude-Code-Prozess seinen gcpAuthRefresh- oder awsAuthRefresh-Befehl selbst ausführt, statt zu warten, während ein anderer Prozess ihn ausführt. Erfordert Claude Code v2.1.286 oder höher
CLAUDE_CODE_DISABLE_AUTO_MEMORY Setzen Sie 1, um Auto-Memory zu deaktivieren. Setzen Sie 0, um Auto-Memory zwangsweise einzuschalten, auch wenn der --bare-Modus oder autoMemoryEnabled: false es andernfalls 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 Amazon Bedrock-Streaming-Antwort 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, dekodiert also den Body, und das Streaming funktioniert weiter. Setzen Sie dies nur für ein Gateway, das den Stream außerdem als Server-Sent Events neu ausgibt; Claude Code liest den Body ohne Header dann stattdessen als Server-Sent Events. Erfordert Claude Code v2.1.239 oder höher
CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD Setzen Sie 1, um die Prüfung zu überspringen, ob eine Amazon Bedrock-Streaming-Antwort den Content-Type application/vnd.amazon.eventstream trägt. Ohne diese Variable lässt Claude Code die Anfrage bei einer Antwort mit einem anderen Content-Type mit einem Fehler fehlschlagen, der diesen Typ nennt, was 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, statt diese Variable zu setzen. Erfordert Claude Code v2.1.208 oder höher
CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF Setzen Sie 1, um laufende Hintergrund-Shell-Befehle, dynamische Workflows und ab v2.1.198 Hintergrund-Subagenten einer Hintergrundsitzung zu stoppen, wenn der Supervisor den Prozess dieser Sitzung stoppt, neu startet oder aktualisiert, statt sie an den nächsten Prozess der Sitzung zu übergeben. Betrifft nur diese Übergabe: Das Verschieben einer Sitzung in den Hintergrund mit ← oder /background übernimmt laufende Arbeit weiterhin, und CLAUDE_DISABLE_ADOPT schaltet beides aus. Erfordert Claude Code v2.1.196 oder höher
CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP Setzen Sie 1, damit Claude Code Hintergrund-Shell-Befehle bei Speicherdruck nicht mehr beendet. Standardmäßig beendet Claude Code unter macOS und Linux Hintergrund-Shells, wenn das Betriebssystem kritischen Speicherdruck meldet und die Sitzung 30 Minuten lang inaktiv war, ohne dass ein Turn oder Subagent lief. Windows hat kein Signal für Speicherdruck, daher hat diese Variable dort keine Wirkung. Erfordert Claude Code v2.1.193 oder höher
CLAUDE_CODE_DISABLE_BUNDLED_SKILLS Setzen Sie 1, um die mit Claude Code mitgelieferten 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 werden. /doctor kann wie die integrierten Befehle weiterhin eingegeben werden; blenden Sie es 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, während der Chrome-Abschnitt des System-Prompts und der mitgelieferte Skill /claude-in-chrome weggelassen werden. Für Hosts, die Claude Code einbetten und ihre eigenen Anweisungen für den Browser bereitstellen. Erfordert Claude Code v2.1.257 oder höher
CLAUDE_CODE_DISABLE_CLAUDE_MDS Setzen Sie 1, um das Laden jeglicher CLAUDE.md-Memory-Dateien in den Kontext zu verhindern, einschließlich Benutzer-, Projekt- und Auto-Memory-Dateien
CLAUDE_CODE_DISABLE_CRON Setzen Sie 1, um geplante Aufgaben zu deaktivieren. Der Skill /loop und die Cron-Tools 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 zum Entfernen kritischer Pfade auszuschalten. Im Modus auto sendet Claude Code diese Löschvorgänge dann stattdessen an den Klassifikator, und im Modus bypassPermissions wartet die Abfrage auf Ihre Antwort. Setzen Sie die Variable in der Umgebung, die Claude Code startet, da Claude Code eine über einen env-Block in den Einstellungen bereitgestellte Kopie ignoriert. Erfordert Claude Code v2.1.281 oder höher
CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS Setzen Sie 1, um Vorabversions-anthropic-beta-Request-Header, die zugehörigen Body-Felder und 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. Vorabversions-Funktionen deaktivieren listet auf, was die Variable entfernt, einschließlich MCP Tool Search, und was Claude Code weiterhin sendet
CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS Setzen Sie 1, um die integrierten Subagenten Explore und Plan zu deaktivieren. Claude erkundet stattdessen mit seinen Such-Tools oder dem Allzweck-Subagenten, und der Plan-Modus liest Dateien direkt, statt Explore- und Plan-Agenten zu starten. Benutzerdefinierte Subagenten namens Explore oder Plan sind nicht betroffen. Um jeden integrierten Subagenten-Typ im Agent SDK oder im nicht interaktiven Modus zu entfernen, verwenden Sie stattdessen CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS. Erfordert Claude Code v2.1.198 oder höher
CLAUDE_CODE_DISABLE_FAST_MODE Setzen Sie 1, um den Fast-Modus zu deaktivieren
CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY Setzen Sie 1, um die Umfragen zur Sitzungsqualität „How is Claude doing?" zu deaktivieren. Umfragen sind auch deaktiviert, wenn DISABLE_TELEMETRY, DO_NOT_TRACK oder CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC gesetzt ist, es sei denn, CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL aktiviert sie wieder. Um eine Stichprobenrate festzulegen, statt die Umfragen vollständig zu deaktivieren, verwenden Sie die Einstellung feedbackSurveyRate. Siehe Umfragen zur Sitzungsqualität
CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING Setzen Sie 1, um das Checkpointing von Dateien zu deaktivieren. Der Befehl /rewind kann Codeänderungen dann nicht wiederherstellen. Überschreibt die Einstellung fileCheckpointingEnabled
CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS Setzen Sie 1, um die integrierten Anweisungen für Commit- und PR-Workflows sowie den Git-Status-Snapshot aus dem Kontext von Claude zu entfernen. Nützlich, wenn Sie Ihre eigenen Skills für Git-Workflows verwenden. Hat Vorrang vor der Einstellung includeGitInstructions, wenn gesetzt
CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP Setzen Sie 1, um die automatische Umleitung von Opus 4.0 und 4.1 auf die aktuelle Opus-Version in der Anthropic API zu verhindern. Verwenden Sie dies, wenn Sie bewusst ein älteres Modell fixieren möchten. Die Umleitung erfolgt nicht auf Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry
CLAUDE_CODE_DISABLE_MODEL_ACCESS_FALLBACK Setzen Sie 1, damit Claude Code auf Amazon Bedrock und Google Cloud's Agent Platform nicht mehr 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 das Maus-Tracking in der Vollbilddarstellung zu deaktivieren. Das Scrollen per Tastatur mit PgUp und PgDn funktioniert weiterhin. Verwenden Sie dies, um das native Kopieren beim Auswählen Ihres Terminals beizubehalten
CLAUDE_CODE_DISABLE_MOUSE_CLICKS Setzen Sie 1, um die Verarbeitung von Klicks, Ziehen und Hover in der Vollbilddarstellung zu deaktivieren und dabei das Scrollen mit dem Mausrad beizubehalten. 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 Schlüssel nicht erneut einliest, wenn eine API-Anfrage mit einem Fehler auf Verbindungsebene fehlschlägt, etwa einem Verbindungsabbruch oder einem TLS-Handshake-Fehler. Bei deaktiviertem Neuladen lädt Claude Code rotierte Dateien erst, wenn es die Einstellungen das nächste Mal 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 des PR- und MR-Status-Badges sowie Verfügbarkeitsprüfungen wie die Prüfung für den Fast-Modus. Außerdem werden die Hintergrundläufe von Plugin-command-Quellen gestoppt, die lokale Befehle statt Netzwerkverkehr sind, da sie Installationen von Abhängigkeiten auslösen können. Das Setzen auf 0 oder false deaktiviert diesen Verkehr trotzdem, 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. Betrifft nicht die Gateway-Modellerkennung, die über eine eigene Opt-in-Option verfügt
CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK Setzen Sie 1, um den Nicht-Streaming-Fallback 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 erzeugt
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 fokussiert ist. Standardmäßig überspringt das Tool sowohl die Desktop-Benachrichtigung als auch die mobile Push-Benachrichtigung, wenn es kürzliche Tastaturaktivität oder den Terminal-Fokus erkennt. Diese Variable deaktiviert nur diese lokale Prüfung, sodass der Server die mobile Push-Benachrichtigung weiterhin unterdrücken kann, wenn er erkennt, dass Sie aktiv sind. Erfordert Claude Code v2.1.193 oder höher
CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL Setzen Sie 1, um die automatische Registrierung des offiziellen Plugin-Marketplace zu deaktivieren. Claude Code liest die Variable, wenn es im Begriff ist, den Marketplace zu registrieren, in der Regel beim ersten interaktiven Start auf einem Rechner. Ist die Variable zu diesem Zeitpunkt gesetzt, überspringt Claude Code die Registrierung dauerhaft. Das spätere Entfernen der Variablen macht das Überspringen nicht rückgängig. Führen Sie claude plugin marketplace add anthropics/claude-plugins-official aus, um den Marketplace jederzeit zu registrieren
CLAUDE_CODE_DISABLE_PERMISSION_PROMPT_NOTIFY_HOOKS Setzen Sie 1, damit Claude Code Ihre Notification-Hooks für unbeantwortete Berechtigungsanfragen 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 Terminal-Sitzungen 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 ablehnt, etwa einem Laufwerksstammverzeichnis oder Ihrem Home-Verzeichnis. Claude Code ignoriert diese Variable im env-Block einer Einstellungsdatei. Erfordert Claude Code v2.1.283 oder höher
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, für ein LLM-Gateway, dessen Upstream diese ablehnt. Die anderen Vorabversions-Funktionen, die CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS ausschaltet, bleiben dabei eingeschaltet. Erfordert Claude Code v2.1.288 oder höher
CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT Setzen Sie 1, um die Prüfung kritischer Pfade für ein rekursives rm auszuschalten, dessen Ziel vollständig die Ausgabe einer Befehlsersetzung 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 Grundlage des Konversationskontexts zu deaktivieren. Dadurch wird auch die Hintergrundanfrage an das kleine/schnelle Modell übersprungen, die einen Sitzungstitel erzeugt
CLAUDE_CODE_DISABLE_THINKING Setzen Sie 1, um den Parameter thinking vollständig aus API-Anfragen wegzulassen. Dies ist eine Kompatibilitätsoption für Proxys und Gateways, die den Parameter ablehnen. Bei Modellen, die standardmäßig nachdenken, bedeutet das Weglassen des Parameters, dass das Modell möglicherweise trotzdem nachdenkt. Um Extended Thinking in der Anthropic API explizit zu deaktivieren, verwenden Sie stattdessen MAX_THINKING_TOKENS=0. Keine der beiden Variablen schaltet das 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 bei dem Kontextfenster, das es für die ID annimmt. CLAUDE_CODE_MAX_CONTEXT_TOKENS kann stattdessen das angenommene Fenster korrigieren; unter Das 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 in der Vollbilddarstellung 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, an den nächsten Prozess der Sitzung übergeben wird, etwa wenn Sie die Sitzung in den Hintergrund verschieben. Wenn Sie die Variable setzen, stoppt ein in den Hintergrund verschobener PowerShell-Befehl, wenn der Prozess der Sitzung beendet wird. Bash-Befehle sind nicht betroffen. Erfordert Claude Code v2.1.269 oder höher
CLAUDE_CODE_DISABLE_WORKFLOWS Setzen Sie 1, um Workflows zu deaktivieren. Entspricht der Einstellung disableWorkflows
CLAUDE_CODE_EFFORT_LEVEL Legt die Effort-Stufe für unterstützte Modelle fest. Werte: low, medium, high, xhigh, max oder auto, um den 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 zur Kompatibilität mit älteren Versionen akzeptiert und hat keine Wirkung. Der Auto-Modus ist standardmäßig bei jedem Anbieter verfügbar, einschließlich Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry und angemeldeter Sitzungen über das Claude apps gateway. In v2.1.158 bis v2.1.206 war das Setzen auf 1 erforderlich, um den Auto-Modus bei diesen Anbietern verfügbar zu machen
CLAUDE_CODE_ENABLE_AWAY_SUMMARY Überschreibt die Verfügbarkeit der Sitzungszusammenfassung. Setzen Sie 0, um Zusammenfassungen unabhängig vom Schalter in /config zwangsweise auszuschalten. Setzen Sie 1, um Zusammenfassungen zwangsweise einzuschalten, wenn awaySummaryEnabled false ist. Hat Vorrang vor der Einstellung und dem Schalter in /config
CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH Auf 1 setzen, um den Plugin-Status im nicht interaktiven Modus an Turn-Grenzen zu aktualisieren, nachdem eine Installation im Hintergrund abgeschlossen ist. Standardmäßig deaktiviert, da die Aktualisierung den System-Prompt mitten in der Sitzung ändert, wodurch das Prompt-Caching für diesen Turn ungültig wird
CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL Auf 1 setzen, um die Umfrage zur Sitzungsqualität „How is Claude doing?“ an Ihren eigenen OpenTelemetry-Collector zu leiten, wenn nicht wesentlicher Datenverkehr an Anthropic blockiert ist. Umfragebewertungen werden ausschließlich 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 Produktfeedback-Richtlinie der Organisation haben Vorrang
CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING Steuert, ob Eingaben für Tool-Aufrufe von der API gestreamt werden, während Claude sie generiert. Ist dies deaktiviert, kommt eine große Tool-Eingabe wie ein langer Schreibvorgang in eine Datei erst an, nachdem Claude sie vollständig generiert hat, was wie ein Hängenbleiben 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 dies unterstützt. Auf 0 setzen, um es zu deaktivieren. Auf 1 setzen, um es zu erzwingen, wenn Anfragen über einen Proxy via ANTHROPIC_BASE_URL, ANTHROPIC_VERTEX_BASE_URL oder ANTHROPIC_BEDROCK_BASE_URL geleitet werden. Standardmäßig deaktiviert bei Microsoft Foundry und Gateway-Verbindungen
CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY Auf 1 setzen, um die /model-Auswahl über den Endpunkt /v1/models Ihres Gateways zu befüllen, wenn ANTHROPIC_BASE_URL auf ein Anthropic-kompatibles Gateway wie LiteLLM, Kong oder einen internen Proxy verweist. Standardmäßig deaktiviert, da Gateways mit einem gemeinsam genutzten API-Schlüssel sonst jedem Benutzer jedes Modell anzeigen würden, auf das der Schlüssel Zugriff hat. Ermittelte Modelle werden weiterhin durch eine availableModels-Allowlist gefiltert, die die Sitzung erhält; stellen Sie die Liste über MDM oder eine Datei mit verwalteten Einstellungen bereit, da die serververwaltete 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 zu deaktivieren, also die ausgegrauten Vorhersagen, die in Ihrem Eingabefeld erscheinen. Hat Vorrang vor der Einstellung promptSuggestionEnabled, die vom Schalter Prompt suggestions in /config geschrieben wird. Claude Code pausiert Vorschläge außerdem, wenn Ihr Konto sein Nutzungslimit fast oder ganz erreicht hat. Auf true setzen, um sie aktiviert 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 bereitstellt, die sie haben. 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 Überwachung
CLAUDE_CODE_ENABLE_TODO_TOOLS Auf 1 setzen, um die Tools zur Aufgabenverfolgung für jedes Modell zu erhalten. Ohne diese Variable stellt Claude Code sie standardmäßig nur für die Modelle bereit, die unter Verfügbarkeit der Task-Tools aufgeführt sind. CLAUDE_CODE_ENABLE_TASKS wählt weiterhin zwischen den Task-Tools und TodoWrite. Erfordert Claude Code v2.1.233 oder höher
CLAUDE_CODE_EXIT_AFTER_STOP_DELAY Wartezeit in Millisekunden, nachdem die Abfrageschleife in den Leerlauf gewechselt ist, bevor automatisch beendet wird. Nützlich für automatisierte Workflows und Skripte, die den SDK-Modus verwenden
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-Anfrage-Bodys zusammengeführt wird. Nützlich, um anbieterspezifische Parameter zu übergeben, die Claude Code nicht direkt bereitstellt. Ein in Ihrer Shell exportierter Wert gilt auch für die Hintergrundsitzungen, die Sie mit claude agents oder --bg starten. Vor v2.1.206 ignorierten Hintergrundsitzungen einen in der Shell exportierten Wert und verwendeten die Kopie, die der Supervisor-Prozess im Hintergrund geerbt hatte
CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS Überschreibt das Standard-Token-Limit für das Lesen von Dateien. Nützlich, wenn Sie größere Dateien vollständig lesen müssen
CLAUDE_CODE_FORCE_SESSION_PERSISTENCE Auf 1 setzen, um die Speicherung von Transkripten, den Prompt-Verlauf und die Registrierung bei claude agents zu erzwingen, auch wenn dieses claude aus einer anderen Claude-Code-Sitzung heraus gestartet wurde. Verwenden Sie dies, wenn ein geerbter Wert von CLAUDE_CODE_CHILD_SESSION, zum Beispiel aus einer screen-Sitzung oder einem Hintergrund-Launcher, der zuerst vom Bash-Tool von Claude Code gestartet wurde, dazu führt, dass eine echte Sitzung der obersten Ebene fälschlicherweise als verschachtelt eingestuft wird. Ab v2.1.178 erkennt Claude Code den tmux-Fall automatisch und ignoriert die geerbte Markierung, sodass tmux diese Variable nicht mehr benötigt. Wird auch in v2.1.169 und früher berücksichtigt; hat keine Wirkung in v2.1.170 und v2.1.171, in denen die Erkennung verschachtelter Sitzungen, die sie überschreibt, entfernt war
CLAUDE_CODE_FORCE_STRIKETHROUGH Auf 1 setzen, um die Darstellung von ~~text~~ als durchgestrichenen Text in Claudes Antworten zu erzwingen, wenn Ihr Terminal dies 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 für 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 das Vollbild-Rendering umschaltet, ändert dies den Renderer nicht
CLAUDE_CODE_FORK_SUBAGENT Steuert den Fork-Modus, mit dem Claude selbst geforkte Subagenten starten kann und der standardmäßig nur in interaktiven Sitzungen aktiviert ist. Auf 1 setzen, um ihn auch in claude -p und im Agent SDK zu aktivieren, oder auf 0, um ihn in allen Arten von Sitzungen zu deaktivieren. Sie können /subtask unabhängig davon ausführen, ob der Fork-Modus aktiviert ist. Der interaktive Standard erfordert Claude Code v2.1.232 oder höher; setzen Sie die Variable in früheren Versionen auf 1, um den Fork-Modus zu aktivieren
CLAUDE_CODE_FORWARD_SUBAGENT_TEXT Auf 1 setzen, um Text- und Thinking-Blöcke von Subagenten in der Ausgabe von claude -p --output-format stream-json auszugeben – dasselbe Verhalten wie mit dem 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, sodass 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 über einen benutzerdefinierten Proxy oder einen Drittanbieter wie Amazon Bedrock oder Claude Platform on AWS zu senden. Auf 0 setzen, um sie bei keiner Verbindung mehr zu senden, auch nicht bei einer direkten Verbindung zur Anthropic API, bei der Claude Code sie standardmäßig sendet. Erfordert Claude Code v2.1.273 oder höher
CLAUDE_CODE_GATEWAY_MODEL_DISCOVERY_TIMEOUT_MS Timeout in Millisekunden für die Anfrage zur Gateway-Modellermittlung, 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 ist, sich aber nicht in Ihrem PATH befindet. Wenn der Pfad nicht existiert oder die Datei nicht bash.exe, sh.exe, bash oder sh heißt, ignoriert Claude Code die Variable, erkennt Git Bash automatisch, als wäre sie nicht gesetzt, und protokolliert eine Warnung, die mit --debug sichtbar ist. Vor v2.1.219 wurde Claude Code beim Start beendet, wenn der Pfad nicht existierte, und verwendete jede vorhandene Datei als Shell, ohne zu prüfen, ob es sich um bash oder sh handelte. Siehe Einrichtung unter Windows
CLAUDE_CODE_GLOB_HIDDEN Auf false setzen, um Dotfiles aus den Ergebnissen auszuschließen, wenn Claude das Glob-Tool aufruft. Standardmäßig enthalten. Wirkt sich nicht auf die @-Dateivervollstä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 per gitignore ausgeschlossenen. Wirkt sich nicht auf die @-Dateivervollständigung aus, die ihre eigene Einstellung respectGitignore hat
CLAUDE_CODE_GLOB_TIMEOUT_SECONDS Timeout in Sekunden für die Dateiermittlung des Glob-Tools. Standardmäßig 20 Sekunden auf den meisten Plattformen und 60 Sekunden unter WSL
CLAUDE_CODE_GOAL_CHECKIN_MINUTES Wie viele Minuten Arbeit im Hintergrund ein aktives Ziel warten lassen kann, bevor Claude Code Claude bittet, danach zu sehen. Standard 30. Auf 0 setzen, um diese Überprüfungen zu deaktivieren. 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 bei Bildschirmfreigaben oder Aufzeichnungen, bei denen der Pfad Ihren Betriebssystem-Benutzernamen preisgibt
CLAUDE_CODE_IDE_HOST_OVERRIDE Überschreibt die Host-Adresse, die für die Verbindung zur IDE-Erweiterung verwendet wird. Standardmäßig ermittelt Claude Code die richtige Adresse automatisch, einschließlich des Routings von WSL zu Windows
CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL Auf 1 setzen, um die automatische Installation von IDE-Erweiterungen zu überspringen. Entspricht dem Setzen von autoInstallIdeExtension auf false
CLAUDE_CODE_IDE_SKIP_VALID_CHECK Auf 1 setzen, um die Validierung von IDE-Lockfile-Einträgen beim Verbinden zu überspringen. Verwenden Sie dies, wenn die automatische Verbindung Ihre IDE nicht findet, obwohl sie läuft
CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS Wie viele Subagenten in einer Sitzung gleichzeitig laufen können, bevor das Agent-Tool das Starten eines weiteren verweigert (Standard: 20). Akzeptiert eine positive ganze Zahl 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 weiterleiten, dessen Kontextfenster nicht der integrierten Größe für seinen Namen entspricht
CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH Maximale Länge in Zeichen für jede MCP-Tool-Beschreibung und die 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 diese 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. Für unbeaufsichtigte Sitzungen, die längere Ausfälle abwarten müssen, setzen Sie stattdessen CLAUDE_CODE_RETRY_WATCHDOG
CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION Entfernt in v2.1.224 und jetzt wirkungslos. Begrenzte zuvor die Gesamtzahl der Subagenten, die Claude mit dem Agent-Tool in einer Sitzung starten konnte (Standard: 200); das Starten über die Obergrenze hinaus schlug mit Subagent spawn limit reached fehl. Das Limit für gleichzeitige Subagenten und das Tiefenlimit gelten weiterhin
CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH Anzahl der Subagenten-Ebenen, die unterhalb der Hauptkonversation erlaubt sind (Standard: 3). Beim Standardwert können Subagenten eigene Subagenten starten, und ein Subagent auf der dritten Ebene kann keine weiteren starten; auf 1 setzen, um die Verschachtelung zu deaktivieren. In v2.1.217 bis v2.1.218 war der Standard 1, sodass ein Subagent keine eigenen starten konnte, sofern Sie das Limit nicht erhöhten; v2.1.219 erhöhte den Standard auf 3. Akzeptiert eine positive ganze Zahl als reine Ziffern; alles andere wird ignoriert, sodass das Limit angepasst, aber nicht aufgehoben werden kann. Erfordert Claude Code v2.1.217 oder höher
CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY Maximale Anzahl nur lesender Tools und Subagenten, die parallel ausgeführt werden können (Standard: 10). Höhere Werte erhöhen die Parallelität, verbrauchen aber mehr Ressourcen
CLAUDE_CODE_MAX_TURNS Begrenzt die Anzahl agentischer Turns, wenn kein explizites Limit übergeben wird. Entspricht der Übergabe von --max-turns, das Vorrang hat, wenn beide gesetzt sind. Ein Wert, der keine positive ganze Zahl ist, wird beim Start mit einem Fehler abgelehnt, statt als fehlende Obergrenze behandelt zu werden
CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION Obergrenze für die Gesamtzahl an WebSearch-Aufrufen, die eine Sitzung ausführen kann (Standard: 200). Wenn Claude die Obergrenze erreicht, geben weitere WebSearch-Aufrufe einen Hinweis zurück, der Claude anweist, mit den bereits gesammelten Informationen fortzufahren. Akzeptiert eine positive ganze Zahl ohne Obergrenze. Alles andere wird ignoriert und der Standard gilt, sodass die Obergrenze erhöht, aber nicht deaktiviert werden kann. Erfordert Claude Code v2.1.212 oder höher
CLAUDE_CODE_MCP_ALLOWLIST_ENV Auf 1 setzen, um stdio-MCP-Server nur mit einer sicheren Basisumgebung plus dem für den Server konfigurierten env zu starten, statt Ihre Shell-Umgebung zu erben
CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS Verstrichene Zeit in Millisekunden, nach der 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 zu deaktivieren. Erfordert Claude Code v2.1.212 oder höher
CLAUDE_CODE_MCP_STARTUP_WAIT_MS Wie lange in Millisekunden der erste Turn einer nicht interaktiven Sitzung auf MCP-Server wartet, die noch eine Verbindung herstellen, anstelle der standardmäßigen Wartezeit im ersten Turn. Wenn gesetzt, gilt die Wartezeit für jeden ausstehenden Server. Auf 0 setzen, um das Warten zu überspringen. Ein --permission-prompt-tool-Server behält unabhängig vom Wert seine eigene MCP_TIMEOUT-Wartezeit. Erfordert Claude Code v2.1.274 oder höher
CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT Leerlauf-Timeout in Millisekunden für MCP-Tool-Aufrufe. Wenn ein stdio-, HTTP-, SSE-, WebSocket- oder claude.ai-Konnektor-MCP-Server so lange weder eine Antwort noch eine Fortschrittsbenachrichtigung sendet, wird der Tool-Aufruf mit einem Fehler abgebrochen, statt auf den gesamten 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 den effektiven MCP_TOOL_TIMEOUT begrenzt. Ein serverspezifischer timeout in .mcp.json von mindestens 1000 erhöht das Leerlauffenster dieses Servers auf mindestens den timeout-Wert. 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 Inbox-Socket binden, exportiert Claude Code den Pfad dieses Sockets an Hooks und Bash-Befehle, wenn es den Socket bindet. In einer Sitzung, die mit aktiviertem Messaging startet, bindet Claude Code den Socket, bevor ein Hook ausgeführt wird. Andere Sitzungen auf dem Rechner stellen Nachrichten an diesen Pfad zu. Jede Sitzung exportiert ihren eigenen Socket statt eines von einer übergeordneten Sitzung geerbten, und darauf eingehende Nachrichten durchlaufen die Steuerung eingehender Nachrichten der Sitzung. env-Blöcke in Einstellungen können sie nicht setzen. Erfordert Claude Code v2.1.224 oder höher
CLAUDE_CODE_MESSAGING_TOKEN Wird von Claude Code gesetzt, nicht von Ihnen: In Sitzungen, die einen Inbox-Socket binden, exportiert Claude Code dieses sitzungsspezifische Token zusammen mit CLAUDE_CODE_MESSAGING_SOCKET an Hooks und Bash-Befehle. Ein Skript, das an den Socket sendet, kann als erste Zeile {"type":"auth","token":"<token>"} senden, um nachzuweisen, dass es zur Sitzung gehört. Unter nativem Windows verlangt Claude Code diese Zeile und schließt jede Verbindung, die nicht mit einer gültigen Zeile beginnt. Die Regeln für eigene Kindprozesse legen fest, wann Claude Code das Token prüft. Jede Sitzung exportiert ihr eigenes Token, niemals eines, das von einer übergeordneten Sitzung geerbt wurde. env-Blöcke in Einstellungen können sie nicht setzen. Erfordert Claude Code v2.1.228 oder höher
CLAUDE_CODE_NATIVE_CURSOR Auf 1 setzen, um an der Eingabemarke den eigenen Cursor des Terminals statt eines gezeichneten Blocks anzuzeigen. Der Cursor berücksichtigt die Einstellungen des Terminals für Blinken, Form und Fokus
CLAUDE_CODE_NEW_INIT Auf 1 setzen, damit /init einen interaktiven Einrichtungsablauf ausführt. Der Ablauf fragt, welche Dateien erzeugt werden sollen, darunter CLAUDE.md, Skills und Hooks, bevor er die Codebasis untersucht und sie schreibt. Ohne diese Variable erzeugt /init automatisch eine CLAUDE.md ohne Nachfrage
CLAUDE_CODE_NONBLOCKING_STDOUT Auf 1 setzen, um die Terminalausgabe über einen zweiten, nicht blockierenden Dateideskriptor zu schreiben, sodass ein Terminal, das nicht mehr liest, 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, bei der eine Zeitüberschreitung auftritt, erneut sendet. Mit 0 schlägt die Anfrage bei der ersten Zeitüberschreitung fehl. Standardmäßig nicht gesetzt, sodass CLAUDE_CODE_MAX_RETRIES diese erneuten Sendungen begrenzt. Zum Timeout siehe Wiederholungsverhalten anpassen. Erfordert Claude Code v2.1.285 oder höher
CLAUDE_CODE_NO_FLICKER Auf 1 setzen, um das Vollbild-Rendering zu aktivieren, eine Research Preview, die Flackern reduziert und den Speicherverbrauch in langen Konversationen konstant hält. Überschreibt die Einstellung tui; Sie können auch mit /tui fullscreen umschalten
CLAUDE_CODE_OAUTH_REFRESH_TOKEN OAuth-Refresh-Token für die Authentifizierung bei Claude.ai. Wenn gesetzt, tauscht claude auth login dieses Token direkt ein, statt einen Browser zu öffnen. Erfordert CLAUDE_CODE_OAUTH_SCOPES. Nützlich für die Bereitstellung der Authentifizierung in automatisierten Umgebungen
CLAUDE_CODE_OAUTH_SCOPES Durch Leerzeichen getrennte OAuth-Scopes, mit denen das Refresh-Token ausgestellt wurde, etwa "user:profile user:inference user:sessions:claude_code". Erforderlich, wenn CLAUDE_CODE_OAUTH_REFRESH_TOKEN gesetzt ist
CLAUDE_CODE_OAUTH_TOKEN OAuth-Zugriffstoken für die Authentifizierung bei claude.ai. 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 neu
CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE Entfernt in v2.1.160 und jetzt wirkungslos. 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, unverarbeitete API-Bodys), einschließlich Kürzungsmarkierung, in UTF-16-Codeeinheiten (Standard: 61440, d. h. 60 KB). Erhöhen Sie den Wert nur, wenn Ihr Telemetrie-Backend Attributwerte 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 Überwachung
CLAUDE_CODE_OTEL_DIAG_STDERR Auf 1 setzen, um Diagnosefehler des OpenTelemetry-Exporters nach stderr zu schreiben. Standardmäßig erscheinen diese Fehler nur mit --debug, sodass ein falsch konfigurierter Exporter, etwa bei einer Prometheus-Portkollision, andernfalls unbemerkt fehlschlägt. Erfordert Claude Code v2.1.179 oder höher. Siehe Überwachung
CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS Timeout in Millisekunden für das Leeren ausstehender OpenTelemetry-Spans (Standard: 5000). Siehe Überwachung
CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS Intervall für die Aktualisierung dynamischer OpenTelemetry-Header in Millisekunden (Standard: 1740000 / 29 Minuten). Siehe Dynamische Header
CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS Timeout in Millisekunden, innerhalb dessen der OpenTelemetry-Exporter beim Herunterfahren abschließen muss (Standard: 2000). Erhöhen Sie den Wert, wenn Metriken beim Beenden verloren gehen. Siehe Überwachung
CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE Auf 1 setzen, damit Claude Code den Upgrade-Befehl Ihres Paketmanagers im Hintergrund ausführt, wenn eine neue Version verfügbar ist. Gilt für Homebrew- und WinGet-Installationen. Andere Paketmanager zeigen weiterhin den Upgrade-Befehl an, ohne ihn auszuführen. Siehe Automatische Updates
CLAUDE_CODE_PERFORCE_MODE Auf 1 setzen, um einen Perforce-bewussten Schreibschutz zu aktivieren. Wenn gesetzt, schlagen Edit, Write und NotebookEdit mit einem Hinweis auf p4 edit <file> fehl, wenn der Zieldatei das Schreibrecht für den Besitzer fehlt, das Perforce bei synchronisierten Dateien entfernt, 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 dieses Pfads. Standardmäßig ~/.claude/plugins
CLAUDE_CODE_PLUGIN_DIRS Plugin-Verzeichnisse, die für die Sitzung geladen werden, jedes so, wie es ein --plugin-dir-Flag laden würde. 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 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 Kurzschreibweise owner/repo über HTTPS statt über SSH zu klonen. Gilt für die Installation und Aktualisierung von Plugins sowie für /plugin marketplace add und update. Nützlich in CI-Runnern, Containern oder jeder Umgebung ohne konfigurierten SSH-Schlüssel für github.com
CLAUDE_CODE_PLUGIN_SEED_DIR Pfad zu einem oder mehreren schreibgeschützten Plugin-Seed-Verzeichnissen, getrennt durch : unter Unix oder ; unter Windows. Verwenden Sie dies, um ein vorab befülltes Plugin-Verzeichnis in ein Container-Image einzubinden. Claude Code registriert Marketplaces aus diesen Verzeichnissen beim Start und verwendet vorab zwischengespeicherte Plugins, ohne sie erneut zu klonen. Siehe Plugins für Container vorab befü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 -ExecutionPolicy Bypass übergibt und stattdessen die effektive Ausführungsrichtlinie des Rechners berücksichtigt. Standardmäßig umgeht Claude Code die Ausführungsrichtlinie auf Prozessebene, damit .ps1-Skripte und Modulimporte auf Windows-Installationen mit der Standardeinstellung Restricted funktionieren. Die Umgehung auf Prozessebene überschreibt unabhängig von dieser Einstellung niemals die Gruppenrichtlinien MachinePolicy oder UserPolicy
CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS Obergrenze in Millisekunden für das Warten im Leerlauf auf Subagenten und Workflows im Hintergrund nach dem letzten Turn im nicht interaktiven Modus mit dem Flag -p. Das Warten im Leerlauf beginnt jedes Mal von vorn, wenn Claude einen Turn ausführt, um ein Ergebnis aus dem Hintergrund 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 Schonfrist, die für einfache Shells im Hintergrund 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 Sitzungen der Agent-Ansicht 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 abgekoppelte Hintergrunddienst sie erbt; Projekt- und lokale Einstellungen können sie nicht setzen. Entspricht der Einstellung processWrapper, die Claude Code v2.1.210 oder höher erfordert; diese Variable hat Vorrang, wenn beide gesetzt sind. Die VS Code-Erweiterung konfiguriert ihren eigenen Launcher separat über ihre Einstellung claudeProcessWrapper. Wird unter Windows ignoriert. Unter Claude Code hinter einem Unternehmens-Launcher ausführen finden Sie das Werteformat, was der Launcher abdeckt und welche Anforderungen der Launcher erfüllen muss. Erfordert Claude Code v2.1.208 oder höher
CLAUDE_CODE_PROJECT_DIR_NAME Zusammen mit CLAUDE_CONFIG_DIR setzen, um den Verzeichnisnamen unter projects/ festzulegen, unter dem Claude Code die Transkripte und das Auto-Memory dieser Sitzung speichert, anstelle eines aus dem Pfad des Arbeitsverzeichnisses abgeleiteten Namens. Wenn Sie Claude Code beispielsweise mit CLAUDE_CONFIG_DIR=/srv/tenant-a CLAUDE_CODE_PROJECT_DIR_NAME=work claude starten, werden sie unter /srv/tenant-a/projects/work/ gespeichert. Claude Code ignoriert diese Variable, wenn CLAUDE_CONFIG_DIR nicht gesetzt ist, und liest sie nur aus der Umgebung, aus der Sie claude starten, niemals aus einem env-Block einer Einstellungsdatei. Siehe Das Projektverzeichnis selbst benennen. Erfordert Claude Code v2.1.234 oder höher
CLAUDE_CODE_PROMPT_CACHE_TTL Setzen Sie 5m oder 1h, die einzigen Werte, die Claude Code akzeptiert, um die Prompt-Cache-TTL für die Hauptkonversation festzulegen: Ihre interaktiven, -p- und SDK-Turns sowie die Hilfsprozesse, die inline mit ihnen laufen. Hat Vorrang vor der Einstellung promptCacheTtl und vor ENABLE_PROMPT_CACHING_1H, und FORCE_PROMPT_CACHING_5M überschreibt sie. Die API berechnet einstündige 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 verweist. Die Weitergabe umfasst den Header traceparent bei Modell- und HTTP-MCP-Anfragen sowie die Umgebungsvariable TRACEPARENT für Bash-, PowerShell- und Hook-Unterprozesse. Standardmäßig ist die Weitergabe nur bei 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-Deaktivierung, 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 Deaktivierung über DISABLE_TELEMETRY folgt. Siehe Standardverhalten nach API-Anbieter
CLAUDE_CODE_PROXY_RESOLVES_HOSTS Auf 1 setzen, damit der Proxy statt des Aufrufers die DNS-Auflösung durchführt. Opt-in für Umgebungen, in denen der Proxy die Auflösung von Hostnamen übernehmen soll
CLAUDE_CODE_REMOTE Wird automatisch auf true gesetzt, wenn Claude Code als Cloud-Sitzung läuft. Lesen Sie 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 die Variable 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 der Übergabe von --restricted. Claude Code ignoriert diese Variable im env-Block einer Einstellungsdatei. Erfordert Claude Code v2.1.248 oder höher
CLAUDE_CODE_RESUME_INTERRUPTED_TURN Auf 1 setzen, um automatisch fortzufahren, wenn die vorherige Sitzung mitten in einem Turn endete. Wird im SDK-Modus verwendet, damit das Modell fortfährt, ohne dass das SDK den Prompt erneut senden muss. Um dies zu deaktivieren, entfernen Sie die Variable oder setzen Sie sie auf 0. Zum Chat-Panel von VS Code siehe Konversationen nach einem Neuladen fortsetzen
CLAUDE_CODE_RESUME_INTERRUPTED_TURN_MAX_AGE_MS Maximales Alter in Millisekunden der letzten Transkriptnachricht, bis zu dem eine mitten im Turn beendete Sitzung beim Fortsetzen automatisch weiterläuft. Ist die letzte Nachricht älter als diese Grenze, überspringt Claude Code das automatische Fortsetzen durch CLAUDE_CODE_RESUME_INTERRUPTED_TURN und die zugehörige Fortsetzungsnachricht aus CLAUDE_CODE_RESUME_PROMPT, und die Sitzung startet im Leerlauf, sodass Sie explizit fortfahren. Nicht gesetzt oder 0 bedeutet keine Grenze, außer dass ein Turn, dessen letzte Anfrage mit einem API-Fehler fehlgeschlagen ist, 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 legt selbst eine Grenze von einer Stunde fest, wenn es eine abgestürzte Sitzung der Agent-Ansicht 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 aufgebrauchtes 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. Zu Anfragen im Fast-Modus siehe Umgang mit Rate-Limits. Der Watchdog wartet zwischen den Versuchen bis zu 5 Minuten oder bis zum Zurücksetzen des Limits, wenn die Antwort einen Rücksetzzeitpunkt für das Rate-Limit enthält, sodass eine Sitzung, die ein Nutzungslimit erreicht, das verbleibende Zeitfenster abwartet. Ab v2.1.199 erhöht er außerdem die Standardanzahl an Wiederholungsversuchen für andere vorübergehende Fehler wie Serverfehler, Zeitüberschreitungen 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 Designs, benutzerdefinierte Tastenkombinationen, Statuszeilen- und Dateivorschlagsbefehle, LSP-Server und Auto-Memory werden nicht geladen, um eine defekte Konfiguration zu beheben. Die Richtlinie der verwalteten Einstellungen gilt weiterhin, einschließlich per Richtlinie konfigurierter Hooks, Statuszeilen- und Dateivorschlagsbefehle; verwaltete Plugins, verwaltete Skills, verwaltete CLAUDE.md und per Richtlinie konfigurierte MCP-Server hingegen nicht. Entspricht der Übergabe von --safe-mode. Direkt gestartete Kindprozesse erben die Variable
CLAUDE_CODE_SCRIPT_CAPS JSON-Objekt, das begrenzt, wie oft bestimmte Skripte pro Sitzung aufgerufen werden dürfen, wenn CLAUDE_CODE_SUBPROCESS_ENV_SCRUB gesetzt ist. Schlüssel sind Teilzeichenfolgen, die mit dem Befehlstext abgeglichen werden; Werte sind ganzzahlige Aufruflimits. Beispielsweise erlaubt {"deploy.sh": 2}, dass deploy.sh höchstens zweimal aufgerufen wird. Der Abgleich basiert auf Teilzeichenfolgen, sodass Tricks mit Shell-Expansion wie ./scripts/deploy.sh $(evil) weiterhin auf die Obergrenze angerechnet werden. Eine Auffächerung zur Laufzeit über xargs oder find -exec wird nicht erkannt; dies ist eine Defense-in-Depth-Maßnahme
CLAUDE_CODE_SCROLL_SPEED Legt den Multiplikator für das Scrollen mit dem Mausrad im Vollbild-Rendering fest. Akzeptiert jeden positiven Wert bis 20, einschließlich Bruchwerten unter 1 wie 0.5, um beschleunigtes Trackpad- und Mausrad-Scrollen in Terminals zu verlangsamen, die Mausrad-Events bereits verstärken. Auf 3 setzen, um vim zu entsprechen, wenn Ihr Terminal pro Raststufe ein Mausrad-Event ohne Verstärkung sendet. Wird im Terminal der JetBrains-IDE ignoriert, wo Claude Code eine eigene Scroll-Verarbeitung verwendet
CLAUDE_CODE_SEND_FEEDBACK Auf 0 setzen, um von Claude entworfenes Feedback für eine Sitzung zu deaktivieren. Auf 1 setzen, um es zu aktivieren, sofern Ihr Konto bereits Zugriff hat; die Variable kann den Zugriff nicht selbst gewähren, und die anderen Schalter, die Feedback deaktivieren, 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 auch 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 Hook-spezifischen timeout angehoben, höchstens 60 Sekunden. Timeouts von Hooks aus Plugins erhöhen das Budget nicht
CLAUDE_CODE_SESSION_ID Wird automatisch auf die aktuelle Sitzungs-ID in Unterprozessen des Bash- und PowerShell-Tools, in Unterprozessen von Hook-Befehlen und in Unterprozessen von stdio-MCP-Servern gesetzt. Für Bash, PowerShell und Hooks entspricht sie 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 fortgesetzte ID, passend zu Hooks und Bash. Bei --continue oder --resume ohne explizite ID erhält er möglicherweise stattdessen die ursprüngliche Start-ID. Verwenden Sie dies, um Skripte und externe Tools der Claude-Code-Sitzung zuzuordnen, die sie gestartet hat
CLAUDE_CODE_SHELL Legt die Shell fest, die Claude Code zum Ausführen 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. Wenn der Wert kein funktionierender bash- oder zsh-Pfad ist, ignoriert Claude Code ihn und fällt auf die automatische Erkennung zurück. Die automatische Erkennung verwendet Ihre $SHELL, wenn sie auf bash oder zsh verweist, und wählt andernfalls die erste funktionierende zsh und dann bash, die in Ihrem PATH und an den Standardinstallationsorten 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 werden ohne das Präfix ausgeführt. Nützlich für Logging oder Auditing. Wenn Sie einen reinen Pfad zu einer ausführbaren Datei wie /path/to/logger.sh setzen, 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 erneut auswerten, zum Beispiel exec bash -c "$1". Wird $1 als reiner Pfad zu einer ausführbaren Datei behandelt, funktionieren stdio-MCP-Server nicht mehr, die Argumente wie npx -y <package> übergeben. Bei 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 Bash, Datei lesen und Datei bearbeiten zu arbeiten. MCP-Tools aus --mcp-config sind weiterhin verfügbar. Deaktiviert die automatische Erkennung von Hooks, Skills, benutzerdefinierten Befehlen, Subagenten, installierten Plugins, MCP-Servern, Auto-Memory und CLAUDE.md. Skills in einem Verzeichnis, das Sie mit --add-dir übergeben, werden weiterhin geladen. OAuth-Token und Anmeldedaten aus dem Schlüsselbund werden nicht gelesen, daher muss die Authentifizierung bei Anthropic ü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 abzulehnen, 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 zu deaktivieren, die über die AWS-Standardkette der Anmeldedatenanbieter aufgelöst werden, sodass Claude Code die Kette bei jeder API-Anfrage auflöst. Bei deaktiviertem Cache fordert ein SSO-basiertes Profil bei jeder Anfrage Anmeldedaten von IAM Identity Center an. Siehe Zwischenspeicherung von Anmeldedaten und Timeout für die Auflösung. Erfordert Claude Code v2.1.207 oder höher
CLAUDE_CODE_SKIP_BEDROCK_AUTH Überspringt die AWS-Authentifizierung für Amazon Bedrock (zum Beispiel bei Verwendung eines LLM-Gateways)
CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS Auf 1 setzen, um eine fehlgeschlagene Verfügbarkeitsprüfung für den Fast-Modus als verfügbar zu behandeln, für Netzwerke, die die direkte Anfrage der Prüfung an api.anthropic.com blockieren. Claude Code berücksichtigt weiterhin eine Antwort „disabled by your organization“
CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK Auf 1 setzen, um die clientseitige Verfügbarkeitsprüfung für den Fast-Modus zu überspringen, für Proxys, die die Anfrage der Prüfung abfangen, statt sie abzulehnen. Die API lehnt Anfragen im Fast-Modus weiterhin ab, wenn Ihre Organisation den Fast-Modus deaktiviert hat
CLAUDE_CODE_SKIP_FOUNDRY_AUTH Überspringt die Azure-Authentifizierung für Microsoft Foundry, für einen Proxy oder ein Gateway, das einen eigenen Authorization-Header einfügt. Claude Code sendet Anfragen ohne Azure-Anmeldedaten und behält den Authorization-Header bei, den Sie angeben, 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 einem Tag lang, welche Modelle Ihr Konto ihrer Feststellung nach nicht aufrufen kann. Auf 1 setzen, um diese Speicherung zu deaktivieren. Erfordert Claude Code v2.1.285 oder höher
CLAUDE_CODE_SKIP_PROMPT_HISTORY Auf 1 setzen, um das Schreiben von Prompt-Verlauf und Sitzungstranskripten auf die Festplatte zu überspringen. Sitzungen, die mit gesetzter Variable gestartet wurden, erscheinen nicht in --resume, --continue oder im Verlauf über die Pfeil-nach-oben-Taste. Nützlich für kurzlebige, skriptgesteuerte Sitzungen
CLAUDE_CODE_SKIP_VERTEX_AUTH Überspringt die Google-Authentifizierung für Google Cloud's Agent Platform (zum Beispiel bei Verwendung eines LLM-Gateways)
CLAUDE_CODE_STARTUP_FAILURE_RESULTS Auf 1 setzen, damit eine mit --output-format stream-json gestartete Sitzung eine Ergebnisnachricht mit dem Grund, warum Claude Code den Start verweigert hat, für Startfehler schreibt, die sonst nur mit einer Ausgabe auf stderr enden. Erfordert Claude Code v2.1.274 oder höher
CLAUDE_CODE_STOP_HOOK_BLOCK_CAP Maximale Anzahl aufeinanderfolgender Male, die ein Stop- oder SubagentStop-Hook das Beenden des Turns blockieren darf, bevor Claude Code ihn überstimmt 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: 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. Die vollständige Reihenfolge finden Sie unter Ein Modell auswählen. Das Setzen auf inherit entspricht dem Nichtsetzen. Vor v2.1.251 überschrieb diese Variable sowohl das Modell pro Aufruf als auch das model-Feld der Definition
CLAUDE_CODE_SUBAGENT_MODEL_FORCE Auf 1 setzen, um Subagenten, Teammitgliedern und Workflow-Agenten ein einziges Modell aufzuzwingen. Unter Jeden Subagenten mit einem Modell ausführen steht, welches Modell das ist. Erfordert Claude Code v2.1.257 oder höher
CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL Setzen Sie 5m oder 1h, die einzigen Werte, die Claude Code akzeptiert, um die Prompt-Cache-TTL für Anfragen außerhalb der Hauptkonversation festzulegen, etwa für Subagenten, Workflows und Arbeit im Hintergrund. Hat Vorrang vor der Einstellung subagentPromptCacheTtl und vor ENABLE_PROMPT_CACHING_1H, und FORCE_PROMPT_CACHING_5M überschreibt sie. Die API berechnet einstündige 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 den Umgebungen von Unterprozessen (Bash-Tool, Hooks, MCP-stdio-Server) zu entfernen: Anmeldedaten von Anthropic und Cloud-Anbietern, jede andere Variable, die Claude Code als Anmeldedaten erkennt, sowie in URLs von Paket-Registrys 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 Claude Codes eigene Zeigervariablen für den Konfigurationsspeicher (etwa CLAUDE_CONFIG_DIR), sodass ein Kindprozess ein verlagertes Konfigurationsverzeichnis nicht finden kann. Lassen Sie die Bereinigung deaktiviert, wenn ein Unterprozess diese Variablen benötigt. Unter Linux werden Bash-Unterprozesse außerdem in einem isolierten PID-Namespace ausgeführt, sodass sie die 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 dies mit CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS, um die Wartezeit zu begrenzen
CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS Timeout in Millisekunden für die synchrone Plugin-Installation. Bei Überschreitung fährt Claude Code ohne Plugins fort und protokolliert einen Fehler. Kein 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 auf deren Liste wartet, höchstens CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS lang, bevor es die erste Abfrage ausführt. Die Downloads selbst werden im Hintergrund abgeschlossen, und Claude wartet auf den Download eines Skills, wenn es diesen Skill aufruft. Erfordert die Authentifizierung über claude.ai. Terminal-Sitzungen, in denen Sie sich mit Ihrem claude.ai-Konto anmelden, laden diese Skills auch ohne diese Variable nach ~/.claude/skills/synced/ herunter und synchronisieren sie etwa alle 10 Minuten erneut; setzen Sie sie daher nur, wenn ein -p-Lauf Ihre aktuellen Skills bereits bei der ersten Abfrage benötigt. Vor v2.1.273 luden Terminal-Sitzungen sie nur in einem -p-Lauf mit gesetzter Variable herunter. Der Ordnername synced ist für diesen Download reserviert. Vor v2.1.227 wurden die Skills direkt nach ~/.claude/skills/ heruntergeladen. Claude Code wendet zusätzliche Regeln auf die heruntergeladenen Skills an, etwa dass ihre !-Befehle nicht auf Ihrem Rechner ausgeführt werden
CLAUDE_CODE_SYNC_SKILLS_INSTALL_TIMEOUT_MS Timeout in Millisekunden für die erneute Synchronisierung der Skills, die mitten in der Sitzung läuft, wenn eine auf dem Agent SDK basierende App Skills neu lädt (Standard: 30000). Bei Überschreitung wird das Neuladen mit den bereits eingetroffenen Skills fortgesetzt, und die verbleibenden Downloads werden im Hintergrund abgeschlossen
CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS Timeout in Millisekunden, wie lange die erste Abfrage auf die anfängliche Skill-Liste wartet, wenn CLAUDE_CODE_SYNC_SKILLS gesetzt ist (Standard: 5000). Bei Überschreitung wird die erste Abfrage mit den bereits eingetroffenen Skills ausgeführt. Die Downloads werden in jedem Fall im Hintergrund abgeschlossen, und Claude wartet auf den Download eines Skills, wenn es diesen Skill aufruft
CLAUDE_CODE_SYNTAX_HIGHLIGHT Auf false setzen, um die Syntaxhervorhebung in der Diff-Ausgabe zu deaktivieren. Nützlich, wenn Farben Ihre Terminal-Einrichtung stören. Um die Hervorhebung auch in Codeblöcken und Dateivorschauen zu deaktivieren, verwenden Sie die Einstellung syntaxHighlightingDisabled
CLAUDE_CODE_TASK_LIST_ID Teilt eine Aufgabenliste über Sitzungen hinweg. Setzen Sie in mehreren Claude-Code-Instanzen dieselbe ID, um sich über eine gemeinsame Aufgabenliste abzustimmen, in Sitzungen, die die Task-Tools haben. 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 heruntergefahren 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 unterhalb des Systemstandards, wenn Ihre Überschreibung ein langer Pfad ist, da einige Tools fehlschlagen, wenn temporäre Pfade zu lang werden. Bash-Befehle außerhalb der 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 wie 1 setzen, um 24-Bit-Truecolor-Ausgabe innerhalb von tmux zu erlauben. Das Setzen auf 0 oder false erlaubt Truecolor weiterhin, anders als bei den meisten Ein/Aus-Variablen; entfernen Sie die Variable, um die Begrenzung auf 256 Farben wiederherzustellen. Standardmäßig begrenzt Claude Code auf 256 Farben, wenn $TMUX gesetzt ist, da tmux Truecolor-Escape-Sequenzen nur weiterleitet, wenn es entsprechend konfiguriert ist. Setzen Sie dies, nachdem Sie set -ga terminal-overrides ',*:Tc' zu Ihrer ~/.tmux.conf hinzugefügt haben. Weitere tmux-Einstellungen finden Sie unter Terminal-Konfiguration
CLAUDE_CODE_TOOL_MEMORY_CGROUP_EXCLUDE Unter Linux und WSL auf eine durch Kommas getrennte Liste der Prozessarten setzen, die Claude Code von der Speicherobergrenze für Tools ausnimmt, etwa mcp oder lsp. Setzen Sie none, um jede Art zu begrenzen, oder all-new, um nur Befehle des Bash-, PowerShell- und Monitor-Tools zu begrenzen. Claude Code hält Befehle des Bash-, PowerShell- und Monitor-Tools unabhängig von Ihrer Liste unter der Obergrenze. Erfordert Claude Code v2.1.246 oder höher
CLAUDE_CODE_TOOL_MEMORY_LIMIT Unter Linux und WSL auf eine Größe wie 4G setzen, um den Arbeitsspeicher zu begrenzen, den Befehle des Bash- und PowerShell-Tools verwenden können, ab v2.1.246 auch 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. Setzen Sie 0 oder off, um die Obergrenze zu deaktivieren. Sobald der erste von Claude Code gestartete Prozess die Obergrenze aktiviert oder deaktiviert hat, wird ein geänderter Wert 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 mitten in der Sitzung erscheinende Zustimmungsabfrage zum Fable-Nutzungsguthaben 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 ermitteln. 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 ist 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 zu deaktivieren. 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 Auf die Anzahl von Millisekunden setzen, die WebFetch die Antwort jeder abgerufenen URL im Cache behält. Der Standard ist 900000, also 15 Minuten. Akzeptiert nur reine Ziffern; 0, eine Dezimalzahl oder jede andere Schreibweise behält den Standard bei. Claude Code liest den Wert einmal pro Start, sodass eine Änderung in einem env-Block der Einstellungen beim nächsten Start von claude wirksam wird. Erfordert Claude Code v2.1.233 oder höher
CLAUDE_CODE_WEBFETCH_DEADLINE_MS Obergrenze in Millisekunden dafür, wie lange WebFetch auf das Herunterladen einer Seite wartet, einschließlich aller Weiterleitungen, denen es folgt. Ein Download, der bis dahin nicht abgeschlossen ist, schlägt mit einem Fristfehler fehl. Der Standard ist 300000, also fünf Minuten. Auf 0 setzen, um das Limit aufzuheben. Akzeptiert nur reine Ziffern; eine Dezimalzahl oder jede andere Schreibweise behält den Standard bei. Erfordert Claude Code v2.1.268 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; agent()-Aufrufe in der Warteschlange 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 parallelen 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 gemeinsam nutzen, hält Claude Code alle Agenten außer dem ersten bis zu dieser Dauer zurück, sodass die übrigen das zwischengespeicherte Präfix lesen, anstatt es jeweils ohne Cache zu verarbeiten. Standardwert 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 parallel 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 Unterprozessen des Bash-Tools und in Hook-Befehlen automatisch auf die Effort-Stufe gesetzt, die beim Start des Unterprozesses 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-Idle-Watchdog auf Byte-Ebene zwangsweise zu aktivieren, oder auf 0, um ihn zwangsweise zu deaktivieren. 0 schaltet außerdem die First-Byte-Frist auf den Verbindungen aus, auf denen diese Frist 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 Event-Ebene dort einen Stillstand melden konnte, selbst während Keep-alive-Pings eintrafen. Informationen zu Timeouts und zum Zusammenspiel der Timer finden Sie unter Streaming-Idle-Watchdogs
CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK Setzen Sie den Wert auf 1, um den Streaming-Idle-Watchdog auf Byte-Ebene für Amazon-Bedrock-Antworten vom Typ vnd.amazon.eventstream zu aktivieren, wodurch auch die First-Byte-Frist 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-Idle-Watchdog auf Event-Ebene 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 aktiviert. Vor v2.1.196 wurde der Standardwert bei nicht gesetzter Variable für die direkte Anthropic API serverseitig gesteuert und war bei anderen Anbietern deaktiviert. Konfigurieren Sie den Timeout mit CLAUDE_STREAM_IDLE_TIMEOUT_MS; Informationen zu den anderen Stillstands-Timern, die parallel dazu laufen, finden Sie unter Streaming-Idle-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 durch die 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 lösen keine Berechtigungsabfrage aus, und das Verzeichnis wird entfernt, wenn die Sitzung gelöscht wird
CLAUDE_PID Claude Code setzt diese Variable in den von ihm gestarteten Unterprozessen 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 ein Signal 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 Frist in Millisekunden für das erste Antwort-Byte einer Streaming-Anfrage auf den Verbindungen, auf denen die First-Byte-Frist 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 Frist wählt, wenn Sie die 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-Idle-Watchdogs auf Event- und Byte-Ebene eine stillstehende Verbindung schließen. Wenn Sie diese Variable explizit setzen, beträgt das Minimum 300000 (5 Minuten); niedrigere Werte werden stillschweigend angehoben, um längere Thinking-Pausen und Proxy-Pufferung aufzufangen, und der Watchdog auf Byte-Ebene begrenzt den Wert auf 30 Minuten. CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS hat für den Watchdog auf Byte-Ebene Vorrang vor dieser Variable. Die Standardwerte der einzelnen Watchdogs bei nicht gesetzter Variable finden Sie unter Streaming-Idle-Watchdogs
CLAUDE_SUBAGENT_BG_SHELL_MAX_MS In v2.1.260 entfernt und jetzt ohne Wirkung. Begrenzte zuvor in Millisekunden, wie lange ein Shell-Befehl im Hintergrund, den ein Subagent gestartet hat, laufen durfte, mit einem Standardwert von 60 Minuten. Siehe die Regeln zur Lebensdauer von Hintergrundbefehlen
DEBUG Setzen Sie den Wert auf 1, um den Debug-Modus zu aktivieren, gleichbedeutend mit dem 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 Wahrheitswerte 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 Hintergrundaktualisierungen zu deaktivieren. 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 jede 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 Diagnosebildschirm-Befehl /doctor aus
DISABLE_ERROR_REPORTING Setzen Sie einen beliebigen nicht leeren Wert, etwa 1, um die Fehlerberichterstattung abzulehnen. Auch das Setzen auf 0 oder false lehnt sie ab, anders als bei den meisten Ein/Aus-Variablen; entfernen Sie die Variable, um die Fehlerberichterstattung wieder einzuschalten
DISABLE_EXTRA_USAGE_COMMAND Setzen Sie den Wert auf 1, um den Befehl /usage-credits auszublenden, mit dem Benutzer zusätzliche Nutzung über 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 außerdem /bug und /share, die über denselben Weg melden; vor v2.1.212 waren sie Aliase von /feedback, sodass der Befehl unter jedem Namen deaktiviert war. 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 im Code zu verwenden. Dadurch sind Remote Control und die anderen Funktionen, die das Abrufen von Feature-Flags benötigen, nicht verfügbar. Das Setzen auf 0 oder false lässt das Abrufen eingeschaltet. Die Protokollierung von Telemetrie-Events bleibt aktiv, sofern nicht auch DISABLE_TELEMETRY gesetzt ist
DISABLE_INSTALLATION_CHECKS Setzen Sie den Wert auf 1, um Installationswarnungen zu deaktivieren. Verwenden Sie dies nur, 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 Standard-Haiku-Modell zu deaktivieren, unabhängig davon, wo es läuft
DISABLE_PROMPT_CACHING_OPUS Setzen Sie den Wert auf 1, um Prompt-Caching für das Standard-Opus-Modell zu deaktivieren
DISABLE_PROMPT_CACHING_SONNET Setzen Sie den Wert auf 1, um Prompt-Caching für das Standard-Sonnet-Modell zu deaktivieren
DISABLE_TELEMETRY Setzen Sie einen beliebigen nicht leeren Wert, etwa 1, um die Telemetrie abzulehnen. Auch das Setzen auf 0 oder false lehnt sie ab, anders als bei den meisten Ein/Aus-Variablen; entfernen Sie die Variable, um die Telemetrie wieder einzuschalten. Telemetrie-Events enthalten keine Benutzerdaten wie Code, Dateipfade oder Bash-Befehle. Deaktiviert außerdem das Abrufen von Feature-Flags. Siehe Telemetrie für Ihre Organisation ausschalten
DISABLE_UPDATES Setzen Sie den Wert auf 1, um alle Aktualisierungen zu blockieren, einschließlich manuellem 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 die Telemetrie abzulehnen, mit derselben Wirkung wie DISABLE_TELEMETRY, auch in Bezug auf das Abrufen von Feature-Flags. Claude Code liest diese Variable als Standard-Boolean, 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. Interaktive CLI-Sitzungen erfordern zusätzlich, dass Ihre Organisation für die Beta freigeschaltet ist. 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 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, 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 in der Hauptkonversation automatisch. 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 festzulegen, 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. Ist die Variable nicht gesetzt, lädt Claude Code standardmäßig alle MCP-Tools verzögert. Vorab geladen werden sie weiterhin bei Modellen auf Google Cloud's Agent Platform, die älter als die Generation Claude 4.5 sind, bei einer auf Azure gehosteten Microsoft-Foundry-Bereitstellung und wenn ANTHROPIC_BASE_URL auf einen Host zeigt, der kein Erstanbieter-Host ist. true lädt immer verzögert und sendet den Beta-Header, außer bei 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 selbst gesetzter Wert wird ignoriert, wenn CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS gesetzt ist. Vor v2.1.221 deaktivierte Claude Code die Tool-Suche 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 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 das Setzen auf 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 bricht Claude Code Wiederholungsversuche auf diese Weise bei Modellen ab, 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-Aktualisierungen zu erzwingen, selbst wenn der Haupt-Auto-Updater über DISABLE_AUTOUPDATER deaktiviert ist
FORCE_HYPERLINK Setzen Sie den Wert auf 1, um anklickbare OSC-8-Hyperlinks zu aktivieren, wenn Ihr Terminal sie unterstützt, dies aber nicht automatisch erkannt wird, oder auf 0, um sie zu deaktivieren. Wenn die Variable nicht gesetzt ist, aktiviert Claude Code Hyperlinks nur, wenn es Terminal-Unterstützung erkennt. Claude Code wertet diesen Wert als Zahl und nicht als Boolean aus, sodass ein Wert wie false, no oder off Hyperlinks aktiviert, anstatt sie zu deaktivieren. Das Badge für Pull Request oder Merge Request 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-Proxy-Server für Netzwerkverbindungen an
HTTPS_PROXY Gibt den HTTPS-Proxy-Server für Netzwerkverbindungen an
IS_DEMO Setzen Sie einen beliebigen nicht leeren Wert, etwa 1, um den Demo-Modus zu aktivieren: Blendet Ihre E-Mail-Adresse und den Namen Ihrer Organisation in der Kopfzeile und in der Ausgabe von /status aus und überspringt das Onboarding. Auch das Setzen auf 0 oder false aktiviert den Demo-Modus, anders als bei den meisten Ein/Aus-Variablen; entfernen Sie die Variable, um ihn auszuschalten. Nützlich beim Streamen oder Aufzeichnen einer Sitzung
MAX_MCP_OUTPUT_TOKENS Maximale Anzahl an Token, die in Antworten von MCP-Tools zulässig sind. 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 im nicht interaktiven Modus mit dem Flag -p die Validierung gegen das --json-schema nicht besteht; nach so vielen fehlgeschlagenen Versuchen ohne gültige Ausgabe schlägt der Lauf fehl. Dieselbe Obergrenze gilt, wenn die strukturierte Ausgabe eines Workflow-Subagenten die Validierung nicht besteht. Standardwert 5, also 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 unter 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 Thinking nicht ausgeschaltet werden kann. 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 anstelle einer höheren Stufe. Claude Code ignoriert Werte ungleich null bei Modellen mit adaptivem Reasoning, außer bei den Modellen, bei denen CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING das adaptive Reasoning ausschaltet
MCP_CLIENT_SECRET OAuth-Client-Secret für MCP-Server, die vorkonfigurierte Anmeldedaten erfordern. Vermeidet die interaktive Abfrage beim Hinzufügen eines Servers mit --client-secret
MCP_CONNECTION_NONBLOCKING Steuert, ob der Start vor der ersten Anfrage darauf wartet, dass MCP-Server verbunden sind. 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 Anfrage auf die Verbindung der Server wartet. 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 ebenfalls vor dem ersten Turn auf noch ausstehende Server. Wenn Sie --mcp-config explizit übergeben, hat das Warten eine längere Frist; die Ausnahme für zwischengespeicherte Server finden Sie im Eintrag zu diesem Flag
MCP_CONNECT_TIMEOUT_MS Wie lange der blockierende MCP-Start in Millisekunden auf den 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 gekennzeichnet sind. Server, die bei Ablauf der Frist noch ausstehen, verbinden sich im Hintergrund weiter. 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 kein 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 Eintrags im Discovery-Cache in Sekunden (Standard: 14400, also 4 Stunden). Ist der Eintrag bei einem Start älter, verwirft Claude Code ihn und verbindet den Server beim Start, wie bei ausgeschaltetem Cache. Claude Code begrenzt den Wert auf 7 Tage. Vor v2.1.238 betrug der Standardwert 86400, also 24 Stunden, und Claude Code begrenzte den Wert nicht
MCP_DISCOVERY_CACHE_STRIKES Ist ein Eintrag im Discovery-Cache bei einem Start älter als MCP_DISCOVERY_CACHE_TTL_S, aktualisiert Claude Code ihn im Hintergrund. Diese Variable legt fest, wie viele Aktualisierungen in Folge fehlschlagen dürfen, 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 Eintrag im Discovery-Cache verwendet, ohne ihn zu aktualisieren (Standard: 900). Ist der Eintrag bei einem Start älter, verwendet Claude Code ihn weiterhin, aktualisiert ihn aber im Hintergrund. Sobald der Eintrag älter als MCP_DISCOVERY_CACHE_MAX_STALE_S ist, verwirft Claude Code ihn stattdessen. Claude Code begrenzt den Wert auf MCP_DISCOVERY_CACHE_MAX_STALE_S, standardmäßig 4 Stunden. Vor v2.1.238 begrenzte Claude Code den Wert nicht
MCP_OAUTH_CALLBACK_PORT Fester Port für den OAuth-Redirect-Callback, als Alternative zu --callback-port beim Hinzufügen eines MCP-Servers mit vorkonfigurierten Anmeldedaten
MCP_PROTOCOL_NEGOTIATION Nur in der v2-MCP-Client-Laufzeitumgebung: 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; ein Server, der auf die Prüfung nicht antwortet, verbindet sich stattdessen über das ältere Protokoll, wie es SSE- und WebSocket-Server immer tun. Setzen Sie legacy, um die Prüfung für alle Server zu überspringen. Ohne die Variable prüft Claude Code HTTP-Server und außerdem claude.ai-Konnektor-Server in Sitzungen, in denen es Feature-Flags abruft. 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 während des Starts parallel verbunden werden (Standard: 20)
MCP_SDK_GENERATION Legt fest, mit welcher MCP-Client-Laufzeitumgebung dieser Prozess sich mit MCP-Servern verbindet: v1, basierend auf dem MCP TypeScript SDK 1.x, oder v2, basierend auf dem 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-Laufzeitumgebung 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 er nicht übereinstimmt. Die v1-Laufzeitumgebung führt diese Prüfung nicht durch. Wenn Sie einen nicht erkannten Wert setzen, ignoriert Claude Code ihn und schreibt eine Warnung in das Debug-Log. Claude Code liest den Wert einmal pro Prozess. Erfordert Claude Code v2.1.218 oder höher
MCP_SERVER_CONNECTION_BATCH_SIZE Maximale Anzahl an lokalen MCP-Servern (stdio), die während des Starts parallel verbunden werden (Standard: 3)
MCP_TIMEOUT Timeout in Millisekunden für den Start von MCP-Servern (Standard: 30000, also 30 Sekunden)
MCP_TOOL_TIMEOUT Timeout in Millisekunden für die Ausführung von MCP-Tools (Standard: 100000000, etwa 28 Stunden). Bei einem HTTP-, SSE- oder claude.ai-Konnektor-Server läuft außerdem jede Anfrage standardmäßig nach 60 Sekunden ab; setzen Sie diese Variable oder den serverspezifischen timeout auf über 60000, um dieses Limit pro Anfrage anzuheben. Ein niedrigerer Wert verkürzt weiterhin 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 betreffenden 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. Für die Umgebungsvariable werden Werte unter 1000 auf eine Sekunde angehoben; für das serverspezifische 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 Telemetrie-Attribute auf den kleineren Wert aus diesem 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-Events 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-Events vom Typ managed_settings_resolved hinzuzufügen. Standardmäßig deaktiviert. Setzen Sie die Variable in Ihrer Shell, in den Benutzereinstellungen oder in verwalteten Einstellungen; ein Wert in Projekt- oder lokalen Einstellungen schaltet sie nicht ein. Erfordert Claude Code v2.1.274 oder höher. Siehe Monitoring
OTEL_LOG_RAW_API_BODIES Gibt Request- und Response-JSON der Anthropic Messages API als Log-Events vom Typ api_request_body / api_response_body aus. Setzen Sie den Wert auf 1 für inline eingebettete 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-Event tool.output aufzunehmen. Span-Attribute enthalten Tool-Inhalte unter eigenen Freigabebedingungen. Erfordert Tracing. Standardmäßig deaktiviert, um sensible Daten zu schützen. Setzen Sie die Variable in Ihrer Shell, in den Benutzereinstellungen oder in verwalteten Einstellungen. Wird in Projekt- und lokalen Einstellungen ignoriert, abgesehen von den Aus-Werten, die in diesem Abschnitt beschrieben sind. Siehe Monitoring
OTEL_LOG_TOOL_DETAILS Setzen Sie den Wert auf 1, um Folgendes in OpenTelemetry-Metriken, -Traces und -Logs aufzunehmen: Tool-Eingabeargumente, Namen von MCP-Servern, von Benutzern erstellte Workflow-Namen, unverarbeitete Fehlerzeichenfolgen bei Tool-Fehlern, die Ablehnungs-category bei api_refusal-Events, echte Namen von Agenten, Skills, Plugins und MCP-Servern in Kosten- und Token-Metriken 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 Aus-Werten, die in diesem Abschnitt beschrieben sind. 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 Aus-Werten, die in diesem Abschnitt beschrieben sind. 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 -Events mit vcs.*-Attributen zu versehen, die das Repository der Sitzung identifizieren (Standard: ausgeschlossen). Erfordert Claude Code v2.1.269 oder höher. Siehe Repository-Attribute
OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES Ab v2.1.161 hängt Claude Code die Schlüssel aus OTEL_RESOURCE_ATTRIBUTES an die Labels 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 ohne Wirkung, zusammen mit dem Tool TaskOutput, dessen Größe sie festlegte. Legte zuvor die maximale Anzahl an Zeichen der Ausgabe einer Hintergrundaufgabe fest, die das Tool TaskOutput behielt. Claude liest die Ausgabedatei einer Hintergrundaufgabe stattdessen mit Read
USE_BUILTIN_RIPGREP Setzen Sie den Wert auf 0, um das systemweit installierte rg anstelle des mit Claude Code mitgelieferten rg zu verwenden
VERTEX_REGION_CLAUDE_3_5_HAIKU Überschreibt die Region für Claude 3.5 Haiku bei Verwendung von Google Cloud's Agent Platform
VERTEX_REGION_CLAUDE_3_5_SONNET Überschreibt die Region für Claude 3.5 Sonnet bei Verwendung von Google Cloud's Agent Platform
VERTEX_REGION_CLAUDE_3_7_SONNET Überschreibt die Region für Claude 3.7 Sonnet bei Verwendung von Google Cloud's Agent Platform
VERTEX_REGION_CLAUDE_4_0_OPUS Überschreibt die Region für Claude 4.0 Opus bei Verwendung von Google Cloud's Agent Platform
VERTEX_REGION_CLAUDE_4_0_SONNET Überschreibt die Region für Claude 4.0 Sonnet bei Verwendung von Google Cloud's Agent Platform
VERTEX_REGION_CLAUDE_4_1_OPUS Überschreibt die Region für Claude 4.1 Opus bei Verwendung von Google Cloud's Agent Platform
VERTEX_REGION_CLAUDE_4_5_OPUS Überschreibt die Region für Claude Opus 4.5 bei Verwendung von Google Cloud's Agent Platform
VERTEX_REGION_CLAUDE_4_5_SONNET Überschreibt die Region für Claude Sonnet 4.5 bei Verwendung von Google Cloud's Agent Platform
VERTEX_REGION_CLAUDE_4_6_OPUS Überschreibt die Region für Claude Opus 4.6 bei Verwendung von Google Cloud's Agent Platform
VERTEX_REGION_CLAUDE_4_6_SONNET Überschreibt die Region für Claude Sonnet 4.6 bei Verwendung von Google Cloud's Agent Platform
VERTEX_REGION_CLAUDE_4_7_OPUS Überschreibt die Region für Claude Opus 4.7 bei Verwendung von Google Cloud's Agent Platform
VERTEX_REGION_CLAUDE_4_8_OPUS Überschreibt die Region für Claude Opus 4.8 bei Verwendung von Google Cloud's Agent Platform
VERTEX_REGION_CLAUDE_5_5_OPUS Überschreibt die Region für Claude Opus 5.5 bei Verwendung von Google Cloud's Agent Platform. Hinzugefügt in v2.1.280
VERTEX_REGION_CLAUDE_5_5_SONNET Überschreibt die Region für Claude Sonnet 5.5 bei Verwendung von Google Cloud's Agent Platform. Hinzugefügt in v2.1.284
VERTEX_REGION_CLAUDE_5_OPUS Überschreibt die Region für Claude Opus 5 bei Verwendung von Google Cloud's Agent Platform. Hinzugefügt in v2.1.219
VERTEX_REGION_CLAUDE_5_SONNET Überschreibt die Region für Claude Sonnet 5 bei Verwendung von Google Cloud's Agent Platform. Hinzugefügt in v2.1.197
VERTEX_REGION_CLAUDE_FABLE_5 Überschreibt die Region für Claude Fable 5 bei Verwendung von Google Cloud's Agent Platform. Hinzugefügt in v2.1.170
VERTEX_REGION_CLAUDE_FABLE_5_1 Überschreibt die Region für Claude Fable 5.1 bei Verwendung von Google Cloud's Agent Platform. Hinzugefügt in v2.1.257
VERTEX_REGION_CLAUDE_HAIKU_4_5 Überschreibt die Region für Claude Haiku 4.5 bei Verwendung von Google Cloud's Agent Platform

Die Standard-Exporter-Variablen von OpenTelemetry (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 sowie signalspezifische Varianten) werden ebenfalls unterstützt. Details zur Konfiguration finden Sie unter Monitoring.

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

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