Cherry Studio anbinden

QCode.cc als benutzerdefinierten Anbieter in Cherry Studio hinzufügen: der Pfad über Einstellungen zu Modelldienste, welche URL jeder der vier Anbietertypen benötigt und warum die Agent-Funktion einen Anthropic-Endpunkt verlangt

Aktualisiert 2026-10-15

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

Auf dieser Seite

Auf einen Blick
Voraussetzungen
Einrichtung
Funktion überprüfen
Bekannte Einschränkungen
Anbietertypen und QCode-Adressen
Wichtige Einstellungen
Häufige Fehler und Fehlersuche
FAQ
Verwandte Dokumentationen

Zuletzt überprüft: 2026-10-15 · 📄 Gemäß offizieller Dokumentation (Cherry Studio v2.0.14, veröffentlicht 2026-09-09)

Auf einen Blick¶

Punkt	Details
Verfügbare Modelle	Claude ✅ (Anthropic-Typ) · GPT ✅ (OpenAI-Typ) · Chinesische Modelle ✅ (OpenAI-Typ) · Gemini ❌ (von QCode vorerst nicht angeboten)
Protokoll & Base URL	Anthropic: `https://api.qcode.cc/api` · OpenAI: `https://api.qcode.cc/openai` (nur Root-URLs — siehe unten)
Konfiguration	In-App: Einstellungen → Modelldienste → „+ Anbieter hinzufügen“
Offizielle Dokumentation	Anbieterkonfiguration

Cherry Studio ist einer der beliebtesten Open-Source-Desktop-AI-Clients unter chinesischsprachigen Nutzern (Windows / macOS / Linux): Chat, Übersetzung, Wissensdatenbanken und MCP in einem Fenster. Kein Kontosystem, rein lokale Konfiguration — auf einen beliebigen OpenAI- / Anthropic-kompatiblen Endpunkt zeigen und loslegen.

Voraussetzungen¶

Cherry Studio installiert (die Download-Seite bietet Global- und CN-Builds, x64 / ARM64; Mindest-OS-Versionen werden vom Hersteller nicht angegeben — siehe Download-Seite). Kein Cherry-Studio-Konto und keine Modell-Anbieterkonten erforderlich.
Ein QCode.cc-cr_-API-Key (Dashboard).
Vom chinesischen Festland aus ersetzen Sie api.qcode.cc durch asia.qcode.cc in allen untenstehenden Angaben — identische Funktionen.

Einrichtung¶

Öffnen Sie Einstellungen → Modelldienste, klicken Sie unterhalb der Liste auf „+ Anbieter hinzufügen“ und arbeiten Sie im Dialog „Benutzerdefinierten Anbieter hinzufügen“. Die offizielle Regel: Das Feld „API Host“ akzeptiert nur die Root-URL — kein /v1, keine Pfade — Cherry Studio ergänzt den Rest je nach gewähltem Typ (z. B. fügt der OpenAI-Typ /v1/chat/completions hinzu); um das Anhängen vollständig zu deaktivieren, beenden Sie die URL mit #.

Route A: Claude-Modelle (Anthropic-Typ, empfohlen)¶

Wählen Sie den Typ Anthropic.
API Host: https://api.qcode.cc/api.
API-Key: Ihr cr_-Schlüssel.
Fügen Sie die gewünschten Modell-IDs hinzu (z. B. claude-sonnet-5) in den Endpunkt-/Modelleinstellungen oder rufen Sie die Modellliste ab.
Die offizielle Dokumentation besagt, dass die Cherry-Agent-Funktion einen Anthropic-Protokoll-fähigen Endpunkt erfordert — wenn Sie In-App-Agenten nutzen möchten, ist dies die richtige Route.

Route B: GPT und chinesische Modelle (OpenAI-Typ)¶

