Cherry Studio + JoinGonka Gateway — AI client desktop

Installazione. Le build per tutti i sistemi sono sulla pagina delle release del progetto: installer e build portatile per Windows, immagine dmg per macOS, AppImage, deb e rpm per Linux — per x64 e ARM. La cronologia delle conversazioni e le impostazioni sono memorizzate localmente, sulla tua macchina.

V1 o V2. Ad agosto 2026 è uscita la linea V2 con una nuova struttura dei dati e impostazioni riprogettate; l'ultima build della linea precedente è la 1.9.13. Il provider personalizzato è presente in entrambe, cambiano il formato di aggiunta e alcune etichette — quei punti sono segnalati più sotto. Passando da V1 a V2 le impostazioni dei provider e dei modelli vengono trasferite automaticamente, i dati originali V1 vengono conservati, ma i nuovi dati non vengono sincronizzati all'indietro, e i backup delle due linee sono incompatibili. Prima di aggiornare, leggi la sezione sulla migrazione nella documentazione di Cherry Studio.

Chiave JoinGonka. Registrati sul gateway, apri nella dashboard la sezione «API-keys» e premi «Crea chiave». La chiave inizia con jg- e viene mostrata una sola volta — salvala subito. È comodo creare una chiave separata per Cherry Studio: nella sezione «Utilizzo» la sua spesa sarà visibile su una riga separata.

1. Clicca l'icona dell'ingranaggio — si aprono le impostazioni. Scegli la sezione Model Provider (nella documentazione in inglese si chiama Model Services).
2. Sotto l'elenco dei provider clicca Add Provider.
3. In V2 si apre la finestra Add Custom Provider. Inserisci il Provider Name — ad esempio JoinGonka. Nel blocco Endpoint settings compila la riga OpenAI con l'indirizzo https://gate.joingonka.ai/v1: sotto il campo comparirà la riga Request path con il percorso finale — deve terminare con /v1/chat/completions. Nel campo API Key incolla jg-your-key e clicca Add.
4. In V1 la finestra è più corta: nome del provider e Provider Type — scegli OpenAI. La chiave e l'indirizzo si inseriscono nella pagina del provider, nei campi API Key e API Host.
5. Verifica che il provider sia attivo: l'interruttore si trova nell'angolo in alto a destra della sua pagina. In V2 i nuovi provider vengono aggiunti disattivati, e i modelli di un provider disattivato non compaiono negli elenchi di selezione.

Come Cherry Studio compone l'indirizzo. Il campo API Host accetta l'indirizzo di base, mentre il percorso lo aggiunge l'app da sola e mostra il risultato nella riga Preview sotto il campo. Le regole sono identiche in entrambe le linee:

Nelle vecchie istruzioni si trova ancora un'altra regola: la barra finale dell'indirizzo disattiverebbe /v1. Valeva nelle prime versioni, fino alla linea 1.6 inclusa, ed è stata rimossa nella 1.7: nelle build attuali solo # disattiva l'inserimento automatico.

Il provider è stato aggiunto, ma nella chat non è ancora visibile: Cherry Studio include nell'elenco di selezione solo i modelli aggiunti esplicitamente. Ci sono due modi.

Elenco dal server. Nella pagina del provider clicca su Sync models (nella V1 su Manage, poi Fetch model list). Cherry Studio richiederà al gateway GET /v1/models e mostrerà la composizione attiva della rete; aggiungi i modelli desiderati con il pulsante +. Manualmente. Il pulsante Add Model apre un modulo dove è obbligatorio un campo — Model ID: l'identificatore deve essere inserito carattere per carattere.

Il prezzo dei modelli di rete è identico, quindi aggiungili tutti — dovrai scegliere tra loro in base al comportamento, non al budget:

Tipi di modello. Ogni modello nell'elenco ha un pulsante di impostazioni dove vengono segnate le sue capacità: Vision, Reasoning, Tool e altre. Cherry Studio imposta alcuni indicatori automaticamente, ma per i modelli del gateway vanno controllati. Vision deve essere disattivato: i modelli di rete sono testuali. Tool è necessario se colleghi strumenti MCP — la chiamata nativa agli strumenti è supportata da tutti i modelli nella tabella. Reasoning è appropriato per il GLM-5.3 Flash, essendo il modello di reasoning della rete.

