Sezioni dell'archivio conoscenza ▾

Strumenti

Strumenti

ZCode: inferenza GLM economica al posto del GLM Coding Plan

A giugno 2026 Z.ai ha rilasciato ZCode 3.0 — un ambiente di sviluppo agentico desktop, che l'azienda stessa definisce «Official Harness for GLM-5.2». Il prodotto ha rapidamente attirato l'attenzione: core agentico proprietario, attività autonome tramite /goal, modalità multi-agent e gestione remota delle sessioni direttamente da Telegram. Ma insieme all'ondata di recensioni è arrivata un'ondata di domande dai primi abbonati al GLM Coding Plan: la quota viene conteggiata come «prompts» in finestre di cinque ore, nelle ore di punta il consumo viene moltiplicato per tre, nei piani base c'è una sola richiesta parallela, e su Hacker News ci si lamenta di blocchi improvvisi dopo una giornata intensa di lavoro.

La buona notizia: ZCode supporta ufficialmente il custom provider — è possibile collegare qualsiasi API compatibile con OpenAI o Anthropic e pagare per i token effettivi, non per le quote di abbonamento. In questa guida vedremo cos'è ZCode e come funziona il GLM Coding Plan, per poi configurare passo dopo passo ZCode sul JoinGonka Gateway — il gateway della rete decentralizzata Gonka, nel cui registro è già stata aggiunta GLM-5.2. Risultato: lo stesso strumento, gli stessi modelli open-weight, ma un'economia basata sui token, centinaia di volte più economica delle API centralizzate.

Cos'è ZCode: ambiente di sviluppo agentico di Z.ai

ZCode non è un «editor con barra laterale per chat», ma un ADE: descrivi un obiettivo, l'agente crea un piano, modifica i file, esegue controlli e itera fino al risultato. Funziona come applicazione desktop su macOS e Windows (build per Linux in stato beta).

Caratteristiche chiave della versione 3.0:

  • ZCode Agent — core agentico proprietario con profonda integrazione di GLM-5.2; oltre a questo è possibile collegare agenti di terze parti (Claude Code, Codex, Gemini CLI e altri);
  • Modalità Goal (/goal) — attività autonome lunghe: piano → esecuzione → verifica passo dopo passo;
  • Multi-agent — lavoro parallelo di diversi agenti su un progetto;
  • Gestione remota — avvio e controllo delle sessioni da Telegram, WeChat e Feishu: l'agente lavora sulla tua macchina e tu rispondi alle domande dal telefono.

Il client è gratuito, ai nuovi utenti Z.ai assegna una quota giornaliera di token GLM-5.2 per testare il prodotto. Dopodiché, o si sottoscrive il GLM Coding Plan, o si usa la propria API-key. Ed è qui che bisogna entrare nei dettagli, perché il sistema di abbonamento è la parte più discussa del prodotto.

GLM Coding Plan: prezzo, limiti e quote

Il GLM Coding Plan è l'abbonamento Z.ai che dà accesso ai modelli GLM in ZCode e in due dozzine di strumenti terzi. Al momento della pubblicazione (luglio 2026) la struttura base è la seguente — ma prezzi e promozioni cambiano, verificate la pagina live z.ai/subscribe:

PianoPrezzo $/meseQuotaRichieste parallele
Lite$18 (in promozione da ~$12.6)«Prompts» in finestre da 5 ore + tetto settimanale1
Pro$72×4 rispetto a Lite1
Max$160×16 rispetto a Litefino a 30

Di cosa si lamentano gli abbonati (thread su Hacker News e GitHub):

  • Moltiplicatore di punta. Nelle ore di punta (14:00—18:00 UTC+8 — sera in Asia, mattina-pomeriggio in Europa) ogni richiesta scala la quota con un coefficiente ×3, fuori ora di punta — ×2. Bisogna pianificare il consumo secondo il fuso orario di Pechino.
  • Quota a «prompts», non a token. Quanti token rimangono è poco chiaro; nei thread si trovano storie del tipo «ho consumato ~17M di token su GLM — e ho ricevuto un blocco di quattro giorni».
  • Una sola richiesta parallela su Lite e Pro. Per un ambiente agentico questo è significativo: la modalità multi-agent di ZCode e qualsiasi sotto-agente parallelo finiscono in coda.
  • GLM-5.2 consuma la quota più velocemente dei modelli minori — il flagship erode il limite con il proprio moltiplicatore.

