Cherry Studio + JoinGonka Gateway — Desktop AI-Client

Installation. Builds für alle Systeme finden Sie auf der Release-Seite des Projekts: Installer und portable Version für Windows, dmg-Image für macOS, AppImage, deb und rpm für Linux – für x64 und ARM. Gesprächsverlauf und Einstellungen werden lokal auf Ihrem Rechner gespeichert.

V1 oder V2. Im August 2026 erschien die V2-Reihe mit neuer Datenstruktur und überarbeiteten Einstellungen; der letzte Build der vorherigen Reihe ist 1.9.13. Ein eigener Anbieter ist in beiden vorhanden, unterschiedlich sind die Form des Hinzufügens und ein Teil der Beschriftungen – solche Stellen sind unten gekennzeichnet. Beim Wechsel von V1 auf V2 werden Anbieter- und Modell-Einstellungen automatisch übernommen, die ursprünglichen V1-Daten bleiben erhalten, aber neue Daten werden nicht zurück synchronisiert, und Backups der beiden Reihen sind nicht kompatibel. Lesen Sie vor dem Update den Abschnitt zur Migration in der Cherry Studio-Dokumentation.

JoinGonka-Schlüssel. Registrieren Sie sich beim Gateway, öffnen Sie im Konto den Bereich „API-Schlüssel“ und klicken Sie auf „Schlüssel erstellen“. Der Schlüssel beginnt mit jg- und wird nur einmal angezeigt – speichern Sie ihn sofort. Praktisch ist ein separater Schlüssel für Cherry Studio: Im Bereich „Nutzung“ erscheint sein Verbrauch als eigene Zeile.

1. Klicken Sie auf das Zahnrad-Symbol – die Einstellungen öffnen sich. Wählen Sie den Bereich Model Provider (in der englischen Dokumentation Model Services genannt).
2. Unterhalb der Anbieterliste klicken Sie auf Add Provider.
3. In V2 öffnet sich der Dialog Add Custom Provider. Tragen Sie unter Provider Name zum Beispiel JoinGonka ein. Im Block Endpoint settings füllen Sie die OpenAI-Zeile mit der Adresse https://gate.joingonka.ai/v1: Unter dem Feld erscheint die Zeile Request path mit dem endgültigen Pfad – er muss auf /v1/chat/completions enden. Fügen Sie im Feld API Key den Wert jg-your-key ein und klicken Sie auf Add.
4. In V1 ist der Dialog kürzer: Anbietername und Provider Type – wählen Sie OpenAI. Schlüssel und Adresse werden erst auf der Anbieterseite eingegeben, in den Feldern API Key und API Host.
5. Vergewissern Sie sich, dass der Anbieter aktiviert ist: Der Schalter befindet sich in der rechten oberen Ecke seiner Seite. In V2 werden neue Anbieter deaktiviert hinzugefügt, und Modelle eines deaktivierten Anbieters erscheinen nicht in den Auswahllisten.

Wie Cherry Studio die Adresse zusammensetzt. Das Feld API Host nimmt die Basisadresse entgegen, den Pfad ergänzt die Anwendung selbst und zeigt das Ergebnis in der Zeile Preview unter dem Feld an. Die Regeln sind in beiden Versionsreihen identisch:

In älteren Anleitungen findet sich noch eine weitere Regel: Ein Schrägstrich am Ende der Adresse soll angeblich /v1 deaktivieren. Sie galt in frühen Versionen bis einschließlich der Reihe 1.6 und wurde in 1.7 entfernt: In aktuellen Builds deaktiviert nur # die automatische Ergänzung.

Der Provider wurde hinzugefügt, ist aber im Chat noch nicht sichtbar: In die Auswahllisten von Cherry Studio gelangen nur die Modelle, die Sie explizit hinzugefügt haben. Es gibt zwei Wege.

Liste vom Server. Klicken Sie auf der Provider-Seite auf Sync models (in V1 Manage, dann Fetch model list). Cherry Studio fragt beim Gateway GET /v1/models ab und zeigt die verfügbaren Modelle des Netzwerks an; fügen Sie die gewünschten Modelle mit der Taste + hinzu. Manuell. Die Taste Add Model öffnet ein Formular, bei dem ein Feld obligatorisch ist – Model ID: Die Kennung muss zeichengenau eingegeben werden.

Die Kosten für alle Netzwerkmodelle sind identisch, fügen Sie also alle hinzu – die Auswahl zwischen ihnen sollte nach Anwendungsfall und nicht nach Budget erfolgen:

Modelltypen. Jedes Modell in der Liste hat eine Einstellungs-Schaltfläche, über die seine Fähigkeiten markiert werden: Vision, Reasoning, Tool usw. Einige Kennzeichnungen setzt Cherry Studio automatisch, für Gateway-Modelle sollten diese jedoch überprüft werden. Vision sollte deaktiviert sein: Die Netzwerkmodelle sind textbasiert. Tool ist erforderlich, wenn Sie MCP-Tools einbinden – nativer Tool-Aufruf wird von allen Modellen in der Tabelle unterstützt. Reasoning ist bei GLM-5.3 Flash angemessen – es ist das Reasoning-Modell des Netzwerks.