Modello predefinito. Nella sezione delle impostazioni Default Model si definiscono i modelli per i ruoli di servizio. Imposta il DeepSeek V4 Flash come modello principale dell'assistente. Per un modello rapido che genera titoli alle conversazioni e prepara query di ricerca, la documentazione di Cherry Studio consiglia un modello leggero e veloce, non di reasoning — tra i modelli di rete, il MiniMax M2.7 è il più adatto, mentre il GLM-5.3 Flash, con il suo ragionamento obbligatorio, non è consigliato qui. Per la traduzione, va bene uno qualsiasi dei primi due.

Nella pagina del provider, nel blocco della chiave, è presente il pulsante Model Check (nella V1 è Check accanto al campo della chiave). Seleziona un modello: Cherry Studio invierà una breve richiesta di prova e mostrerà il risultato insieme alla latenza. Se il controllo è superato, vai in chat, seleziona il modello del gateway nel selettore e poni qualsiasi domanda.

Per assicurarti che le richieste passino effettivamente attraverso il gateway, apri la sua dashboard, sezione "Utilizzo": nel blocco "Per chiavi" vedrai apparire le richieste e l'orario dell'ultimo accesso per la chiave Cherry Studio, mentre nel blocco "Per modelli" vedrai il modello selezionato. Nella V2 è presente anche una statistica client dedicata, nella sezione impostazioni Usage: token e richieste per provider, modelli e chiavi. Il costo visualizzato è puramente informativo, poiché Cherry Studio lo stima basandosi sui listini pubblici dei modelli e non sui prezzi della rete Gonka, quindi verifica gli importi esatti nella dashboard del gateway.

Se qualcosa non funziona, la causa è quasi sempre indicata nella risposta:

Il client stesso è distribuito gratuitamente, paghi solo per l'inference. Tramite JoinGonka Gateway i token costano $0.0069 per milione in ingresso e $0.021 per milione in uscita; il prezzo è identico per tutti i modelli della rete e viene prelevato in questa pagina da una fonte in tempo reale. La chat consuma token in modo significativamente inferiore rispetto agli strumenti agentici, quindi l'ordine di grandezza dei costi a settembre 2026 è il seguente:

Nota importante sui dialoghi lunghi: a ogni battuta il client invia al modello l'intera cronologia, quindi la centesima battuta costa più della prima. Il rimedio è un nuovo dialogo per un nuovo compito; in Cherry Studio è un solo pulsante.

Confronto tra modelli in un'unica chat. Cherry Studio permette di porre la stessa domanda a più modelli contemporaneamente: basta selezionarli nel selettore dei modelli e ciascuno risponderà con una richiesta separata. Grazie al prezzo unico per tutti i modelli della rete, questo è il modo più rapido per capire quali attività richiedono MiniMax M2.7, dove è necessaria la risposta lunga di DeepSeek V4 Flash e dove invece si giustifica il ragionamento di GLM-5.3 Flash — le cui impostazioni sono spiegate nella recensione del modello.

Secondo protocollo con la stessa chiave. Il gateway risponde anche nel formato Anthropic. Nel dialogo V2, è presente una riga Anthropic separata nel blocco Endpoint settings: inserisci lì https://gate.joingonka.ai e nella riga Request path dovrebbe apparire il percorso /v1/messages. Nella V1, lo stesso risultato si ottiene tramite un provider separato con Provider Type impostato su Anthropic e lo stesso indirizzo. Sotto il pulsante More options nella V2 è presente anche la riga OpenAI Responses — il gateway gestisce anche quella, con lo stesso indirizzo della riga principale OpenAI.

Esecuzione di agenti da terminale. Nella pagina Code CLI (Coding Companion nella documentazione), Cherry Studio installa ed esegue agenti da console, inserendo il provider e il modello dalle proprie impostazioni; l'elenco dei provider viene filtrato in base al protocollo richiesto dallo specifico strumento. Pertanto, è consigliabile inserire l'indirizzo Anthropic in anticipo se si intende eseguire Claude Code da qui. Per configurare lo stesso agente senza intermediari, consulta la guida Claude Code + Gonka.

Knowledge Base. Nella V2 funziona anche senza un modello di embedding, utilizzando la ricerca testuale BM25; con un modello di embedding, viene attivata la ricerca ibrida. I modelli della rete Gonka sono generativi, quindi per la modalità ibrida occorre utilizzare un modello di embedding di un altro provider, ad esempio uno locale tramite Ollama; la risposta in base ai frammenti trovati sarà comunque fornita dal modello del gateway.

Ti serve una chat condivisa per il team nel browser? Cherry Studio è un client desktop personale. Per un'interfaccia web condivisa con account utente, dai un'occhiata a Open WebUI: si connette al gateway con lo stesso indirizzo e la stessa chiave.