GLM-5.2, GLM-5.3 e GLM-5.3-Flash in Claude Code: configurazione e cambio modello

Configura GLM in Claude Code tramite APIMaster. Imposta settings.json su Windows, macOS e Linux, avvia claude, seleziona un modello con /model e inizia a chattare.

Configura APIMaster in settings.json, esegui claude, poi digita /model MODEL_ID nella conversazione per usare GLM. Gli ID disponibili trattati qui sono glm-5.2, glm-5.3, glm-5.3-flash. Claude Code è il client; GLM è il modello che risponde.

Prima di iniziare

Completa la verifica dell'ambiente e la configurazione di Claude Code. Ottieni una chiave API APIMaster con credito sufficiente e accesso ai modelli selezionati.

claude --version

Il base URL del gateway è https://apimaster.ai, senza /v1. Claude Code aggiunge /v1/messages da solo.

1. Apri la directory di configurazione

Windows

Premi Win + R, digita il seguente percorso e premi Invio:

%USERPROFILE%\.claude

Crea la cartella se necessario. Apri o crea settings.json. Assicurati che non sia denominato settings.json.txt.

macOS / Linux

Su macOS, in Finder premi Command + Shift + G e digita:

~/.claude

Su Linux, apri la stessa directory con il tuo file manager o editor. Creala se necessario:

mkdir -p ~/.claude

Apri o crea settings.json lì. Se hai impostato una directory di configurazione personalizzata per Claude Code, usa quella directory.

2. Modifica settings.json

Windows, macOS e Linux usano la stessa configurazione. Sostituisci YOUR_APIMASTER_API_KEY con la tua chiave APIMaster:

{
  "model": "glm-5.3",
  "env": {
    "ANTHROPIC_BASE_URL": "https://apimaster.ai",
    "ANTHROPIC_API_KEY": "YOUR_APIMASTER_API_KEY",
    "ANTHROPIC_AUTH_TOKEN": "",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0",
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
  }
}

Se il file esiste già, creane un backup e integra questi campi nell'oggetto JSON esistente e nell'oggetto env. Mantieni le altre impostazioni di cui hai bisogno. Non aggiungere un secondo oggetto JSON né duplicare una chiave env. JSON non ammette commenti né virgole finali.

La guida generale di Claude Code mostra l'autenticazione tramite token. Questa guida usa l'autenticazione tramite chiave API verificata nei nostri test di integrazione. Mantieni ANTHROPIC_AUTH_TOKEN vuoto quando usi ANTHROPIC_API_KEY e rimuovi le credenziali in conflitto da altre impostazioni o dal tuo terminale. Usa una chiave APIMaster per questo gateway.

Il campo model imposta il modello iniziale. Puoi selezionarne un altro dopo l'avvio. Mantieni questo file di impostazioni utente privato; non committare chiavi reali in un repository condiviso. Salva il file e riavvia Claude Code per caricare la nuova configurazione.

3. Avvia Claude Code

In un terminale aperto nella directory del tuo progetto, esegui:

claude

Completa i normali prompt della prima esecuzione e conferma il prompt di fiducia del progetto. Il modello iniziale dovrebbe essere glm-5.3. Si tratta di una normale sessione interattiva con i consueti strumenti e le impostazioni del progetto.

4. Seleziona un modello e inizia a chattare

Nella conversazione di Claude Code, digita uno dei seguenti comandi e premi Invio:

/model glm-5.2
/model glm-5.3
/model glm-5.3-flash

Esegui una riga alla volta, scegliendo il modello che desideri. Dopo che Claude Code ha confermato il cambio, invia un breve messaggio:

Reply with exactly OK.

Una normale risposta testuale conferma la connessione di base. Puoi quindi continuare a chattare o chiedergli di lavorare al tuo progetto. Per cambiare di nuovo nella stessa conversazione, digita un altro comando /model MODEL_ID.

