Qoder mit QCode einrichten (BYOK)

Fügen Sie QCode zu den benutzerdefinierten Modellen von Qoder hinzu: OpenAI Compatible für GPT und chinesische Modelle, Anthropic Compatible für Claude.

Brauchen Sie einen API-Key? Registrieren →·Endpunkte & Base-URLs →

Zuletzt überprüft: 2026-11-10 · 📄 Laut offizieller Dokumentation (Qoder 0.5.7 und Qoder CLI 1.1.86, beide veröffentlicht am 2026-11-09; die Dokumentation wurde am 2026-11-10 gelesen)

Auf einen Blick¶

Qoder IDE ist ein eigenes Produkt derselben Familie; seine Seite zu benutzerdefinierten Modellen (docs.qoder.com/user-guide/chat/custom-models) führt nur vordefinierte Anbieter. Eigene Base URLs gibt es in der Qoder-Desktop-App (seit 0.1.8, 2026-09-05) und in Qoder CLI, wo Nutzer der Personal Edition sie seit 1.1.50 (2026-09-11) auf der Seite Custom in /model verwalten – um diese beiden geht es hier.

Welches Protokoll¶

Das Formular für einen eigenen Endpunkt bietet zwei Anbietertypen; bei OpenAI Compatible wählen Sie zusätzlich den API-Typ. Nehmen Sie die Zeile, die zur Modellfamilie passt:

Claude-Modelle laufen nur über das Anthropic-Protokoll, tragen Sie claude-…-IDs also unter Anthropic Compatible ein; GPT-Modelle laufen nur über die beiden OpenAI-Protokolle. Die vier chinesischen Modellfamilien funktionieren mit beiden. Die vollständige Tabelle steht unter Endpunkte & API-Pfade; Modell-IDs übernehmen Sie Zeichen für Zeichen von qcode.cc/models.

Form der Base URL. Qoder formuliert es so: „enter the exact Base URL supplied by the model service. Qoder displays https://api.example.com/v1 as an example format.“ Das Beispiel endet auf /v1, also geben Sie für beide OpenAI-Varianten die QCode-URL mit /v1 am Ende ein. Für die Responses API funktioniert das ebenfalls, weil QCode /openai/responses und /openai/v1/responses gleich bedient. Welchen Pfad Qoder bei Anthropic Compatible anhängt, sagt die Dokumentation nicht. Beginnen Sie mit der Anthropic-Adresse von QCode https://api.qcode.cc/api (ohne abschließenden Schrägstrich). Schlägt Validate and add model fehl, tragen Sie https://api.qcode.cc/api/v1 ein und validieren Sie erneut: Beide Adressen führen zum selben QCode-Endpunkt /api/v1/messages; der Unterschied liegt nur darin, wie viele Pfadsegmente Qoder selbst ergänzt.

In Asien oder Nordamerika können Sie die Domain durch asia.qcode.cc oder us.qcode.cc ersetzen; die Pfade bleiben gleich.

Installation¶

Laden Sie die Desktop-App von der Qoder-Downloadseite herunter (macOS 12+, Windows 10+ oder Linux) und melden Sie sich an. Für die CLI nennt dieselbe Seite:

# macOS / Linux
curl -fsSL https://qoder.com/install | bash

# Windows PowerShell
irm https://qoder.com/install.ps1 | iex

Qoder CN hat eine eigene App und Dokumentation auf docs.qoder.cn. Gleichen Sie Ihre Version mit den oben genannten ab.

Konfiguration¶

Desktop: Settings → Models¶

Die Schritte stammen von der offiziellen Seite zu benutzerdefinierten Modellen, mit den Oberflächenbegriffen der englischen Dokumentation:

1. Öffnen Sie Settings und wählen Sie in der linken Navigation Models.
2. Klicken Sie auf Add model. Für einen eigenen Endpunkt öffnen Sie Provider und wählen unter Custom OpenAI Compatible oder Anthropic Compatible.
3. Bei OpenAI Compatible wählen Sie Chat Completions API oder Responses API.
4. Geben Sie die Base URL, Ihren API-Schlüssel und mindestens eine Model ID ein. Für weitere Modelle am selben Endpunkt klicken Sie auf Add Model ID.
5. Stellen Sie die Fähigkeiten ein, die die Seite aufführt: Display name, Context window (unterstützte Werte wählen, dann ein Default context window), Vision (einschalten, wenn das Modell Bilder verarbeitet) und Thinking (einschalten, wenn das Modell Reasoning unterstützt, dann die Aufwandsstufen wählen).
6. Klicken Sie auf Validate and add model. „Qoder validates the connection and saves the model after validation succeeds.“
7. Wählen Sie das neue Modell in der Chat-Oberfläche aus.

Werte für QCode (Platzhalter für den Schlüssel: cr_xxx):

Legen Sie je benötigtem Protokoll einen Eintrag an; jeder Eintrag bekommt seine eigene Base URL.

Unterschiede zwischen global und CN. Die globale Seite nennt als vordefinierte Anbieter Alibaba Cloud Model Studio, DeepSeek, Z.ai, Kimi, MiniMax, Xiaomi MIMO, OpenAI, Google und OpenRouter. Die CN-Seite nennt Alibaba Cloud Model Studio, DeepSeek, Zhipu, Kimi, MiniMax und Xiaomi MIMO, ohne OpenAI, Google und OpenRouter. Beide führen dieselben zwei benutzerdefinierten Anbieter – OpenAI Compatible und Anthropic Compatible – und dieselben Schritte.

