Cherry Studio + JoinGonka Gateway — desktopowy klient AI

Instalacja. Kompilacje dla wszystkich systemów znajdziesz na stronie wydań projektu: instalator i wersja przenośna dla Windows, obraz dmg dla macOS, AppImage, deb i rpm dla Linuksa — na x64 i ARM. Historia rozmów i ustawienia są przechowywane lokalnie, na Twoim komputerze.

V1 czy V2. W sierpniu 2026 ukazała się linia V2 z nową strukturą danych i przebudowanymi ustawieniami; ostatnia kompilacja poprzedniej linii to 1.9.13. Własny dostawca jest w obu, różnią się forma dodawania i część opisów — poniżej takie miejsca są oznaczone. Przy przejściu z V1 ustawienia dostawców i modeli przenoszą się automatycznie, dane źródłowe V1 są zachowywane, ale nowe dane nie synchronizują się z powrotem, a kopie zapasowe obu linii są niekompatybilne. Przed aktualizacją przeczytaj sekcję o migracji w dokumentacji Cherry Studio.

Klucz JoinGonka. Zarejestruj się w bramie, otwórz w panelu sekcję „Klucze API” i kliknij „Utwórz klucz”. Klucz zaczyna się od jg- i jest pokazywany tylko raz — zapisz go od razu. Warto założyć osobny klucz dla Cherry Studio: w sekcji „Użycie” jego zużycie będzie widoczne w osobnym wierszu.

1. Kliknij ikonę zębatki — otworzą się ustawienia. Wybierz sekcję Model Provider (w angielskiej dokumentacji nazywa się Model Services).
2. Pod listą dostawców kliknij Add Provider.
3. W V2 otworzy się okno Add Custom Provider. Wpisz Provider Name — na przykład JoinGonka. W bloku Endpoint settings w polu OpenAI wpisz adres https://gate.joingonka.ai/v1: pod polem pojawi się wiersz Request path z docelową ścieżką — musi kończyć się na /v1/chat/completions. W polu API Key wklej jg-your-key i kliknij Add.
4. W V1 okno jest krótsze: nazwa dostawcy i Provider Type — wybierz OpenAI. Klucz i adres wprowadza się już na stronie dostawcy, w polach API Key i API Host.
5. Upewnij się, że dostawca jest włączony: przełącznik znajduje się w prawym górnym rogu jego strony. W V2 nowi dostawcy dodawani są wyłączeni, a modele wyłączonego dostawcy nie pojawiają się na listach wyboru.

Jak Cherry Studio składa adres. Pole API Host przyjmuje adres bazowy, a ścieżkę aplikacja dopisuje sama i pokazuje wynik w wierszu Preview pod polem. Zasady są takie same w obu liniach:

W starych instrukcjach można spotkać jeszcze jedną zasadę: ukośnik na końcu adresu rzekomo wyłącza /v1. Działała ona we wczesnych wersjach, aż do linii 1.6 włącznie, i została usunięta w 1.7: w aktualnych buildach automatyczne podstawianie wyłącza tylko #.

Dostawca został dodany, ale w czacie go jeszcze nie widać: na listy wyboru Cherry Studio trafiają tylko te modele, które dodałeś jawnie. Są na to dwa sposoby.

Lista z serwera. Na stronie dostawcy kliknij Sync models (w V1 — Manage, następnie Fetch model list). Cherry Studio zapyta bramkę o GET /v1/models i pokaże aktualny skład sieci; dodaj potrzebne modele przyciskiem +. Ręcznie. Przycisk Add Model otwiera formularz, w którym obowiązkowe jest jedno pole — Model ID: identyfikator wpisuje się znak w znak.

Cena modeli sieci jest taka sama, więc dodaj wszystkie — wybierać między nimi będziesz musiał według zachowania, a nie budżetu:

Typy modelu. Każdy model na liście ma przycisk ustawień, gdzie zaznacza się jego możliwości: Vision, Reasoning, Tool i inne. Część oznaczeń Cherry Studio stawia automatycznie, ale dla modeli bramki warto je sprawdzić. Vision powinien być odznaczony: modele sieci są tekstowe. Tool jest potrzebny, jeśli podłączasz narzędzia MCP — natywne wywoływanie narzędzi obsługują wszystkie modele z tabeli. Reasoning jest odpowiedni dla GLM-5.3 Flash — to model sieci typu reasoning.

Model domyślny. W sekcji ustawień Default Model przypisuje się modele do ról systemowych. Jako główny model asystenta ustaw DeepSeek V4 Flash. Dla szybkiego modelu, który wymyśla tytuły dialogów i przygotowuje zapytania wyszukiwania, dokumentacja Cherry Studio zaleca lekki i szybki model, nie reasoning — z modeli sieci do tej roli najlepiej nadaje się MiniMax M2.7, a GLM-5.3 Flash z jej obowiązkowymi rozumowaniami tu nie ustawiaj. Do tłumaczenia nada się każdy z pierwszych dwóch.

