Warp + JoinGonka Gateway — agent terminal sul proprio endpoint

Chiave JoinGonka. Registrati sul gateway, apri la sezione "Chiavi API" nel tuo profilo e clicca su "Crea chiave". La chiave inizia con jg- e viene mostrata una sola volta: salvala subito. È comodo creare una chiave separata per Warp: in questo modo, nella sezione "Utilizzo", il consumo dell'agent da terminale sarà visibile separatamente rispetto ad altri strumenti.

Piano Warp. Il proprio endpoint non è disponibile solo nei piani a pagamento; le condizioni dipendono dalle dimensioni del team:

Indirizzo HTTPS pubblico. È un requisito di Warp non sempre ovvio: le richieste al tuo endpoint non vengono inviate dall'applicazione sul tuo PC, ma dai server di Warp, quindi l'indirizzo deve essere raggiungibile da Internet. localhost, 127.0.0.1 e gli indirizzi di rete privata vengono rifiutati dal modulo, ed è ammesso solo lo schema https://. JoinGonka Gateway è un servizio HTTPS pubblico, quindi tunnel come ngrok, suggeriti nella documentazione di Warp per i modelli locali, non sono necessari qui.

Versione aggiornata dell'app. Il proprio endpoint è incluso nella build stabile dal rilascio del 20 maggio 2026, la selezione dello schema API nel modulo è apparsa nel rilascio del 31 luglio 2026. Se il campo API schema non è presente nel modulo, aggiorna Warp.

Tutta la configurazione si fa dall'interfaccia dell'app: niente modifiche manuali ai file.

1. Apri Settings e digita inference endpoint nella ricerca delle impostazioni: Warp ti porterà al blocco con le chiavi dei provider e i tuoi endpoint (si trova nella pagina delle impostazioni di Warp Agent).
2. Clicca Add custom endpoint: si apre il modulo.
3. Compila i campi con i valori della tabella e clicca Add endpoint.

Il pulsante + Add model aggiunge la riga successiva. Configura subito tutte le modelle della rete, così potrai passare dall'una all'altra senza tornare nelle impostazioni: deepseek-ai/DeepSeek-V4-Flash-0731, MiniMaxAI/MiniMax-M2.7 e zai-org/GLM-5.3-Flash. L'elenco aggiornato è sempre disponibile con GET https://gate.joingonka.ai/v1/models. Copia gli identificativi carattere per carattere: il modulo verifica solo il formato dell'indirizzo e che i campi siano compilati, non fa una richiesta di prova al salvataggio, quindi un refuso nel nome della modella salterà fuori solo durante la conversazione con l'agente.

Dopo il salvataggio, le modelle compaiono nel selettore dell'agente. Se come predefinita era rimasta una delle modelle di Warp, l'app potrebbe proporti di cambiarla: accetta e scegli la modella del tuo endpoint. Dettaglio importante: le voci Auto nel selettore girano sempre sull'infrastruttura di Warp e consumano i suoi crediti, anche con un endpoint configurato. Perché la richiesta arrivi al gateway, nel selettore dev'essere scelta una modella specifica del tuo elenco.

Seleziona nel selettore il modello del tuo endpoint e assegna all'agente un compito breve, ad esempio: «Mostra i cinque file più grandi nella directory corrente e spiega il comando». L'agente dovrebbe suggerire il comando, eseguirlo previa autorizzazione e commentare l'output.

Ora apri il pannello del gateway, sezione «Usage». Nel blocco «By keys», per la chiave configurata in Warp, appariranno le richieste e l'orario dell'ultima interazione; nel blocco «By models» apparirà il modello selezionato. Se i contatori aumentano, significa che l'inference avviene tramite JoinGonka Gateway e non a spese dei crediti Warp. Da parte sua, Warp mostra il consumo di token direttamente nella chat con l'agente, sotto i nomi brevi (alias) che hai impostato.

Se qualcosa non va, la causa è solitamente leggibile nella risposta:

La prima risposta della sessione potrebbe arrivare con un ritardo di alcuni secondi: l'agente invia un ampio system prompt con la descrizione degli strumenti, e la richiesta attraversa prima i server Warp e poi il nodo della rete. Successivamente la conversazione sarà più fluida.

