Skip to main content
Umgebungsvariablen können das Verhalten von Claude Code steuern, z. B. Modellauswahl, Authentifizierung, Request-Routing und Feature-Toggles. Viele der gleichen Verhaltensweisen können auch über ein Einstellungsfeld konfiguriert werden, ein CLI-Flag oder einen In-Session-Befehl wie /model. Diese Seite behandelt folgende Themen:

Umgebungsvariablen setzen

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

In Ihrer Shell

Setzen Sie die Variable vor dem Starten von claude:
Um sie für jede Sitzung zu setzen, fügen Sie die export-Zeile zu ~/.bashrc, ~/.zshrc oder Ihrer Shell-Profildatei hinzu.

In Einstellungsdateien

Fügen Sie Variablen unter dem Schlüssel env in einer settings.json-Datei hinzu. Claude Code liest sie direkt beim Start aus der Datei, sodass sie wirksam werden, unabhängig davon, wie claude gestartet wurde.
~/.claude/settings.json
Die Datei, die Sie wählen, bestimmt, für wen die Variablen gelten: Siehe Einstellungsdateien für den Speicherort jeder Datei und Einstellungs-Vorrang für die Kombination, wenn mehr als eine die gleiche Variable setzt.

Vorrang

Wenn das gleiche Verhalten sowohl eine Umgebungsvariable als auch ein Einstellungsfeld hat, hat die Umgebungsvariable Vorrang. Zum Beispiel überschreibt ANTHROPIC_MODEL die Einstellung model, und CLAUDE_CODE_AUTO_CONNECT_IDE überschreibt autoConnectIde. Das Einstellungsfeld gilt, wenn die Umgebungsvariable nicht gesetzt ist. Wenn die gleiche Variable sowohl in Ihrer Shell als auch in einer Einstellungsdatei im env-Block gesetzt ist, gilt der Wert der Einstellungsdatei. Claude Code schreibt jeden env-Eintrag beim Start in die Prozessumgebung und ersetzt dabei den Wert, der von der Shell geerbt wurde. Einige Variablen werden speziell behandelt; die env-Einstellung listet die Ausnahmen auf. Zwischen Einstellungsdateien folgen env-Werte dem Einstellungsvorrang, sodass ein verwalteter Einstellungseintrag die gleiche Variable in Benutzer- oder Projekteinstellungen überschreibt. Wie eine Umgebungsvariable mit CLI-Flags und In-Session-Befehlen interagiert, variiert je nach Feature: --model und /model überschreiben ANTHROPIC_MODEL, während CLAUDE_CODE_EFFORT_LEVEL /effort überschreibt. Wenn eine Variable mit einer anderen Konfigurationsquelle interagiert, gibt ihre Zeile in der Variablen-Liste den Vorrang an oder verlinkt auf die Seite, die ihn dokumentiert. Claude Code liest Umgebungsvariablen beim Start, sodass Änderungen beim nächsten Start von claude wirksam werden.

Variablen