Na stronie dostawcy w bloku klucza znajduje się przycisk Model Check (w V1 — Check obok pola klucza). Wybierz model — Cherry Studio wyśle do niego krótkie zapytanie próbne i wyświetli wynik wraz z opóźnieniem odpowiedzi. Jeśli sprawdzenie przebiegło pomyślnie, przejdź do czatu, wybierz model bramy w przełączniku modeli i zadaj dowolne pytanie.

Aby upewnić się, że zapytania przechodzą przez bramę, otwórz jej panel, sekcję „Użycie” (Usage): w bloku „Według kluczy” dla klucza Cherry Studio pojawią się zapytania i czas ostatniego użycia, a w bloku „Według modeli” — wybrany model. W V2 dostępna jest również własna statystyka klienta, sekcja ustawień Usage: tokeny i zapytania według dostawców, modeli i kluczy. Koszt jest tam poglądowy — Cherry Studio szacuje go na podstawie publicznych cenników modeli, a nie cen sieci Gonka, więc dokładne kwoty należy sprawdzać w panelu bramy.

Jeśli coś poszło nie tak, przyczynę prawie zawsze można odczytać z odpowiedzi:

Sam klient jest dostępny za darmo, płacisz tylko za inferencję. Przez JoinGonka Gateway tokeny kosztują $0.0069 za milion na wejściu i $0.021 za milion na wyjściu — cena jest taka sama dla wszystkich modeli w sieci i jest pobierana na tej stronie z aktywnego źródła. Czat zużywa tokeny znacznie skromniej niż narzędzia agentskie, dlatego orientacyjne kwoty na wrzesień 2026 wyglądają następująco:

Ważna uwaga dotycząca długich dialogów: z każdą repliką klient wysyła modelowi całą historię od nowa, więc setna replika kosztuje więcej niż pierwsza. Rozwiązanie — nowy dialog dla nowego zadania; w Cherry Studio to tylko jeden przycisk.

Porównanie modeli w jednym oknie czatu. Cherry Studio potrafi zadać jedno pytanie wielu modelom jednocześnie: wybierz je w przełączniku modeli, a każdy odpowie osobnym zapytaniem. Przy jednolitej cenie wszystkich modeli w sieci jest to najszybszy sposób, aby sprawdzić w swoich zadaniach, gdzie wystarcza MiniMax M2.7, gdzie potrzebna jest długa odpowiedź DeepSeek V4 Flash, a gdzie opłacają się rozumowania GLM-5.3 Flash — ich ustawienia zostały opisane w przeglądzie modelu.

Drugi protokół tym samym kluczem. Brama odpowiada również w formacie Anthropic. W oknie dialogowym V2 znajduje się dla niego osobna linia Anthropic w bloku Endpoint settings: wpisz tam https://gate.joingonka.ai, a w linii Request path ścieżka powinna wynosić /v1/messages. W V1 ten sam rezultat daje osobny dostawca z Provider Type Anthropic i tym samym adresem. Pod przyciskiem More options w V2 znajduje się również linia OpenAI Responses — brama również ją obsługuje, adres jest taki sam jak w głównej linii OpenAI.

Uruchamianie agentów terminalowych. Na stronie Code CLI (w dokumentacji — Coding Companion) Cherry Studio instaluje i uruchamia agentów konsolowych, podstawiając im dostawcę i model z własnych ustawień; lista dostawców jest tam filtrowana według protokołu wymaganego przez konkretne narzędzie. Dlatego adres Anthropic warto wypełnić wcześniej, jeśli zamierzasz uruchamiać stąd Claude Code. Jak skonfigurować tego samego agenta bez pośredników — w przewodniku Claude Code + Gonka.

Baza wiedzy. W V2 działa ona również bez modelu embeddingowego — na wyszukiwaniu tekstowym BM25, a z modelem embeddingowym włącza się wyszukiwanie hybrydowe. Modele sieci Gonka są generatywne, więc dla trybu hybrydowego należy użyć modelu embeddingowego od innego dostawcy, na przykład lokalnie przez Ollama; odpowiadać na podstawie znalezionych fragmentów będzie przy tym model bramy.

Potrzebujesz wspólnego czatu dla zespołu w przeglądarce? Cherry Studio to osobisty klient stacjonarny. Aby uzyskać wspólny interfejs internetowy z kontami użytkowników, sprawdź Open WebUI: łączy się on z bramą przy użyciu tego samego adresu i klucza.