Verbinde deinen eigenen Modell-Key

Dein Companion braucht ein Gehirn — ein großes Sprachmodell, das seinen Kontext, seine Erinnerungen und seine Tools in eine Antwort umsetzt. Standardmäßig stellt weside dafür eines zur Verfügung. Du kannst deinen Companion aber auch auf ein Modell hinweisen, das du selbst kontrollierst, indem du deinen eigenen Provider-Key verbindest. So zahlst du direkt an den Provider und bestimmst genau, welches Modell antwortet.

Was es ist

In deinen Account-Einstellungen unter Data Residency legst du fest, wo dein Companion denkt. Heute gibt es drei Modi:

Region — ein von weside gehostetes Modell in einer bestimmten Region (EU oder USA), abhängig von deinem Plan.
WESIDE preset — ein kuratiertes Platform-Modell.
BYOK (bring your own key) — du fügst einen Provider-Key ein, und dein Companion spricht bei jedem Turn mit diesem Provider.

BYOK ist die Developer-Variante. Der Key wird verschlüsselt gespeichert, ist auf deinen Account begrenzt und wird dir nach dem Speichern nie unverschlüsselt zurückgegeben.

Warum es für dich wichtig ist

Wenn du bereits für Anthropic, OpenAI, Google oder ein Claude Code/Cursor-Abo zahlst, lässt dich BYOK deinen Companion damit nutzen — keine zweite Rechnung, deine Nutzungslimits, deine Modellwahl. Eine besondere Option: ein Claude Code OAuth Token, damit dein Companion über dein eigenes Max/Pro-Abo antwortet statt über weside-Credits.

Wie du es nutzt

Öffne Settings → Data Residency und wähle BYOK.
Wähle einen Provider. Die Base-URL und Auth werden pro Provider von weside gesteuert — du gibst nur den Key an und, falls angeboten, einen Modellnamen.
Füge deinen Key ein (mindestens 10 Zeichen) und speichere. weside führt einen einmaligen Test mit einem Token durch, um zu bestätigen, dass der Key funktioniert, bevor er gespeichert wird.

Für den Claude Code OAuth-Provider (Plan-abhängig für höhere Tiers) generierst du den Token in deinem Terminal:

claude setup-token
# → produces a token starting with sk-ant-oat01-

Füge diesen Token als Key ein. Du zahlst über dein Claude-Abo, nicht über weside.

Limits & Grenzfälle

Plan-abhängig. Die Region-Auswahl und der Claude Code OAuth-Provider erfordern einen qualifizierenden Plan; niedrigere Tiers sehen eine 403-Aufforderung zum Upgrade.
Noch keine rohen weside-Proxy-Keys. weside gibt derzeit keinen persönlichen wsk_-Key aus, um weside als OpenAI/Anthropic-Endpoint von deinen eigenen Tools zu nutzen — die unterstützte Richtung ist umgekehrt: verbinde hier deinen Provider-Key.
Der Key ist Write-Only. Nach dem Speichern teilt weside dir nur mit, ob ein Key gespeichert ist (has_api_key), niemals den Wert. Um zu rotieren, füge einen neuen ein.
Die Verifikation kann einen schlechten Key beim Speichern über die Inference-Probe ablehnen (der Claude Code OAuth-Provider überspringt die Live-Probe).