Um den Schlüssel später zu ändern, nutzen Sie die Aktion Edit im Panel Models; Delete entfernt das Modell.

CLI: /model → Custom¶

1. Starten Sie Qoder CLI und geben Sie /model ein.
2. Wechseln Sie zum Tab Custom.
3. Wählen Sie Add custom model... und drücken Sie Enter.
4. Folgen Sie dem Assistenten: „Provider → model type → model“, dann geben Sie den API-Schlüssel und weitere abgefragte Angaben ein.
5. Nach erfolgreicher Validierung wird die Konfiguration automatisch gespeichert, und das Modell ist sofort auswählbar. Wählen Sie es im Tab Custom; mit d auf einem Modell löschen Sie es dort.

Die offizielle Seite sagt außerdem: „Do not configure BYOK manually in settings.json; the available providers, models, and credential fields are determined by the BYOK catalog available to the current account.“ Die Felder des Assistenten listet die CLI-Seite nicht auf. Laut Release Note zu CLI 1.1.50 können Nutzer der Personal Edition BYOK-Modelle „with custom URL endpoints from the Custom page in /model“ einrichten, und der offizielle Qoder-Account auf X beschreibt es als Eingabe von Base URL, Model ID und API-Schlüssel. Tragen Sie in diese Felder die QCode-Werte aus der Tabelle oben ein.

Verbindung prüfen¶

1. Wählen Sie das hinzugefügte Modell und senden Sie eine kurze Nachricht wie ping.
2. Öffnen Sie probe.qcode.cc, geben Sie Ihren QCode-Schlüssel ein und prüfen Sie, ob die Anfrage mit diesem Modell erscheint.
3. Schlüssel und Pfad ohne Qoder testen:

KEY="cr_your_key"

# OpenAI Compatible, Chat Completions API
curl -sS https://api.qcode.cc/openai/v1/chat/completions \
  -H "Authorization: Bearer $KEY" \
  -H "content-type: application/json" \
  -d '{"model":"gpt-6.1-sol","max_tokens":32,
       "messages":[{"role":"user","content":"ping"}]}'

# Anthropic Compatible
curl -sS https://api.qcode.cc/api/v1/messages \
  -H "x-api-key: $KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5-5","max_tokens":32,
       "messages":[{"role":"user","content":"ping"}]}'

Fehlerbehebung¶

Die offizielle FAQ für ein Modell, das sich nicht hinzufügen lässt, nennt fünf Prüfpunkte. So übertragen Sie sie auf QCode:

Zwei Meldungen kommen von QCode: model_not_available_on_endpoint heißt, dass eine claude-…-ID unter einer OpenAI-Variante eingetragen wurde – tragen Sie sie unter Anthropic Compatible ein; das ist ein falsch gewähltes Protokoll, kein Schlüsselproblem. Invalid API key ist ein Schlüsselproblem.

Zur CLI sagt die offizielle Seite: Fehlen der Tab Custom oder der Eintrag zum Hinzufügen, prüfen Sie, ob BYOK für den aktuellen Account und Tarif verfügbar ist; fehlt ein Anbieter oder Modell, gilt der aktuelle Katalog, den der Assistent anzeigt.

Bekannte Einschränkungen¶

• Offiziell: „Image and video generation are currently unavailable when using models connected with your own API key (BYOK).“
• Offiziell: Kosten für benutzerdefinierte Modelle laufen über das API-Konto beim Anbieter und „do not use Qoder Credits“. Repo Wiki nutzt ein festes Modell und verbraucht weiterhin Qoder Credits.
• Das Beispiel https://api.example.com/v1 zeigt Qoder nur als Format; welchen Pfad Qoder je Protokoll anhängt, beschreibt die Dokumentation nicht. Maßgeblich ist daher das Ergebnis von Validate and add model.
• QoderWork ist ein eigenes Produkt. Seine Modellseite nennt die Stufen Premium, Advanced und Standard sowie Qwen3.7-Max und Qwen3.7-Plus und hat Stand 2026-11-10 keinen Eintrag für benutzerdefinierte Modelle. Laut Qoder-Downloadseite stellt QoderWork den Betrieb am 5. September 2027 ein; empfohlen wird der Wechsel zu Qoder Desktop, das Werkzeuge für den Datenimport mitbringt.
• Laut offizieller Mitteilung wurde die Modellstufe Lite am 18. September 2026 um 14:00 Uhr Singapurer Zeit (UTC+8) aus der Modellauswahl entfernt.

Weiterführende Dokumentation¶

• Endpunkte & API-Pfade – Tabelle „Protokoll × Modellfamilie“
• Übersicht der Tool-Kompatibilität – welches Tool welches Protokoll spricht
• DeepSeek Harness – ein weiteres Tool mit Formular für benutzerdefinierte Modelle
• LobsterAI – ein Desktop-Agent, dessen benutzerdefinierte Anbieter ebenfalls Anthropic- und OpenAI-Formate annehmen
• Chinesische Modelle – IDs und Pfade von GLM / Kimi / DeepSeek / Qwen
• Qoder-Leitfaden zu Custom Models und BYOK auf qcode.cc – Daten und Hintergrund

Enterprise →