OpenCode API-Schlüssel-Einrichtung

OpenCode API-Schlüssel-Einrichtung: Basis-URL, Provider & Modelle

OpenCode mit einer Drittanbieter-API benötigt drei Dinge: einen API-Schlüssel, eine base_url und eine Provider-Konfiguration.

Pay-as-you-go für Claude, Kimi, GLM und mehr: API-Schlüssel holen, base_url und provider in opencode.json setzen und dann mit einer Testnachricht bestätigen.

OpenCode ist installiert: konfigurieren Noch nicht installiert: mit der Installation beginnen

Beispiel opencode.jsonJSON

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "model": "aicodewith-anthropic/claude-opus-5-5",
  "provider": {
    "aicodewith-anthropic": {
      "npm": "@ai-sdk/anthropic",
      "name": "AI Code With Anthropic",
      "options": {
        "baseURL": "https://api.aicodewith.ai/v1",
        "apiKey": "your-aicodewith-api-key"
      },
      "models": {
        "claude-opus-5-5": {
          "name": "Claude Opus 5.5"
        }
      }
    }
  }
}

OpenCode not installed?

This page configures the OpenCode terminal CLI. If opencode --version already prints a version, skip ahead to the quick setup.

Open the official OpenCode download page Already installed: continue

Grundlegender Installationsbefehl

curl -fsSL https://opencode.ai/install | bash

Or install globally with npm (this exact command is commonly searched)

npm install -g opencode-ai@latest

Installation succeeds when opencode --version prints a version number.

Continue with AI Code With Read the official installation docs

Sichere Schnell-Einrichtung

Wähle ein Modell, kopiere die Konfiguration, speichere die Datei und verifiziere die Verbindung in etwa 3 Minuten.

1. Modell auswählen

Der aktuelle Katalog enthält 47 Modelle.

2. Konfiguration kopieren

Provider: aicodewith-anthropic
npm-Adapter: @ai-sdk/anthropic
Basis-URL: https://api.aicodewith.ai/v1
Modell-ID: claude-opus-5-5

{
  "$schema": "https://opencode.ai/config.json",
  "model": "aicodewith-anthropic/claude-opus-5-5",
  "provider": {
    "aicodewith-anthropic": {
      "npm": "@ai-sdk/anthropic",
      "name": "AI Code With Anthropic",
      "options": {
        "baseURL": "https://api.aicodewith.ai/v1",
        "apiKey": "your-aicodewith-api-key"
      },
      "models": {
        "claude-opus-5-5": {
          "name": "Claude Opus 5.5"
        }
      }
    }
  }
}

Nächster Schritt: Konfiguration speichern

3. opencode.json speichern und API-Schlüssel setzen

Sichere eine vorhandene opencode.json, und führe dann sowohl Modell als auch Provider aus dem generierten Inhalt zusammen. Behalte andere Provider bei und speichere den echten Schlüssel nur in einer lokalen Umgebungsvariable.

API-Schlüssel-Seite öffnen

Konfigurationsdatei speichern

1. Öffne das Terminal deines Systems
2. Führe den folgenden Befehl aus, um die Konfigurationsdatei zu öffnen (wird automatisch erstellt, falls sie fehlt):
```
notepad "$env:USERPROFILE\.config\opencode\opencode.json"
```
3. Füge die in Schritt 2 kopierte Konfiguration ein und speichere sie
Drücke Strg+S unter Windows/Linux, Cmd+S unter macOS.

API-Schlüssel setzen (ersetze your-key durch deinen echten Schlüssel)

Öffne ein neues Terminal oder lade deine Shell-Konfiguration neu und starte dann OpenCode neu.

4. Neu starten und verifizieren

Im Systemterminal ausführenopencode
In OpenCode eingeben/models bestätige, dass Provider und Modell-ID mit der Auswahl auf der Seite übereinstimmen
Im Chat sendenReply with exactly: connection successful
bestätige, dass OpenCode eine Antwort anzeigt, und gleiche deren Zeit und Modell in den AI Code With Nutzungsdaten ab

