Come usare GLM-5.2 in Claude Code: guida completa alla configurazione

Usare GLM-5.2 in Claude Code richiede circa due minuti. Claude Code può collegarsi a qualsiasi endpoint compatibile con la Messages API di Anthropic, e Zhipu offre proprio questa compatibilità per GLM: basta puntare il client a z.ai. Puoi farlo in due modi: con un'app che gestisce il cambio di provider in un clic, la soluzione più semplice se vuoi poter tornare a Claude in qualsiasi momento, oppure modificando manualmente un file di configurazione. Qui trovi entrambe le procedure per macOS, Windows e Linux, incluso il passaggio di nuovo a Claude.

Configurazione rapida con CC Switch

Se usi già più provider, evita di modificare JSON a mano e prova CC Switch: è un'app desktop open source con licenza MIT, disponibile per Windows/macOS/Linux. Gestisce le configurazioni dei provider per Claude Code, Codex, Gemini CLI e altri strumenti da riga di comando.

1. Installa CC Switch da ccswitch.io oppure dal suo repository GitHub. Nella finestra principale, premi il pulsante arancione + in alto a destra per aprire Add Provider, quindi seleziona la scheda Claude Provider.
2. Cerca zhipu tra i preset. Compariranno due opzioni: Zhipu GLM, per l'endpoint della Cina continentale, e Zhipu GLM en. Se ti trovi fuori dalla Cina continentale, scegli Zhipu GLM en per usare l'endpoint internazionale.

1. Scorri verso il basso e incolla la tua chiave API z.ai nel campo API Key. Il preset completa automaticamente gli altri parametri: formato Anthropic Messages (Native), campo di autenticazione ANTHROPIC_AUTH_TOKEN e URL di base.
2. Nella sezione Model Mapping, imposta glm-5.2 come modello richiesto per ogni ruolo — Sonnet, Opus, Fable e Haiku — così tutte le richieste verranno inviate a GLM, indipendentemente dal tier scelto da Claude Code. Seleziona la casella 1M per un ruolo per dichiarare a Claude Code il contesto da un milione di token. Salva la configurazione.

1. Torna all'elenco dei provider e fai clic su Enable accanto a Zhipu GLM. Puoi lasciare nell'elenco un provider esistente, come Claude Official, per tornare a Claude in seguito. Riavvia quindi Claude Code per assicurarti che rilevi il nuovo provider. Esegui /status e verifica che il modello indicato sia glm-5.2.

Rispetto a una configurazione statica, l'app ha un vantaggio pratico: include preset per gran parte dei provider che potresti voler provare — Kimi, MiniMax, MiMo, Qwen, DeepSeek e altri. Invece di riscrivere la configurazione, basta scegliere un preset e inserire la chiave; passare da uno all'altro, o tornare a Claude, richiede pochi clic. È la base operativa del flusso di lavoro ibrido descritto più avanti.

Configurazione manuale in settings.json

Preferisci gestire tutto in autonomia, oppure stai configurando una macchina CI senza interfaccia grafica? Puoi modificare direttamente il file.

1. Recupera una chiave API dalla console API di Z.AI. Funzionano sia una chiave pay-as-you-go sia una chiave associata a un abbonamento GLM Coding Plan.
2. Integra questo blocco env nel file delle impostazioni di Claude Code, mantenendo le chiavi già presenti senza sovrascrivere l'intero file. Il blocco è identico su tutte le piattaforme: cambia soltanto 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"
  }
}

1. Riavvia Claude Code, poi esegui /status. La riga del modello dovrebbe mostrare glm-5.2, oppure glm-5.2[1m] per la variante con contesto da un milione di token. Se appare ancora un modello Claude, il file non è stato caricato: controlla la sintassi JSON e verifica il percorso.

Se preferisci non modificare il file, puoi usare due alternative basate sulla shell:

• macOS / Linux — esporta le variabili per una singola sessione bash/zsh, poi avvia il client:

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"
claude

Chiudi il terminale e tornerai alla configurazione abituale.

• Windows — imposta le variabili d'ambiente utente permanenti 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 modello a cui Claude Code invia le richieste: Opus, Sonnet e Haiku. Le versioni più recenti aggiungono anche il ruolo Fable, esposto da CC Switch. Impostandole tutte su glm-5.2, ogni richiesta viene inviata a GLM; se invece vuoi mantenere economiche e veloci le attività in background, puoi assegnare glm-4.5-air allo slot Haiku. Per la finestra completa da un milione di token usa glm-5.2[1m]. Il valore elevato di API_TIMEOUT_MS è più importante di quanto sembri: le risposte di GLM sono spesso più lente di quelle di Claude e il timeout predefinito può interrompere le generazioni più lunghe.

Endpoint z.ai, proxy o Coding Plan: quale scegliere

Esistono tre modi pratici per portare GLM-5.2 in Claude Code, ma non sono equivalenti.

