Collega Cherry Studio a Claude

Cherry Studio è un client desktop ben organizzato per conversare con molti modelli e supporta direttamente il formato nativo di Anthropic. Aggiungendo il gateway AI Prime Tech come provider di tipo Anthropic, puoi usare Claude nella stessa finestra di tutti gli altri modelli che utilizzi, con un solo host e una sola chiave.

Apri Servizi modelli

Vai in Impostazioni e apri Servizi modelli. Qui Cherry Studio elenca tutti i provider con cui può comunicare e ti permette di aggiungerne di nuovi. Premi il pulsante più per aggiungere un provider: ti verrà chiesto di specificarne il tipo.

La scelta del tipo è importante perché determina il formato di comunicazione. Per Claude sul gateway, scegli il tipo Anthropic, che usa l'interfaccia nativa /v1/messages anziché un endpoint in stile OpenAI.

Poiché Cherry Studio organizza i provider in un elenco, il gateway compare accanto agli altri servizi che hai configurato e puoi passare dall'uno all'altro per ogni conversazione. Questo lo rende un ambiente comodo per un gateway multimodello: una sola voce del provider può includere diversi modelli Claude, che puoi selezionare dal menu secondo necessità. È proprio la possibilità di gestire il gateway come una voce fra le altre a rendere Cherry Studio una comoda postazione di controllo per più modelli. Puoi cambiare provider per ogni conversazione senza uscire dall'app.

Scegli il tipo Anthropic

Seleziona Anthropic come tipo di provider e abilitalo. Cherry Studio mostra quindi due campi che determinano tutta la configurazione: Chiave API e Host API. Incolla la chiave del gateway nel campo della chiave.

Poiché il tipo è Anthropic nativo, Cherry Studio invierà le richieste nel formato Messages che il gateway supporta per Claude. Una volta impostato il tipo, non devi preoccuparti di un'impostazione separata per il protocollo.

Se il gateway espone anche un'interfaccia compatibile con OpenAI per altri modelli, aggiungili come provider separato di tipo OpenAI anziché inserirli in questo. Dedicare la voce di tipo Anthropic a Claude mantiene inequivocabile il formato di comunicazione ed evita confusione tra protocolli. Mantenere i protocolli in voci separate dei provider è un piccolo accorgimento che evita molta confusione in seguito. Ogni voce avrà così un solo formato di comunicazione da considerare.

Imposta correttamente l'host API

Host API è il campo che più spesso viene compilato in modo errato. Inserisci solo l'URL radice dell'host, senza /v1 alla fine, perché Cherry Studio aggiunge autonomamente il percorso della versione. Aggiungere /v1 manualmente genera un percorso duplicato e causa il fallimento della richiesta.

Il valore è quindi semplicemente l'host del gateway. Se hai riscontrato errori 404 o errori di percorso dopo aver aggiunto un provider, la causa è quasi sempre un /v1 superfluo nel campo Host API.

Una barra finale nell'host causa lo stesso tipo di problema, quindi inserisci soltanto l'host, senza nulla dopo. Quando una richiesta fallisce, la verifica più rapida consiste nel rileggere il campo Host API e rimuovere tutto ciò che segue il nome dell'host prima di cercare altrove. Quando qualcosa non funziona, controllare prima questo singolo campo risolve immediatamente la maggior parte dei problemi di configurazione. Il valore da inserire è un host senza alcun suffisso.

Blocco dell'URL con il cancelletto finale

Cherry Studio supporta un accorgimento semplice ma importante: termina il valore di Host API con un # e il client userà quell'URL esatto senza aggiungere nulla. In questo modo puoi imporre un endpoint preciso quando l'aggiunta automatica crea problemi.

Per un gateway standard, di solito lasci soltanto l'host e permetti a Cherry Studio di aggiungere il percorso. Usa # solo quando il gateway richiede un percorso preciso che l'aggiunta automatica altererebbe.

Vale la pena ricordare # proprio perché il suo uso non è intuitivo: è la soluzione per qualsiasi gateway il cui percorso non corrisponda a quello previsto per impostazione predefinita da Cherry Studio. Se il percorso /v1/messages aggiunto automaticamente non coincide con quello atteso dal gateway, # ti permette di specificare manualmente l'URL completo. Memorizzare ora questo accorgimento ti consentirà di riconoscere subito la soluzione se un percorso dovesse risultare errato. È l'unica impostazione di override che gestisce qualsiasi percorso non standard del gateway.

Scegli un modello e avvia una chat

Aggiungi i modelli Claude che desideri sotto il provider, usando gli ID disponibili sul gateway, come claude-sonnet-4-5 per le conversazioni quotidiane e claude-opus-4-8 per il ragionamento più complesso. Compariranno quindi nel menu dei modelli di Cherry Studio.

Avvia una conversazione, seleziona un modello Claude dal menu e inizierai a comunicare con il gateway. Poiché il provider usa il formato nativo di Anthropic, le funzionalità che dipendono dal formato Messages si comportano come previsto.

Puoi tenere aperte contemporaneamente diverse conversazioni con modelli Claude differenti, una possibilità utile per confrontare il modo in cui Sonnet e Opus gestiscono lo stesso prompt. Poiché passano tutti attraverso lo stesso provider del gateway, per cambiare modello basta una scelta nel menu, senza riconfigurare nulla. Confrontare i modelli fianco a fianco è uno dei piccoli piaceri di far passare tutto attraverso un unico provider. Per provare lo stesso prompt con Sonnet e Opus basta cambiare la selezione nel menu.

# Cherry Studio -> Settings -> Model Services -> + Add
# Provider type: Anthropic   (native /v1/messages)
# API Key:  <your gateway key>
# API Host: https://aiprimetech.io        (root only, NO /v1 -- it auto-appends)
#   end with #  ->  https://aiprimetech.io#   to lock the exact URL
# Model: claude-sonnet-4-5

Domande frequenti

AI Prime Tech è un gateway API indipendente. Non è affiliato ad Anthropic, non è approvato da Anthropic e non è un suo rivenditore. Claude e i nomi dei modelli correlati sono marchi dei rispettivi proprietari.