Coding Agents einrichten

Claude Code installieren: API Key, Base URL und Modelle

Verbinde Claude Code über BetterToken API Key, Base URL und Model ID. Wähle das Modell vor dem Start oder wechsle im Gespräch mit /model.

Verbinden Sie Claude Code mit Ihrem BetterToken API Key, der Base URL https://bettertoken.ai und der gewünschten Model ID. Kopieren Sie die genaue Model ID aus der model plaza.

Wichtige Einstellungen

Feld	Wert
API Key	BetterToken API Key
Base URL	`https://bettertoken.ai`
Model	`YOUR_MODEL_ID`

Voraussetzungen

Installiere Claude Code
Installiere Node.js, wenn du das automatische BetterToken-Konfigurationsskript verwendest. Für die npm-Installation ist Node.js 22 oder höher erforderlich.
Erstelle und kopiere einen BetterToken API Key

Registrieren und BetterToken API Key erhalten

Du hast bereits ein Konto? Melde dich an, lade Guthaben auf und erstelle dann einen Schlüssel in der Konsole.

Installation

Anthropic empfiehlt den nativen Installer, für den Node.js nicht erforderlich ist. Wenn du npm bevorzugst, installiere zuerst Node.js 22 oder höher und führe dann Folgendes aus:

npm install -g @anthropic-ai/claude-code

Konfiguration über die Befehlszeile

Das automatische BetterToken-Konfigurationsskript schreibt die Anbieter-Konfiguration für Claude Code. Es benötigt Node.js und fragt nach dem API Key, wenn er nicht als Argument übergeben wurde.

macOS / Linux

curl -fsSL "https://bettertoken.ai/install-claudecode-provider.sh" | bash

Windows

iwr "https://bettertoken.ai/install-claudecode-provider.ps1" -OutFile "$env:TEMP\install-claudecode-provider.ps1"; powershell -ExecutionPolicy Bypass -File "$env:TEMP\install-claudecode-provider.ps1"

Prüfe nach Abschluss ~/.claude/settings.json (unter Windows %USERPROFILE%\.claude\settings.json) und starte Claude Code vollständig neu. Verwende die manuelle Konfiguration unten, wenn du jedes Feld selbst festlegen möchtest.

Manuelle Konfiguration

System	Datei
macOS / Linux	`~/.claude/settings.json`
Windows	`%USERPROFILE%\.claude\settings.json`

Kopieren Sie die genaue Model ID aus der model plaza.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://bettertoken.ai",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "API_TIMEOUT_MS": "3000000",
    "ANTHROPIC_MODEL": "YOUR_MODEL_ID",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "YOUR_MODEL_ID",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "YOUR_MODEL_ID",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "YOUR_MODEL_ID"
  }
}

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.

Die Beispiele enthalten die optionale Einstellung CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1. Sie deaktiviert automatische Updates, Fehlerberichte sowie einige Verfügbarkeitsprüfungen und Kontofunktionen. Für die Authentifizierung ist sie nicht erforderlich. Für manuelle Updates führe claude update aus oder verwende den Paketmanager, falls dieser die Installation verwaltet. Siehe die Anleitung für manuelle Updates und die Auswirkungen der Einstellung.

VS Code-Erweiterung

Die Erweiterung verwendet die VS Code-Datei settings.json. Füge eine separate Konfiguration für claudeCode.environmentVariables hinzu:

{
  "claudeCode.environmentVariables": [
    {
      "name": "ANTHROPIC_BASE_URL",
      "value": "https://bettertoken.ai"
    },
    {
      "name": "ANTHROPIC_AUTH_TOKEN",
      "value": "YOUR_API_KEY"
    },
    {
      "name": "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC",
      "value": "1"
    },
    {
      "name": "API_TIMEOUT_MS",
      "value": "3000000"
    },
    {
      "name": "ANTHROPIC_MODEL",
      "value": "YOUR_MODEL_ID"
    },
    {
      "name": "ANTHROPIC_DEFAULT_HAIKU_MODEL",
      "value": "YOUR_MODEL_ID"
    },
    {
      "name": "ANTHROPIC_DEFAULT_SONNET_MODEL",
      "value": "YOUR_MODEL_ID"
    },
    {
      "name": "ANTHROPIC_DEFAULT_OPUS_MODEL",
      "value": "YOUR_MODEL_ID"
    }
  ]
}

Verbindung prüfen

Starte Claude Code in deinem Projekt:

claude

Sende eine kurze Nachricht. Eine normale Antwort ohne 401, Verbindungs- oder Modellfehler bestätigt die Konfiguration. Führe in der interaktiven Sitzung /status aus und prüfe zwei Zeilen:

Anthropic base URL sollte die BetterToken Base URL https://bettertoken.ai anzeigen. Fehlt die Zeile, wurde die Variable nicht an die aktuelle Sitzung übergeben. Prüfe den Pfad zu settings.json und starte Claude Code vollständig neu.
Die Authentifizierungszeile sollte ANTHROPIC_AUTH_TOKEN statt einer Anmeldung mit einem claude.ai-Konto anzeigen.

