Erweiterte Konfiguration

Bewährte Vorgehensweisen

Nutze BetterToken zuverlässig: Schütze deinen API Key, wähle passende Modelle, kontrolliere Kosten, behandle Fehler und konfiguriere externe Tools sicher.

API Key sicher aufbewahren

Verwende Umgebungsvariablen — niemals fest eincodieren. Wenn du deinen API Key direkt in Quellcode oder Konfigurationsdateien schreibst, kann er versehentlich in der Versionsverwaltung offengelegt werden. Empfohlener Ansatz:

# Add to ~/.zshrc or ~/.bashrc so it loads automatically each session
export BETTERTOKEN_API_KEY="your-api-key-here"

Verwalte Secrets für Claude Code über das Feld env in settings.json, statt sie in deiner Shell-Konfiguration offenzulegen:

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "your-api-key-here"
  }
}

Wechsle deinen API Key regelmäßig. Wenn du eine Offenlegung vermutest, lösche den Key sofort im Dashboard und erstelle einen neuen.

Großzügigen Timeout festlegen

Antworten von KI-Modellen können Zeit benötigen, besonders bei komplexen Denkaufgaben. Setze den Timeout hoch genug, um vorzeitige Verbindungsabbrüche zu vermeiden:

{
  "env": {
    "API_TIMEOUT_MS": "3000000"
  }
}

3000000 ms = 50 Minuten. Das eignet sich für tiefes Reasoning oder lange agentische Aufgaben.

Konfligierende Umgebungsvariablen löschen

Wenn du zuvor die offiziellen Anthropic- oder OpenAI-APIs — oder einen anderen Relay-Dienst — verwendet hast, können veraltete Umgebungsvariablen deine BetterToken-Konfiguration überschreiben und Requests unbemerkt an den falschen Endpunkt senden.

Prüfe und lösche diese Werte, bevor du BetterToken konfigurierst:

# Check if they exist
echo $ANTHROPIC_AUTH_TOKEN
echo $ANTHROPIC_BASE_URL
echo $OPENAI_API_KEY
echo $OPENAI_BASE_URL

# Clear them
unset ANTHROPIC_AUTH_TOKEN
unset ANTHROPIC_BASE_URL
unset OPENAI_API_KEY
unset OPENAI_BASE_URL

Claude Code: Zuerst den Provider prüfen

Ersetzen Sie YOUR_MODEL_ID durch die kopierte ID. ANTHROPIC_MODEL legt das Hauptmodell fest, die drei Variablen ANTHROPIC_DEFAULT_*_MODEL die Aliase Haiku, Sonnet und Opus. Sie können dasselbe Modell oder unterschiedliche Modelle pro Rolle verwenden.

Mische die beiden Konfigurationen nicht, sonst können Requests an das falsche Modell weitergeleitet werden.

Deaktiviere nicht essenziellen Traffic. CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 reduziert Hintergrund-Requests von Claude Code und reserviert dein API-Kontingent für tatsächliche Coding-Aufgaben.

Füge Claude Code nicht /v1 hinzu. ANTHROPIC_BASE_URL muss https://bettertoken.ai sein.

Einen API Key in mehreren Tools verwenden

Der gleiche API Key funktioniert in Claude Code, Codex und external tools. Das Kontingent wird geteilt, was die zentrale Verwaltung vereinfacht.

Der Endpunkt muss jedoch zum Protokoll passen:

Claude Code / ANTHROPIC_BASE_URL: https://bettertoken.ai
Codex / OPENAI_BASE_URL / external tools: https://bettertoken.ai/v1

Wenn du die Nutzung pro Projekt oder Team getrennt verfolgen möchtest, erstelle mehrere API Keys im Dashboard und weise jedem Tool oder Projekt einen zu.

Kopieren Sie die genaue Model ID aus der model plaza.

Checkliste zur Fehlerbehebung

Bestätige, dass der API Key korrekt ist — prüfe das Dashboard und füge ihn sorgfältig ohne zusätzliche Leerzeichen ein
Bestätige den Endpunkt für das Protokoll — Claude Code verwendet https://bettertoken.ai; Codex / external tools verwenden https://bettertoken.ai/v1
Prüfe auf konfliktierende Umgebungsvariablen — führe echo $ANTHROPIC_AUTH_TOKEN, echo $OPENAI_BASE_URL und verwandte Befehle aus
Prüfe die offiziellen Einrichtungsanforderungen des Tools — überprüfe bei external tools zuerst Base URL, API Key, Model ID und Tool-Version; füge zusätzliche Header nur hinzu, wenn die offizielle Tool-Dokumentation oder dein Upstream-Gateway sie ausdrücklich verlangt
Prüfe dein Guthaben — Requests werden abgelehnt, wenn das Guthaben aufgebraucht ist
Kontaktiere den Support — falls die obigen Schritte das Problem nicht lösen