OpenCode

OpenCode ist ein Open-Source-Coding-Agent für das Terminal. Ein einziger Befehl meldet ihn bei Synthorai an: OpenCode erhält einen eigenen API-Schlüssel und einen Provider Synthorai, der die Modelle auflistet, die dieser Schlüssel aufrufen darf. Sie müssen weder einen Schlüssel kopieren noch eine Konfigurationsdatei bearbeiten.

Schritt 1 - Anmelden

opencode auth login https://synthorai.io

OpenCode liest https://synthorai.io/.well-known/opencode und führt den dort genannten Anmeldebefehl aus. Dieser gibt einen Link und einen Code aus 8 Buchstaben aus, etwa BCDF-GHJK, und öffnet Ihren Browser.

Melden Sie sich in der Konsole an, prüfen Sie, ob der Code auf der Seite mit dem im Terminal übereinstimmt, wählen Sie, wie lange der Schlüssel gilt (7, 30 oder 90 Tage, Standard sind 90), und klicken Sie auf Erlauben. Das Terminal meldet Signed in, und OpenCode speichert den neuen Schlüssel.

ℹ

Der Anmeldebefehl braucht sh und curl und läuft daher unter macOS, Linux, WSL und Git Bash. Unter nativem Windows richten Sie den Provider von Hand ein, mit einem API-Schlüssel.

Über SSH öffnet der Befehl keinen Browser: Öffnen Sie den Link auf einem anderen Gerät und melden Sie sich dort an. Mit SYNTHORAI_NO_BROWSER=1 erhalten Sie dasselbe Verhalten auch auf Ihrem eigenen Rechner.

Schritt 2 - Modell auswählen

opencode
# then, inside OpenCode:
/models

Starten Sie OpenCode und geben Sie /models ein. Der Provider Synthorai listet die Modelle, die Ihr Schlüssel aufrufen darf, mit Kontextlimit und Preis. OpenCode aktualisiert die Liste bei jedem Start.

Jedes Modell wird automatisch über das passende Protokoll angesprochen, ohne dass Sie etwas einstellen: Claude-Modelle über die Anthropic Messages API (Prompt Caching bleibt erhalten), OpenAI-Modelle über die Responses API und alle anderen über Chat Completions.

Der Schlüssel von OpenCode

Der Schlüssel erscheint in der Konsole auf der Seite API-Schlüssel als OpenCode · …, gefolgt vom Ort, an dem Sie sich angemeldet haben, und trägt die Kennzeichnung Agent-Anmeldung. Dort können Sie ihn jederzeit löschen.

Ist der Schlüssel abgelaufen, schlagen Aufrufe mit einer Meldung fehl, die Sie auffordert, opencode auth login https://synthorai.io erneut auszuführen.

Sicherheit

Bestätigen Sie nur einen Code, den Sie selbst angefordert haben. Kommt die Anmeldeanfrage aus einem anderen Netzwerk als Ihr Browser, weist die Bestätigungsseite darauf hin.
Ist im Workspace Neue IPs erst nach Freigabe zulassen aktiviert (Einstellungen › Sicherheit), wird die Adresse, von der Sie sich angemeldet haben, automatisch als vertrauenswürdige Adresse des neuen Schlüssels eingetragen, wenn Sie die Anmeldung aus demselben Netzwerk erlauben; Aufrufe von anderen Adressen warten auf Freigabe. Erlauben Sie sie aus einem anderen Netzwerk, wird die Adresse nicht eingetragen: Geben Sie sie frei, sobald ihr erster Aufruf zurückgehalten wird. Ist die Option aus, sollten Sie überlegen, sie einzuschalten.

Lokale Konfiguration hat Vorrang

Definiert Ihre lokale opencode.json einen Provider namens synthorai, verwendet OpenCode diesen statt des Providers vom Gateway, denn lokale Konfiguration geht vor entfernter.

Manuelle Einrichtung (Windows ohne sh)

Erstellen Sie in der Konsole auf der Seite API-Schlüssel einen Schlüssel, legen Sie ihn in der Umgebungsvariable SYNTHORAI_API_KEY ab und fügen Sie diesen Provider in opencode.json ein:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "synthorai": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Synthorai",
      "options": {
        "baseURL": "https://synthorai.io/v1",
        "apiKey": "{env:SYNTHORAI_API_KEY}"
      },
      "models": {
        "claude-sonnet-5-5": { "name": "Claude Sonnet 5.5" }
      }
    }
  }
}

Tragen Sie unter models jedes Modell ein, das Sie in OpenCode auswählen möchten. Die IDs finden Sie auf der Modellseite.

Fehlerbehebung

Failed to load auth provider metadata Prüfen Sie die Adresse: https://synthorai.io, ohne Pfad dahinter.

Sign-in did not complete: the login was declined in the console Die Anfrage wurde auf der Bestätigungsseite abgelehnt. Führen Sie den Befehl erneut aus, um von vorn zu beginnen.

Der Code ist abgelaufen Ein Code gilt 10 Minuten. Führen Sie opencode auth login https://synthorai.io erneut aus, um einen neuen zu erhalten.

Limits, Ablauf und das Löschen von Schlüsseln beschreibt die Seite API-Keys.