Claude Code

Anthropics offizieller Terminal-Coding-Agent. Er spricht das Anthropic-Messages-Protokoll, sodass nach dem Verweis auf Synthorai mit zwei Umgebungsvariablen jedes Claude-Modell in Ihrem Workspace verfügbar ist — nichts anderes in Ihrer Konfiguration ändert sich.

✦

Dies ist der beliebteste Integrationsweg für Teams, die Claude im Terminal nutzen möchten und zentralisierte Abrechnung + Ratenlimits am Gateway.

Bevor Sie beginnen

Erstellen Sie einen API-Schlüssel unter Console → API Keys. Der vollständige Schlüssel wird angezeigt einmal — kopieren Sie ihn, bevor Sie den Dialog schließen.

Schritt 1 — Umgebungsvariablen festlegen

Claude Code liest ANTHROPIC_BASE_URL und ANTHROPIC_API_KEY aus der Umgebung. Fügen Sie sie zu Ihrem Shell-Profil hinzu (~/.zshrc, ~/.bashrc, oder ~/.config/fish/config.fish) damit jedes neue Terminal sie übernimmt.

# ~/.zshrc (or equivalent)
export ANTHROPIC_BASE_URL="https://synthorai.io"
export ANTHROPIC_API_KEY="sk-..."   # your Synthorai key

⚠

Die base URL enthält nicht /v1 — das Anthropic SDK hängt /v1/messages intern an. Wenn Sie https://synthorai.io/v1eingefügt haben, treffen die Anfragen auf /v1/v1/messages und ergeben 404.

Schritt 2 — Senden Sie Ihre erste Anfrage

# Reload env, then:
claude --model claude-sonnet-4-6 "explain this diff" < <(git diff HEAD~1)

# Or start an interactive coding session:
claude code --model claude-opus-4-6

Eine erfolgreiche Antwort gibt die Modellausgabe auf stdout aus. Wenn Sie 401 ist der Schlüssel falsch oder deaktiviert; wenn Sie 404 ist der Modellname in Ihrem Workspace nicht routbar — überprüfen Sie /console/pricing.

Empfohlene Modelle

Parameter	Typ	Beschreibung
`claude-opus-4-6`	`reasoning`	Flaggschiff-Qualität. Für tiefgreifende Refactorings und mehrdeutige Probleme.
`claude-sonnet-4-6`	`balanced`	Bestes Preis-Leistungs-Verhältnis für tägliches Codieren und lange Agent-Sitzungen.
`claude-haiku-4-5`	`fast`	Am günstigsten, am schnellsten. Gut für lockere Ad-hoc-Fragen und kurze Bearbeitungen.

Fehlerbehebung

401 Unauthorized — der Schlüssel ist falsch, deaktiviert oder bereits widerrufen. Regenerieren Sie ihn unter /console/keys.

404 / „Modell nicht gefunden" — das Modell, das Sie an --model übergeben haben, ist nicht im Channel-Katalog Ihres Workspace enthalten. Führen Sie curl $ANTHROPIC_BASE_URL/v1/models -H "x-api-key: $ANTHROPIC_API_KEY" aus, um zu sehen, was verfügbar ist.

„Erreicht weiterhin api.anthropic.com" — Ihre Shell hat die neuen Umgebungsvariablen nicht übernommen. Öffnen Sie ein neues Terminal, oder source ~/.zshrc.

Kann ich über claude-code Modelle nutzen, die nicht von Claude stammen? — Nein. Die CLI spricht nur die Anthropic Messages API und der /v1/messages von Synthorai routet nur zu Claude-Modellen. Für OpenAI- / Gemini- / Qwen-Modelle verwenden Sie Codex, Aider oder das OpenAI SDK direkt.

Die aktuellen Token-Preise für alle drei Stufen finden Sie in der Claude model price comparison.