WorkBuddy: eigenes Modell mit QCode

So binden Sie QCode.cc als benutzerdefiniertes WorkBuddy-Modell ein: China- und internationale Zugänge, models.json-Pfade, Endpunkt-URL, Fehler 4100.

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

Zuletzt überprüft: 2026-11-10 · 📄 Gemäß offizieller Dokumentation (China-Seite workbuddy.cn: neuester Eintrag im Änderungsprotokoll 5.11.0, 2026-11-03, schrittweise Auslieferung; internationale Seite workbuddy.ai: neuester Eintrag 5.9.4)

Auf einen Blick¶

WorkBuddy (internationale Seite: workbuddy.ai) ist der Desktop-AI-Agent des CodeBuddy-Teams von Tencent Cloud für Büro-Arbeitsergebnisse (Notizen, Tabellen, Präsentationen, leichter Code). Er ist kein direkter Ersatz für Claude Code. Laut dem offiziellen llms.txt teilt er sich dieselbe Grundlage wie das Coding-Produkt CodeBuddy; zu CodeBuddy siehe benutzerdefinierte Modelle für CodeBuddy. Um WorkBuddy mit QCode.cc zu verbinden, öffnen Sie die Einstellungen → Modelle, fügen ein benutzerdefiniertes Modell mit dem Endpunkt https://api.qcode.cc/openai/v1/chat/completions, Ihrem cr_-Key und einer aktiven Modell-ID wie gpt-6.1-sol hinzu und wählen dann das Modell aus und senden ping. Benutzerdefinierte WorkBuddy-Modelle nutzen OpenAI Chat Completions; darüber stellt QCode GPT und chinesische Modelle bereit. Claude-Modelle liefert QCode über den Anthropic-Endpunkt, den Clients wie Claude Code verwenden.

Diese Seite behandelt eine Aufgabe: QCode.cc als WorkBuddy-benutzerdefiniertes Modell hinzufügen, sodass derselbe cr_-Key unsere verfügbaren GPT- / GLM- / Kimi- / DeepSeek- / Qwen-Modelle von WorkBuddy aus aufrufen kann.

