Skip to main content
OpenCode ist ein terminalbasierter Coding-Agent, der benutzerdefinierte Modellanbieter unterstützt. Fügen Sie Tokios als Anbieter in opencode.json unter Verwendung des @ai-sdk/openai-compatible-Pakets hinzu, zeigen Sie options.baseURL auf https://api.tokios.com/v1 und listen Sie Ihren Tokios-Deployment-Namen unter models auf. OpenCode leitet dann jede Agent-Anfrage über Ihren privaten Connector-Tunnel zu Ihrem lokalen Modell weiter.

​
Voraussetzungen

​
OpenCode konfigurieren

Fügen Sie einen Tokios-Anbieterblock zu Ihrer opencode.json-Konfiguration hinzu. Der genaue Speicherort der Konfigurationsdatei (projektlokal opencode.json im Vergleich zu einem globalen Konfigurationspfad) und die genauen Schlüsselnamen (options, npm, models) können je nach OpenCode-Version variieren, daher bestätigen Sie diese anhand des Anbieter-Schemas Ihrer installierten Version.
opencode.json
Ersetzen Sie gemma-tunnel durch den öffentlichen Deployment-Namen, den Sie auf der Models-Registerkarte registriert haben — nicht durch die lokale Modell-ID, die Ihr Backend (Ollama, llama.cpp, vLLM oder LM Studio) verwendet. Ersetzen Sie sk-tok-YOUR_KEY durch Ihren eigenen Schlüssel und vermeiden Sie es, ihn in eine freigegebene oder versionierte Konfigurationsdatei zu committen.
options.baseURL muss /v1 enthalten. Der OpenAI-kompatible Provider von OpenCode sendet Anfragen relativ zu dieser URL, sodass eine Basis-URL ohne /v1 die Tokios-API-Oberfläche nicht erreicht.

​
Wählen Sie ein Tool-fähiges Modell

Der Agent von OpenCode ist auf Tool-Aufrufe angewiesen, um Dateien zu lesen, Befehle auszuführen und Code zu bearbeiten. Nicht jedes lokale Modell unterstützt Tool-Aufrufe zuverlässig — wählen Sie einen Deployment, der auf einem Modell mit starker Tool-Aufruf-Unterstützung basiert, bevor Sie sich für echte Änderungen auf den Agenten von OpenCode verlassen. Siehe Wählen Sie ein lokales Modell für den Vergleich der Kandidaten.

​
Fehlerbehebung

Der von OpenCode gesendete API-Schlüssel fehlt, ist fehlerhaft oder wurde widerrufen. Bestätigen Sie, dass options.apiKey den vollständigen sk-tok-…-Schlüssel ohne zusätzliche Leerzeichen enthält, und prüfen Sie dessen Status auf der Keys-Registerkarte.
Der Modell-Schlüssel unter models stimmt nicht mit einem registrierten Deployment überein. Bestätigen Sie, dass er exakt dem öffentlichen Namen auf der Models-Registerkarte entspricht — nicht Ihrer lokalen Modell-ID von Ollama, llama.cpp, vLLM oder LM Studio.
Der Connector für dieses Deployment ist offline oder hat sein gleichzeitiges Limit erreicht. Prüfen Sie die Connectors-Registerkarte — der Connector muss als Online angezeigt werden, und die Maschine, die ihn ausführt, muss weiterhin online und erreichbar sein.

​
Nächste Schritte

Kompatible Clients

Siehe Basis-URL und Schlüsseleinrichtung für andere OpenAI- und Anthropic-kompatible Clients.

Wählen Sie ein lokales Modell

Vergleichen Sie Backends und Modelle, bevor Sie eine Deployment für agentic Workflows festlegen.