Endpoint nativo z.ai (consigliato). Usa l'URL https://api.z.ai/api/anthropic indicato sopra. Parla il protocollo Anthropic, quindi Claude Code si collega senza middleware: è la scelta predefinita.

Proxy di conversione. Altri host, come Fireworks, NVIDIA NIM o pesi self-hosted, espongono GLM-5.2 tramite API compatibili con OpenAI, che Claude Code non può leggere direttamente. Serve quindi un proxy che converta i formati. claude-code-router può occuparsene. Ha senso solo se possiedi già crediti o hardware su una di queste piattaforme.

Abbonamento GLM Coding Plan. È un piano mensile a tariffa fissa, a partire da $18/month secondo la pagina abbonamenti di z.ai, che usa lo stesso endpoint z.ai ma applica un costo fisso invece della fatturazione per token. Se programmi ogni giorno con Claude Code, un abbonamento è in genere più economico e prevedibile dei token a consumo; confronta la spesa mensile in token per trovare il punto di pareggio. Se il tuo utilizzo è discontinuo, il pay-as-you-go conviene di più.

Passare da GLM-5.2 a Claude e viceversa

Claude Code usa un solo provider attivo alla volta: non puoi dividere gli slot, devi cambiare provider. Puoi usare GLM-5.2 per il lavoro ordinario ad alto volume e attivare il provider Claude Official in CC Switch quando ti serve Claude per architettura, codice sensibile dal punto di vista della sicurezza o revisioni. Per il lato Claude funziona qualsiasi endpoint compatibile con Anthropic: il tuo account Anthropic oppure un relay come AIReiter, una delle diverse opzioni disponibili. Se vuoi instradare automaticamente ogni richiesta tra provider differenti, un gateway come claude-code-router gestisce la distribuzione.

Risoluzione dei problemi

Domande frequenti

GLM-5.2 è gratuito in Claude Code?

Non senza limiti, anche se z.ai ha offerto finestre gratuite a tempo limitato per GLM-5.2 e il Coding Plan parte da $18/month. Persino alle tariffe pay-as-you-go complete, pari a $1.40 / $4.40 per milione, un utilizzo leggero costa pochi centesimi.

GLM-5.2 supporta il contesto da 1M token in Claude Code?

Sì. Nelle variabili ANTHROPIC_DEFAULT_*, imposta l'ID modello su glm-5.2[1m] anziché glm-5.2: Claude Code userà la finestra da un milione di token.

Per programmare in Claude Code è meglio GLM-5.2 o Claude?

Per modifiche ordinarie e sequenziali, la differenza di prezzo rende GLM-5.2 la scelta razionale predefinita. Claude tende a essere superiore nell'architettura multi-step, nel lavoro sensibile per la sicurezza e nei flussi con subagent ad alta concorrenza. La configurazione per il passaggio tra provider permette di usare ciascun modello dove dà il meglio, senza doverne scegliere uno solo.

Posso usare GLM-5.2 anche con strumenti diversi da Claude Code?

Sì. Lo stesso endpoint z.ai e le stesse chiavi funzionano con altri CLI agentici: OpenCode, Cline e Kilo Code accettano tutti un URL di base personalizzato, mentre CC Switch gestisce i preset per molti di essi.

Serve un abbonamento Claude a pagamento per usare GLM-5.2 in Claude Code?

No. Claude Code è soltanto il client: una volta configurato per z.ai, la fatturazione passa da z.ai e non da Anthropic. Ti serve un account Claude solo se vuoi mantenere Claude come provider disponibile per il cambio.

Devo riavviare Claude Code dopo aver cambiato provider in CC Switch?

Secondo la documentazione di CC Switch, Claude Code supporta il cambio a caldo dei dati del provider senza riavvio, mentre la maggior parte degli altri strumenti CLI richiede il riavvio del terminale o dell'app. Nella pratica, riavviare Claude Code è il modo più affidabile per assicurarsi che il cambio sia stato applicato.

Come torno a Claude con il login ufficiale in CC Switch?

Aggiungi un provider Claude Official dall'elenco dei preset, attivalo, quindi completa una volta il normale flusso di logout/login di Claude Code tramite OAuth. Da quel momento potrai alternare liberamente il login Claude ufficiale e provider di terze parti come z.ai.

CC Switch è gratuito e sicuro da usare?

Sì: è gratuito, open source e distribuito con licenza MIT. Le configurazioni restano in locale in un database SQLite con scritture atomiche; per progettazione, l'app modifica solo il minimo indispensabile nelle configurazioni dei singoli strumenti. I tuoi CLI continueranno quindi a funzionare normalmente anche se disinstalli l'app.

Approfondimenti correlati

• API GLM-5.2: accesso e prezzi
• GLM-5.2 vs Opus 4.6 per la programmazione
• Codex vs Claude Code