Wählen Sie den Typ OpenAI.
API Host: https://api.qcode.cc/openai (Cherry baut daraus /openai/v1/chat/completions).
API-Key: derselbe cr_-Schlüssel.
Modell-IDs: beliebiges GPT (z. B. gpt-5.6-sol) oder chinesisches Modell (glm-5.3, kimi-k3, deepseek-v4.1-flash, qwen3.8-max, …) — aktuelle Liste unter qcode.cc/models.

Die verbleibenden Typen¶

OpenAI Responses: derselbe Host https://api.qcode.cc/openai; beachten Sie, dass der QCode-Responses-Endpunkt nur GPT-Modelle bedient — kein Claude, keine chinesischen Modelle (Matrix: Endpunkte und API-Pfade).
Gemini (QCode bietet Gemini derzeit nicht an; dieser Punkt beschreibt nur den Cherry-Typ): API Host https://api.qcode.cc/gemini; wir haben den exakten Pfad, den Cherry für diesen Typ anhängt, nicht überprüft — bei einem 404 passen Sie ihn über die Root-URL + abschließendes # an.

Funktion überprüfen¶

Senden Sie eine Nachricht an das neue Modell in einem beliebigen Chat-Tab, oder nutzen Sie die In-App-Funktion „Modellliste abrufen“ (sie greift auf <api host>/models zu). Falls keine Antwort kommt: Prüfen Sie zunächst, ob der Typ zur Modellfamilie passt (Claude benötigt den Anthropic-Typ), dann ob Sie nicht manuell /v1/... in den Host eingefügt haben (es würde sich zu /v1/v1 verdoppeln). Immer noch Probleme? Befolgen Sie das Fehlerbehebungs-Handbuch; jede Anfrage ist unter probe.qcode.cc sichtbar.

Bekannte Einschränkungen¶

Claude kann den OpenAI-Typ nicht verwenden: der QCode-OpenAI-Endpunkt lehnt Claude-Modelle direkt ab (model_not_available_on_endpoint); verwenden Sie den Anthropic-Typ.
Fügen Sie keine vollständigen Pfade wie /v1/chat/completions in den API Host ein — das Anhängen ist die Standardeinstellung; das abschließende # ist der Ausstieg.
Cherrys zweisprachige Dokumentation bezeichnet die Einstellungsseite je nach Version sowohl als „Model Services“ als auch als „Model Provider“; die Schaltfläche „Modellliste abrufen“ kann in Ihrem Build „Modelle synchronisieren“ lauten.
Bildgenerierung / -bearbeitung haben eigene Base-URL-Felder; QCodes Bildmodell (gpt-image-2) ist in gpt-image-2 Bildgenerierung und -bearbeitung dokumentiert — Cherry-seitiges Verhalten hier nicht verifiziert.
Die Domain der offiziellen Dokumentation wurde kürzlich umgezogen (docs.cherry-ai.com leitet jetzt per 301 auf docs.cherryai.com.cn um); alte Lesezeichen werden umgeleitet.

Anbietertypen und QCode-Adressen¶

Stand 2026-10-15 gilt laut dem Abschnitt zu Anbietertypen in der Cherry-Studio-Dokumentation: Der OpenAI-kompatible Typ verwendet /v1/chat/completions, der Anthropic-kompatible Typ /v1/messages, und Cherry Agent verlangt den Anthropic-Typ; ein benutzerdefinierter Anbieter kann jeden OpenAI-, Anthropic- oder Gemini-kompatiblen Endpunkt anbinden. Übertragen auf QCode:

Cherry-Studio-Typ	API-Adresse	Nutzbare Modelle	Tatsächliche Anfrage von Cherry
Anthropic	`https://api.qcode.cc/api`	Claude; chinesische Modelle ebenfalls möglich	`/api/v1/messages`
OpenAI	`https://api.qcode.cc/openai`	GPT, chinesische Modelle	`/openai/v1/chat/completions`
OpenAI Responses	`https://api.qcode.cc/openai`	Nur GPT	`/openai/v1/responses`

