Vollständiger Leitfaden zu Claude Code Umgebungsvariablen: AWS Bedrock Kompatibilitätsfehler mit nur einer Einstellung beheben

Anmerkung des Autors: Detaillierte Erklärung der Funktion und Konfiguration aller über 60 Umgebungsvariablen von Claude Code, mit besonderem Fokus auf CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS, um Fehlermeldungen bezüglich des „anthropic-beta“-Headers auf Drittanbieter-Plattformen zu beheben.

Wenn Sie Claude Code mit AWS Bedrock, Google Vertex AI oder anderen Drittanbieter-LLM-Gateways verbinden, sind Sie wahrscheinlich schon auf diesen Fehler gestoßen: "Unexpected value(s) for the anthropic-beta header". Die Ursache dieses Problems liegt darin, dass Claude Code standardmäßig experimentelle Beta-Header sendet, die spezifisch für die Anthropic-API sind und von Drittanbieter-Plattformen wie AWS Bedrock nicht erkannt werden.

Die Lösung erfordert nur eine einzige Einstellung: CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1.

Doch die Umgebungsvariablen von Claude Code gehen weit darüber hinaus – die offizielle Dokumentation listet über 60 Umgebungsvariablen auf, die Authentifizierungskonfigurationen, Modellauswahl, Leistungsoptimierung, Funktionsschalter und vieles mehr abdecken. In diesem Artikel werden wir diese Umgebungsvariablen systematisch ordnen, damit Sie Konfigurationsprobleme in Claude Code schnell lokalisieren und lösen können.

Kernwert: Nach der Lektüre dieses Artikels werden Sie das vollständige System der Umgebungsvariablen von Claude Code beherrschen, Kompatibilitätsprobleme mit AWS Bedrock/Vertex AI schnell lösen können und lernen, wie Sie das Nutzungserlebnis und die Kosten von Claude Code durch Umgebungsvariablen optimieren.

Kernpunkte der Claude Code Umgebungsvariablen

Die über 60 Umgebungsvariablen von Claude Code lassen sich in 6 Hauptkategorien unterteilen. Hier sind die wichtigsten Variablen, auf die Sie achten sollten:

Zwei Möglichkeiten zum Setzen von Claude Code Umgebungsvariablen

Methode 1: Shell-Umgebungsvariablen (temporär)

Nach dem Setzen im Terminal Claude Code starten; gilt nur für die aktuelle Sitzung:

export CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1
export ANTHROPIC_API_KEY="ihr-api-schlüssel"
claude

Methode 2: settings.json Konfiguration (permanent)

Konfigurieren Sie das Feld env in der Datei ~/.claude/settings.json, damit es bei jedem Start automatisch geladen wird:

{
  "env": {
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1",
    "ANTHROPIC_API_KEY": "ihr-api-schlüssel"
  }
}

🎯 Empfehlung: Für Einstellungen, die dauerhaft wirksam sein sollen (wie API-Schlüssel oder Fixes für die Plattform-Kompatibilität), wird die Methode über die settings.json empfohlen, um manuelle export-Befehle bei jedem Start zu vermeiden. Wenn Ihr API-Schlüssel von einer Drittanbieter-Plattform wie APIYI (apiyi.com) stammt, konfigurieren Sie ihn ebenfalls hier.

Claude Code Umgebungsvariablen im Fokus: AWS Bedrock Kompatibilitätsprobleme lösen

CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS im Detail

Dies ist der wichtigste Parameter in diesem Artikel. Wenn Sie Claude Code über Drittanbieter-Gateways wie AWS Bedrock, Google Vertex AI oder LiteLLM nutzen, fügt Claude Code den Anfragen automatisch experimentelle Beta-Identifier von Anthropic hinzu, zum Beispiel:

anthropic-beta: prompt-caching-scope-2026-01-05,advanced-tool-use-2025-11-20

Diese Beta-Identifier sind spezifische Funktionen für den direkten API-Zugriff bei Anthropic. Drittanbieter-Plattformen wie AWS Bedrock können diese nicht erkennen und geben eine Fehlermeldung zurück:

Error: Unexpected value(s) for the anthropic-beta header

Die Lösung:

# Option 1: Shell-Befehl
export CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1

# Option 2: settings.json
{
  "env": {
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
  }
}

