# WorkBuddy-Integration

> **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

| Punkt | Details |
|---|---|
| Verfügbare Modelle | Claude ❌ (benutzerdefinierte Modelle sprechen nur OpenAI Chat Completions) · GPT ✅ · Chinesische Modelle ✅ · Gemini ❌ |
| Protokoll & Base-URL | OpenAI Chat: Endpunkt `https://api.qcode.cc/openai/v1` |
| Konfiguration | In-App: Einstellungen → Modelle → benutzerdefiniertes Modell (Abschnitt „Erweiterte Tools“) |
| Offizielle Dokumentation | [codebuddy.cn/work](https://www.codebuddy.cn/work/) |

[WorkBuddy](https://www.codebuddy.cn/work/) 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](https://www.codebuddy.cn/docs) (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](/docs/getting-started/installation) oder [Codex CLI](/docs/ide/codex).

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](/docs/getting-started/installation),
> [Cline](/docs/ide/cline), [Zed](/docs/ide/zed). Siehe
> [Endpunkte & API-Pfade](/docs/getting-started/endpoints-and-api-paths).

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](https://www.codebuddy.cn/docs/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/Model).

## Voraussetzungen

- WorkBuddy installiert (Website: [codebuddy.cn/work](https://www.codebuddy.cn/work/); Installationsanleitung: offizielle [Mac](https://www.codebuddy.cn/docs/workbuddy/From-Beginner-to-Expert-Guide/Installation-Mac-Guide)- / [Windows](https://www.codebuddy.cn/docs/workbuddy/From-Beginner-to-Expert-Guide/Installation-Win-Guide)-Anleitungen)
- Ein QCode.cc API-Key (beginnt mit `cr_`) aus dem [Dashboard](https://qcode.cc/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](/docs/getting-started/endpoints-and-api-paths)

## 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

| Feld | Wert | Hinweise |
|-------|--------|------|
| Anbieter | `Custom` | Keinen integrierten Tencent Cloud Token Plan auswählen |
| Endpunkt-URL | `https://api.qcode.cc/openai/v1` | Festlandchina: `https://asia.qcode.cc/openai/v1` bevorzugen |
| API-Key | Ihr QCode.cc-Key (`cr_`-Präfix) | Keine führenden/abschließenden Leerzeichen |
| Modellname | z. B. `gpt-6-sol` | Muss eine aktive ID auf [qcode.cc/models](https://qcode.cc/models) sein, zeichengenau |
| Erweiterte Tools | Tool Calling / Bildeingabe / Reasoning bei Bedarf aktivieren | Im offiziellen TokenHub-Beispiel vorgeschlagen; nicht erforderlich |

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**:

| Schalter | Verhalten |
|--------|-----------|
| Aus (Standard) | Standardpfad `/chat/completions` verwenden; URL validieren und vervollständigen |
| An | URL **exakt wie eingegeben** senden; Validierung und Autovervollständigung überspringen |

Bei der Standardeinstellung (Aus) stoppen Sie also bei `/openai/v1` — derselbe Wert wie `OPENAI_BASE_URL` in [Umgebungsvariablen](/docs/getting-started/environment) — 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:

| Knoten | Endpunkt-URL (benutzerdefiniertes Protokoll aus) |
|------|-------------------------------------|
| Global (Route 53) | `https://api.qcode.cc/openai/v1` |
| Asien (in CN empfohlen) | `https://asia.qcode.cc/openai/v1` |
| Nordamerika / Europa | `https://us.qcode.cc/openai/v1` |

### 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](https://www.codebuddy.cn/docs/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/Model). 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](https://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).

| Modell-ID | Einsatz |
|----------|-----|
| `gpt-5.6-terra` | GPT-Alltagstarif |
| `glm-5.2` | Zhipu-Flaggschiff, verbreitet für Büroarbeit in China |
| `kimi-k3` | Moonshot-Flaggschiff, langer Kontext |
| `deepseek-v4-pro` | DeepSeek-Flaggschiff, unter den niedrigsten Einzelpreisen |
| `qwen3.8-max` | Qwen-Flaggschiff |

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](/docs/usage/model-selection). Setzen Sie keinen Namen, der nicht auf [qcode.cc/models](https://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](/docs/getting-started/endpoints-and-api-paths) §4):

```bash
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](https://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](https://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](https://www.codebuddy.cn/docs/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/Model) und Tencents Nutzungsvereinbarung sind maßgeblich. Anfragen, die QCode erreichen, können unter [probe.qcode.cc](https://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](/docs/ide/cc-switch). Ein QCode-Key, ein Kontingent — siehe [Abrechnung](/docs/reference/billing).

## Nächste Schritte

- [Endpunkte & API-Formate](/docs/getting-started/endpoints-and-api-paths) — drei Protokolle, drei Domains, `BASE_URL`-Übersicht
- [CC Switch Einrichtung](/docs/ide/cc-switch) — denselben Key zwischen Claude Code und Codex wechseln
- [Modellauswahl](/docs/usage/model-selection) — welcher Tarif im Alltag
- [Abrechnung](/docs/reference/billing) — Tarife und Kontingent
- Aktive IDs und Preise: [qcode.cc/models](https://qcode.cc/models)

> Noch keinen QCode.cc API-Key? Wählen Sie einen Plan unter [qcode.cc/pricing](https://qcode.cc/pricing).