In Festlandchina ersetzen Sie api.qcode.cc durch asia.qcode.cc.

Wichtige Einstellungen¶

Einstellung	Erklärung
Anbietertyp	Legt Protokoll und angehängten Pfad fest; hier passiert am häufigsten ein Fehler, und eine falsche Wahl zeigt sich meist als 404 oder `model_not_available_on_endpoint`
API-Adresse	Nur die Wurzel eintragen, kein `/v1` und keinen vollständigen Pfad. `#` am Ende nur setzen, wenn Sie einen festen Pfad brauchen und das automatische Anhängen abschalten wollen
API-Schlüssel	Ihr QCode-Schlüssel mit Präfix `cr_`, ohne Leerzeichen drumherum
Modell-ID	Manuell hinzufügen oder „Modellliste abrufen“; die echten Claude- und GPT-IDs stehen auf qcode.cc/models

Häufige Fehler und Fehlersuche¶

Symptom	Mögliche Ursache	Abhilfe
`model_not_available_on_endpoint`	Ein Claude-Modell hängt an einem Anbieter vom Typ OpenAI	Einen eigenen Anbieter vom Typ Anthropic mit der Adresse `https://api.qcode.cc/api` anlegen
404	`/v1` in die API-Adresse geschrieben (wird zu `/v1/v1`) oder Typ und Adresse passen nicht zusammen	`/v1` entfernen und die Zuordnungstabelle oben prüfen
`Invalid API key`	Schlüssel falsch, Leerzeichen drumherum oder der Schlüssel eines anderen Dienstes eingetragen	Den `cr_`-Schlüssel erneut kopieren
„Modellliste abrufen“ leer oder fehlgeschlagen	Der Abruf geht an `<API-Adresse>/models`, und Typ oder Adresse sind falsch	Zuerst Typ und Adresse korrigieren; bleibt die Liste leer, Modell-IDs von Hand hinzufügen
Agent-Funktionen gehen nicht	Der aktuelle Anbieter ist nicht vom Typ Anthropic	Einen Anbieter vom Typ Anthropic wie in Route A einrichten
Instabil in Festlandchina	Die Standarddomain hat einen ungünstigen Netzwerkpfad	Auf `asia.qcode.cc` wechseln

Lässt sich die Ursache immer noch nicht eingrenzen, geben Sie Ihren Schlüssel auf probe.qcode.cc ein, um zu sehen, ob Anfragen bei QCode ankommen, und folgen Sie dann der Fehlerbehebung.

FAQ¶

Brauche ich ein Konto bei Cherry Studio?¶

Nein. Es ist ein Client mit rein lokaler Konfiguration: QCode-Adresse und Schlüssel eintragen, fertig.

Warum zwei Anbieter für einen Schlüssel?¶

Weil Claude nur über die Anthropic-Schnittstelle läuft, GPT und chinesische Modelle aber über die OpenAI-Schnittstelle, und ein Anbieter in Cherry Studio nur einen Typ haben kann. Beide Anbieter nutzen denselben cr_-Schlüssel; nur Adresse und Typ unterscheiden sich.

Wie richte ich die Agent-Funktion der App ein?¶

Laut offizieller Dokumentation braucht Cherry Agent einen Anbieter vom Typ Anthropic: Typ Anthropic wählen, API-Adresse https://api.qcode.cc/api eintragen und Claude-Modelle hinzufügen.

Wann brauche ich ein `#` am Ende der API-Adresse?¶

Nur wenn ein Dienst einen festen vollständigen Pfad verlangt und Cherry Studio nicht je nach Typ einen Pfad anhängen soll. Bei normaler QCode-Nutzung genügt die Wurzeladresse aus der Zuordnungstabelle oben, ein # ist nicht nötig.

Kann ich Gemini über Cherry Studio nutzen?¶

QCode bietet derzeit keine Gemini-Modelle an. Bitte verwenden Sie Claude, GPT oder chinesische Modelle.