Coding Agents einrichten

OpenCode: eigene Modelle, API Key und Base URL

Verbinde OpenCode über /connect, opencode.json, API Key, Base URL und Modell-ID mit den OpenAI-kompatiblen Chat Completions von BetterToken im Projekt.

OpenCode verbindet sich über @ai-sdk/openai-compatible mit BetterToken. Nenne den OpenCode-Anbieter BetterToken oder OpenAI Compatible. Nutze diese Seite für die allgemeine Einrichtung von API Key, Base URL oder opencode.json. Verwende die GLM-Anleitung oder die Kimi-K3-Anleitung, wenn du eines dieser Modelle auswählen und prüfen möchtest. Kopieren Sie die genaue Model ID aus der model plaza.

Wichtige Einstellungen

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

Voraussetzungen

Installiere OpenCode 1 mit den unten aufgeführten Befehlen.
Erstelle einen BetterToken API Key
Kopiere eine Modell-ID aus dem model plaza oder dem Dialog Setup des 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

Diese Befehle installieren OpenCode 1. Für OpenCode 2 nutze die Installationsanleitung. OpenCode 2 liest vorhandene Konfigurationen an denselben Speicherorten und überträgt unterstützte V1-Provider-Einstellungen. Lies vor Änderungen an der Konfigurationssyntax die Migrationsanleitung.

curl

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

npm

npm install -g opencode-ai

Konfiguration über die Befehlszeile

Das automatische BetterToken-Konfigurationsskript erstellt oder aktualisiert den BetterToken-Anbieter in OpenCode. Es benötigt Node.js. Wenn du API Key oder Modell-ID nicht als Argument übergibst, fragt das Skript danach.

macOS / Linux

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

Windows

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

Wähle nach Abschluss des Skripts bettertoken/YOUR_MODEL_ID. Wenn OpenCode bereits läuft, starte es vor dem Test neu.

Manuelle Konfiguration

Option 1: Anmeldedaten mit /connect speichern

Starte OpenCode und führe Folgendes aus:

/connect

Wähle Other, gib bettertoken als Anbieter-ID ein und trage danach YOUR_API_KEY ein. OpenCode speichert die Anmeldedaten lokal.

Option 2: JSON konfigurieren

Die globale Datei ist ~/.config/opencode/opencode.json. Ein Projekt kann opencode.json im Stammverzeichnis verwenden.

{
  "$schema": "https://opencode.ai/config.json",
  "model": "bettertoken/YOUR_MODEL_ID",
  "provider": {
    "bettertoken": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "BetterToken",
      "options": {
        "baseURL": "https://bettertoken.ai/v1"
      },
      "models": {
        "YOUR_MODEL_ID": {
          "name": "YOUR_MODEL_ID"
        }
      }
    }
  }
}

Wenn du /connect nicht verwendest, füge "apiKey": "YOUR_API_KEY" unter options hinzu. Committe niemals eine Konfiguration, die einen echten Key enthält.

Dieses Beispiel verwendet @ai-sdk/openai-compatible für Chat Completions. Das SDK-Paket muss zum Protokoll des Endpunkts passen. Lies die offiziellen Hinweise zu Providern, bevor du ein anderes Protokoll verwendest. In macOS-Tests mit einem GPT-Modell führten OpenCode 1.19.4 und 2.1.4 mit beiden SDKs erfolgreich Tool-Aufrufe zum Lesen von Dateien aus: @ai-sdk/openai-compatible verwendete /v1/chat/completions, @ai-sdk/openai verwendete /v1/responses. Alle vier Fälle bestanden den Test mit erlaubtem read und gesperrtem edit und bash.

Verbindung prüfen

Führe opencode in einem Projekt aus, wähle bettertoken/YOUR_MODEL_ID und sende eine kurze Nachricht. Eine normale Antwort bestätigt die Konfiguration. Starte OpenCode nach einer JSON-Änderung neu.

Nicht-interaktiver Texttest mit OpenCode 1:

opencode run --format json -m bettertoken/YOUR_MODEL_ID "Reply with only: OK"

OpenCode 2 benötigt --standalone für diesen nicht-interaktiven Lauf:

opencode run --standalone --format json -m bettertoken/YOUR_MODEL_ID "Reply with only: OK"

Modelle wechseln

Füge eine neue YOUR_MODEL_ID unter provider.bettertoken.models hinzu, aktualisiere model auf der obersten Ebene, speichere und starte OpenCode neu.

Häufige Fehler

Fehler	Lösung
`401`	Führe `/connect` erneut aus oder prüfe `apiKey`.
`404`	Verwende nur `https://bettertoken.ai/v1` als `baseURL` und hänge kein `/chat/completions` an.
Modell nicht gefunden	Stelle sicher, dass `model` auf der obersten Ebene exakt einer ID unter `models` entspricht.
Konfiguration nicht angewendet	Prüfe, ob die Projektdatei `opencode.json` die globale Datei überschreibt, und starte OpenCode neu.

Erweiterte Konfiguration

Optional: Anbieter mit CC Switch verwalten

Wenn du Anbieter für mehrere Tools an einem Ort verwalten möchtest, siehe OpenCode in CC Switch einrichten.

Technische Details

Anbieter und Modellanbieter

Der OpenCode-Anbieter ist bettertoken und verwendet @ai-sdk/openai-compatible sowie Chat Completions. Trage die ausgewählte vollständige Modell-ID unter models ein. Kopieren Sie die genaue Model ID aus der model plaza.