Dokumentation

Roo Code

Der OpenAI Compatible-Anbieter von Roo Code umfasst drei Felder sowie einen Block für Modellfähigkeiten. Dieser Block ist keine optionale Ergänzung – Roo Code richtet seine Kontextbudgetierung danach aus.

OpenAI Compatible auswählen, Basis-URL und Schlüssel einfügen und Kontextfenster sowie maximale Ausgabe des Modells festlegen, damit Roo Codes eigene Budgetierung stimmt.

Roo-Code-Einstellungsbereich

API Provider   OpenAI Compatible
Base URL       https://api.kunavo.com/v1
API Key        sk-kn-...
Model          claude-sonnet-5

Model Configuration
  Context Window     200000
  Max Output Tokens  64000
  Image Support      on

Roo Code verwendet ausschließlich native Tool-Aufrufe und bietet keinen Fallback. Daher muss das ausgewählte Modell OpenAI-kompatible Tool-Aufrufe unterstützen. Alle IDs in der folgenden Tabelle erfüllen diese Voraussetzung. Ein reines Text- oder Medienmodell, das hier konfiguriert wird, schlägt beim ersten Tool fehl, das der Agent zu verwenden versucht – nicht bereits bei der Einrichtung.

Füllen Sie Context Window und Max Output Tokens aus, statt die Standardwerte zu übernehmen. Roo Code entscheidet anhand dieser Zahlen, wann die Unterhaltung verdichtet wird. Ein zu niedrig eingestelltes Kontextfenster führt daher dazu, dass der Verlauf unnötig gekürzt wird; ein zu hoch eingestelltes Fenster verursacht stattdessen 400-Fehler vom Upstream, statt den Verlauf sauber zu verdichten.

Noch kein Schlüssel? Erstelle ein Kunavo-Konto, erstelle einen Schlüssel (er beginnt mit sk-kn-) und füge ab $10 Guthaben hinzu – Aufrufe werden aus diesem Guthaben bezahlt, fehlgeschlagene Aufrufe werden nicht berechnet. Das Dashboard öffnet anschließend die Roo Code-Einrichtung.

Schritt für Schritt

Erstellen Sie unter /app/keys einen Schlüssel und kopieren Sie ihn — er wird nur einmal angezeigt.
Öffnen Sie den Einstellungsbereich von Roo Code und setzen Sie API Provider auf OpenAI Compatible.
Geben Sie die Basis-URL https://api.kunavo.com/v1 und Ihren Schlüssel ein. Das Suffix /v1 gehört in die Basis-URL – Roo Code hängt nur den Pfad an.
Wählen Sie die Modell-ID aus oder geben Sie sie ein. Öffnen Sie dann Model Configuration und legen Sie das Kontextfenster, die maximalen Ausgabe-Tokens, die Bildunterstützung sowie die Ein- und Ausgabepreise aus der folgenden Tabelle fest.
Senden Sie eine Nachricht im Code-Modus. Die hier eingegebenen Preise verwendet Roo Code für die eigene Kostenanzeige pro Aufgabe; es lohnt sich daher, sie korrekt anzugeben.

Abgeglichen mit Die Seite zum OpenAI Compatible-Anbieter von Roo Code am 6. September 2026. Einstellungen von Drittanbietern können sich ändern; wenn ein Feldname hier nicht mehr mit deiner Ansicht übereinstimmt, ist diese Seite maßgeblich, nicht diese hier.

Dies ist die Kurzfassung. Die vollständige Anleitung – Modellauswahl, Kosten einer tatsächlichen Sitzung und Fehlerszenarien – findest du in die Roo-Code-Anleitung zu Claude.

Vor dem Debugging des Clients prüfen

Eine Anfrage klärt, ob der Fehler am Endpunkt, am Schlüssel oder an der Konfigurationsdatei liegt. Wenn diese Anfrage JSON zurückgibt, funktionieren dieselbe Basis-URL und derselbe Schlüssel in Roo Code.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

Welche Modell-ID in das Feld gehört

Jedes Textmodell ist über eine Modell-ID erreichbar – die aktuelle Liste findest du unter GET /v1/models, den Katalog mit Preisen auf der Modellseite. Die Tarife sind USD pro 1 Mio. Token, Eingabe / Ausgabe.

Modell-ID	Kunavo: Ein- und Ausgabe	Wo es in Roo Code hineinpasst
`claude-sonnet-5`	$1.40 / $7.00	Code-Modus – der Standardmodus, auf den die Kostenanzeige abgestimmt ist
`claude-opus-5`	$3.50 / $17.50	Architect-Modus, bei dem ein falscher Plan mehr als nur Tokens kostet
`claude-haiku-4-5`	$0.70 / $3.50	Ask-Modus und wiederholtes Lesen von Dateien
`gpt-5-6-terra`	$0.70 / $4.20	Durchläufe mit langem Kontext in einem großen Repository

Die Abrechnung erfolgt pro Token aus einem vorausbezahlten Guthaben ohne Monatsgebühr – siehe Abrechnung. Bei wiederholtem Kontext – dem Großteil dessen, was ein Editor oder Chat-Client sendet – verändert Prompt-Caching die Rechnung stärker als die Modellwahl.

Häufig gestellte Fragen

Wie richte ich Roo Code auf einen benutzerdefinierten OpenAI-kompatiblen Endpunkt aus?

Setzen Sie im Einstellungsbereich von Roo Code den API Provider auf "OpenAI Compatible". Tragen Sie anschließend die Basis-URL und den API-Schlüssel des Endpunkts ein und wählen Sie ein Modell. Die Basis-URL ist die /v1-Wurzel des Dienstes, da Roo Code daran nur den Pfad anhängt. In der eigenen Dokumentation von Roo Code wird das Feld Basis-URL als entscheidend bezeichnet: Es legt fest, wohin jede Anfrage gesendet wird.

Welche Modelle funktionieren in Roo Code über einen benutzerdefinierten Endpunkt?

Jedes Modell, das der Endpunkt bereitstellt und das native OpenAI-kompatible Tool-Aufrufe unterstützt. Roo Code verwendet ausschließlich native Tool-Aufrufe und bietet keinen Fallback-Modus. Ein Modell ohne Tool-Unterstützung wird also zwar verbunden, schlägt aber fehl, sobald der Agent versucht, eine Datei zu lesen oder zu schreiben. Claude- und GPT-Textmodelle sind alle geeignet; Bild-, Video- und Audiomodelle nicht.

Welche Werte sollte ich bei Roo Code unter Context Window und Max Output Tokens eintragen?

Die tatsächlichen Grenzwerte des ausgewählten Modells, nicht die Standardwerte. Roo Code verwendet diese beiden Zahlen, um zu entscheiden, wann die Unterhaltung verdichtet wird. Ein Wert unterhalb des tatsächlichen Kontextlimits des Modells führt dazu, dass unnötig Verlauf verworfen wird; ein Wert darüber verursacht 400-Fehler vom Upstream, statt den Verlauf sauber zu verdichten. Die Angaben für die einzelnen Modelle finden Sie im Modellkatalog des Endpunkts.

Warum zeigt Roo Code für eine Aufgabe falsche Kosten an?

Weil Input Price und Output Price in Model Configuration manuell eingetragen werden und standardmäßig auf null oder die Tarife eines anderen Anbieters gesetzt sind. Roo Code berechnet die Kostenanzeige pro Aufgabe ausschließlich anhand dieser beiden Felder. Es liest die Preise nicht vom Endpunkt ab. Die Anzeige ist also nur so genau wie die eingegebenen Werte. Übernehmen Sie die Tarife aus dem eigenen Katalog des Anbieters.