Zum Hauptinhalt springen
Mit einem einzigen Capriole-AI-API-Schlüssel nutzen Sie GPT-6.2 Astra, Claude Fable 5.1, Opus 5.5 und Gemini 4 Carbon in OpenCode, bis zu 92% unter den offiziellen API-Preisen.

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 Befehl opencode, daher ist immer nur eine der beiden Versionen installiert. Installieren Sie OpenCode 2 mit dem offiziellen Installationsskript:
Oder installieren Sie es mit npm:
Um von OpenCode 1 zu wechseln, führen Sie 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:
Was die einzelnen Einstellungen bewirken:
  • 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 package mit @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.
  • env nennt die Variable, die Ihren Schlüssel enthält. Der Authorization-Header sendet den Schlüssel für jedes Paket als Bearer-Token.
  • reasoningEffort gibt jedem GPT-Modell eine Standardstufe für das Reasoning. Ohne diese Einstellung antworten GPT-Modelle ohne Reasoning.
  • baseURL enthält für jedes Paket /v1. limit teilt OpenCode das Kontextfenster und das Ausgabelimit jedes Modells mit.
  • agents.title legt 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:
Was die einzelnen Einstellungen bewirken:
  • 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.npm mit @ai-sdk/openai, das die Responses API verwendet. Jedes Claude-Modell überschreibt es mit @ai-sdk/anthropic, das Anthropic Messages verwendet.
  • baseURL enthält für jedes Paket /v1.
  • {env:CAPRIOLE_AI_API_KEY} liest Ihren Schlüssel aus der Umgebung. Der Authorization-Header sendet ihn für jedes Paket als Bearer-Token.
  • limit teilt OpenCode das Kontextfenster und das Ausgabelimit jedes Modells mit, damit es den Kontext verfolgen und die Sitzung rechtzeitig komprimieren kann.
  • small_model ist 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 2 sendet Modellanfragen aus einem Hintergrunddienst, der den Schlüssel beim Start liest. Mit 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 Form capriole-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, dass CAPRIOLE_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 Modellreferenz capriole-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 projektbezogene opencode.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

Zuletzt geändert am 18. November 2026