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

Auf dieser Seite

Cherry Studio Integration

Cherry Studio Integration ¶

Zuletzt überprüft: 2026-09-18 · 📄 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 ✅ (Gemini-Typ, Pfadverknüpfung nicht live getestet)
Protokoll & Base URL	Anthropic: `https://api.qcode.cc/api` · OpenAI: `https://api.qcode.cc/openai` · Gemini: `https://api.qcode.cc/gemini` (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 upstream 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) 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 die QCode-Responses-Schiene nur GPT-Modelle bedient — kein Claude, keine chinesischen Modelle (Matrix: Endpunkte und API-Pfade).
Gemini: 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: die QCode-OpenAI-Schiene 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.