Was ist OpenCode
OpenCode ist ein Open-Source-KI-Coding-Agent als Terminaloberfläche, Desktop-App und IDE-Erweiterung. Dieses Setup fügt Capriole AI als einen benutzerdefinierten Anbieter hinzu. Jedes Modell darin verwendet das API-Protokoll, das Capriole AI für die jeweilige Modellfamilie bereitstellt.Voraussetzungen
Bevor Sie beginnen, stellen Sie sicher, dass Sie Folgendes haben:- Ein Capriole-AI-Konto (Hier registrieren)
- Premium (USD 9 pro Monat, inklusive unbegrenztem Web-Chat) oder Team, denn API-Schlüssel gibt es nur mit einem dieser Pläne (Abonnieren)
- Einen Capriole-AI-API-Schlüssel (Schlüssel abrufen)
Installation
OpenCode 2 und OpenCode 1 verwenden beide den Befehlopencode, daher ist immer nur eine der beiden Versionen installiert. Installieren Sie OpenCode 2 mit dem offiziellen Installationsskript:
opencode upgrade --major aus. Das Skript https://opencode.ai/install und das npm-Paket opencode-ai installieren weiterhin OpenCode 1.
Prüfen Sie die Installation:
Konfiguration
Modellvalidierung
OpenCode 2.2.5 besteht mit der OpenCode-2-Konfiguration für jedes Modell im Abschnitt „Unterstützte Modelle“ eine Prüfung aus Dateilesen und abschließender Antwort über Capriole AI. OpenCode 1.19.3 besteht mit der OpenCode-1-Konfiguration eine Prüfung aus Dateilesen, Dateischreiben und abschließender Antwort.OpenCode 2
Erstellen oder aktualisieren Sie~/.config/opencode/opencode.json:
package: "@opencode/ai/providers/openai-compatible"ist das Standardpaket für den Anbieter, sodass Gemini, Grok, GLM und Kimi Chat Completions verwenden.- Jedes GPT-Modell überschreibt
packagemit@opencode/ai/providers/openai-compatible/responses, das die Responses API verwendet. Jedes Claude-Modell überschreibt es mit@opencode/ai/providers/anthropic-compatible, das Anthropic Messages verwendet. envnennt die Variable, die Ihren Schlüssel enthält. DerAuthorization-Header sendet den Schlüssel für jedes Paket als Bearer-Token.reasoningEffortgibt jedem GPT-Modell eine Standardstufe für das Reasoning. Ohne diese Einstellung antworten GPT-Modelle ohne Reasoning.baseURLenthält für jedes Paket/v1.limitteilt OpenCode das Kontextfenster und das Ausgabelimit jedes Modells mit.agents.titlelegt das Modell fest, das OpenCode für Sitzungstitel verwendet.
OpenCode 1
OpenCode 1 liest die OpenCode-2-Form nicht, OpenCode 2 liest aber diese Form, sodass eine OpenCode-1-Einrichtung nach dem Upgrade weiter funktioniert. Erstellen oder aktualisieren Sie~/.config/opencode/opencode.json:
npm: "@ai-sdk/openai-compatible"ist das Standardpaket für den Anbieter, sodass Gemini, Grok, GLM und Kimi Chat Completions verwenden.- Jedes GPT-Modell überschreibt
provider.npmmit@ai-sdk/openai, das die Responses API verwendet. Jedes Claude-Modell überschreibt es mit@ai-sdk/anthropic, das Anthropic Messages verwendet. baseURLenthält für jedes Paket/v1.{env:CAPRIOLE_AI_API_KEY}liest Ihren Schlüssel aus der Umgebung. DerAuthorization-Header sendet ihn für jedes Paket als Bearer-Token.limitteilt OpenCode das Kontextfenster und das Ausgabelimit jedes Modells mit, damit es den Kontext verfolgen und die Sitzung rechtzeitig komprimieren kann.small_modelist das Modell, das OpenCode für leichte Aufgaben wie Sitzungstitel verwendet.
OpenCode ausführen
Setzen Sie Ihren API-Schlüssel und starten Sie OpenCode aus Ihrem Projektverzeichnis:opencode service restart übernimmt er den eben gesetzten Schlüssel. In OpenCode 1 lassen Sie diesen Schritt weg.
Verwenden Sie /models, um das Modell zu wechseln. Für einen nicht interaktiven Lauf verwenden Sie opencode run:
Unterstützte Modelle
Modellreferenzen haben die Formcapriole-ai/<model-id>.
openai-latest, claude-latest und google-latest zeigen immer auf unser neuestes Flaggschiff-Modell der jeweiligen Familie, derzeit GPT-6.2 Astra, Claude Fable 5.1 und Gemini 4 Carbon.
Fehlerbehebung
Warum gibt OpenCode einen Authentifizierungsfehler zurück?
Bestätigen Sie, dassCAPRIOLE_AI_API_KEY in derselben Shell exportiert ist, bevor Sie OpenCode starten, und dass der Authorization-Header unter headers (OpenCode 2) oder options.headers (OpenCode 1) vorhanden ist. Meldet OpenCode 2 Missing Bearer token, wurde sein Hintergrunddienst ohne den Schlüssel gestartet: Führen Sie in dieser Shell opencode service restart aus.
Warum schlagen Claude-Anfragen mit Unsupported Claude Messages model fehl?
Claude-Modelle, die das Anthropic-Paket verwenden, benötigen die Claude-IDs ohne Präfix, etwa claude-opus-5-5. Die IDs mit dem Präfix anthropic/ sind für Chat Completions gedacht.
Warum schlagen GPT-Anfragen fehl?
Bestätigen Sie, dass jedes GPT-Modell"package": "@opencode/ai/providers/openai-compatible/responses" (OpenCode 2) oder "provider": { "npm": "@ai-sdk/openai" } (OpenCode 1) enthält, damit seine Anfragen die Responses API verwenden.
Warum werden keine Capriole-AI-Modelle angezeigt?
Bestätigen Sie, dass die Modellreferenzcapriole-ai/<model-id> verwendet, etwa capriole-ai/moonshot/kimi-k3, und dass disabled_providers capriole-ai nicht blockiert. OpenCode 1 ignoriert die OpenCode-2-Form mit providers.
Warum greifen Konfigurationsänderungen nicht?
Prüfen Sie, ob eine projektbezogeneopencode.json oder eine OPENCODE_CONFIG-Überschreibung vorhanden ist, und starten Sie OpenCode dann neu.
Warum treten Fehler mit Anbieterpaketen auf?
Leeren Sie~/.cache/opencode und starten Sie OpenCode neu, damit es die Anbieterpakete neu installiert.
Hinweise
- Bewahren Sie Ihren Schlüssel in der Umgebung auf. Fügen Sie ihn nicht in
opencode.jsonein. - Um ein weiteres Capriole-AI-Modell hinzuzufügen, kopieren Sie den Eintrag eines Modells derselben Familie und ändern Sie die ID.
GET https://api.caprioletech.com/v1/modelslistet alle Modell-IDs auf. - Gemini 4 Carbon denkt länger nach als Gemini 4 Argon, daher können Durchläufe länger dauern und mehr Tokens verbrauchen. Für schnellere Durchläufe nutzen Sie
google/gemini-4-argon. - Wie Sie denselben Schlüssel mit Ihren anderen Coding-Agents nutzen, zeigt Einen API-Schlüssel mit Coding-Agents nutzen.
- Referenzen für OpenCode 2: Installation, Migration von OpenCode 1, Anbieter, Modelle, Hintergrunddienst und Releases.
- Referenzen für OpenCode 1: Installation, Konfiguration, Anbieter, Modelle und Fehlerbehebung.

