GLM-5.2, GLM-5.3 e GLM-5.3-Flash in Codex: configurazione e selezione del modello
Configura GLM in Codex con APIMaster. Trova config.toml su Windows, macOS e Linux, imposta la tua chiave API, avvia una chat interattiva e seleziona un modello.
Configura la tua chiave API APIMaster e il config.toml di Codex, quindi esegui codex per chattare con GLM. Usa glm-5.2, glm-5.3, glm-5.3-flash. Codex si connette tramite l'API Responses all'indirizzo https://apimaster.ai/v1.
Prima di iniziare
Completa il controllo dell'ambiente, installa Codex seguendo la guida generale e ottieni una chiave API APIMaster con accesso a questi modelli e un credito sufficiente.
codex --version
1. Apri la directory di configurazione
Windows
Premi Win + R, inserisci il seguente percorso e premi Invio:
%USERPROFILE%\.codex
Crea la cartella se non esiste. Apri o crea config.toml con un editor di testo. Assicurati che il nome del file non sia config.toml.txt.
macOS / Linux
Su macOS, in Finder premi Command + Shift + G e inserisci:
~/.codex
Su Linux, apri la stessa directory con il tuo file manager o editor. Se necessario, creala dal terminale:
mkdir -p ~/.codex
Apri o crea config.toml in questa directory. Se usi una directory di stato personalizzata per Codex, usa quella directory.
2. Configura config.toml
Entrambe le piattaforme usano lo stesso contenuto:
model = "glm-5.3"
model_provider = "apimaster"
model_reasoning_summary = "none"
model_supports_reasoning_summaries = false
[model_providers.apimaster]
name = "APIMaster"
base_url = "https://apimaster.ai/v1"
env_key = "APIMASTER_API_KEY"
wire_api = "responses"
Se il file esiste già, creane una copia di backup e unisci queste impostazioni. Sostituisci le chiavi di primo livello esistenti invece di duplicarle e inseriscile prima del primo heading [tabella]. Unisci la sezione del provider se esiste già. Questo modifica il provider e il modello predefiniti per le nuove sessioni di Codex.
L'URL di base include /v1. Mantieni wire_api = "responses"; un endpoint Chat Completions da solo è insufficiente per questo flusso di lavoro. Le impostazioni dei riassunti disabilitano i riassunti facoltativi del ragionamento, non il pensiero interno del modello.
Per mantenere il tuo provider predefinito esistente, inserisci questa configurazione in ~/.codex/glm.config.toml (Windows: %USERPROFILE%\.codex\glm.config.toml). Quindi aggiungi --profile glm ai comandi di avvio indicati di seguito. I file di profilo con nome richiedono Codex 0.134.0 o successivo ed ereditano le altre impostazioni di base.
3. Imposta la tua chiave API
Sostituisci YOUR_APIMASTER_API_KEY con la chiave ottenuta da APIMaster. La configurazione TOML memorizza il nome della variabile d'ambiente, non la chiave stessa.
Windows PowerShell
Esegui nel terminale da cui lancerai Codex:
$env:APIMASTER_API_KEY = 'YOUR_APIMASTER_API_KEY'
Per salvarla anche per i terminali futuri:
[Environment]::SetEnvironmentVariable('APIMASTER_API_KEY', 'YOUR_APIMASTER_API_KEY', 'User')
Apri un nuovo terminale dopo aver salvato una variabile persistente, oppure continua a usare il terminale corrente in cui hai eseguito il primo comando.
macOS / Linux
export APIMASTER_API_KEY='YOUR_APIMASTER_API_KEY'
Questo vale per il terminale corrente. Per riutilizzarla nei nuovi terminali, aggiungi la stessa riga di export al file di avvio della tua shell, ad esempio ~/.zshrc per Zsh o ~/.bashrc per Bash interattivo, quindi apri un nuovo terminale. Mantieni i file contenenti chiavi reali privati e fuori dai repository condivisi.
4. Avvia Codex e chatta
Apri un terminale nella directory del tuo progetto ed esegui:
codex
Dopo i normali prompt di primo avvio o di fiducia del progetto, verifica che il modello attivo sia glm-5.3. Nella conversazione di Codex, inserisci:
Reply with exactly OK.
Una risposta normale conferma la connessione di base. Puoi quindi chiedere di spiegare del codice, leggere un file o apportare una modifica. Rivedi i consueti prompt di permesso per file e comandi.
5. Seleziona un altro modello
Per questi ID di modello personalizzati, scegli il modello esplicitamente all'avvio di Codex. Esegui un comando alla volta nel tuo terminale:
codex --model glm-5.2
codex --model glm-5.3
codex --model glm-5.3-flash
Ogni comando apre una conversazione interattiva. Per passare a un altro modello da una sessione aperta, inserisci /exit, quindi esegui il comando per il modello desiderato. Per continuare una conversazione salvata esistente con un altro modello, usa codex resume SESSION_ID --model MODEL_ID invece di avviare una nuova conversazione.
In Codex, /model apre il catalogo dei modelli e /status mostra il modello attivo. Il menu non elenca automaticamente tutti i modelli presenti nel marketplace di modelli di APIMaster. Se il tuo modello GLM non è presente, usa --model come indicato sopra. Non dare per scontato che la sintassi /model MODEL_ID di Claude Code funzioni in Codex; non è il percorso verificato per la selezione di modelli personalizzati in questo caso.
Per il profilo con nome opzionale, ad esempio:
codex --profile glm --model glm-5.3
Per modificare il modello predefinito per gli avvii futuri, modifica il valore model di primo livello nella configurazione che usi.
Risoluzione dei problemi
| Sintomo | Verifica |
|---|---|
| Chiave API mancante / 401 | Imposta APIMASTER_API_KEY nel terminale da cui avvii Codex; controlla la validità della chiave e il saldo. |
| Usa ancora un altro provider | Controlla model_provider, il profilo selezionato, le sovrascritture del progetto e i flag di avvio. Riavvia dopo aver modificato la configurazione. |
| Errore di parsing TOML | Evita chiavi o tabelle duplicate; le impostazioni di primo livello devono precedere gli heading delle tabelle. |
| 404 / protocollo non supportato | Usa https://apimaster.ai/v1 e wire_api = "responses". |
| Modello assente da /model | Usa l'ID completo del modello con codex --model. Il catalogo integrato non è l'elenco dei modelli del gateway. |
| Avviso su metadati del modello o elenco modelli | Questi ID potrebbero non avere metadati Codex. Controlla la risposta finale; i limiti di contesto di fallback non sono capacità verificate del modello. |
| Avviso sul flusso di ragionamento/output | Controlla la risposta finale e i risultati degli strumenti. Segnala l'output interrotto con il modello, la versione della CLI, l'ora UTC e l'ID della richiesta se disponibili. |
Validazione e controllo opzionale degli strumenti
Test di integrazione registrati: 2026-09-15 UTC, Codex CLI 0.154.0, Linux. Tutti i modelli elencati qui hanno restituito il testo previsto e usato uno strumento per leggere un file locale. Tutti e tre hanno anche corretto una piccola funzione Python ed eseguito i suoi test; il file di test è stato verificato e rieseguito in modo indipendente. Sono fornite le istruzioni di configurazione per Windows e macOS, ma questi sistemi operativi non facevano parte delle esecuzioni registrate. Questi controlli non stabiliscono la piena compatibilità delle funzionalità, il comportamento nelle sessioni lunghe o i limiti massimi di contesto.
Per verificare gli strumenti per i file, crea probe.txt in un progetto temporaneo contenente:
FILE_PROBE_739182
Avvia Codex lì con il modello scelto, quindi inserisci:
Read probe.txt using a tool and reply with its exact contents. Do not guess.
Conferma che uno strumento di lettura dei file venga eseguito e che la risposta corrisponda al contenuto del file. Usa questo test dopo aver verificato che la conversazione di base funzioni.
FAQ
Usa il mio abbonamento ChatGPT?
Le richieste usano la tua chiave e il tuo saldo APIMaster. Codex è il client; GLM è il modello selezionato. Questa configurazione non rende GLM un modello OpenAI.
Perché Claude Code usa un URL diverso?
Codex usa https://apimaster.ai/v1 per Responses. Claude Code usa la radice del sito https://apimaster.ai e aggiunge /v1/messages da sé.