Conclusione semplice: per uno sviluppo in solitaria tranquillo, l'abbonamento funziona onestamente. Ma più la tua modalità è «agentica» — attività parallele, sessioni autonome lunghe, esecuzioni notturne — più il modello a quote si trasforma in una lotteria. L'alternativa è il pagamento per i token effettivi: senza finestre, moltiplicatori o code — quanto l'agente ha consumato, tanto è stato addebitato. È esattamente il modello offerto dal meccanismo custom provider integrato in ZCode, e si configura in cinque minuti.

BYOK in ZCode: la tua API-key e il custom provider

ZCode include ufficialmente il supporto nativo per BYOK: la documentazione consente esplicitamente di aggiungere "qualsiasi servizio compatibile con i protocolli OpenAI o Anthropic", inclusi API pubbliche, canali aziendali e persino installazioni self-hosted. Si configura in tre modi:

  • pulsante Connect nella welcome-screen → «Set Your API Key»;
  • Manage Models nel selettore del modello;
  • icona ingranaggio → Settings → Model Settings → Add Provider.

Al provider si assegnano OpenAI Base URL e/o Anthropic Base URL più la API Key; ZCode caricherà automaticamente l'elenco dei modelli disponibili.

I tre errori più comuni:

  • Gli endpoint di Z.ai differiscono. L'abbonamento Coding Plan funziona solo tramite il coding-endpoint https://api.z.ai/api/coding/paas/v4; il generico /api/paas/v4 con una chiave in abbonamento restituirà un errore: è la classica causa del "ricevo 401/429, anche se il piano è pagato".
  • "Funziona in Claude Code ≠ funziona in ZCode". Le variabili d'ambiente come ANTHROPIC_BASE_URL, utilizzate per configurare Claude Code, non vengono lette da ZCode: ha un proprio sistema di archiviazione delle impostazioni dei provider. Configurate direttamente nelle Settings.
  • "Il modello è visibile nel selettore ≠ la chiave ha credito". L'elenco dei modelli viene estratto dall'API del provider, ma la disponibilità dipende dal saldo e dai limiti della specifica chiave.

Ora passiamo alla pratica: colleghiamo ZCode al gateway JoinGonka e otteniamo lo stack GLM pagando per token.

Configurazione JoinGonka Gateway in ZCode: GLM pagando per token

JoinGonka Gateway è il gateway verso la rete decentralizzata Gonka con due protocolli nativi: OpenAI-compatible /v1/chat/completions e Anthropic Messages /v1/messages. Per ZCode questo significa: connessione diretta in entrambi i campi custom provider, senza strati di proxy. Il modello economico è pay-per-token: nessuna finestra di 5 ore, moltiplicatori di picco ×3 e nessun limite di richiesta parallela; il consumo è visibile nella dashboard in tempo reale e il gateway non archivia il contenuto dei prompt.

PassaggioAzione
1. ChiaveRegistratevi su gate.joingonka.ai/register (i nuovi account ricevono 10M di token gratuiti), create un'API-key nella sezione Keys. Maggiori dettagli sulle chiavi e sulla prima richiesta in API Quick Start.
2. ProviderZCode → Settings → Model Settings → Add Provider (o Connect → «Set Your API Key» sulla welcome-screen).
3. OpenAI Base URLhttps://gate.joingonka.ai/v1
4. Anthropic Base URLhttps://gate.joingonka.ai (il client aggiungerà automaticamente l'endpoint /v1/messages)
5. API Keyla vostra chiave del tipo jg-…
6. ModelloSelezionate dall'elenco caricato: oggi sono moonshotai/Kimi-K2.6 e MiniMaxAI/MiniMax-M2.7; dopo l'attivazione del GLM-5.2 in lista apparirà zai-org/GLM-5.2-FP8.

Verifica: ponete all'agente qualsiasi domanda. Se la risposta arriva, tutto funziona; errore 401: controllate la chiave, 402: controllate il saldo del conto.

Confronto prezzi: Coding Plan, Z.ai API, OpenRouter e Gonka