Standardmodell. Im Einstellungsbereich Default Model werden die Modelle für Hilfsrollen definiert. Als Hauptmodell für den Assistenten setzen Sie DeepSeek V4 Flash. Für ein schnelles Modell, das Dialogtitel generiert und Suchanfragen vorbereitet, empfiehlt die Cherry Studio-Dokumentation ein leichtes und schnelles Modell, kein Reasoning-Modell – von den Netzwerkmodellen eignet sich MiniMax M2.7 am besten für diese Rolle; verwenden Sie hierfür nicht das GLM-5.3 Flash mit seinen obligatorischen Überlegungen. Für Übersetzungen ist jedes der ersten beiden Modelle geeignet.

Auf der Anbieterseite befindet sich im Schlüsselblock eine Model Check-Schaltfläche (in V1 heißt sie Check direkt neben dem Schlüsselfeld). Wählen Sie ein Modell aus — Cherry Studio sendet eine kurze Testanfrage und zeigt das Ergebnis zusammen mit der Antwortlatenz an. Wenn die Prüfung erfolgreich war, wechseln Sie zum Chat, wählen Sie das Gateway-Modell im Modellauswähler und stellen Sie eine beliebige Frage.

Um sicherzustellen, dass die Anfragen tatsächlich über das Gateway laufen, öffnen Sie dessen Dashboard im Bereich „Nutzung“ (Usage): Im Block „Nach Schlüsseln“ (By keys) erscheinen Anfragen und die Zeit der letzten Nutzung für den Cherry Studio-Schlüssel, im Block „Nach Modellen“ (By models) das ausgewählte Modell. V2 bietet zudem eine eigene Client-Statistik im Einstellungsbereich Usage: Token-Verbrauch und Anfragen nach Anbietern, Modellen und Schlüsseln. Die dortigen Kosten sind nur Referenzwerte — Cherry Studio schätzt diese basierend auf den öffentlichen Preislisten der Modelle und nicht auf den Preisen des Gonka-Netzwerks, daher finden Sie die genauen Beträge im Gateway-Dashboard.

Wenn etwas schiefgelaufen ist, lässt sich die Ursache fast immer an der Antwort ablesen:

Der Client selbst ist kostenlos, Sie zahlen nur für die Inferenz. Über das JoinGonka Gateway kosten Token $0.0069 pro Million Eingabetoken und $0.021 pro Million Ausgabetoken — der Preis ist für alle Modelle im Netzwerk identisch und wird auf dieser Seite aus einer Live-Quelle abgerufen. Der Chat verbraucht deutlich weniger Token als Agenten-Tools, daher sieht die ungefähre Kostenaufstellung für September 2026 wie folgt aus:

Ein wichtiger Hinweis zu langen Dialogen: Mit jeder Antwort sendet der Client dem Modell die gesamte Historie erneut, sodass die hundertste Antwort teurer ist als die erste. Die Lösung: Ein neuer Dialog für jede neue Aufgabe; in Cherry Studio ist das ein einziger Klick.

Modellvergleich in einem Dialog. Cherry Studio kann eine Frage an mehrere Modelle gleichzeitig stellen: Wählen Sie diese im Modell-Umschalter aus, und jedes wird mit einer separaten Anfrage antworten. Bei einem einheitlichen Preis für alle Modelle im Netzwerk ist dies der schnellste Weg, um bei Ihren eigenen Aufgaben festzustellen, wo MiniMax M2.7 ausreicht, wo eine lange Antwort von DeepSeek V4 Flash benötigt wird und wo sich das Reasoning von GLM-5.3 Flash auszahlt – dessen Einstellungen werden im Modell-Review analysiert.

Zweites Protokoll mit demselben Schlüssel. Das Gateway antwortet auch im Anthropic-Format. Im V2-Dialog gibt es dafür eine separate Anthropic-Zeile im Block „Endpoint settings“: Geben Sie dort https://gate.joingonka.ai ein, und in der Zeile „Request path“ sollte der Pfad /v1/messages stehen. In V1 erzielt man dasselbe Ergebnis mit einem separaten Provider mit dem Provider Type Anthropic und derselben Adresse. Unter der Schaltfläche „More options“ in V2 gibt es auch eine Zeile „OpenAI Responses“ – diese wird vom Gateway ebenfalls unterstützt, die Adresse ist dieselbe wie für die OpenAI-Hauptzeile.

Starten von Terminal-Agenten. Auf der Seite „Code CLI“ (in der Dokumentation als „Coding Companion“ bezeichnet) installiert und startet Cherry Studio Konsolen-Agenten, wobei Provider und Modell aus den eigenen Einstellungen übernommen werden; die Liste der Provider dort wird nach dem Protokoll gefiltert, das das jeweilige Tool benötigt. Daher sollte die Anthropic-Adresse im Voraus ausgefüllt werden, wenn Sie von hier aus Claude Code starten möchten. Wie derselbe Agent ohne Vermittler konfiguriert wird, erfahren Sie im Guide Claude Code + Gonka.

Wissensdatenbank. In V2 funktioniert sie auch ohne Embedding-Modell – basierend auf der BM25-Textsuche; mit einem Embedding-Modell wird die hybride Suche aktiviert. Die Modelle des Gonka-Netzwerks sind generativ, daher sollten Sie für den Hybrid-Modus ein Embedding-Modell eines anderen Anbieters wählen, zum Beispiel lokal über Ollama; die Beantwortung der gefundenen Fragmente erfolgt dann durch das Gateway-Modell.

Benötigen Sie einen gemeinsamen Chat für das Team im Browser? Cherry Studio ist ein persönlicher Desktop-Client. Für ein gemeinsames Web-Interface mit Benutzerkonten schauen Sie sich Open WebUI an: Es verbindet sich mit dem Gateway über dieselbe Adresse und denselben Schlüssel.