Dokumentation

Dokumentation

Qoder

Die eigenständige Qoder-Desktop-App akzeptiert unter Anbieter → Benutzerdefiniert eine beliebige Base URL. Tragen Sie drei Werte und eine manuell eingegebene Modell-ID ein, und Qoder kommuniziert über einen einzigen Schlüssel mit Claude und GPT – beides wird im eigenen Katalog nicht aufgeführt.

Qoder Settings → Models → + Add → Provider → Custom akzeptiert eine OpenAI-kompatible Base URL, einen API-Schlüssel und manuell eingegebene Modell-IDs — so erreicht die eigenständige Qoder-Desktop-App Claude und GPT, die beide nicht in ihrem eigenen Katalog enthalten sind.

Qoder Settings → Models → + Add → Provider → Custom
Qoder Settings -> Models -> + Add -> Provider -> Custom

Provider              OpenAI Compatible     <- under "Custom", not a preset
API type              Chat Completions API  <- asked only for OpenAI Compatible
Base URL              https://api.kunavo.com/v1
API Key               sk-kn-...
Model ID              claude-sonnet-5       <- typed by hand
  Add Model ID        claude-opus-5
  Add Model ID        claude-haiku-4-5

Next ->
Display name              Kunavo · Sonnet 5
Supported Context Windows pick from what the model supports
Default Context Window    one of the values picked above
Vision                    on for models that take image input
Thinking Mode             on for reasoning models, then pick effort levels

Validate and Add Model
Dies ist die eigenständige Qoder-App, nicht Qoder IDE. „Qoder“ bezeichnet eine Reihe separat dokumentierter Produkte. Nur für die eigenständige Desktop-App ist ein beliebiger Endpunkt dokumentiert: Auf der Seite zu benutzerdefinierten Modellen werden OpenAI Compatible und Anthropic Compatible unter Benutzerdefiniert angeboten. In den Versionshinweisen zu Version 0.1.8 vom 5. September 2026 wurde die Funktion mit „BYOK im Personal-Tarif unterstützt jetzt benutzerdefinierte Base URLs für jeden OpenAI- oder Anthropic-kompatiblen Modelldienst“ eingeführt. Auf der Seite zu benutzerdefinierten Modellen von Qoder IDE sind nur benannte Anbieter aufgeführt; die Zeichenfolge Base URL kommt dort nicht vor. Wenn das Feld nicht auf Ihrem Bildschirm zu sehen ist, verwenden Sie wahrscheinlich ein anderes Qoder-Produkt.
Die Base URL behält das Suffix /v1. Auf Qoders Seite steht, man solle „die genaue Base URL eingeben, die vom Modelldienst bereitgestellt wird“; als Beispielformat wird https://api.example.com/v1 gezeigt. Für einen OpenAI-kompatiblen Endpunkt erwartet das Feld also den Stamm /v1, nicht den bloßen Ursprung. Bei Clients im Anthropic-Stil ist es umgekehrt: Sie erwarten https://api.kunavo.com und fügen die Route selbst an.
Qoder bietet auch einen benutzerdefinierten Anbieter vom Typ Anthropic Compatible an, und Kunavo unterstützt ebenfalls /v1/messages. In der Dokumentation gibt es eine Beispiel-Base-URL, aber keine Angabe dazu, welche Route die jeweilige Protokollart anhängt. Daher ist nicht geklärt, ob dieser Typ https://api.kunavo.com oder https://api.kunavo.com/v1 erwartet. Den OpenAI-kompatiblen Pfad oben bestätigt das eigene Beispiel; wenn Sie stattdessen den Anthropic-Typ wählen, müssen Sie wahrscheinlich beide Formen ausprobieren. Qoders eigene Liste zur Fehlerbehebung beginnt mit genau diesem Hinweis: „Prüfen Sie, ob die Base URL vollständig ist und das ausgewählte kompatible Protokoll sowie der API-Typ zum Endpunkt passen.“
Kunavo hat keine Sitzung in Qoder ausgeführt. Nichts hier ist ein Laufzeittest des Clients: Die Felder wurden am unten genannten Datum von Qoders eigener Seite übernommen, die Angaben zum Endpunkt stammen aus Kunavos veröffentlichter API. Über die Schaltfläche Validieren und Modell hinzufügen wird das Wertepaar tatsächlich geprüft; die Prüfung läuft auf Ihrem Rechner, nicht bei uns.
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 Qoder-Einrichtung.

