Trae + JoinGonka Gateway — modelli della rete Gonka in AI-IDE

Build e versione. Trae ha due rami: internazionale (documentazione su docs.trae.ai) e cinese (docs.trae.cn). Il modulo Custom Model è presente in entrambi ed è strutturato allo stesso modo; variano i modelli integrati e il set di preset nelle impostazioni aggiuntive. L'indirizzo di richiesta personalizzato per il proprio modello è supportato dalla versione 3.5.51 del 14 aprile 2026 — se la tua build è più vecchia, aggiornala. La build internazionale non è disponibile in tutti i paesi: prima dell'installazione controlla l' elenco dei paesi e regioni supportati.

Sistema. macOS 12 e versioni successive, Windows 10 o 11 (x64), Linux in pacchetti .deb e .rpm. Al primo avvio Trae ti chiederà di scegliere tema e lingua, importare le impostazioni da VS Code o Cursor e accedere al tuo account.

Chiave JoinGonka. Registrati sul gateway, apri la sezione "API-keys" nel pannello di controllo e clicca su "Create Key". La chiave inizia con jg- e viene mostrata una sola volta — salvala immediatamente. È comodo creare una chiave separata per Trae: nella sezione "Usage" il suo consumo sarà visibile su una riga separata.

Piano Trae. Il tuo modello deve essere selezionato manualmente nell'elenco dei modelli, e nella tabella dei piani di Trae per il piano gratuito nella riga di selezione del modello figura solo la modalità Auto — in essa i propri modelli non vengono utilizzati. La documentazione non specifica chiaramente se questa limitazione si applichi ai modelli aggiunti tramite chiave personalizzata. La regola pratica è semplice: se nel tuo piano l'Auto Mode nell'elenco dei modelli può essere disattivata, sei pronto; in caso contrario, avrai bisogno di un piano a pagamento.

1. Apri Settings → Models, il pannello di gestione dei modelli.
2. Clicca su Add Model. Nella finestra che si apre scegli l'opzione Custom Model, non un provider dall'elenco predefinito.
3. Compila i campi con i valori della tabella. Le colonne sono due, una per ciascun formato API: scegline una.
4. Clicca su Add Model. Trae effettuerà una chiamata di prova all'API e verificherà la chiave: in caso di successo il modello comparirà nell'elenco, in caso di errore la finestra mostrerà un messaggio di errore e il log della risposta del provider.

Gli altri campi non dipendono dal formato:

Quale formato scegliere. Inizia con OpenAI Chat Completions: è il percorso principale del gateway e la maggior parte degli strumenti lo utilizza. Anthropic Messages è utile se sei abituato a questo formato in altri strumenti o se vuoi confrontare il comportamento dell'agente su due protocolli: chiave e saldo sono gli stessi.

Come funziona Full URL. L'interruttore decide chi aggiunge il percorso. Disattivato: tu fornisci l'indirizzo di base e Trae aggiunge il percorso in base al formato scelto: /chat/completions all'indirizzo con /v1 per OpenAI e /v1/messages alla radice per Anthropic. Attivato: l'indirizzo viene usato così com'è e deve contenere il percorso completo. L'errore più frequente è mescolare le modalità: inserire il percorso completo con l'interruttore disattivato o l'indirizzo di base con l'interruttore attivato.

Una voce, un modello. Ripeti i passaggi per gli altri modelli della rete, così da poter passare dall'uno all'altro senza tornare nelle impostazioni: deepseek-ai/DeepSeek-V4-Flash-0731, MiniMaxAI/MiniMax-M2.7 e zai-org/GLM-5.3-Flash. L'elenco aggiornato è fornito da GET https://gate.joingonka.ai/v1/models. Il modello aggiunto può poi essere modificato, disattivato (rimarrà nel pannello ma sparirà dall'elenco in chat) o eliminato.

Sotto i campi principali c'è un elenco comprimibile Advanced Settings. Non è necessario modificarlo — Trae inserirà i valori predefiniti — ma due impostazioni vale la pena definire consapevolmente: la serie del modello e la finestra di contesto.

Il prezzo dei modelli di rete è lo stesso, quindi la scelta dipende dal comportamento. Tutti i modelli nella tabella supportano il tool calling nativo, su cui si basa il lavoro degli agenti Trae.

