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 in Ihrer Shell oder in einer Einstellungsdatei
• Überprüfen, welcher Wert gilt, wenn ein Verhalten auf mehr als eine Weise festgelegt werden kann
• Die Variablen nachschlagen, die Claude Code liest
• Sehen Sie, welche Funktionen nicht mehr funktionieren, wenn eine Variable das Abrufen von Funktionsflags deaktiviert

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

$env:API_TIMEOUT_MS = "1200000"
claude

set API_TIMEOUT_MS=1200000
claude

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

echo $env:API_TIMEOUT_MS

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:

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

Vorrang

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

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

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

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

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

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

Variablen

Numerische Variablen wie Timeouts, Token-Budgets und die Anzahl der Wiederholungsversuche akzeptieren neben einfachen Ziffern auch wissenschaftliche Notation und Schreibweisen mit Zifferntrennzeichen, außer wenn in der Zeile einer Variable angegeben ist, 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.

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

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

Was die Bereinigung der Subprozess-Umgebung entfernt

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

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

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

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

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

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

Funktionen, die das Abrufen von Feature-Flags erfordern

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

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

Bei ausgeschaltetem Abruf können Sie Folgendes nicht:

• /auto-mode-setup ausführen, um Einträge für autoMode.environment zu entwerfen
• Remote Control verwenden, wenn CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC oder DISABLE_GROWTHBOOK gesetzt ist. Informationen zu DISABLE_TELEMETRY und DO_NOT_TRACK finden Sie in den Anforderungen für Remote Control
• Nachrichten an Sitzungen außerhalb dieses Rechners senden, wenn Remote Control nicht verfügbar ist. Nachrichten zwischen Sitzungen auf diesem Rechner funktionieren auch bei ausgeschaltetem Abruf
• claude import oder den Befehl /import ausführen
• /skill-doctor ausführen oder dessen Bericht im Tab Stats von /plugin öffnen
• Die für Ihr claude.ai-Konto aktivierten Skills und Plugins in Ihre Terminal-Sitzungen synchronisieren
• Das Advisor-Tool verwenden
• Kommentare zu einem Artefakt lesen oder beantworten
• Claude das öffentliche Artefakt einer anderen Organisation lesen lassen
• Claude Code claude.ai-Konnektor-Server oder stdio-Server auf MCP-Protokollrevision 2026-07-28 prüfen lassen, es sei denn, Sie setzen MCP_PROTOCOL_NEGOTIATION=auto
• Das PowerShell-Tool standardmäßig für claude.ai- und Console-Konten unter Windows mit installiertem Git Bash erhalten; Claude Code leitet Shell-Befehle über Git Bash, es sei denn, Sie setzen CLAUDE_CODE_USE_POWERSHELL_TOOL=1. Unter Windows ohne Git Bash bleibt das Tool aktiviert
• Von Claude entworfenes Feedback erhalten, das Claude Code über ein abgerufenes Flag aktiviert
• Claude große Einfügungen als eingefügten statt als getippten Text behandeln lassen; der Inhalt hinter einem Platzhalter [Pasted text #N] erreicht Claude ohne Kennzeichnung
• Claude Code MCP-Tools ausschließen lassen, deren Eingabeschema die API ablehnen würde; es sendet das Schema trotzdem, und eine Anfrage, die es enthält, schlägt mit einem 400-Fehler fehl, der das Tool anhand seiner Position benennt

Erste Sitzung nach einer Installation oder einem Upgrade

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

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

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

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

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

Siehe auch

• Einstellungen: Alle settings.json-Konfiguration, einschließlich des env-Schlüssels
• CLI-Referenz: Startzeit-Flags
• Netzwerkkonfiguration: Proxy- und TLS-Setup
• Überwachung: OpenTelemetry-Konfiguration