GPT und chinesische Modelle über QCode. WorkBuddys benutzerdefinierte Modelle nutzen das Protokoll OpenAI Chat Completions; darüber stellt QCode GPT und die chinesischen Modellfamilien (DeepSeek / GLM / Kimi / Qwen) bereit. Claude-Modelle liefert QCode über den Anthropic-Endpunkt (https://api.qcode.cc/api), den WorkBuddys benutzerdefinierte Modelle nicht verwenden; eine claude-…-ID am OpenAI-Endpunkt liefert model_not_available_on_endpoint. Für Claude nutzen Sie ein Tool mit Unterstützung für den Anthropic-Endpunkt, etwa Claude Code, ZCode oder Qoder. Siehe Endpunkte & API-Pfade.

QCode.cc steht in keiner Verbindung zu Tencent, WorkBuddy oder CodeBuddy. Die UI-Bezeichnungen richten sich nach dem von Ihnen installierten WorkBuddy-Build; die Feldbedeutungen folgen der offiziellen Modellkonfiguration (China · International). Die internationale Seite sagt: "Custom model integration currently uses the OpenAI-compatible Chat Completions API."

Voraussetzungen¶

• Desktop-WorkBuddy installiert (China-Ausgabe workbuddy.cn, internationale Ausgabe workbuddy.ai; Installationsanleitung: offizielle Mac- / Windows-Anleitungen). Die mobile App hat keinen Eintrag für benutzerdefinierte Modelle; siehe die FAQ unten
• Ein QCode.cc API-Key (beginnt mit cr_) aus dem Dashboard
• Derselbe Key funktioniert auf allen drei Protokollen. WorkBuddy benutzerdefinierte Modelle verwenden OpenAI Chat Completions, was QCode /openai/v1/chat/completions entspricht. Protokoll- und BASE_URL-Regeln: Endpunkte & API-Formate

QCode in der UI hinzufügen (empfohlen)¶

Die offiziellen Modellseiten besagen, dass benutzerdefinierte Modelle über eine visuelle Oberfläche verwaltet werden (hinzufügen, bearbeiten, löschen), ohne eine Konfigurationsdatei manuell zu bearbeiten. Die China-Seite sagt: Falls Ihr Modelldienst nicht in der Voreinstellungsliste steht, wählen Sie Custom und geben URL, API-Key und Modellnamen von Hand ein. Der WorkBuddy-Leitfaden von Tencent Cloud TokenHub verwendet denselben Weg.

1. China-Ausgabe: WorkBuddy starten → Kontomenü (unten links) → Einstellungen → Modell. Internationale Ausgabe: Avatar > System Settings > Models
2. Unter benutzerdefinierte Modelle Modell hinzufügen
3. Anbieter: Custom
4. Die untenstehende Tabelle ausfüllen, speichern und dann das neue Modell in der Chat-Modellauswahl auswählen
5. Die internationale Ausgabe hat außerdem Test Connection („Checks whether the API can respond“); führen Sie es aus, bevor Sie sich auf die Zeile verlassen. Laut der Dokumentation bedeutet das Speichern einer Konfiguration nicht, dass die Verbindung erfolgreich ist

Sie können mehrere benutzerdefinierte Einträge mit derselben URL und demselben Key hinzufügen und nur den Modellnamen ändern — z. B. einen glm-5.3 und einen deepseek-v4-pro.

URL ausfüllen (benutzerdefiniertes Protokoll)¶

Offizielles Verhalten des Schalters für das benutzerdefinierte Protokoll (in den erweiterten Einstellungen):

Die internationale Seite ergänzt drei Punkte: Bei ausgeschaltetem Schalter wird die Adresse so normalisiert, dass der Pfad auf /chat/completions endet, andere vom Anbieter benötigte Pfadsegmente werden nicht automatisch angehängt; bei ausgeschaltetem Schalter können Sie die Basis-URL mit /v1 oder die vollständige URL eingeben („you can enter the base URL containing /v1 or the full URL when the toggle is disabled“); und in den meisten Fällen müssen Sie den Schalter nicht einschalten. Er ändert nur die Verarbeitung der Adressen und ist kein allgemeiner API-Protokoll-Konverter.

Für QCode tragen Sie den vollständigen Pfad https://api.qcode.cc/openai/v1/chat/completions ein. Er stimmt in beiden Schalterstellungen: ausgeschaltet endet der Pfad bereits auf /chat/completions, eingeschaltet wird er unverändert gesendet. Es ist derselbe Wert, den eine handgeschriebene models.json als url braucht (siehe unten), und auch der TokenHub-Leitfaden von Tencent Cloud für WorkBuddy trägt eine vollständige URL mit /v1/chat/completions ein. Für die Desktop-App von WorkBuddy zählt am Ende das Ergebnis des Verbindungstests.

• Bei ausgeschaltetem Schalter funktioniert auch https://api.qcode.cc/openai/v1 (derselbe Wert wie OPENAI_BASE_URL in Umgebungsvariablen); WorkBuddy hängt /chat/completions an
• Behalten Sie /v1: WorkBuddy hängt nur /chat/completions an, keine weiteren Pfadsegmente, und der Chat-Pfad von QCode lautet /openai/v1/chat/completions
• QCode nutzt den Standardpfad, das benutzerdefinierte Protokoll kann also aus bleiben; ist es eingeschaltet, funktioniert nur der vollständige Pfad
• Kein abschließendes /. Zusätzliche Schrägstriche ergeben //chat/completions

Die drei Zugriff-Domains sind funktional identisch; nur das Routing unterscheidet sich. Derselbe Key funktioniert auf allen:

Wo die Konfiguration liegt¶

China- und internationale Ausgabe verwenden unterschiedliche Pfade; lesen Sie sie getrennt (zitiert aus den beiden offiziellen Seiten):

Die internationale Seite ergänzt, dass Sie bei geändertem Konfigurationsverzeichnis den auf der Modelleinstellungsseite angezeigten Pfad verwenden sollten und dass eine Konfigurationsdatei mit API-Keys nicht in ein öffentliches Repository hochgeladen werden darf. Die China-Seite nennt nur workbuddy/models.json, ohne den Ordner anzugeben; maßgeblich ist die tatsächliche Datei auf Ihrem Rechner, oder Sie verwalten die Einträge einfach in der UI.

Außerdem:

• Laut offiziellem Hinweis zum Guthabenverbrauch werden alle Kosten eines benutzerdefinierten Modells an den Drittanbieter gezahlt (hier QCode.cc, Abrechnung pro Token)
• Laut dem offiziellen Änderungsprotokoll wurde das Hot-Reload von models.json mit 5.1.1 eingeführt: Änderungen wirken ohne Neustart

Für die tägliche Arbeit nutzen Sie die UI. Wenn Sie models.json von Hand bearbeiten müssen, stehen die Feldtabelle und die Regel für url in benutzerdefinierte Modelle für CodeBuddy. Die offizielle CodeBuddy-Dokumentation sagt: "url field must be the complete interface path, typically ending with /chat/completions" (https://api.openai.com/v1 gilt dort als falsches Beispiel); für QCode lautet url daher https://api.qcode.cc/openai/v1/chat/completions. Mit CodeBuddy Code CLI, das auf derselben Grundlage aufbaut, ist dieser vollständige Pfad als url in models.json getestet und verbindet (CodeBuddy Code 2.182.0, 2026-11-10). WorkBuddy hat für diese Datei keine eigene Feldtabelle; fügen Sie daher zuerst einen Eintrag in der UI hinzu und prüfen Sie die lokale Datei. Kopieren Sie kein Schema aus einem Drittanbieter-Blog.

Zuerst hinzuzufügende Modelle¶

Alle nachstehenden IDs wurden am 2026-11-10 gegen die aktive Liste auf qcode.cc/models abgeglichen. Preise werden auf dieser Seite nicht gespiegelt — betrachten Sie qcode.cc/models als maßgeblich (Administratoren können die Servicegebühr ändern).

Die schlankeren Schwestermodelle glm-5.3-flash, deepseek-v4-flash, deepseek-v4.1-flash, qwen3.8-flash und qwen3.7-plus sind alle verfügbar; die Vorgängergeneration glm-5.1 und kimi-k2.6 wurden eingestellt — Eingaben schlagen fehl. Siehe Modellauswahl. Setzen Sie keinen Namen, der nicht auf qcode.cc/models aufgeführt ist, in Modellname.

Dieser Pfad nutzt OpenAI Chat Completions. Setzen Sie ANTHROPIC_BASE_URL (https://api.qcode.cc/api) nicht in das Endpunktfeld — dieses Präfix ist für Claude Code / das Anthropic SDK.

Überprüfung¶

Prüfen Sie zunächst, ob der OpenAI-Pfad von QCode in Ihrem Netzwerk erreichbar ist (gleicher Test wie unter Endpunkte & API-Formate §4):

KEY="cr_your_key"

curl -s -o /dev/null -w '%{http_code}\n' -X POST \
  https://api.qcode.cc/openai/v1/chat/completions \
  -H "Authorization: Bearer $KEY"
# → 400 = path and key both work (empty body is expected)
# → 401 = bad key; 404 = wrong path prefix

Festlandchina: Wiederholen Sie den Test mit Host asia.qcode.cc. Wählen Sie anschließend in WorkBuddy das neue Modell aus und senden Sie ping. Eine Antwort bedeutet, dass die Integration funktioniert.

Wenn der Pfad-Test erfolgreich ist, WorkBuddy aber weiterhin Fehler meldet, prüfen Sie den vorherigen Abschnitt erneut: Die URL behält /v1 und hat keinen abschließenden Schrägstrich, bei eingeschaltetem Custom Protocol ist es der vollständige Pfad mit /chat/completions, und die Modell-ID ist zeichengenau korrekt.

FAQ¶

Das Modellauswahlmenü zeigt die neue Zeile nicht an¶

Seit 5.1.1 beschreibt das offizielle Änderungsprotokoll ein Hot-Reload von models.json — normalerweise reicht Speichern aus. Falls das Menü die Zeile weiterhin nicht anzeigt, beenden Sie WorkBuddy vollständig (nicht in der Taskleiste lassen) und öffnen Sie es erneut; prüfen Sie dann unter Einstellungen → Modell die Zeile.

Fehlercode 4100 (benutzerdefiniertes Modell ohne Endpunkt oder API-Key)¶

Die offizielle Fehlercode-Seite der chinesischen Website sagt (übersetzt): Für das gewählte benutzerdefinierte Modell ist keine Endpunkt-URL oder kein API-Key konfiguriert, daher wird die Anfrage nicht gesendet. Abhilfe: Klicken Sie auf der Fehlerkarte auf „go to configuration“ und tragen Sie die Endpunkt-URL und den API-Key des Modells ein. Ein solches Modell erscheint in der Modellauswahl ausgegraut mit einem Warnsymbol und ist nach dem Speichern ohne Neustart wieder nutzbar. Die offizielle Modellseite ergänzt, dass Modelle mit Zeigen auf den lokalen Rechner (zum Beispiel ein lokales Ollama) keinen API-Key benötigen und davon nicht betroffen sind.

Ich finde benutzerdefinierte Modelle auf meinem Smartphone nicht¶

Die offizielle Modellseite für Mobilgeräte sagt (übersetzt): Die mobile App bietet keinen Eintrag zum Konfigurieren benutzerdefinierter Modelle; die Liste zeigt nur die verfügbaren Modelle. Konfigurieren Sie auf dem Desktop.

Brauchen die China- und die internationale Ausgabe eine getrennte Einrichtung?¶

Laut der offiziellen Dokumentation speichern beide Ausgaben ihre Konfiguration in unterschiedlichen Dateien (China workbuddy/models.json, international ~/.workbuddy-ai/models.json); konfigurieren Sie daher die Ausgabe, die Sie installiert haben. URL und Key von QCode tragen Sie in beiden auf dieselbe Weise ein.

HTTP 404¶

1. Endpunkt: https://api.qcode.cc/openai/v1/chat/completions (bei Custom Protocol aus geht auch https://api.qcode.cc/openai/v1)
2. Bei Custom Protocol an funktioniert nur der vollständige Pfad; …/openai/v1 allein wird unverändert ohne /chat/completions gesendet
3. /v1 behalten; kein abschließender /
4. Verwenden Sie nicht https://api.qcode.cc/api (Anthropic-Messages-Präfix)

HTTP 401¶

Der Key muss mit cr_ beginnen und darf keine Leerzeichen enthalten. Prüfen Sie ihn unter qcode.cc/dashboard. WorkBuddy speichert den Key lokal; ein Schlüsselwechsel erfordert das Bearbeiten dieser Custom-Model-Zeile.

Ungewöhnliche oder fehlgeschlagene Antworten nach dem Ausfüllen des Modellnamens¶

Modellname muss eine aktive ID auf diesem Endpunkt sein, z. B. gpt-5.6-terra — nicht das Anzeigelabel „GPT 5.6 Terra“ und kein Alias eines anderen Anbieters. Aktive Liste: qcode.cc/models oder GET https://api.qcode.cc/openai/v1/models mit Ihrem Key — diese Liste ist das Set, das WorkBuddy nutzen kann, und sie enthält kein Claude.

Lädt WorkBuddy den Chat zu Tencent hoch?¶

Offizielle Formulierung: Im Custom-Model-Pfad ist WorkBuddy ein Transport; es leitet Eingaben an den von Ihnen konfigurierten Drittanbieter weiter, und der API-Key bleibt lokal. Die offizielle Modellseite und Tencents Nutzungsvereinbarung sind maßgeblich. Anfragen, die QCode erreichen, können unter probe.qcode.cc mit demselben Key eingesehen werden.

Kann WorkBuddy Claude Code ersetzen?¶

Nein. WorkBuddy ist für Multi-Agent-Büro-Workflows gebaut; Claude Code / Codex sind für Coding-Loops im Repository konzipiert. Nutzen Sie beide: Büro-Deliverables in WorkBuddy, Codeänderungen in Claude Code, umgeschaltet über CC Switch. Ein QCode-Key, ein Kontingent — siehe Abrechnung.

Nächste Schritte¶

• Endpunkte & API-Formate — drei Protokolle, drei Domains, BASE_URL-Übersicht
• Benutzerdefinierte Modelle für CodeBuddy — das Coding-Produkt aus demselben Team: models.json-Felder und die Responses-Einrichtung
• CC Switch Einrichtung — denselben Key zwischen Claude Code und Codex wechseln
• Modellauswahl — welcher Tarif im Alltag
• Abrechnung — Tarife und Kontingent
• Aktive IDs und Preise: qcode.cc/models

Noch keinen QCode.cc API-Key? Wählen Sie einen Plan unter qcode.cc/pricing.

Enterprise →