Quanto costa il GLM-inference su diversi canali (prezzi per 1M di token; per i competitor fissati a luglio 2026, il prezzo JoinGonka viene inserito in pagina direttamente dall'API del gateway):

CanaleInput, $/1MOutput, $/1MModello di pagamento
Z.ai API (GLM-5.2)$1.40 (cached input — $0.26)$4.40da token
GLM Coding Plan$18—160/meseabbonamento: quote in "prompt", moltiplicatore ×3 ai picchi, limiti di parallelismo
OpenRouter (z-ai/glm-5.2)$0.93$3.00da token; variante gratuita di GLM-5.2 non disponibile
JoinGonka Gateway$0.003$0.009da token, rete Gonka

La differenza di due o tre ordini di grandezza non è un arrotondamento di marketing, ma un'economia diversa: i calcoli sono eseguiti dai partecipanti alla rete decentralizzata che guadagnano dal lavoro stesso, non dal margine del data center. Un'analisi dettagliata di come funziona e quali sono i limiti di applicabilità è presente nell'articolo sul più economico AI API.

Nota doverosa sul GLM-5.2: il prezzo esatto del modello verrà impostato dalla rete al momento dell'attivazione (nella tabella sopra è indicato il prezzo live corrente dei modelli di rete). Le cifre in questa pagina si aggiornano automaticamente, non dovrete ricalcolare nulla manualmente.

GLM-5.2 nella rete Gonka: status e domande frequenti

Il modello zai-org/GLM-5.2-FP8 è stato aggiunto al registro on-chain della rete Gonka: la configurazione imposta una finestra di contesto fino a 400K token e il modello è di tipo pesante (richiede oltre un terabyte di VRAM per replica). È attualmente in fase di rollout: i nodi della rete stanno effettuando il caricamento dei pesi (warm-up). Non appena i controlli saranno positivi, il modello apparirà automaticamente nell'elenco dei modelli del gateway: il base URL e la chiave non cambiano, in ZCode basterà selezionarlo dal menu a tendina.

Info sul modello: pesi aperti sotto licenza MIT, architettura MoE da ~750B di parametri (circa 40B attivi per token), finestra nativa fino a 1M di token. Secondo Z.ai, su SWE-bench Pro il modello ottiene 62.1 — un punteggio superiore a GPT-5.5, mentre su FrontierSWE è dietro a Claude Opus 4.8 di circa l'1%. Per un modello open-weight, si tratta del primo posto nel coding.

Domande frequenti:

  • Perché subito dopo l'attivazione di un nuovo modello si ricevono errori 429? — È la fase di rollout: parte dei nodi sta ancora caricando i pesi. Ripeti la richiesta dopo alcuni secondi: il bilanciatore troverà un nodo attivo.
  • Cosa è disponibile oggi? — Kimi K2.6 e MiniMax M2.7: entrambi i modelli funzionano in ZCode tramite lo stesso custom provider, la configurazione descritta in questa guida è già pienamente operativa.
  • Com'è gestita la privacy? — Il gateway non archivia il contenuto di prompt e risposte; nelle statistiche vengono riportati solo i dati aggregati del consumo.
  • Quando conviene il Coding Plan? — Se lavori in solitaria, rientri nella quota Lite e non esegui agenti in parallelo, l'abbonamento con tariffa fissa è comodo e prevedibile. Fai i tuoi calcoli in base al tuo profilo: con un uso intensivo di agenti, pagare i token tramite la rete costa ordini di grandezza in meno, mentre per piccole modifiche al codice un paio di volte al giorno la differenza potrebbe essere impercettibile.
  • È compatibile con altri strumenti? — Sì: lo stesso endpoint funziona con Claude Code, Cursor, Cline e qualsiasi client compatibile con OpenAI/Anthropic.
ZCode 3.0 è un'IDE basata su agenti notevole, ma il suo abbonamento nativo GLM Coding Plan è basato su quote: "prompt" limitati in finestre di 5 ore, moltiplicatore ×3 nelle ore di punta e una sola richiesta parallela nei piani base. Più è intenso il carico agentico, più il costo diventa elevato e imprevedibile. Il BYOK ufficiale risolve il problema: connetti JoinGonka Gateway come custom provider e paghi per i token effettivi alle tariffe della rete decentralizzata Gonka, centinaia di volte più economiche delle API centralizzate. GLM-5.2 è già nel registro di rete e apparirà automaticamente nel tuo selettore modelli, mentre Kimi K2.6 e MiniMax M2.7 sono già disponibili. Inizia con 10M di token gratuiti.

Vuoi saperne di più?

Esplora altre sezioni o inizia a guadagnare GNK subito.

Ottieni 10M di token gratuiti →