Wenn dieser Wert auf 1 gesetzt ist, sendet Claude Code diese experimentellen Beta-Header nicht mehr, wodurch die Kompatibilität mit allen Drittanbieter-Plattformen gewährleistet wird.

Bekannte Probleme und temporäre Lösungen

Laut GitHub-Issues gibt es bei einigen Versionen von Claude Code (nach 2.1.18) Probleme, bei denen diese Umgebungsvariable nicht vollständig greift – selbst wenn CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 gesetzt ist, werden bestimmte neue Beta-Header (wie advanced-tool-use-2025-11-20) weiterhin gesendet.

Falls Sie weiterhin auf Probleme stoßen, können Sie folgende zusätzliche Maßnahmen ausprobieren:

• Claude Code Version downgraden: Gehen Sie zurück auf eine bekannt stabile Version wie 2.1.68.
• LiteLLM Gateway nutzen: LiteLLM bietet die Konfigurationsdatei anthropic_beta_headers_config.json, mit der Sie genau steuern können, welche Beta-Header weitergeleitet werden.
• Gleichzeitig DISABLE_PROMPT_CACHING setzen: Das Deaktivieren des Prompt-Cachings kann Beta-Header im Zusammenhang mit prompt-caching-scope vermeiden.

# Einstellungen für maximale Kompatibilität
export CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1
export DISABLE_PROMPT_CACHING=1

Claude Code Umgebungsvariablen: Komplette Übersicht

Kategorie 1: Authentifizierung und API-Konfiguration

Dies ist die grundlegendste und am häufigsten verwendete Kategorie. Sie steuert, wie Claude Code eine Verbindung zum API-Dienst herstellt:

🎯 Hinweis für Nutzer von Drittanbieter-Plattformen: Wenn Sie Plattformen wie APIYI (apiyi.com) nutzen, müssen Sie sowohl ANTHROPIC_API_KEY als auch ANTHROPIC_BASE_URL konfigurieren. Claude Code priorisiert den API-Schlüssel aus den Umgebungsvariablen, selbst wenn Sie mit einem Anthropic-Abonnement-Konto angemeldet sind.

Kategorie 2: Modellauswahl und -konfiguration

Steuert, welches Modell Claude Code verwendet und welche Parameter für das Verhalten des Modells gelten:

Kategorie 3: Plattformkompatibilität und Gateway-Konfiguration

Diese Variablen lösen gezielt Kompatibilitätsprobleme zwischen Claude Code und verschiedenen Cloud-Plattformen oder LLM-Gateways:

Kategorie 4: Funktionsschalter (Feature Toggles)

Deaktivieren Sie spezifische Funktionen über Variablen mit dem Präfix DISABLE_ oder CLAUDE_CODE_DISABLE_:

Kategorie 5: Kontext- und Performance-Management

Steuert, wie Claude Code das Kontextfenster und die Ressourcennutzung verwaltet:

🎯 Optimierungsvorschlag: Wenn Sie feststellen, dass Claude Code in langen Dialogen den Kontext zu häufig komprimiert, können Sie CLAUDE_AUTOCOMPACT_PCT_OVERRIDE auf einen niedrigeren Wert setzen (z. B. 50). Dadurch wird die Komprimierung früher ausgelöst, was den Informationsverlust reduzieren kann. Diese Konfigurationen werden auch beim Aufruf über APIYI (apiyi.com) unterstützt.

Claude Code Umgebungsvariablen: Schnellstart-Guide

Minimalbeispiel: Claude Code für die Verbindung mit Drittanbieter-API-Plattformen konfigurieren

# Starten Sie Claude Code, nachdem Sie die Umgebungsvariablen im Terminal gesetzt haben
export ANTHROPIC_API_KEY="sk-your-api-key"
export ANTHROPIC_BASE_URL="https://vip.apiyi.com/v1"
export CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1
claude

{
  "env": {
    "ANTHROPIC_API_KEY": "sk-your-api-key",
    "ANTHROPIC_BASE_URL": "https://vip.apiyi.com/v1",
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1",
    "CLAUDE_CODE_MAX_OUTPUT_TOKENS": "32000",
    "CLAUDE_AUTOCOMPACT_PCT_OVERRIDE": "80",
    "DISABLE_TELEMETRY": "1"
  },
  "permissions": {
    "allow": ["Read", "Glob", "Grep"],
    "deny": []
  }
}