Il funzionamento del budget di ragionamento e il motivo per cui non bisogna limitare eccessivamente il limite di uscita dei modelli di ragionamento sono analizzati nella recensione di GLM-5.3 Flash; il confronto dei modelli su attività di sviluppo si trova nell'articolo sui migliori modelli per il codice.

I tuoi modelli risiedono nell'elenco generale: fai clic sul nome del modello corrente nell'angolo in basso a destra del campo di input della chat e seleziona quello aggiunto. Nello stesso posto si trova l'interruttore Auto Mode — deve essere disattivato: in modalità Auto, Trae sceglie autonomamente un modello da quelli integrati e non utilizza quelli aggiunti da te.

Dai all'agente un compito che richieda uno strumento, ad esempio: "Leggi package.json ed elenca gli script di build". L'agente dovrebbe aprire il file e rispondere nel merito; ciò significa che il ciclo "richiesta - chiamata strumento - risposta" attraverso il gateway è configurato correttamente. Successivamente, apri il pannello del gateway, sezione "Utilizzo": nel blocco "Per chiavi", appariranno le richieste e l'ora dell'ultimo accesso per la chiave Trae; nel blocco "Per modelli", apparirà il modello selezionato.

Se qualcosa è andato storto, controlla il testo dell'errore. Trae non nasconde la risposta del tuo modello: mostra l'errore del provider così com'è, con il proprio codice 4028.

L'agente nell'IDE consuma token più velocemente della chat: in ogni richiesta vengono inviate istruzioni di sistema, descrizione degli strumenti, file aperti e cronologia dei passaggi. Pertanto, il prezzo per token determina se è possibile eseguire l'agente per ogni minima cosa o se è necessario risparmiare.

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 riportato su questa pagina da una fonte in tempo reale. L'ordine degli importi basato sui prezzi di settembre 2026 è:

Il confronto con Trae stesso è chiaro, perché esistono modelli aperti anche tra quelli integrati e Trae pubblica il loro listino prezzi per milione di token. DeepSeek-V4-Flash e MiniMax-M2.7 costano lì $0.30 in ingresso e $1.20 in uscita, mentre GLM-5.3 Flash non è affatto presente nell'elenco integrato della versione internazionale. Tramite il gateway, la differenza per gli stessi modelli è di circa ×43 in ingresso e ×58 in uscita.

Il tuo modello funziona dove c'è un elenco di modelli. Questo include chat e agenti, sia in modalità IDE che in SOLO (i modelli personalizzati sono supportati dalla versione 3.3.0). L'autocompletamento e la previsione delle modifiche sono un meccanismo separato CUE con il proprio pannello di impostazioni: non c'è scelta del modello al suo interno, e i suoi limiti sono definiti dal piano tariffario di Trae.

Strumenti e MCP. Gli agenti di Trae agiscono come client MCP e i server collegati rimangono disponibili per l'agente sul proprio modello: tutti i modelli della rete supportano la chiamata nativa agli strumenti. Se Trae comunica che lo schema degli argomenti dello strumento non è compatibile con il modello (codice 4027), prova un altro modello della rete o un altro server MCP.

TraeWork. Nell'applicazione separata TraeWork, il modulo per aggiungere il proprio modello è lo stesso, ma, secondo la documentazione, funziona solo in TraeWork Desktop e solo per attività in ambiente locale.

Plugin per altri editor. Nella documentazione del plugin TraeCode per VS Code e JetBrains non c'è una sezione dedicata ai modelli personalizzati: questa guida si riferisce all'IDE desktop. Se rimani su VS Code, lo stesso gateway si collega tramite estensioni per agenti, ad esempio Cline.

Privacy. L'impostazione Privacy Mode (Settings → Account) controlla cosa fa Trae con le tue conversazioni e i frammenti di codice: con questa attiva, non vengono inviati ad analisi o addestramento. Dal lato del gateway, le conversazioni non vengono archiviate: i prompt e le risposte non rimangono sul server dopo la risposta, nel pannello di controllo sono visibili solo i contatori di richieste e token.

Se hai bisogno di lavorare con le immagini — layout, screenshot di errori — assegna questo compito al modello integrato dotato di visione, mentre codice, comandi e file lasciali al modello della rete: il passaggio richiede un solo clic nell'elenco dei modelli.