Nutzungsdaten bestätigen, dass eine Anfrage AI Code With erreicht hat. Bestimme den Erfolg anhand des Status, des Antwortinhalts und der tatsächlich in OpenCode angezeigten Antwort.

Konfiguration wurde nicht geladen: Fehlerbehebung

Wie verbindet OpenCode sich mit einer Drittanbieter-API?

OpenCode verwendet einen benutzerdefinierten Provider, um Anfragen an den von dir gewählten API-Dienst zu senden: Der Provider ist der Namespace, der OpenCode sagt, welcher Dienst aufgerufen werden soll, der API-Schlüssel übernimmt die Authentifizierung, die Base URL ist der Drittanbieter-API-Endpunkt und die Model ID wählt das tatsächliche Modell aus.

Nach dem Speichern laufen Anfragen entlang OpenCode → Provider → Base URL → Modell-API. Nach einer /models-Prüfung und einer kurzen Testnachricht kannst du die Anfrage anhand von Zeit und Modell mit deinen Nutzungsdatensätzen abgleichen.

Wenn die Einrichtung fehlschlägt, prüfe zuerst diese 4 Dinge

Jeder Punkt verlinkt auf einen eigenen Artikel zur Fehlerbehebung mit detaillierten Schritten.

401 Unauthorized
Detaillierte Fehlerbehebung anzeigen →
Meist ist der API-Schlüssel ungültig, falsch geschrieben oder wird nicht korrekt gelesen. Prüfe, dass AICODEWITH_API_KEY ohne zusätzliche Leerzeichen gesetzt ist und dass OpenCode aus demselben Terminal gestartet wird.
Modell nicht gefunden
Detaillierte Fehlerbehebung anzeigen →
Die Model ID passt nicht zur Provider-Konfiguration, oder der Kanal unterstützt das Modell nicht. Vergleiche das generierte Paar aus Model ID und Provider Zeichen für Zeichen.
Base URL / 404
Detaillierte Fehlerbehebung anzeigen →
Meist ist die Base URL falsch. Kopiere den auf dieser Seite generierten Wert und hänge weder /v1 noch /v1beta an und erfinde keinen Endpunktpfad.
Konfiguration nicht angewendet / Provider fehlt
Detaillierte Fehlerbehebung anzeigen →
Prüfe den Pfad der Konfigurationsdatei, ob das JSON gültig ist und ob OpenCode die Datei neu geladen hat. Öffne OpenCode nach dem Speichern erneut und führe dann /models aus.

Häufig gestellte Fragen

Wie sollte die Base URL lauten?

Kopiere die Base URL, die von der Schnelleinrichtung oben generiert wurde. Hänge nicht manuell /v1 oder /v1beta an.

Wo befindet sich die OpenCode-Konfigurationsdatei?

Diese Seite generiert ~/.config/opencode/opencode.json. Pfade können je nach Installationsmethode und Version variieren, vergleiche sie daher mit der aktuellen OpenCode-Dokumentation.

Wie bestätige ich, dass die Einrichtung funktioniert?

Führe /models aus, um das Modell auszuwählen, sende eine kurze Nachricht und gleiche die Anfrage dann in den Nutzungsdatensätzen von AI Code With anhand von Zeit und Modell ab.

Welche Modelle werden unterstützt?

Unter anderem Claude, GPT, Gemini, DeepSeek, GLM, Kimi und Grok. Klicke auf "Alle Modelle anzeigen", um den vollständigen Katalog zu durchsuchen.

Brauchst du vollständige Installations- oder Fehlerbehebungsdokumentation?

Sieh dir die OpenCode-Setup-Dokumentation für vollständige Installationsanleitungen, jeden Konfigurationsparameter, die vollständige Modellliste und Fehlerbehebung an.

OpenCode-Setup-Dokumentation öffnen