Cherry Studio: Claude-, GPT- und DeepSeek-API einrichten
Stand 2026-10-07 verbinden Sie Cherry Studio so mit der Claude API: Unter Einstellungen → Model Services fügen Sie einen Anbieter hinzu, wählen den Typ Anthropic und tragen als API-Adresse nur die Stammadresse https://api.qcode.cc/api ein, ohne /v1. Für GPT und chinesische Modelle wie DeepSeek wählen Sie den Typ OpenAI mit https://api.qcode.cc/openai; in beiden Fällen nutzen Sie denselben cr_-Schlüssel. Diese Seite geht Schritte, Modell-IDs und häufige Fehler anhand der QCode-Dokumentation und der offiziellen Cherry-Studio-Dokumentation Punkt für Punkt durch.
Aktualisiert 2026-10-07
Vier Punkte vor dem Start
Anbietertyp für Claude
API-Adresse https://api.qcode.cc/api. Laut QCode-Dokumentation funktioniert Claude nicht über den Typ OpenAI, und auch Cherry Agent braucht einen Endpunkt mit Anthropic-Protokoll.
Typ für GPT und chinesische Modelle
API-Adresse https://api.qcode.cc/openai; Cherry ergänzt daraus automatisch /openai/v1/chat/completions.
So füllen Sie die API-Adresse aus
Nur die Stammadresse, ohne /v1 und ohne Pfad: Wer /v1 selbst einträgt, landet bei /v1/v1. Wenn Sie das automatische Anhängen wirklich abschalten müssen, beenden Sie die Adresse mit #.
Ein Schlüssel für beide Typen
Beide Typen erhalten denselben cr_-Schlüssel, den Sie in der Konsole erstellen. Cherry kann außerdem mehrere Schlüssel pro Anbieter reihum nutzen, getrennt durch normale (englische) Kommas.
So bindet Cherry Studio eine eigene API an
Stand 2026-10-07 läuft das Anbinden von Claude, GPT oder DeepSeek in Cherry Studio immer auf dasselbe hinaus: Sie fügen unter Einstellungen → Model Services einen eigenen Anbieter hinzu. Claude nutzt den Typ Anthropic mit https://api.qcode.cc/api, GPT und chinesische Modelle den Typ OpenAI mit https://api.qcode.cc/openai. Cherry Studio ist ein quelloffener Desktop-Client (die Community Edition steht unter AGPL-3.0) für Windows, Mac und Linux. Laut offizieller Dokumentation sind über 60 Anbieter eingebaut; Dienste, die nicht in der Liste stehen, lassen sich als eigener Anbieter hinzufügen, sofern sie etwa ein OpenAI- oder Anthropic-kompatibles Protokoll anbieten. Die QCode-Dokumentation hält fest, dass es kein Kontosystem gibt und alles lokal konfiguriert wird: Sie brauchen weder ein Cherry-Studio-Konto noch ein Konto bei einem Modellanbieter.
Aktuelle Cherry-Studio-Versionen (Stand 2026-10-07)
Stand 2026-10-07 ist v2.1.4 die neueste stabile Version auf GitHub Releases, veröffentlicht am 2026-09-30 (UTC). In den Release Notes heißt es „Add Claude Sonnet 5.5 and Opus 5.5 with thinking controls and native web-tool eligibility“; außerdem kam Unterstützung für GPT-6.1 Sol bei OpenAI und OpenAI Codex hinzu. Laut v2.1.3 (2026-09-24) werden Anbieter nach dem Hinzufügen von Modellen automatisch geprüft und eingeschaltet, v2.1.0 (2026-09-18) brachte DeepSeek V4.1 Flash. Das sind Updates des eingebauten Modellkatalogs von Cherry; für QCode tragen Sie die Modell-IDs weiterhin nach der QCode-Dokumentation ein und gleichen sie mit /models ab. Die QCode-Anleitung für Cherry Studio wurde anhand der offiziellen Dokumentation zu v2.0.14 geprüft, die Beschriftungen in der Oberfläche können sich daher je nach Version unterscheiden.
Zeitleiste: Versionen und Dokumentation
Cherry Studio v2.0.14 erscheint; die QCode-Anleitung für Cherry Studio wurde anhand der offiziellen Dokumentation genau dieser Version geprüft. Ab diesem Release zeigen Fehler konkrete Angaben des Anbieters statt allgemeiner Meldungen wie „400 null“.
Die QCode-Anleitung für Cherry Studio wird aktualisiert und zuletzt geprüft; am selben Tag erscheint Cherry Studio v2.1.0 mit DeepSeek V4.1 Flash im eingebauten Katalog.
Cherry Studio v2.1.4 erscheint (UTC) und nimmt Claude Sonnet 5.5 und Opus 5.5 in den eingebauten Katalog auf; Stand 2026-10-07 ist das die neueste stabile Version auf GitHub.
Bestätigt vs. nicht dokumentiert
Bestätigt (wörtlich in der Dokumentation)
Alles Folgende lässt sich wörtlich in der QCode-Dokumentation, der offiziellen Cherry-Studio-Dokumentation oder den GitHub-Release-Notes nachprüfen: Claude nutzt den Typ Anthropic mit https://api.qcode.cc/api; GPT und chinesische Modelle den Typ OpenAI mit https://api.qcode.cc/openai; beide Typen verwenden denselben cr_-Schlüssel; die API-Adresse ist nur die Stammadresse, und nur ein abschließendes # schaltet das Anhängen ab; Claude im Typ OpenAI wird mit model_not_available_on_endpoint abgelehnt; der OpenAI-Responses-Endpunkt bedient bei QCode nur die GPT-Familie; Cherry Agent braucht einen Endpunkt mit Anthropic-Protokoll (steht sowohl bei QCode als auch bei Cherry); ein Anbieter muss per Schalter eingeschaltet sein, und nur Modelle in seiner Liste erscheinen in der Modellauswahl; v2.1.4 erschien am 2026-09-30.
Nicht dokumentiert oder nicht geprüft
Zu drei Punkten zieht diese Seite keine Schlüsse. Erstens wurde die QCode-Anleitung auf v2.0.14 geprüft und weist selbst darauf hin, dass die Einstellungsseite mal Model Services, mal Model Provider heißt und die Schaltfläche zum Abrufen der Modellliste in manchen Versionen als Modelle synchronisieren erscheint; die Oberfläche von v2.1.4 hat diese Seite nicht getestet, maßgeblich ist Ihr eigener Client. Zweitens nennt die QCode-Anleitung für chinesische Modelle nur eine Einrichtung, den Typ OpenAI; andere Kombinationen sind dort nicht beschrieben, und diese Seite beschreibt sie auch nicht. Drittens haben Bildgenerierung und Bildbearbeitung eigene Base-URL-Felder, und die QCode-Anleitung hält fest, dass das Verhalten von Cherry dort auf jener Seite nicht geprüft wurde.
Welchen Anbietertyp Sie wählen sollten
Anthropic vs. OpenAI
Entscheidend ist die Modellfamilie. Claude läuft nur über den Typ Anthropic (https://api.qcode.cc/api), der OpenAI-Endpunkt von QCode lehnt Claude direkt ab; GPT und die chinesischen Modelle GLM, Kimi, DeepSeek und Qwen laufen über den Typ OpenAI (https://api.qcode.cc/openai). Die zweite Trennlinie ist Agent: Sowohl die QCode- als auch die Cherry-Dokumentation sagen ausdrücklich, dass Cherry Agent einen Endpunkt mit Anthropic-Protokoll braucht. Wer Agent in der App nutzen will, richtet also den Typ Anthropic ein.
OpenAI vs. OpenAI Responses
Beide nehmen https://api.qcode.cc/openai als API-Adresse; der Unterschied liegt bei den erreichbaren Modellen. Laut QCode-Dokumentation bedient der Responses-Endpunkt nur die GPT-Familie, Claude und chinesische Modelle funktionieren dort nicht. Wer nur GPT braucht, kann beide nehmen; wer zusätzlich DeepSeek oder ein anderes chinesisches Modell will, wählt den Typ OpenAI.
Sechs Schritte zu Claude (danach GPT und DeepSeek)
① Öffnen Sie Einstellungen → Model Services, klicken Sie unter der Liste auf die Schaltfläche zum Hinzufügen eines Anbieters und geben Sie ihm im Dialog für eigene Anbieter einen Namen. ② Wählen Sie den Typ Anthropic, tragen Sie als API-Adresse https://api.qcode.cc/api ein und fügen Sie den cr_-Schlüssel aus der Konsole ein. ③ Rufen Sie die Modellliste ab oder fügen Sie über + eine Modell-ID von Hand hinzu, etwa claude-sonnet-5; nur Modelle in der Liste erscheinen in der Modellauswahl. ④ Schalten Sie den Anbieter oben rechts ein, klicken Sie dann auf die Prüf-Schaltfläche und wählen Sie ein Modell, um die Verbindung zu testen. ⑤ Für GPT und chinesische Modelle: Typ OpenAI, API-Adresse https://api.qcode.cc/openai, derselbe cr_-Schlüssel und Modell-IDs wie gpt-6-sol, deepseek-v4.1-flash oder glm-5.3. ⑥ Wählen Sie das neue Modell in einem beliebigen Chatfenster und senden Sie eine Nachricht; kommt keine Antwort, prüfen Sie zuerst, ob Typ und Adresse zusammenpassen.
Auf QCode
Auf QCode funktioniert ein cr_-Schlüssel (in der Konsole erstellt) protokollübergreifend; welches Protokoll greift, entscheidet der Anfragepfad: claude-sonnet-5, claude-sonnet-5-5 und claude-opus-5-5 laufen über den Typ Anthropic mit https://api.qcode.cc/api, gpt-6-sol, gpt-5.6-terra, deepseek-v4.1-flash, glm-5.3, kimi-k3 und qwen3.8-max über den Typ OpenAI mit https://api.qcode.cc/openai. Die drei Zugangsdomains bieten denselben Funktionsumfang und akzeptieren denselben Schlüssel: us.qcode.cc (Los Angeles) richtet sich an Nordamerika und Europa, für Netze in Festlandchina empfiehlt die Dokumentation asia.qcode.cc, die Pfade bleiben gleich. Berechnet wird pro Token, die Preise je Modell stehen unter /models. Jede Anfrage können Sie auf probe.qcode.cc nach Eingabe Ihres Schlüssels einsehen.
Häufig gestellte Fragen
Welchen Anbietertyp wähle ich in Cherry Studio für Claude?
Den Typ Anthropic. Tragen Sie als API-Adresse https://api.qcode.cc/api und Ihren cr_-Schlüssel ein, dann fügen Sie eine Modell-ID hinzu (etwa claude-sonnet-5) oder rufen die Modellliste ab. Laut QCode-Dokumentation können Claude-Modelle nur den Anthropic-Endpunkt nutzen, nicht den Typ OpenAI. Der eingebaute Anthropic-Anbieter in Cherry zeigt standardmäßig auf https://api.anthropic.com; die QCode-Dokumentation sieht stattdessen einen zusätzlichen eigenen Anbieter vor.
Was bedeutet model_not_available_on_endpoint?
Das Protokoll ist falsch, nicht der Schlüssel. Legen Sie ein Claude-Modell unter den Typ OpenAI, liefert QCode einen Fehler wie Model 'claude-sonnet-5' is not available on this endpoint. Laut Dokumentation läuft diese Prüfung vor der Authentifizierung, der Fehler kommt also selbst bei ungültigem Schlüssel; ein falscher Schlüssel liefert dagegen Invalid API key. Die Lösung: Claude in den Typ Anthropic mit https://api.qcode.cc/api verschieben.
Gehört /v1 oder ein Schrägstrich am Ende in die API-Adresse?
Weder noch. Tragen Sie nur die Stammadresse ein, Cherry Studio hängt den Pfad passend zum gewählten Typ selbst an; wer /v1 selbst schreibt, landet bei /v1/v1. Auch die QCode-Dokumentation zu Endpunkten rät allgemein, die BASE_URL ohne abschließenden Schrägstrich einzutragen, sonst entsteht //v1/messages und ein 404-Fehler. Brauchen Sie wirklich eine vollständige Adresse, beenden Sie sie mit #: Dann hängt Cherry nichts mehr an und nutzt genau Ihre Eingabe.
Der Schlüssel ist eingetragen, aber der Chat funktioniert nicht oder das Modell fehlt. Was tun?
Prüfen Sie drei Dinge: ob der Schalter des Anbieters oben rechts eingeschaltet ist (sonst erscheinen seine Modelle nicht in der Auswahl), ob das Modell zur Liste hinzugefügt wurde (nur Modelle in der Liste erscheinen in der Modellauswahl) und ob Typ und Adresse zusammenpassen. Die offiziellen Cherry-FAQ raten zudem zu prüfen, ob das Standardmodell bei diesem Anbieter tatsächlich nutzbar ist, und mit der Prüf-Schaltfläche zu testen; schlägt die Prüfung fehl, suchen Sie in der Modellliste nach einer vertippten ID. Beurteilen Sie die Lage nicht über einen direkten curl-Aufruf von https://api.qcode.cc/api: Dabei kommt eine HTML-Infoseite (HTTP 200), die weder ein Fehler noch ein Beleg dafür ist, dass der Pfad funktioniert. Ihr Anfrageprotokoll sehen Sie auf probe.qcode.cc nach Eingabe Ihres Schlüssels.
Kann Cherry Agent Claude über QCode nutzen?
Ja, wenn Sie den Typ Anthropic einrichten. Die QCode-Dokumentation sagt ausdrücklich, dass die Agent-Funktion von Cherry einen Endpunkt mit Anthropic-Protokoll braucht; für Agent in der App richten Sie also den Typ Anthropic mit https://api.qcode.cc/api ein. Auch die offizielle Cherry-Seite zu Anthropic schreibt, dass Agent einen Endpunkt mit Anthropic-Protokoll benötigt. Meldet Agent, dass das API-Gateway eingeschaltet sein muss, schalten Sie es direkt aus dieser Meldung heraus ein und starten es, oder Sie starten es manuell unter Einstellungen → API-Gateway.
Welcher Typ und welche Modell-IDs für GPT und DeepSeek?
Der Typ OpenAI, mit https://api.qcode.cc/openai als API-Adresse und demselben cr_-Schlüssel. Als Modell-IDs eignen sich gpt-6-sol, gpt-5.6-terra, deepseek-v4.1-flash, glm-5.3, kimi-k3 oder qwen3.8-max; was aktuell angeboten wird, steht unter /models. Der Typ OpenAI Responses funktioniert mit derselben Adresse ebenfalls, bedient bei QCode aber nur die GPT-Familie: DeepSeek, andere chinesische Modelle und Claude laufen dort nicht.
Quellen
Einrichtungsschritte, Anbietertypen und Adressen: die QCode-Dokumentationsseite zu Cherry Studio (aktualisiert am 2026-09-18) und die Seite zu Endpunkten und API-Formaten (aktualisiert am 2026-09-25; welche Modellfamilien welchen Endpunkt nutzen, der genaue Fehlertext und die drei Zugangsdomains), beide abgerufen am 2026-10-07. Oberfläche und Regeln von Cherry Studio selbst: die offizielle Cherry-Studio-Dokumentation unter docs.cherryai.com.cn (die alte Domain docs.cherry-ai.com leitet per 301 dorthin weiter) mit den Seiten zu eigenen Anbietern, den Einstellungen der Modelldienste, Anthropic, der Anbieter-Kurzreferenz und den FAQ, am selben Tag abgerufen. Versionen und Plattformen: README und Releases des Cherry-Studio-Repositorys auf GitHub (Release Notes von v2.0.14 bis v2.1.4), am selben Tag abgerufen.
Cherry Studio mit QCode verbinden
Ein cr_-Schlüssel: Claude über den Typ Anthropic, GPT und chinesische Modelle über den Typ OpenAI. Berechnet wird pro Token, die Preise je Modell stehen unter /models.
Weiterführende Lektüre
Claude Code: benutzerdefinierten Endpunkt einrichten
Die beiden Umgebungsvariablen, die Form in settings.json und apiKeyHelper.
Cline: Leitfaden zur OpenAI-kompatiblen API
Drei Felder in Cline, um QCode anzubinden.
So beurteilen Sie, ob ein KI-API-Relay sich lohnt
Vier Prüfungen, die Sie selbst durchführen können.
Die Schritte und Zitate auf dieser Seite wurden am 2026-10-07 anhand der QCode-Dokumentation, der offiziellen Cherry-Studio-Dokumentation und der GitHub-Release-Notes geprüft; Änderungen bei den Anbietern sind ohne Vorankündigung möglich. Beschriftungen in der Oberfläche ändern sich je nach Client-Version, maßgeblich ist Ihre eigene; für die Modellverfügbarkeit gilt /models.