Come usare GLM-5.2: chat Z.ai, API e Cursor

Che cos'è GLM-5.2

GLM-5.2 è il modello flagship di Z.ai. Puoi incontrarlo in due modi diversi: come chatbot nella chat ufficiale Z.ai, oppure come modello API per sviluppatori. La documentazione lo descrive come text-in/text-out, con contesto da 1M token, output massimo 128K, function calling, structured output, MCP e context caching.

• Se vuoi solo provarlo, parti dalla chat Z.ai.
• Non è un modello vision: per immagini e screenshot serve un passaggio con un altro modello.
• Se vuoi integrarlo in workflow tecnici, usa API, gateway LLM o strumenti di coding agentico.
• Il suo vantaggio emerge quando il task richiede molto contesto e più passaggi verificabili.

Da dove partire

Il primo passo non è installarlo in locale. Se vuoi usarlo come alternativa a Claude o ChatGPT, apri la chat Z.ai e prova richieste reali: un testo da migliorare, un documento da sintetizzare, un problema da ragionare, un pezzo di codice da spiegare. Solo dopo ha senso passare ad API o strumenti developer.

• Provalo prima su task personali o dati non sensibili.
• Confrontalo con Claude o ChatGPT usando gli stessi prompt.
• Controlla qualità della risposta, limiti, velocità e gestione del contesto.
• Passa ad API solo quando vuoi automazioni, integrazioni o misure precise sui costi.

Usarlo come chat

La chat Z.ai è il percorso più vicino all'esperienza ChatGPT o Claude. È il modo giusto per capire se GLM-5.2 ti basta per scrivere, studiare, sintetizzare, ragionare su documenti, fare brainstorming o ricevere aiuto su codice semplice. Non devi ragionare subito in token, endpoint o provider.

• Usa chat.z.ai se vuoi una prova immediata da browser.
• Fai tre confronti: una richiesta di scrittura, una richiesta tecnica e una richiesta lunga con molto contesto.
• Non inviare dati sensibili finché non hai letto termini, privacy e impostazioni dell'account.
• Se la chat ti basta, non ti serve ancora API o Cursor.

Setup diretto con Z.ai

Le API Z.ai diventano interessanti quando vuoi andare oltre la chat. Sono la via più diretta se vuoi usare il provider ufficiale, leggere i prezzi dalla fonte primaria e collegare GLM-5.2 a un prodotto, uno script o un workflow tecnico. La documentazione mostra esempi cURL, SDK ufficiale e OpenAI Python SDK.

• Crea una API key su Z.ai.
• Usa l'endpoint `https://api.z.ai/api/paas/v4/chat/completions`.
• Imposta il modello `glm-5.2`.
• Configura `thinking`, `reasoning_effort`, `max_tokens` e streaming in base al task.

curl -X POST "https://api.z.ai/api/paas/v4/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $ZAI_API_KEY" \
  -d '{
    "model": "glm-5.2",
    "messages": [
      { "role": "user", "content": "Analizza questo modulo e proponi un piano di refactor verificabile." }
    ],
    "thinking": { "type": "enabled" },
    "reasoning_effort": "max",
    "max_tokens": 4096
  }'

Setup rapido con OpenRouter

OpenRouter è spesso il modo più comodo per provare GLM-5.2 senza sposare subito un solo provider. Usi una chiave, un endpoint compatibile e un catalogo che include anche altri modelli. Questo è utile se vuoi confrontare GLM con Claude, GPT, Kimi o modelli più economici sullo stesso task.

• Crea una API key OpenRouter e carica pochi crediti per il pilot.
• Usa il modello `z-ai/glm-5.2` quando chiami l'API.
• Mantieni separato il budget del test rispetto ai provider principali.
• Controlla provider finale, logging e policy dati prima di inviare codice sensibile.

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://openrouter.ai/api/v1",
  apiKey: process.env.OPENROUTER_API_KEY,
});

const completion = await client.chat.completions.create({
  model: "z-ai/glm-5.2",
  messages: [
    { role: "user", content: "Trova i rischi principali in questo piano di migrazione API." },
  ],
});

console.log(completion.choices[0]?.message?.content);

Usarlo in Cursor o in un agente CLI

Il valore pratico arriva quando GLM-5.2 entra nel tuo ambiente di lavoro. In Cursor puoi ragionare in termini di provider custom o endpoint compatibile OpenAI. In un agente CLI puoi creare un profilo dedicato e confrontarlo con il provider che usi già. L'obiettivo non è cambiare tutto, ma avere un modello economico e lungo per task adatti.

• Usa GLM-5.2 per refactor, audit e task con molto contesto.
• Usa Claude, GPT o un modello vision per planning critico, screenshot e review finale se servono.
• Tieni un profilo GLM separato per misurare costo e qualità.
• Non mischiare dati sensibili nel primo pilot.

Quando usarlo davvero

GLM-5.2 è più interessante quando vuoi ridurre dipendenza e costo dei modelli premium senza rinunciare a un modello forte. Per uso quotidiano, confrontalo con Claude e ChatGPT su task reali. Per sviluppo software, diventa ancora più interessante quando il task è lungo e sfrutta contesto, caching e reasoning.

• Scrittura, sintesi e brainstorming nella chat Z.ai.
• Analisi di documenti lunghi quando non servono funzioni vision.
• Audit tecnico di una codebase.
• Refactor multi-file con vincoli espliciti.
• Migrazione API o SDK adaptation.

Quando non è la scelta giusta

Non usare GLM-5.2 come scorciatoia universale. I benchmark sono un segnale, ma non sostituiscono una prova sul tuo workflow. Se il task richiede visione, compliance chiara, supporto enterprise o massima affidabilità su codice critico, serve un controllo più severo o un modello già approvato dal team.

• Hai screenshot, immagini o UI visuale senza un passaggio vision separato.
• Stai lavorando su dati cliente, segreti o repository non autorizzati.
• Ti serve un provider già approvato legalmente e contrattualmente.
• Il task è piccolo e il costo di setup supera il vantaggio.
• Non hai test o criteri per capire se la risposta è corretta.

Pilot consigliato

Il modo più sano di provarlo è scegliere un task già risolto o facilmente verificabile. Chiedi prima un piano, poi una patch, poi verifica con test o review. Alla fine confronta GLM-5.2 con il tuo modello abituale su qualità, tempo, costo e interventi manuali.

• Task: refactor piccolo ma multi-file.
• Input: requisiti, file interessati, vincoli e test.
• Output atteso: piano, patch, comandi eseguiti e rischi residui.
• Baseline: stesso task con Claude, Codex, Cursor o Kimi.
• Decisione: tenerlo solo se riduce costo o migliora autonomia senza aumentare review.

Domande frequenti