{
  "env": {
    "CLAUDE_CODE_USE_BEDROCK": "1",
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1",
    "DISABLE_PROMPT_CACHING": "1",
    "ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION": "us-east-1"
  }
}

{
  "env": {
    "CLAUDE_CODE_USE_FOUNDRY": "1",
    "ANTHROPIC_FOUNDRY_BASE_URL": "https://my-resource.services.ai.azure.com/anthropic",
    "ANTHROPIC_FOUNDRY_API_KEY": "your-foundry-key",
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
  }
}

Empfehlung: Wenn Sie sich die komplexe Konfiguration von AWS Bedrock oder Azure ersparen möchten, können Sie die gesamte Claude-Modellserie direkt über APIYI (apiyi.com) nutzen. Sie müssen lediglich zwei Variablen (API-Schlüssel und Base URL) festlegen und müssen sich nicht um Cloud-Plattform-Authentifizierung oder Kompatibilitätsprobleme kümmern.

Häufig gestellte Fragen (FAQ)

Zusammenfassung

Die Kernpunkte der Claude Code Umgebungsvariablen:

1. Lösung für AWS Bedrock-Fehler: Setzen Sie CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1, um experimentelle Beta-Header zu deaktivieren. Diese Konfiguration behebt mit einer einzigen Zeile den Fehler „Unexpected value(s) for the anthropic-beta header“.
2. Über 60 Umgebungsvariablen in 6 Kategorien: Authentifizierungskonfiguration, Modellauswahl, Plattformkompatibilität, Funktionsschalter, Kontextmanagement und sonstige Einstellungen.
3. Zwei Konfigurationsmethoden: Shell-Export (temporär) und settings.json (permanent). Es wird empfohlen, die permanente Konfiguration in die settings.json zu schreiben.
4. Vereinfachte Lösung über Drittanbieter-Plattformen: Über eine einheitliche API-Plattform wie APIYI (apiyi.com) müssen lediglich die zwei Variablen ANTHROPIC_API_KEY und ANTHROPIC_BASE_URL gesetzt werden. Damit entfallen komplexe Cloud-Plattform-Authentifizierungen und Kompatibilitätsprobleme mit Beta-Headern.

Wir empfehlen den schnellen Einstieg in Claude Code über APIYI (apiyi.com). Die Plattform bietet Gratis-Guthaben und eine einheitliche Schnittstelle, wodurch verschiedene Kompatibilitätshürden bei der Konfiguration von AWS Bedrock oder Vertex AI vermieden werden.

📚 Referenzen

1. Claude Code Offizielle Dokumentation – Umgebungsvariablen: Vollständige Liste und Erläuterung der Umgebungsvariablen

   • Link: code.claude.com/docs/en/env-vars
   • Beschreibung: Die offizielle Referenz für alle über 60 Umgebungsvariablen.

2. Claude Code Offizielle Dokumentation – Einstellungen: Konfigurationsbereiche und settings.json-Spezifikationen

   • Link: code.claude.com/docs/en/settings
   • Beschreibung: Verständnis des vierstufigen Konfigurationssystems (Managed/User/Project/Local).

3. Claude Code Offizielle Dokumentation – Amazon Bedrock: Leitfaden zur AWS Bedrock-Integration

   • Link: code.claude.com/docs/en/amazon-bedrock
   • Beschreibung: Spezifische Konfigurationen für Bedrock und Lösungen für häufige Probleme.

4. GitHub Issue #22893 – DISABLE_EXPERIMENTAL_BETAS greift nicht vollständig: Community-Bug-Bericht

   • Link: github.com/anthropics/claude-code/issues/22893
   • Beschreibung: Informationen über bekannte Einschränkungen dieser Umgebungsvariable und temporäre Lösungen.

5. LiteLLM – Claude Code Beta-Header Management: Lösung zur Filterung von Beta-Headern auf Gateway-Ebene

   • Link: docs.litellm.ai/docs/tutorials/claude_code_beta_headers
   • Beschreibung: Fein abgestimmte Steuerung der Beta-Header bei Verwendung des LiteLLM-Gateways.

Autor: APIYI Technik-Team
Technischer Austausch: Diskutieren Sie gerne Ihre Erfahrungen mit der Claude Code-Konfiguration in den Kommentaren. Weitere Tutorials finden Sie im APIYI Dokumentationszentrum unter docs.apiyi.com.