Puoi eseguire GLM-5.2 in Claude Code già da oggi e la configurazione richiede circa due minuti. Claude Code संवादa con qualsiasi endpoint che supporti la Messages API di Anthropic, e Zhipu offre esattamente questo per GLM — punta Claude Code a z.ai e hai finito. Ci sono due modi per iniziare: un'app switcher con un clic (la più semplice, e ti permette di tornare a Claude in qualsiasi momento), oppure un file di configurazione modificato manualmente. Questa guida copre entrambe le soluzioni, su macOS, Windows e Linux, oltre a come tornare a Claude quando ne hai bisogno.
Il modo più veloce: CC Switch
Se stai già gestendo più di un provider, salta la configurazione manuale e usa CC Switch (open-source, con licenza MIT, Windows/macOS/Linux). È un'app desktop che gestisce le configurazioni dei provider per Claude Code, Codex, Gemini CLI e alcune altre CLI, così non devi modificare manualmente il JSON.
1. Installa CC Switch da ccswitch.io o dal suo repository GitHub. Fai clic sul pulsante arancione + nell'angolo in alto a destra della finestra principale per aprire Add Provider, quindi seleziona la scheda Claude Provider. 2. Digita zhipu nella ricerca dei preset. Appaiono due preset — Zhipu GLM (endpoint della Cina continentale) e Zhipu GLM en. Al di fuori della Cina continentale, scegli Zhipu GLM en per l'endpoint internazionale.
3. Scorri verso il basso e incolla la tua chiave API z.ai nel campo API Key. Il preset compila automaticamente il resto: formato Anthropic Messages (Native), campo di autenticazione ANTHROPIC_AUTH_TOKEN e l'URL base.
4. In Model Mapping, imposta il modello richiesto per ogni ruolo — Sonnet, Opus, Fable e Haiku — su glm-5.2, così ogni richiesta viene instradata a GLM indipendentemente dal tier a cui Claude Code si rivolge. Seleziona la casella 1M su un ruolo per dichiarare a Claude Code il contesto da un milione di token. Salva.
5. Tornate all'elenco dei provider, fate clic su Enable nella voce Zhipu GLM (un provider esistente come Claude Official può rimanere nell'elenco per poter tornare indietro in seguito), quindi riavviate Claude Code per assicurarvi che rilevi il nuovo provider. Eseguite /status per confermare che il modello mostri glm-5.2.
Perché darsi pena con l'app invece di una configurazione statica: include preset per la maggior parte dei provider che vorresti provare — Kimi, MiniMax, MiMo, Qwen, DeepSeek e altri — quindi per ciascuno basta un preset e una chiave invece di riscrivere la configurazione, e passare da uno all'altro (o tornare a Claude) richiede un paio di clic. Questa è la base pratica del flusso di lavoro ibrido qui sotto.
Configurazione manuale con settings.json
Preferisci configurarlo da solo, oppure impostare una macchina CI senza GUI? Modifica direttamente il file.
1. Ottieni una chiave API dalla console API di Z.AI. Funzionano sia una chiave pay-as-you-go sia una chiave di abbonamento GLM Coding Plan. 2. Unisci questo blocco env al file delle impostazioni di Claude Code (conserva eventuali chiavi esistenti — non sovrascrivere l'intero file). Il blocco è identico su ogni piattaforma; cambia solo il percorso: - macOS / Linux: ~/.claude/settings.json - Windows: %USERPROFILE%\.claude\settings.json
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.z.ai/api/anthropic",
"ANTHROPIC_AUTH_TOKEN": "your_zai_api_key",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-5.2",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-5.2",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-5.2",
"API_TIMEOUT_MS": "3000000"
}
}3. Riavvia Claude Code, quindi esegui /status. La riga del modello dovrebbe mostrare glm-5.2 (o glm-5.2[1m] per la variante da un milione di token). Se mostra ancora un modello Claude, il file non è stato rilevato — controlla la presenza di errori di sintassi JSON e verifica il percorso.
Due alternative basate su shell, se preferisci non modificare il file:
macOS / Linux — esporta le variabili (bash/zsh) per una sessione una tantum, poi avvia:
export ANTHROPIC_BASE_URL="https://api.z.ai/api/anthropic"
export ANTHROPIC_AUTH_TOKEN="your_zai_api_key"
export ANTHROPIC_DEFAULT_OPUS_MODEL="glm-5.2"
export ANTHROPIC_DEFAULT_SONNET_MODEL="glm-5.2"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="glm-5.2"
claudeChiudi il terminale e torni alla tua configurazione normale.
Windows — imposta le variabili d’ambiente utente persistenti in PowerShell, quindi riavvia il terminale:
setx ANTHROPIC_BASE_URL "https://api.z.ai/api/anthropic"
setx ANTHROPIC_AUTH_TOKEN "your_zai_api_key"
setx ANTHROPIC_DEFAULT_OPUS_MODEL "glm-5.2"
setx ANTHROPIC_DEFAULT_SONNET_MODEL "glm-5.2"
setx ANTHROPIC_DEFAULT_HAIKU_MODEL "glm-5.2"Le variabili ANTHROPIC_DEFAULT_* rimappano i ruoli del modello verso cui Claude Code indirizza le richieste — Opus, Sonnet e Haiku (le versioni più recenti aggiungono un ruolo Fable, che anche CC Switch espone). Impostandole tutte su glm-5.2 si invia ogni richiesta a GLM; se preferisci mantenere le attività in background economiche e veloci, punta invece lo slot Haiku su glm-4.5-air. Usa glm-5.2[1m] per la finestra completa da un milione di token. Il lungo API_TIMEOUT_MS conta più di quanto sembri: le risposte di GLM spesso sono più lente di quelle di Claude e il timeout predefinito interromperà le generazioni lunghe.
Quale percorso: nativo z.ai, un proxy o il Piano Coding?
Tre modi pratici per integrare GLM-5.2 in Claude Code, e non sono intercambiabili.
endpoint nativo z.ai (consigliato). L'URL https://api.z.ai/api/anthropic sopra. Parla il protocollo Anthropic, quindi Claude Code si connette senza middleware — la scelta predefinita.
Un proxy di traduzione. Altri host (Fireworks, NVIDIA NIM, pesi self-hosted) servono GLM-5.2 tramite un API compatibile con OpenAI che Claude Code non può leggere direttamente, quindi hanno bisogno di un proxy che converta i formati. claude-code-router gestisce questo. Ne vale la pena solo se hai già crediti o hardware su una di quelle piattaforme.
Abbonamento GLM Coding Plan. Un piano mensile fisso (a partire da $18/mese, sulla pagina di abbonamento di z.ai) che utilizza lo stesso endpoint z.ai ma fattura una tariffa fissa invece che per token. Se programmi ogni giorno in Claude Code, un abbonamento è di solito più economico e più prevedibile dei token a consumo; fai il calcolo rispetto alla tua spesa mensile in token per trovare il punto di pareggio. Se il tuo utilizzo è irregolare, il pay-as-you-go conviene.
Passaggio tra GLM-5.2 e Claude
Claude Code utilizza un solo provider attivo alla volta, quindi *passi* da uno all'altro invece di suddividere gli slot: esegui GLM-5.2 per il volume di routine e abilita il tuo provider Claude Official in CC Switch quando hai bisogno di Claude per l'architettura, codice sensibile alla sicurezza o revisione. Qualsiasi endpoint compatibile con Anthropic funziona per il lato Claude — il tuo account Anthropic, oppure un relay come AIReiter, una delle varie opzioni. Per il routing automatico per richiesta tra provider, un gateway come claude-code-router gestisce l'instradamento.
Risoluzione dei problemi
Sintomo | Probabile causa | Correzione |
|---|---|---|
| settings.json non caricato | Verifica che il JSON sia valido; conferma di aver modificato |
errore | ID del modello errato (sensibile alle maiuscole/minuscole) | Usa esattamente |
401 / autenticazione fallita | Disallineamento tra chiave/endpoint | Non associare una chiave OpenRouter con l'URL z.ai; rigenera la chiave se necessario |
Le generazioni lunghe vengono interrotte | Timeout troppo basso | Imposta |
Le chiamate agli strumenti falliscono o entrano in loop | JSON dello strumento non valido | Riduci i subagent paralleli; riprova; semplifica l'istruzione |
Domande frequenti
GLM-5.2 è gratuito in Claude Code?
Non in modo illimitato, però z.ai ha effettuato finestre gratuite a tempo limitato su GLM-5.2, e il Coding Plan parte da $18/mese. Anche alle tariffe complete pay-as-you-go ($1.40 / $4.40 per milione), un uso leggero costa pochi centesimi.
GLM-5.2 supporta il contesto da 1M token in Claude Code?
Sì. Imposta l'ID del modello su glm-5.2[1m] invece di glm-5.2 nelle tue variabili ANTHROPIC_DEFAULT_* e Claude Code utilizza la finestra da un milione di token.
GLM-5.2 o Claude sono migliori per programmare in Claude Code?
Per modifiche di routine e sequenziali, la differenza di prezzo rende GLM-5.2 la scelta predefinita razionale. Claude tende a prevalere nell’architettura multi-step, nei lavori sensibili alla sicurezza e nei workflow di subagent ad alta concorrenza. La configurazione di switching ti consente di usare ciascuno dove è più forte, invece di sceglierne uno solo.
Posso usare GLM-5.2 in strumenti diversi da Claude Code?
Sì. Lo stesso endpoint z.ai e le stesse chiavi funzionano con altre CLI agentiche — OpenCode, Cline e Kilo Code accettano tutti un URL base personalizzato, e CC Switch gestisce i preset per diversi di essi.
Ho bisogno di un abbonamento Claude a pagamento per usare GLM-5.2 in Claude Code?
No. Claude Code è solo il client; una volta che lo punti a z.ai, la fatturazione è di z.ai, non di Anthropic. Ti serve un account Claude solo se mantieni Claude disponibile come provider a cui passare.
Devo riavviare Claude Code dopo aver cambiato provider in CC Switch?
Secondo la documentazione di CC Switch, Claude Code supporta il cambio rapido dei dati del provider senza dover riavviare, mentre la maggior parte degli altri strumenti CLI richiede invece il riavvio del terminale o dell'app. In pratica, riavviare Claude Code è il modo più affidabile per essere sicuri che un cambio abbia avuto effetto.
Come posso tornare a Claude (accesso ufficiale) in CC Switch?
Aggiungi un provider ufficiale Claude dall'elenco predefinito, abilitalo, quindi esegui una volta il normale flusso di logout / login (OAuth) di Claude Code. Dopodiché potrai passare liberamente dal tuo accesso ufficiale Claude ai provider di terze parti come z.ai.
CC Switch è gratuito e sicuro da usare?
Sì — è open-source con licenza MIT ed è gratuito. Le tue configurazioni risiedono localmente in un database SQLite con scritture atomiche e, per progettazione, apporta modifiche minime alla configurazione di ciascun tool, così le tue CLI continuano a funzionare normalmente anche se disinstalli l'app.