WorkBuddy-Integration

Binden Sie Tencent WorkBuddy als benutzerdefiniertes Modell an QCode.cc an: URL, API-Key und Modell-ID in der UI ausfüllen, dann GPT- und China-Modelle mit einem einzigen cr_-Key aufrufen

Zuletzt überprüft: 2026-09-18 · 📄 Gemäß offizieller Dokumentation (WorkBuddy 5.5.6 (offizielle Website, geprüft 2026-09; Windows 10+ / macOS 12+, kein Linux-Desktop-Paket))

Auf einen Blick¶

WorkBuddy ist ein Desktop-AI-Agent von Tencent Cloud. Er richtet sich an Büro-Arbeitsergebnisse (Notizen, Tabellen, Präsentationen, leichter Code) und gehört zur gleichen Familie wie CodeBuddy (der IDE-/CLI-Coding-Assistent). Er ist kein direkter Ersatz für Claude Code: Refactoring im Repository-Maßstab, Tests und CI gehören weiterhin zu Claude Code oder Codex CLI.

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.

🔴 WorkBuddy kann keine Claude-Modelle verwenden. WorkBuddys benutzerdefinierte Modelle sprechen nur das OpenAI Chat Completions-Protokoll, und QCodes OpenAI-Zweig akzeptiert keine Claude-Modelle (eine claude-…-ID liefert model_not_available_on_endpoint zurück). GPT und die vier chinesischen Familien funktionieren daher in WorkBuddy, aber Claude nicht. Verwenden Sie für Claude einen Client, der das Anthropic-Protokoll spricht — Claude Code, Cline, Zed. 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.

Voraussetzungen¶

• WorkBuddy installiert (Website: codebuddy.cn/work; Installationsanleitung: offizielle Mac- / Windows-Anleitungen)
• 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 offizielle Modellseite besagt, dass benutzerdefinierte Modelle in den Einstellungen hinzugefügt werden sollten, ohne eine Konfigurationsdatei manuell zu bearbeiten. Der WorkBuddy-Leitfaden von Tencent Cloud TokenHub verwendet denselben Weg.

1. WorkBuddy starten → Kontomenü (unten links) → Einstellungen
2. Linke Navigation: Modell → unter benutzerdefinierte Modelle Modell hinzufügen
3. Anbieter: Benutzerdefiniert
4. Die untenstehende Tabelle ausfüllen, speichern und dann das neue Modell in der Chat-Modellauswahl auswählen

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.2 und einen deepseek-v4-pro.

URL ausfüllen (benutzerdefiniertes Protokoll)¶

Offizielles Verhalten des Schalters für das benutzerdefinierte Protokoll:

Bei der Standardeinstellung (Aus) stoppen Sie also bei /openai/v1 — derselbe Wert wie OPENAI_BASE_URL in Umgebungsvariablen — und lassen WorkBuddy /chat/completions anhängen.

• Geben Sie nicht .../openai/v1/chat/completions ein, solange das benutzerdefinierte Protokoll deaktiviert ist; der Pfad könnte doppelt angehängt werden und 404 zurückgeben
• Falls die Standardvervollständigung fehlschlägt, folgen Sie dem offiziellen TokenHub-Beispiel: Tragen Sie die vollständige URL https://api.qcode.cc/openai/v1/chat/completions in das Feld ein und aktivieren Sie das benutzerdefinierte Protokoll
• 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¶

Offizielle Aussagen:

• Parameter (einschließlich des API-Keys) werden nur in der lokalen workbuddy/models.json gespeichert und nicht hochgeladen
• Benutzerdefinierte Modelle, die zuvor über ~/.codebuddy/models.json hinzugefügt wurden, funktionieren nach dem UI-Upgrade weiterhin und können in der UI angezeigt / bearbeitet / gelöscht werden
• Die Token-Kosten benutzerdefinierter Modelle werden an den Drittanbieter (hier QCode.cc) gezahlt und nicht vom integrierten Guthaben von WorkBuddy abgezogen

Diese Seite stellt kein handgeschriebenes models.json-Schema bereit. Der offizielle Weg ist die UI; die Feldnamen richten sich nach Ihrem installierten Build und der offiziellen Modellkonfiguration. Wenn Sie eine Stapelbearbeitung benötigen, fügen Sie zunächst einen Eintrag in der UI hinzu und inspizieren Sie die lokale Datei — kopieren Sie kein Schema von einem Drittanbieter-Blog.

Zuerst hinzuzufügende Modelle¶

Alle nachstehenden IDs wurden am 2026-09-18 sowohl auf qcode.cc/models als auch über GET https://api.qcode.cc/api/v1/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: überflüssiges /chat/completions oder abschließender Schrägstrich, Custom-Protocol-Schalter vs. Art der URL-Eingabe und eine zeichengenau korrekte Modell-ID.

FAQ¶

Das Modellauswahlmenü zeigt die neue Zeile nicht an¶

Seit v5.1.1 beschreiben die offiziellen Docs ein Hot-Reload für Modellkonfiguration — 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.

HTTP 404¶

1. Custom Protocol aus: Endpunkt ist https://api.qcode.cc/openai/v1 — hängen Sie /chat/completions nicht selbst an
2. Custom Protocol an: verwenden Sie den vollen Pfad https://api.qcode.cc/openai/v1/chat/completions
3. 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
• 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.