Digitare /model da solo apre il selettore dei modelli. Gli ID personalizzati del gateway potrebbero non comparire nell'elenco predefinito. In tal caso digita l'ID completo come mostrato sopra. Il comando slash appartiene all'interno di Claude Code, non a PowerShell o Bash. I nomi dei modelli descrivono i modelli GLM, non Claude Sonnet o Opus.

Puoi anche scegliere un modello al lancio dal terminale. Esegui un comando alla volta:

claude --model glm-5.2
claude --model glm-5.3
claude --model glm-5.3-flash

Per impostare esplicitamente il predefinito per le sessioni future, modifica model in settings.json. Un flag di avvio, la variabile d'ambiente ANTHROPIC_MODEL o un'impostazione di progetto/gestita possono influire sul modello selezionato; controlla questi elementi se il modello iniziale differisce dal valore salvato.

Risoluzione dei problemi

Sintomo	Verifica
401 / richiesta di accesso inattesa	Controlla la chiave APIMaster, il base URL e le variabili di autenticazione in conflitto; riavvia la CLI dopo aver modificato le impostazioni.
404	Usa `https://apimaster.ai`, senza `/v1` o `/v1/messages`.
Le impostazioni non hanno effetto	Verifica la posizione del file, la validità del JSON e le sovrascritture da impostazioni del terminale, del progetto o gestite.
Modello assente dal selettore	Digita `/model MODEL_ID` con l'ID esatto, oppure avvia con `claude --model MODEL_ID`.
Modello non disponibile / 403	Controlla l'ortografia, i modelli consentiti dalla chiave, il saldo del conto e la disponibilità attuale della route.
`unrecognized_model`	Osservato con ID personalizzati nei nostri test. Verifica la risposta effettiva e il risultato dello strumento; i comportamenti predefiniti delle funzionalità Claude integrate non sono verificati per GLM.
Permesso negato per file o comando	Rivedi e approva l'operazione prevista tramite i consueti prompt di autorizzazione.
429 / 5xx / risposta interrotta	Conserva l'errore, l'ID del modello, la versione della CLI, l'ora UTC e l'ID della richiesta, se disponibile, per il supporto.

Validazione e diagnostica opzionale

Test di integrazione registrati: 2026-09-15 UTC, Claude Code 2.1.239, Linux. Tutti i modelli elencati qui hanno restituito il testo previsto e letto un file locale tramite uno strumento. Tutti e tre hanno anche completato una piccola riparazione Python ed esecuzione di test, verificata successivamente in modo indipendente. Windows e macOS non facevano parte di quelle esecuzioni registrate.

I controlli automatizzati precedenti usavano la modalità bare per isolare la configurazione. L'uso quotidiano normale segue le impostazioni settings.json e i passaggi interattivi sopra descritti. La modalità bare e --setting-sources "" saltano le integrazioni normali o le impostazioni salvate, quindi non dovrebbero essere aggiunti al comando di avvio quotidiano di questa guida.

Per un rapido controllo non interattivo usando la configurazione salvata:

claude --model glm-5.3 -p "Reply with exactly OK."

Per un controllo degli strumenti, crea probe.txt contenente FILE_PROBE_739182, avvia Claude Code in quella directory e chiedigli di leggere il file usando uno strumento e di restituirne il contenuto esatto. Conferma che lo strumento venga effettivamente eseguito.

Questi sono controlli di integrazione delimitati, non una garanzia di ogni funzionalità di Claude Code, del comportamento in sessioni lunghe o del contesto massimo. La documentazione del gateway di Anthropic non supporta ufficialmente l'instradamento di Claude Code verso modelli non Claude; questa guida descrive l'integrazione di APIMaster.

FAQ

Il mio abbonamento Claude copre queste richieste?

No. Con questa configurazione APIMaster, le richieste usano la tua chiave e il tuo saldo APIMaster.

Posso continuare a chattare dopo aver cambiato modello?

Sì, usa il comando di cambio modello nella conversazione aperta e attendi la conferma prima di inviare il messaggio successivo. Per un confronto pulito tra modelli, avvia una sessione separata con claude --model MODEL_ID.