Um die Verbindung aus einem Skript zu prüfen, sende eine kurze Testanweisung:

claude -p "Reply with only: OK"

Eine normale Antwort mit OK bestätigt, dass die Verbindung funktioniert.

Konflikte mit einer bestehenden Anmeldung

Zugangsdaten in Umgebungsvariablen haben Vorrang vor einer gespeicherten claude.ai-Anmeldung. Wenn beim Start eine Warnung zu zwei Quellen für Zugangsdaten erscheint, entferne eine davon. Um nur deinen BetterToken API Key zu behalten, führe /logout aus. Falls deine Shell auch ANTHROPIC_API_KEY setzt, entferne diese Variable zuerst.

Modelle wechseln

Ändern Sie die Model ID in der Konfiguration und starten Sie Claude Code neu. Innerhalb einer Sitzung wechseln Sie mit /model YOUR_MODEL_ID.

Für weitere Aliase, etwa fable mit ANTHROPIC_DEFAULT_FABLE_MODEL, folge der offiziellen Zuordnung der Aliase und verwende eine verfügbare Model ID. Wenn Claude Code für eine eigene ID ein falsches Kontextfenster annimmt, folge der Anleitung zum Kontextfenster für Gateway- oder eigene Modell-IDs und verwende den bestätigten Grenzwert des Modells.

BetterToken-Modelle in /model anzeigen (optional)

Verwende eine aktuelle Version von Claude Code. Ergänze "CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY": "1" im bestehenden env-Block in ~/.claude/settings.json und starte Claude Code vollständig neu. Beim Start fragt Claude Code die verfügbaren Modelle über /v1/models unter https://bettertoken.ai ab. Siehe die offizielle Anleitung zur Gateway-Einrichtung.

Um die Modellerkennung zu prüfen, starte claude --debug und suche in ~/.claude/debug/<session-id>.txt nach Zeilen mit [gatewayDiscovery]. Eine Meldung über zwischengespeicherte Modelle bestätigt die erfolgreiche Erkennung.

Claude Code zeigt nur Gateway-Modelle an, deren Model ID claude oder anthropic enthält (unabhängig von Groß- und Kleinschreibung), wie im Gateway-Protokoll beschrieben. Andere von /v1/models zurückgegebene Modelle, einschließlich GPT-Modellen, erscheinen nicht in /model, auch wenn BetterToken sie anbietet. Claude Code kann solche Modelle weiterhin aufrufen, wenn du ihre Model ID direkt festlegst; im Test mit Claude Code 2.1.309 beantwortete ein so angegebenes GPT-Modell Textanfragen und Anfragen zum Lesen von Dateien über Anthropic Messages.

Häufige Fehler

Fehler	Lösung
`401` oder Authentifizierungsfehler	Prüfe `ANTHROPIC_AUTH_TOKEN` und entferne Leerzeichen um den API Key.
`ConnectionRefused`	Verwende exakt `https://bettertoken.ai` und hänge kein `/v1` an.
Model ID	Prüfe die genaue Model ID in der model plaza und trage sie in den Modelleinstellungen des Clients ein.
Konfiguration nicht angewendet	Prüfe den Dateipfad, entferne widersprüchliche Umgebungsvariablen und starte Claude Code vollständig neu.
Warnung zu zwei widersprüchlichen Quellen für Zugangsdaten beim Start	Entferne eine der Quellen oder führe `/logout` aus.
Zertifikats- / TLS-Fehler, häufig bei einem Unternehmensproxy	Setze `NODE_EXTRA_CA_CERTS` auf den Pfad zur CA-Zertifikatsdatei und starte Claude Code neu.
`400` mit einem Hinweis auf ein unbekanntes Feld, etwa `Extra inputs are not permitted`	Ergänze `"CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"` in `env` und starte Claude Code vollständig neu. Bleibt der Fehler bestehen, kontaktiere den Support.
Kontext in einer langen Sitzung zu lang	Führe `/compact` aus, um die Sitzung zu komprimieren.

Mit einem API Key nicht verfügbare Funktionen

Fernsteuerung (Remote Control) und Spracheingabe erfordern die Anmeldung mit einem claude.ai-Konto. Mit einem BetterToken API Key und einer eigenen Base URL sind sie nicht verfügbar. Dies ist eine Einschränkung des Claude Code-Clients und beeinträchtigt normale Programmiergespräche nicht.

Erweiterte Konfiguration

Zum Verwalten mehrerer Tool-Konfigurationen verwenden Sie CC Switch.

Technische Details

Protokoll und Endpunkt

Claude Code verwendet Anthropic Messages. Setze ANTHROPIC_BASE_URL auf https://bettertoken.ai. Der Client hängt /v1/messages an. Füge daher kein /v1 zur Base URL hinzu.