Schritt für Schritt

  1. Erstellen Sie unter /app/keys einen Schlüssel und kopieren Sie ihn — er wird nur einmal angezeigt.
  2. Öffnen Sie Qoder-Einstellungen, wählen Sie in der linken Navigation Modelle aus und klicken Sie auf + Hinzufügen.
  3. Öffnen Sie Anbieter und wählen Sie unter Benutzerdefiniert die Option OpenAI Compatible aus – keinen der darüber aufgeführten voreingestellten Anbieter. Wählen Sie anschließend für den API-Typ Chat Completions API aus.
  4. Geben Sie Base URL, API-Schlüssel und mindestens eine Modell-ID ein. Qoder dokumentiert für dieses Feld keine automatische Erkennung verfügbarer Modelle, geben Sie die IDs daher manuell ein. Klicken Sie für jedes weitere Modell am selben Endpunkt auf Modell-ID hinzufügen.
  5. Klicken Sie auf Weiter und legen Sie die Funktionen fest, die Qoder nicht selbst ermitteln kann: Anzeigename, Unterstützte Kontextfenster und einen Standardkontextumfang aus diesen Werten sowie die Schalter Vision und Thinking-Modus, sofern das Modell sie unterstützt.
  6. Klicken Sie auf Validieren und Modell hinzufügen. Auf Qoders Seite zur Modellauswahl steht, dass „das Modell nach dem Hinzufügen in den Modellauswahlen für Aufgaben, Agenten und Automatisierungen verfügbar ist“.

Abgeglichen mit die Seite für benutzerdefinierte Modelle der eigenständigen Qoder-App am 21. 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 Qoder oder Claude Code – welches Qoder, welcher Endpunkt, welche Rechnung.

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 Qoder.

# 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-IDKunavo: Ein- und AusgabeWo es in Qoder hineinpasst
claude-sonnet-5$1.40 / $7.00das standardmäßig verwendete Modell für Aufgaben- und Agentenauswahlen
claude-opus-5$3.50 / $17.50umfangreiche Refaktorierungen, bei denen ein falscher Plan mehr kostet als die Tokens
claude-haiku-4-5$0.70 / $3.50Automatisierungsläufe mit hohem Volumen, bei denen die Anzahl ausschlaggebend ist
gpt-5-6-sol$2.00 / $12.00eine zweite Meinung aus einer anderen Modellfamilie, mit demselben Schlüssel und Endpunkt
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.

Warum in Ihrem Qoder möglicherweise kein Feld für eine Base URL vorhanden ist

Drei Qoder-Oberflächen dokumentieren die Nutzung eigener Schlüssel; nur eine davon dokumentiert einen Endpunkt, den Sie selbst festlegen können. Davon hängt allein ab, ob die Einrichtung oben dort möglich ist, wo Sie gerade arbeiten. Prüfen Sie das, bevor Sie eine Konfigurationsdatei bearbeiten – auf der CLI-Seite wird ausdrücklich davon abgeraten.

OberflächeIst eine benutzerdefinierte Base URL dokumentiert?Angaben auf der jeweiligen Produktseite
Qoder (eigenständige App)JaOpenAI Compatible und Anthropic Compatible stehen in der Anbieterliste unter Benutzerdefiniert, zusammen mit Feldern für Base URL, API-Schlüssel und manuell einzugebende Modell-IDs. Diese Seite.
Qoder IDENeinAuf der Seite zu benutzerdefinierten Modellen steht „Gilt für: Nutzer mit einem Individuals-Tarif“. Als Anbieter werden Alibaba Cloud Model Studio, DeepSeek, Z.ai, Kimi, MiniMax und Xiaomi MIMO genannt. Die Zeichenfolge Base URL kommt nicht vor.
Qoder CLINicht auf der DokumentationsseiteUnter /model gibt es den Tab Benutzerdefiniert mit Add custom model..., aber auf der Seite wird keine Base URL dokumentiert. Außerdem steht dort die Warnung: „Konfigurieren Sie BYOK nicht manuell in settings.json.“

Bei Qoder CLI ist die Lage verwirrend, weil sich die eigenen Versionshinweise und die Dokumentation widersprechen. In den Versionshinweisen zu Version 1.1.50 vom 11. September 2026 steht: „Nutzer der Personal Edition können BYOK-Modelle jetzt zentral verwalten und über die Seite Benutzerdefiniert mit eigenen URL-Endpunkten konfigurieren.“ Auf der weiterhin verfügbaren Seite zu benutzerdefinierten Modellen wird dagegen ein Katalog beschrieben: „Die verfügbaren Anbieter, Modelle und Zugangsdatenfelder richten sich nach dem BYOK-Katalog, der für das aktuelle Konto verfügbar ist.“ Sowohl dort als auch auf der Seite zu Qoder IDE ist die Funktion auf einen Individuals-Tarif beschränkt. Wenn der Tab „Benutzerdefiniert“ fehlt oder kein Feld für den Endpunkt anzeigt, prüfen Sie daher, welchen Tarif das Konto hat und was der Katalog dieses Kontos anbietet. Die Seite zu Qoder CLI rät davon ab, eine Konfigurationsdatei manuell zu bearbeiten; diese wird ohnehin aus dem Katalog neu erzeugt.

Häufig gestellte Fragen

Wie füge ich Qoder einen benutzerdefinierten Anbieter hinzu?