Il prezzo dei modelli di rete è identico, quindi la scelta riguarda il comportamento, non il budget. Il terminal agent legge molto (output di comandi, log, file) e richiama costantemente strumenti; tutti i modelli nella tabella supportano il native tool calling.

Schema pratico: DeepSeek V4 Flash come modello principale, MiniMax M2.7 per le piccole cose, GLM-5.3 Flash quando l'attività si basa sulla logica e non sul volume. Lo switch richiede un secondo perché tutti i modelli sono già impostati nell'endpoint e i nomi brevi dal campo alias aiutano a non confondersi con gli identificativi lunghi. Maggiori dettagli sul più popolare nel review di DeepSeek V4 Flash.

Il consumo di token dell'agent nel terminale è superiore a quello della chat: a ogni richiesta Warp aggiunge istruzioni di sistema, contesto della conversazione e descrizione degli strumenti, e un'attività consiste in diversi passaggi. Pertanto, il prezzo per token qui è più importante che nella corrispondenza normale.

Tramite JoinGonka Gateway i token costano $0.0069 per milione in entrata e $0.021 per milione in uscita — il prezzo è uguale per tutti i modelli di rete e viene fornito su questa pagina da una fonte in tempo reale. Ordine di grandezza dei prezzi a settembre 2026:

Per confronto, tre modi per pagare l'agent Warp:

Warp stesso per singoli utenti e team fino a 10 persone non addebita crediti per il lavoro tramite il proprio endpoint — paghi solo i token sul gateway. Il saldo viene ricaricato nel pannello, dove sono visibili anche il resto e il consumo per giorni e modelli.

Per la maggior parte degli strumenti, un endpoint personalizzato significa «le richieste vanno direttamente dalla mia macchina al provider». Con Warp è diverso: la parte di esecuzione dell'agente funziona sui server Warp e l'endpoint personalizzato modifica solo la destinazione finale e la chiave. Secondo la documentazione di Warp, il percorso della richiesta è il seguente:

1. L'applicazione prende l'indirizzo dell'endpoint e la chiave dal deposito sicuro sul dispositivo e li invia ai server Warp insieme al tuo prompt.
2. L'agente lato Warp raccoglie la richiesta completa — istruzioni di sistema, contesto della conversazione, strumenti — e chiama il tuo endpoint con quella chiave.
3. La risposta viene restituita all'applicazione tramite streaming attraverso gli stessi server.

Cosa significa questo nella pratica:

• Chiave. Viene memorizzata solo sul dispositivo. Passa attraverso i server Warp a ogni richiesta, ma, secondo Warp, non viene salvata lì: viene utilizzata al momento e poi scartata.
• Prompt e risposte. Transitano attraverso il backend di Warp. Warp dichiara di non utilizzare questi contenuti per l'addestramento, mentre l'archiviazione e l'analisi sono soggette alle impostazioni di privacy e telemetria del tuo account. La garanzia ZDR, che si applica ai modelli di Warp, non può essere estesa all'endpoint personalizzato: ciò che viene conservato dipende dal provider scelto.
• Lato gateway. JoinGonka Gateway non conserva le conversazioni: i prompt e le risposte non rimangono sul gateway dopo la risposta; nel pannello di controllo sono visibili solo i contatori delle richieste e dei token.
• Cosa rimane sull'infrastruttura Warp. Le opzioni Auto, i router di modelli personalizzati, il Codebase Context, i suggerimenti Active AI e gli agenti cloud non sono influenzati dall'endpoint personalizzato.

Se per le tue attività il percorso attraverso server terzi non è accettabile, utilizza un agente che si colleghi all'endpoint direttamente dalla tua macchina, ad esempio Codex CLI o qualsiasi strumento della guida rapida alle API. Warp stessa, nell'annuncio, promette anche un'opzione lato client: un modulo agente leggero in Rust in un repository open source, che si connetterà ai modelli locali senza passare per i server Warp, oltre al supporto per l'Agent Client Protocol. Dalla release del 2 settembre 2026, le descrizioni degli endpoint sono memorizzate in un file di configurazione in un formato comune all'applicazione e al Warp Agent CLI; le chiavi non vengono salvate in questo file e rimangono nel deposito sicuro.