ANTHROPIC_BASE_URL und API-Key in Claude Code einrichten

Diese beiden Werte benötigen Sie

Claude Code verwendet das Anthropic-Protokoll. Deshalb unterscheidet sich seine Adresse von der für Codex und andere OpenAI-compatible Clients, die in der Regel `https://www.bettertoken.ai/v1%60?utm_source=blog&utm_medium=organic_content&utm_campaign=SEO-015&utm_content=anthropic-base-url-api-key-nastroyka benötigen.

Schritt 1. Konfligierende Umgebungsvariablen entfernen

Prüfen Sie vor der Einrichtung, ob noch alte Werte gesetzt sind:

printenv ANTHROPIC_BASE_URL
test -n "$ANTHROPIC_AUTH_TOKEN" && echo "ANTHROPIC_AUTH_TOKEN is set"

Geben Sie den Token selbst nicht aus. Sind die Variablen in der aktuellen Shell gesetzt und soll stattdessen die Konfigurationsdatei Vorrang haben, entfernen Sie sie:

unset ANTHROPIC_BASE_URL
unset ANTHROPIC_AUTH_TOKEN

Prüfen Sie anschließend ~/.zshrc, ~/.bashrc, .env, die IDE-Einstellungen und den Provider-Manager. Eine Umgebungsvariable, die ein bereits laufender Prozess geerbt hat, kann auch nach einer Dateiänderung weiter wirksam sein.

Schritt 2. Benutzerkonfiguration hinzufügen

Laut der offiziellen Einstellungsreferenz für Claude Code liegen Benutzereinstellungen in ~/.claude/settings.json, Projekteinstellungen in .claude/settings.json und lokale Projekteinstellungen in .claude/settings.local.json.

Fügen Sie für BetterToken Folgendes hinzu:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://bettertoken.ai/?utm_source=blog&utm_medium=organic_content&utm_campaign=SEO-015&utm_content=anthropic-base-url-api-key-nastroyka",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "API_TIMEOUT_MS": "3000000"
  }
}

Ersetzen Sie ausschließlich YOUR_API_KEY. Enthält die Datei bereits permissions, hooks, plugins oder andere Felder, überschreiben Sie sie nicht vollständig. Ergänzen oder verbinden Sie stattdessen das Objekt env, sodass gültiges JSON erhalten bleibt.

Beschränken Sie den Zugriff auf die Datei und prüfen Sie anschließend, ob die Berechtigungen übernommen wurden:

chmod 600 ~/.claude/settings.json
ls -l ~/.claude/settings.json

In der Ausgabe dürfen für die Gruppe und andere Benutzer weder Lese- noch Schreibrechte gesetzt sein. Hängen Sie die Datei nicht vollständig an ein Issue an. Veröffentlichen Sie bei einer Teamkonfiguration keinen gemeinsam genutzten Arbeitstoken. Jede Person sollte ihren eigenen Schlüssel verwenden.

Schritt 3. Claude Code vollständig neu starten

Beenden Sie den aktuellen Prozess vollständig und starten Sie claude erneut. Eine neue Terminal-Registerkarte reicht nicht aus, solange der bereits laufende Claude-Code-Prozess nicht neu gestartet wurde: Der Prozess behält die beim Start übernommene Umgebung.

Wenn Sie die VS-Code-Erweiterung verwenden, hat sie einen eigenen Konfigurationspunkt: claudeCode.environmentVariables in der VS-Code-Datei settings.json. Gehen Sie nicht davon aus, dass die Terminal-Shell und die Extension immer dieselben Umgebungsvariablen lesen.

Schritt 4. Verbindung mit einer kleinen Aufgabe testen

Starten Sie Claude Code in einem Testordner und senden Sie diese sichere Anfrage:

Antworte in genau einer Zeile: CLAUDE_PROVIDER_OK. Ändere keine Dateien und führe keine Befehle aus.

Notieren Sie vor der Anfrage die aktuelle Uhrzeit. Die Konfiguration funktioniert, wenn:

• die Antwort ohne 401, 403, ConnectionRefused oder model not found eintrifft;
• im BetterToken Workspace ein neuer Eintrag mit einem Zeitpunkt nach dem Start des Tests erscheint;
• dieser Eintrag das erwartete Modell, den Status und den Verbrauch zeigt;
• Claude Code nach dem Neustart nicht zum alten Provider zurückkehrt.

Eine erfolgreiche Antwort allein belegt noch nicht den tatsächlichen Anfrageweg: Bei einem Konflikt könnte Claude Code einen anderen Provider verwendet haben. Maßgeblich ist der neue Eintrag für die Testanfrage im Workspace. Öffnen Sie das Arbeits-Repository erst, nachdem Sie bestätigt haben, dass im Workspace ein neuer Eintrag mit einem Zeitpunkt nach dem Start des Tests vorhanden ist.

So finden Sie einen Konfigurationskonflikt

Verlassen Sie sich nicht auf eine allgemeingültige Prioritätsreihenfolge. Die wirksame Konfiguration hängt von der Startmethode, verwalteten Richtlinien und der bereits vom Prozess geerbten Umgebung ab. Ermitteln Sie zuerst alle Quellen, in denen die benötigten Konfigurationsnamen gesetzt sind:

printenv ANTHROPIC_BASE_URL
test -n "$ANTHROPIC_AUTH_TOKEN" && echo "ANTHROPIC_AUTH_TOKEN is set"
grep -lE '"ANTHROPIC_(BASE_URL|AUTH_TOKEN)"' \
  ~/.claude/settings.json \
  .claude/settings.json \
  .claude/settings.local.json 2>/dev/null

Der Befehl zeigt ausschließlich Dateinamen, nicht den Wert des Tokens. Prüfen Sie außerdem die verwalteten Einstellungen der Organisation, die VS-Code-Erweiterung und einen externen Provider-Manager, falls diese am Start beteiligt sind. Ändern Sie anschließend jeweils nur eine Quelle, starten Sie den Client vollständig neu und wiederholen Sie die kleine Anfrage, wobei Sie den neuen Eintrag im Workspace prüfen.

Häufige Fehler

ConnectionRefused oder Verbindung zum falschen Endpoint

Prüfen Sie die Adresse Zeichen für Zeichen: https://bettertoken.ai – ohne /v1, ohne /messages und ohne Leerzeichen am Ende. Den erforderlichen Pfad ergänzt der Client selbst.

401 oder authentication failure

Erstellen Sie bei Verdacht auf ein Leck einen neuen Schlüssel, kopieren Sie ihn ohne Leerzeichen und stellen Sie sicher, dass ANTHROPIC_AUTH_TOKEN verwendet wird – nicht die Variable eines anderen Clients. Senden Sie den Token nicht im Klartext an den Support.

Änderungen wurden nicht übernommen

Beenden Sie alle Claude-Code-Prozesse, prüfen Sie mit printenv auf alte Werte und starten Sie den Client erneut. Führen Sie in VS Code Reload Window aus oder starten Sie die Extension neu.

model not found

Übernehmen Sie keine beliebige Model ID aus einem veralteten Artikel. Beziehen Sie für Schlüssel und Modelle, die eine explizite Zuordnung erfordern, die aktuelle Model ID ausschließlich aus Setup oder der aktuellen Claude-Code-Anleitung.

Kurze Checkliste

• Die Base URL für Claude Code enthält kein /v1.
• Der echte Schlüssel befindet sich weder in Git noch in einem Screenshot.
• Alle Quellen alter Einstellungen wurden gefunden und einzeln überprüft.
• Der Client wurde vollständig neu gestartet.
• Die kleine schreibgeschützte Anfrage ist im Workspace sichtbar.

Sind alle fünf Punkte erfüllt, können Sie mit der eigentlichen Aufgabe fortfahren. Andernfalls öffnen Sie die Schritt-für-Schritt-Anleitung für Claude Code, wählen Ihren Client aus und gleichen die Felder einzeln ab, statt die gesamte Konfiguration auf einmal zu ersetzen.