In der eigenständigen Qoder-Desktop-App: Öffnen Sie die Qoder-Einstellungen, wählen Sie in der linken Navigation „Modelle“ aus und klicken Sie auf „+ Hinzufügen“. Öffnen Sie anschließend „Anbieter“ und wählen Sie unter „Benutzerdefiniert“ entweder „OpenAI Compatible“ oder „Anthropic Compatible“ aus. Für den OpenAI-Typ wählen Sie außerdem „Chat Completions API“ oder „Responses API“. Geben Sie Base URL, API-Schlüssel und mindestens eine Modell-ID ein. Für weitere Modelle am selben Endpunkt verwenden Sie „Modell-ID hinzufügen“. Klicken Sie auf „Weiter“, legen Sie Anzeigename, unterstützte Kontextfenster, Standardkontextumfang, Vision und Thinking-Modus fest und klicken Sie dann auf „Validieren und Modell hinzufügen“. Qoder prüft die Verbindung, bevor das Modell gespeichert wird.

Muss die Qoder-Base-URL mit /v1 enden?

Für einen OpenAI-kompatiblen Endpunkt: ja. Auf Qoders Seite zu benutzerdefinierten Modellen steht, dass die genaue, vom Modelldienst bereitgestellte Base URL einzugeben ist. Als Beispielformat wird https://api.example.com/v1 angegeben. Das Feld erwartet also den /v1-Stamm statt des bloßen Ursprungs – für Kunavo https://api.kunavo.com/v1. Für den Typ „Anthropic Compatible“ gibt es auf der Seite kein eigenes Beispiel und keine Angabe dazu, welche Route angehängt wird. Dieser Fall ist daher laut Dokumentation ungeklärt. Probieren Sie zuerst den /v1-Stamm und bei fehlgeschlagener Validierung den bloßen Ursprung aus.

Warum gibt es in meinem Qoder keinen Tab „Benutzerdefiniert“ und kein Feld für eine Base URL?

Weil für die drei Qoder-Oberflächen unterschiedliche BYOK-Regeln gelten. Nur für die eigenständige Qoder-Desktop-App ist eine beliebige Base URL dokumentiert. Auf der Seite zu benutzerdefinierten Modellen von Qoder IDE sind benannte Anbieter aufgeführt, die Base URL wird dort jedoch nie erwähnt. Laut Qoder-CLI-Seite richten sich die verfügbaren Anbieter, Modelle und Zugangsdatenfelder nach dem BYOK-Katalog des aktuellen Kontos. Sowohl für IDE als auch CLI ist die Funktion laut Dokumentation auf einen Individuals-Tarif beschränkt. Wenn das Feld fehlt, prüfen Sie, welches Qoder-Produkt geöffnet ist und was Tarif und Katalog des Kontos zulassen. Auf der CLI-Seite wird ausdrücklich davor gewarnt, BYOK manuell in settings.json zu konfigurieren.

Kann Qoder Claude-Modelle ohne ein Anthropic-Konto verwenden?

Über einen benutzerdefinierten Anbieter: ja; Qoders integrierter Katalog ist eine andere Sache. Auf der Seite zur Modellauswahl sind Qwen-, DeepSeek-, GLM-, Kimi- und MiniMax-Modelle aufgeführt, aber kein Modell von Claude, GPT oder Gemini. Die dokumentierte Möglichkeit, ein eigenes Modell einzubinden, ist daher die Nutzung eines eigenen Schlüssels. „OpenAI Compatible“ bezeichnet dabei eine Auswahl des Drahtprotokolls, nicht des Anbieters: Die eingegebene Modell-ID wird an der konfigurierten Base URL aufgelöst. Eine Claude-ID funktioniert also, sofern der Endpunkt sie bereitstellt; die verwendeten Zugangsdaten stammen von diesem Endpunkt, nicht von Anthropic.

Verbraucht ein benutzerdefiniertes Modell in Qoder weiterhin Qoder Credits?

Auf Qoders Seite zu benutzerdefinierten Modellen steht, dass Gebühren für benutzerdefinierte Modelle direkt über das API-Konto des Anbieters abgerechnet werden und keine Qoder Credits verbrauchen. Als Ausnahme wird Repo Wiki genannt: Dort wird ein festgelegtes Modell verwendet und separat abgerechnet; beim Generieren wird ein Hinweis angezeigt. Kunavo berechnet pro Token über ein Prepaid-Guthaben, ohne Monatsgebühr. Beachten Sie auch: Mit der Bearbeiten-Funktion für ein gespeichertes benutzerdefiniertes Modell kann Qoder nur den API-Schlüssel aktualisieren. Wenn Sie die Base URL ändern möchten, müssen Sie den Eintrag löschen und neu hinzufügen.

Hat Kunavo diese Einrichtung in Qoder getestet?

Nein. Kunavo hat in keiner Qoder-Oberfläche eine Sitzung ausgeführt. Diese Seite ist kein Laufzeit-Kompatibilitätsbericht: Feldnamen und Reihenfolge wurden am angegebenen Datum von Qoders eigener Seite zu benutzerdefinierten Modellen übernommen; Angaben zum Endpunkt stammen aus Kunavos veröffentlichter API. Die entscheidende Prüfung findet auf Ihrem Rechner statt: Mit Qoders Schaltfläche „Validieren und Modell hinzufügen“ werden Base URL, Schlüssel und Modell-ID gemeinsam geprüft, bevor die Werte gespeichert werden. Ein einfacher curl-Aufruf mit derselben Base URL und demselben Schlüssel zeigt, ob das Problem beim Endpunkt oder beim Client liegt.